Skip to contents

Get season statistics by team

Usage

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

Arguments

year

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

season_type

(String default: both): Select Season Type - regular, postseason, or both

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

Value

cfbd_stats_season_team() - A data frame with 32 variables:

col_nametypesdescription
seasonintegerSeason for stats.
teamcharacterTeam name.
conferencecharacterConference of team.
gamesintegerNumber of games.
time_of_poss_totalintegerTime of possession total.
time_of_poss_pgdoubleTime of possession per game.
pass_compsintegerTotal number of pass completions.
pass_attsintegerTotal number of pass attempts.
completion_pctdoublePassing completion percentage.
net_pass_ydsintegerNet passing yards.
pass_ypadoublePassing yards per attempt.
pass_yprdoublePassing yards per reception.
pass_TDsintegerPassing touchdowns.
interceptionsintegerPassing interceptions.
int_pctdoubleInterception percentage (of attempts).
rush_attsintegerRushing attempts.
rush_ydsintegerRushing yards.
rush_TDsintegerRushing touchdowns.
rush_ypcdoubleRushing yards per carry.
total_ydsintegerRushing total yards.
fumbles_lostintegerFumbles lost.
turnoversintegerTurnovers total.
turnovers_pgdoubleTurnovers per game.
first_downsintegerNumber of first downs.
third_downsintegerNumber of third downs.
third_down_convsintegerNumber of third down conversions.
third_conv_ratedoubleThird down conversion rate.
fourth_down_convsintegerFourth down conversions.
fourth_downsintegerFourth downs.
fourth_conv_ratedoubleFourth down conversion rate.
penaltiesintegerTotal number of penalties.
penalty_ydsintegerPenalty yards total.
penalties_pgdoublePenalties per game.
penalty_yds_pgdoublePenalty yardage per game.
yards_per_penaltydoubleAverage yards per penalty.
kick_returnsintegerNumber of kick returns.
kick_return_ydsintegerTotal kick return yards.
kick_return_TDsintegerTotal kick return touchdowns.
kick_return_avgdoubleKick return yards average.
punt_returnsintegerNumber of punt returns.
punt_return_ydsintegerPunt return total yards.
punt_return_TDsintegerPunt return total touchdowns.
punt_return_avgdoublePunt return yards average.
passes_interceptedintegerPasses intercepted.
passes_intercepted_ydsintegerPass interception return yards.
passes_intercepted_TDsintegerPass interception return touchdowns.

Examples

# \donttest{
   try(cfbd_stats_season_team(year = 2018, conference = "B12", start_week = 1, end_week = 8))
#> ── Season stats from CollegeFootballData.com ───────────────── cfbfastR 2.3.0 ──
#>  Data updated: 2026-06-12 02:22:22 UTC
#> # A tibble: 10 × 32
#>    season team          conference games time_of_poss_total pass_comps pass_atts
#>     <int> <chr>         <chr>      <int>              <int>      <int>     <int>
#>  1   2018 Baylor        Big 12         7              13974        179       288
#>  2   2018 Iowa State    Big 12         6              10683        121       179
#>  3   2018 Kansas        Big 12         7              12405        133       224
#>  4   2018 Kansas State  Big 12         7              11392         91       170
#>  5   2018 Oklahoma      Big 12         7              11600        125       176
#>  6   2018 Oklahoma Sta… Big 12         7              11418        136       232
#>  7   2018 TCU           Big 12         7              12200        137       239
#>  8   2018 Texas         Big 12         7              13593        160       246
#>  9   2018 Texas Tech    Big 12         7              14014        220       319
#> 10   2018 West Virginia Big 12         6              10212        138       196
#> # ℹ 25 more variables: net_pass_yds <int>, pass_TDs <int>, interceptions <int>,
#> #   rush_atts <int>, rush_yds <int>, rush_TDs <int>, total_yds <int>,
#> #   fumbles_lost <int>, turnovers <int>, first_downs <int>, third_downs <int>,
#> #   third_down_convs <int>, fourth_down_convs <int>, fourth_downs <int>,
#> #   penalties <int>, penalty_yds <int>, kick_returns <int>,
#> #   kick_return_yds <int>, kick_return_TDs <int>, punt_returns <int>,
#> #   punt_return_yds <int>, punt_return_TDs <int>, passes_intercepted <int>, …

   try(cfbd_stats_season_team(2019, team = "LSU"))
#> ── Season stats from CollegeFootballData.com ───────────────── cfbfastR 2.3.0 ──
#>  Data updated: 2026-06-12 02:22:23 UTC
#> # A tibble: 1 × 32
#>   season team  conference games time_of_poss_total pass_comps pass_atts
#>    <int> <chr> <chr>      <int>              <int>      <int>     <int>
#> 1   2019 LSU   SEC           15              27200        426       567
#> # ℹ 25 more variables: net_pass_yds <int>, pass_TDs <int>, interceptions <int>,
#> #   rush_atts <int>, rush_yds <int>, rush_TDs <int>, total_yds <int>,
#> #   fumbles_lost <int>, turnovers <int>, first_downs <int>, third_downs <int>,
#> #   third_down_convs <int>, fourth_down_convs <int>, fourth_downs <int>,
#> #   penalties <int>, penalty_yds <int>, kick_returns <int>,
#> #   kick_return_yds <int>, kick_return_TDs <int>, punt_returns <int>,
#> #   punt_return_yds <int>, punt_return_TDs <int>, passes_intercepted <int>, …

   try(cfbd_stats_season_team(2013, team = "Florida State"))
#> ── Season stats from CollegeFootballData.com ───────────────── cfbfastR 2.3.0 ──
#>  Data updated: 2026-06-12 02:22:24 UTC
#> # A tibble: 1 × 32
#>   season team          conference games time_of_poss_total pass_comps pass_atts
#>    <int> <chr>         <chr>      <int>              <int>      <int>     <int>
#> 1   2013 Florida State ACC           14              24612        288       442
#> # ℹ 25 more variables: net_pass_yds <int>, pass_TDs <int>, interceptions <int>,
#> #   rush_atts <int>, rush_yds <int>, rush_TDs <int>, total_yds <int>,
#> #   fumbles_lost <int>, turnovers <int>, first_downs <int>, third_downs <int>,
#> #   third_down_convs <int>, fourth_down_convs <int>, fourth_downs <int>,
#> #   penalties <int>, penalty_yds <int>, kick_returns <int>,
#> #   kick_return_yds <int>, kick_return_TDs <int>, punt_returns <int>,
#> #   punt_return_yds <int>, punt_return_TDs <int>, passes_intercepted <int>, …
# }