Skip to contents

Get season statistics by player

Usage

cfbd_stats_season_player(
  year,
  season_type = "both",
  team = NULL,
  conference = NULL,
  start_week = NULL,
  end_week = NULL,
  category = NULL
)

Arguments

year

(Integer required): Year, 4 digit format (YYYY)

season_type

(String default both): Season type - regular, postseason, both, allstar, spring_regular, spring_postseason

team

(String optional): D-I Team

conference

(String optional): Conference abbreviation - Select a valid FBS conference Conference abbreviations P5: ACC, B12, B1G, SEC, PAC Conference abbreviations G5 and FBS Independents: CUSA, MAC, MWC, Ind, SBC, AAC

start_week

(Integer optional): Starting Week - values range from 1-15, 1-14 for seasons pre-playoff, i.e. 2013 or earlier

end_week

(Integer optional): Ending Week - values range from 1-15, 1-14 for seasons pre-playoff, i.e. 2013 or earlier

category

(String optional): Category filter (e.g defensive) Offense: passing, receiving, rushing Defense: defensive, fumbles, interceptions Special Teams: punting, puntReturns, kicking, kickReturns

Value

cfbd_stats_season_player() - A data frame with 59 variables:

col_nametypesdescription
yearintegerSeason of the player stats.
teamcharacterTeam name.
conferencecharacterConference of the team.
athlete_idcharacterAthlete referencing id.
playercharacterPlayer name.
positioncharacterPlayer position.
passing_completionsdoublePassing completions.
passing_attdoublePassing attempts.
passing_pctdoublePassing completion percentage.
passing_ydsdoublePassing yardage.
passing_tddoublePassing touchdowns.
passing_intdoublePassing interceptions.
passing_ypadoublePassing yards per attempt.
rushing_cardoubleRushing yards per carry.
rushing_ydsdoubleRushing yards total.
rushing_tddoubleRushing touchdowns.
rushing_ypcdoubleRushing yards per carry.
rushing_longdoubleRushing longest yardage attempt.
receiving_recdoubleReceiving - pass receptions.
receiving_ydsdoubleReceiving - pass reception yards.
receiving_tddoubleReceiving - passing reception touchdowns.
receiving_yprdoubleReceiving - passing yards per reception.
receiving_longdoubleReceiving - longest pass reception yardage.
fumbles_fumdoubleFumbles.
fumbles_recdoubleFumbles recovered.
fumbles_lostdoubleFumbles lost.
defensive_solodoubleDefensive solo tackles.
defensive_totdoubleDefensive total tackles.
defensive_tfldoubleDefensive tackles for loss.
defensive_sacksdoubleDefensive sacks.
defensive_qb_hurdoubleDefensive quarterback hurries.
interceptions_intdoubleInterceptions total.
interceptions_ydsdoubleInterception return yards.
interceptions_avgdoubleInterception return yards average.
interceptions_tddoubleInterception return touchdowns.
defensive_pddoubleDefense - passes defensed.
defensive_tddoubleDefense - defensive touchdowns.
kicking_fgmdoubleKicking - field goals made.
kicking_fgadoubleKicking - field goals attempted.
kicking_pctdoubleKicking - field goal percentage.
kicking_xpadoubleKicking - extra points attempted.
kicking_xpmdoubleKicking - extra points made.
kicking_ptsdoubleKicking - total points.
kicking_longdoubleKicking - longest successful field goal attempt.
kick_returns_nodoubleKick Returns - number of kick returns.
kick_returns_ydsdoubleKick Returns - kick return yards.
kick_returns_avgdoubleKick Returns - kick return average yards per return.
kick_returns_tddoubleKick Returns - kick return touchdowns.
kick_returns_longdoubleKick Returns - longest kick return yardage.
punting_nodoublePunting - number of punts.
punting_ydsdoublePunting - punting yardage.
punting_yppdoublePunting - yards per punt.
punting_longdoublePunting - longest punt yardage.
punting_in_20doublePunting - punt downed inside the 20 yard line.
punting_tbdoublePunting - punt caused a touchback.
punt_returns_nodoublePunt Returns - number of punt returns.
punt_returns_ydsdoublePunt Returns - punt return yardage total.
punt_returns_avgdoublePunt Returns - punt return average yards per return.
punt_returns_tddoublePunt Returns - punt return touchdowns.
punt_returns_longdoublePunt Returns - longest punt return yardage.

Examples

# \donttest{
   try(cfbd_stats_season_player(year = 2018, conference = "B12", start_week = 1, end_week = 7))
#> ── Advanced player season stats from CollegeFootballData.com ───────────────────
#>  Data updated: 2026-06-13 04:20:08 UTC
#> # A tibble: 544 × 60
#>     year team          conference athlete_id player position passing_completions
#>    <dbl> <chr>         <chr>      <chr>      <chr>  <chr>                  <dbl>
#>  1  2018 Oklahoma      Big 12     3116367    Curti… LB                        NA
#>  2  2018 Oklahoma      Big 12     3116384    Carso… FB                        NA
#>  3  2018 TCU           Big 12     3116420    Grays… QB                         8
#>  4  2018 TCU           Big 12     3116426    Ridwa… S                         NA
#>  5  2018 TCU           Big 12     3116431    Ty Su… LB                        NA
#>  6  2018 TCU           Big 12     3116436    Trey … G                         NA
#>  7  2018 TCU           Big 12     3116449    L.J. … DE                        NA
#>  8  2018 West Virginia Big 12     3116455    Yodny… OL                        NA
#>  9  2018 West Virginia Big 12     3116461    Billy… P                         NA
#> 10  2018 Baylor        Big 12     3116715    Jalan… QB                        26
#> # ℹ 534 more rows
#> # ℹ 53 more variables: passing_att <dbl>, passing_pct <dbl>, passing_yds <dbl>,
#> #   passing_td <dbl>, passing_int <dbl>, passing_ypa <dbl>, rushing_car <dbl>,
#> #   rushing_yds <dbl>, rushing_td <dbl>, rushing_ypc <dbl>, rushing_long <dbl>,
#> #   receiving_rec <dbl>, receiving_yds <dbl>, receiving_td <dbl>,
#> #   receiving_ypr <dbl>, receiving_long <dbl>, fumbles_fum <dbl>,
#> #   fumbles_rec <dbl>, fumbles_lost <dbl>, defensive_solo <dbl>, …

   try(cfbd_stats_season_player(2019, team = "LSU", category = "passing"))
#> ── Advanced player season stats from CollegeFootballData.com ───────────────────
#>  Data updated: 2026-06-13 04:20:09 UTC
#> # A tibble: 2 × 60
#>    year team  conference athlete_id player        position passing_completions
#>   <dbl> <chr> <chr>      <chr>      <chr>         <chr>                  <dbl>
#> 1  2019 LSU   SEC        3915511    Joe Burrow    QB                       402
#> 2  2019 LSU   SEC        4242210    Myles Brennan QB                        24
#> # ℹ 53 more variables: passing_att <dbl>, passing_pct <dbl>, passing_yds <dbl>,
#> #   passing_td <dbl>, passing_int <dbl>, passing_ypa <dbl>, rushing_car <dbl>,
#> #   rushing_yds <dbl>, rushing_td <dbl>, rushing_ypc <dbl>, rushing_long <dbl>,
#> #   receiving_rec <dbl>, receiving_yds <dbl>, receiving_td <dbl>,
#> #   receiving_ypr <dbl>, receiving_long <dbl>, fumbles_fum <dbl>,
#> #   fumbles_rec <dbl>, fumbles_lost <dbl>, defensive_solo <dbl>,
#> #   defensive_tot <dbl>, defensive_tfl <dbl>, defensive_sacks <dbl>, …

   try(cfbd_stats_season_player(2013, team = "Florida State", category = "passing"))
#> ── Advanced player season stats from CollegeFootballData.com ───────────────────
#>  Data updated: 2026-06-13 04:20:10 UTC
#> # A tibble: 3 × 60
#>    year team          conference athlete_id player  position passing_completions
#>   <dbl> <chr>         <chr>      <chr>      <chr>   <chr>                  <dbl>
#> 1  2013 Florida State ACC        514124     Jake C… QB                        18
#> 2  2013 Florida State ACC        530299     Sean M… QB                        13
#> 3  2013 Florida State ACC        530308     Jameis… QB                       257
#> # ℹ 53 more variables: passing_att <dbl>, passing_pct <dbl>, passing_yds <dbl>,
#> #   passing_td <dbl>, passing_int <dbl>, passing_ypa <dbl>, rushing_car <dbl>,
#> #   rushing_yds <dbl>, rushing_td <dbl>, rushing_ypc <dbl>, rushing_long <dbl>,
#> #   receiving_rec <dbl>, receiving_yds <dbl>, receiving_td <dbl>,
#> #   receiving_ypr <dbl>, receiving_long <dbl>, fumbles_fum <dbl>,
#> #   fumbles_rec <dbl>, fumbles_lost <dbl>, defensive_solo <dbl>,
#> #   defensive_tot <dbl>, defensive_tfl <dbl>, defensive_sacks <dbl>, …

# }