Skip to contents

Get ESPN college football team stats data

Usage

espn_cfb_team_stats(team_id, year, season_type = "regular", total = FALSE)

Arguments

team_id

Team ID

year

Year

season_type

(character, default: regular): Season type - regular or postseason

total

(boolean, default: FALSE): Totals

Value

Returns a tibble with the following columns:

col_nametypes
team_idcharacter
team_guidcharacter
team_uidcharacter
team_sdrcharacter
team_slugcharacter
team_locationcharacter
team_namecharacter
team_nicknamecharacter
team_abbreviationcharacter
team_display_namecharacter
team_short_display_namecharacter
team_colorcharacter
team_alternate_colorcharacter
is_activelogical
is_all_starlogical
logo_hrefcharacter
logo_dark_hrefcharacter
general_fumblesnumeric
general_fumbles_lostnumeric
general_fumbles_forcednumeric
general_fumbles_recoverednumeric
general_fumbles_touchdownsnumeric
general_games_playednumeric
general_offensive_two_pt_returnsnumeric
general_offensive_fumbles_touchdownsnumeric
general_defensive_fumbles_touchdownsnumeric
passing_avg_gainnumeric
passing_completion_pctnumeric
passing_completionsnumeric
passing_espnqb_ratingnumeric
passing_interception_pctnumeric
passing_interceptionsnumeric
passing_long_passingnumeric
passing_misc_yardsnumeric
passing_net_passing_yardsnumeric
passing_net_passing_yards_per_gamenumeric
passing_net_total_yardsnumeric
passing_net_yards_per_gamenumeric
passing_passing_attemptsnumeric
passing_passing_big_playsnumeric
passing_passing_first_downsnumeric
passing_passing_fumblesnumeric
passing_passing_fumbles_lostnumeric
passing_passing_touchdown_pctnumeric
passing_passing_touchdownsnumeric
passing_passing_yardsnumeric
passing_passing_yards_after_catchnumeric
passing_passing_yards_at_catchnumeric
passing_passing_yards_per_gamenumeric
passing_qb_ratingnumeric
passing_sacksnumeric
passing_sack_yards_lostnumeric
passing_team_games_playednumeric
passing_total_offensive_playsnumeric
passing_total_pointsnumeric
passing_total_points_per_gamenumeric
passing_total_touchdownsnumeric
passing_total_yardsnumeric
passing_total_yards_from_scrimmagenumeric
passing_two_point_pass_convsnumeric
passing_two_pt_passnumeric
passing_two_pt_pass_attemptsnumeric
passing_yards_from_scrimmage_per_gamenumeric
passing_yards_per_completionnumeric
passing_yards_per_gamenumeric
passing_yards_per_pass_attemptnumeric
passing_net_yards_per_pass_attemptnumeric
passing_quarterback_ratingnumeric
rushing_avg_gainnumeric
rushing_espnrb_ratingnumeric
rushing_long_rushingnumeric
rushing_misc_yardsnumeric
rushing_net_total_yardsnumeric
rushing_net_yards_per_gamenumeric
rushing_rushing_attemptsnumeric
rushing_rushing_big_playsnumeric
rushing_rushing_first_downsnumeric
rushing_rushing_fumblesnumeric
rushing_rushing_fumbles_lostnumeric
rushing_rushing_touchdownsnumeric
rushing_rushing_yardsnumeric
rushing_rushing_yards_per_gamenumeric
rushing_stuffsnumeric
rushing_stuff_yards_lostnumeric
rushing_team_games_playednumeric
rushing_total_offensive_playsnumeric
rushing_total_pointsnumeric
rushing_total_points_per_gamenumeric
rushing_total_touchdownsnumeric
rushing_total_yardsnumeric
rushing_total_yards_from_scrimmagenumeric
rushing_two_point_rush_convsnumeric
rushing_two_pt_rushnumeric
rushing_two_pt_rush_attemptsnumeric
rushing_yards_from_scrimmage_per_gamenumeric
rushing_yards_per_gamenumeric
rushing_yards_per_rush_attemptnumeric
receiving_avg_gainnumeric
receiving_espnwr_ratingnumeric
receiving_long_receptionnumeric
receiving_misc_yardsnumeric
receiving_net_total_yardsnumeric
receiving_net_yards_per_gamenumeric
receiving_receiving_big_playsnumeric
receiving_receiving_first_downsnumeric
receiving_receiving_fumblesnumeric
receiving_receiving_fumbles_lostnumeric
receiving_receiving_targetsnumeric
receiving_receiving_touchdownsnumeric
receiving_receiving_yardsnumeric
receiving_receiving_yards_after_catchnumeric
receiving_receiving_yards_at_catchnumeric
receiving_receiving_yards_per_gamenumeric
receiving_receptionsnumeric
receiving_team_games_playednumeric
receiving_total_offensive_playsnumeric
receiving_total_pointsnumeric
receiving_total_points_per_gamenumeric
receiving_total_touchdownsnumeric
receiving_total_yardsnumeric
receiving_total_yards_from_scrimmagenumeric
receiving_two_point_rec_convsnumeric
receiving_two_pt_receptionnumeric
receiving_two_pt_reception_attemptsnumeric
receiving_yards_from_scrimmage_per_gamenumeric
receiving_yards_per_gamenumeric
receiving_yards_per_receptionnumeric
defensive_assist_tacklesnumeric
defensive_avg_interception_yardsnumeric
defensive_avg_sack_yardsnumeric
defensive_avg_stuff_yardsnumeric
defensive_blocked_field_goal_touchdownsnumeric
defensive_blocked_punt_touchdownsnumeric
defensive_defensive_touchdownsnumeric
defensive_hurriesnumeric
defensive_kicks_blockednumeric
defensive_long_interceptionnumeric
defensive_misc_touchdownsnumeric
defensive_passes_batted_downnumeric
defensive_passes_defendednumeric
defensive_two_pt_returnsnumeric
defensive_sacksnumeric
defensive_sack_yardsnumeric
defensive_safetiesnumeric
defensive_solo_tacklesnumeric
defensive_stuffsnumeric
defensive_stuff_yardsnumeric
defensive_tackles_for_lossnumeric
defensive_team_games_playednumeric
defensive_total_tacklesnumeric
defensive_yards_allowednumeric
defensive_points_allowednumeric
defensive_one_pt_safeties_madenumeric
defensive_interceptions_interceptionsnumeric
defensive_interceptions_interception_touchdownsnumeric
defensive_interceptions_interception_yardsnumeric
kicking_avg_kickoff_return_yardsnumeric
kicking_avg_kickoff_yardsnumeric
kicking_extra_point_attemptsnumeric
kicking_extra_point_pctnumeric
kicking_extra_points_blockednumeric
kicking_extra_points_blocked_pctnumeric
kicking_extra_points_madenumeric
kicking_fair_catchesnumeric
kicking_fair_catch_pctnumeric
kicking_field_goal_attemptsnumeric
kicking_field_goal_attempts1_19numeric
kicking_field_goal_attempts20_29numeric
kicking_field_goal_attempts30_39numeric
kicking_field_goal_attempts40_49numeric
kicking_field_goal_attempts50_59numeric
kicking_field_goal_attempts60_99numeric
kicking_field_goal_attempts50numeric
kicking_field_goal_attempt_yardsnumeric
kicking_field_goal_pctnumeric
kicking_field_goals_blockednumeric
kicking_field_goals_blocked_pctnumeric
kicking_field_goals_madenumeric
kicking_field_goals_made1_19numeric
kicking_field_goals_made20_29numeric
kicking_field_goals_made30_39numeric
kicking_field_goals_made40_49numeric
kicking_field_goals_made50_59numeric
kicking_field_goals_made60_99numeric
kicking_field_goals_made50numeric
kicking_field_goals_made_yardsnumeric
kicking_field_goals_missed_yardsnumeric
kicking_kickoff_returnsnumeric
kicking_kickoff_return_touchdownsnumeric
kicking_kickoff_return_yardsnumeric
kicking_kickoffsnumeric
kicking_kickoff_yardsnumeric
kicking_long_field_goal_attemptnumeric
kicking_long_field_goal_madenumeric
kicking_long_kickoffnumeric
kicking_team_games_playednumeric
kicking_total_kicking_pointsnumeric
kicking_touchback_pctnumeric
kicking_touchbacksnumeric
returning_def_fumble_returnsnumeric
returning_def_fumble_return_yardsnumeric
returning_fumble_recoveriesnumeric
returning_fumble_recovery_yardsnumeric
returning_kick_return_fair_catchesnumeric
returning_kick_return_fair_catch_pctnumeric
returning_kick_return_fumblesnumeric
returning_kick_return_fumbles_lostnumeric
returning_kick_returnsnumeric
returning_kick_return_touchdownsnumeric
returning_kick_return_yardsnumeric
returning_long_kick_returnnumeric
returning_long_punt_returnnumeric
returning_misc_fumble_returnsnumeric
returning_misc_fumble_return_yardsnumeric
returning_opp_fumble_recoveriesnumeric
returning_opp_fumble_recovery_yardsnumeric
returning_opp_special_team_fumble_returnsnumeric
returning_opp_special_team_fumble_return_yardsnumeric
returning_punt_return_fair_catchesnumeric
returning_punt_return_fair_catch_pctnumeric
returning_punt_return_fumblesnumeric
returning_punt_return_fumbles_lostnumeric
returning_punt_returnsnumeric
returning_punt_returns_started_inside_the10numeric
returning_punt_returns_started_inside_the20numeric
returning_punt_return_touchdownsnumeric
returning_punt_return_yardsnumeric
returning_special_team_fumble_returnsnumeric
returning_special_team_fumble_return_yardsnumeric
returning_team_games_playednumeric
returning_yards_per_kick_returnnumeric
returning_yards_per_punt_returnnumeric
returning_yards_per_returnnumeric
punting_avg_punt_return_yardsnumeric
punting_fair_catchesnumeric
punting_gross_avg_punt_yardsnumeric
punting_long_puntnumeric
punting_net_avg_punt_yardsnumeric
punting_punt_returnsnumeric
punting_punt_return_yardsnumeric
punting_puntsnumeric
punting_punts_blockednumeric
punting_punts_blocked_pctnumeric
punting_punts_inside10numeric
punting_punts_inside10pctnumeric
punting_punts_inside20numeric
punting_punts_inside20pctnumeric
punting_punt_yardsnumeric
punting_team_games_playednumeric
punting_touchback_pctnumeric
punting_touchbacksnumeric
scoring_defensive_pointsnumeric
scoring_field_goalsnumeric
scoring_kick_extra_pointsnumeric
scoring_misc_pointsnumeric
scoring_passing_touchdownsnumeric
scoring_receiving_touchdownsnumeric
scoring_return_touchdownsnumeric
scoring_rushing_touchdownsnumeric
scoring_total_pointsnumeric
scoring_total_points_per_gamenumeric
scoring_total_touchdownsnumeric
scoring_total_two_point_convsnumeric
scoring_two_point_pass_convsnumeric
scoring_two_point_rec_convsnumeric
scoring_two_point_rush_convsnumeric
scoring_one_pt_safeties_madenumeric
miscellaneous_first_downsnumeric
miscellaneous_first_downs_passingnumeric
miscellaneous_first_downs_penaltynumeric
miscellaneous_first_downs_per_gamenumeric
miscellaneous_first_downs_rushingnumeric
miscellaneous_fourth_down_attemptsnumeric
miscellaneous_fourth_down_conv_pctnumeric
miscellaneous_fourth_down_convsnumeric
miscellaneous_fumbles_lostnumeric
miscellaneous_possession_time_secondsnumeric
miscellaneous_redzone_efficiency_pctnumeric
miscellaneous_redzone_field_goal_pctnumeric
miscellaneous_redzone_scoring_pctnumeric
miscellaneous_redzone_touchdown_pctnumeric
miscellaneous_third_down_attemptsnumeric
miscellaneous_third_down_conv_pctnumeric
miscellaneous_third_down_convsnumeric
miscellaneous_total_giveawaysnumeric
miscellaneous_total_penaltiesnumeric
miscellaneous_total_penalty_yardsnumeric
miscellaneous_total_takeawaysnumeric
miscellaneous_total_drivesnumeric
miscellaneous_turn_over_differentialnumeric

Author

Saiem Gilani

Examples

# \donttest{
  try(espn_cfb_team_stats(team_id = 52, year = 2020))
#> ── CFB Team Season stats from ESPN.com ─────────────────────── cfbfastR 1.9.5 ──
#>  Data updated: 2024-02-01 16:01:35 UTC
#> # A tibble: 1 × 290
#>   team_id team_guid          team_uid team_sdr team_slug team_location team_name
#>   <chr>   <chr>              <chr>    <chr>    <chr>     <chr>         <chr>    
#> 1 52      fa181128-4809-a20… s:20~l:… 5995     florida-… Florida State Seminoles
#> # ℹ 283 more variables: team_nickname <chr>, team_abbreviation <chr>,
#> #   team_display_name <chr>, team_short_display_name <chr>, team_color <chr>,
#> #   team_alternate_color <chr>, is_active <lgl>, is_all_star <lgl>,
#> #   logo_href <chr>, logo_dark_href <chr>, general_fumbles <dbl>,
#> #   general_fumbles_lost <dbl>, general_fumbles_forced <dbl>,
#> #   general_fumbles_recovered <dbl>, general_fumbles_touchdowns <dbl>,
#> #   general_games_played <dbl>, general_offensive_two_pt_returns <dbl>, …
# }