Skip to contents

Get ESPN college football player stats data

Usage

espn_cfb_player_stats(athlete_id, year, season_type = "regular", total = FALSE)

Arguments

athlete_id

Athlete 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
athlete_idcharacter
athlete_uidcharacter
athlete_guidcharacter
athlete_typecharacter
sdrcharacter
first_namecharacter
last_namecharacter
full_namecharacter
display_namecharacter
short_namecharacter
weightnumeric
display_weightcharacter
heightnumeric
display_heightcharacter
ageinteger
date_of_birthcharacter
birth_place_citycharacter
birth_place_statecharacter
birth_place_countrycharacter
slugcharacter
jerseycharacter
position_idcharacter
position_namecharacter
position_display_namecharacter
position_abbreviationcharacter
position_leaflogical
linkedlogical
experience_yearsinteger
experience_display_valuecharacter
experience_abbreviationcharacter
activelogical
status_idcharacter
status_namecharacter
status_typecharacter
status_abbreviationcharacter
headshot_hrefcharacter
headshot_altcharacter
general_fumblesnumeric
general_fumbles_lostnumeric
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_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_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_qbrnumeric
passing_adj_qbrnumeric
passing_quarterback_ratingnumeric
rushing_avg_gainnumeric
rushing_espnrb_ratingnumeric
rushing_long_rushingnumeric
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_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_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_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
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
general_fumbles_forcedlogical
general_fumbles_recoveredlogical
passing_misc_yardslogical
passing_total_pointslogical
rushing_misc_yardslogical
rushing_total_pointslogical
receiving_misc_yardslogical
receiving_total_pointslogical
defensive_assist_tackleslogical
defensive_avg_interception_yardslogical
defensive_avg_sack_yardslogical
defensive_avg_stuff_yardslogical
defensive_blocked_field_goal_touchdownslogical
defensive_blocked_punt_touchdownslogical
defensive_defensive_touchdownslogical
defensive_hurrieslogical
defensive_kicks_blockedlogical
defensive_long_interceptionlogical
defensive_misc_touchdownslogical
defensive_passes_batted_downlogical
defensive_passes_defendedlogical
defensive_two_pt_returnslogical
defensive_sackslogical
defensive_sack_yardslogical
defensive_safetieslogical
defensive_solo_tackleslogical
defensive_stuffslogical
defensive_stuff_yardslogical
defensive_tackles_for_losslogical
defensive_team_games_playedlogical
defensive_total_tackleslogical
defensive_yards_allowedlogical
defensive_points_allowedlogical
defensive_one_pt_safeties_madelogical
defensive_interceptions_interceptionslogical
defensive_interceptions_interception_touchdownslogical
defensive_interceptions_interception_yardslogical
kicking_avg_kickoff_return_yardslogical
kicking_avg_kickoff_yardslogical
kicking_extra_point_attemptslogical
kicking_extra_point_pctlogical
kicking_extra_points_blockedlogical
kicking_extra_points_blocked_pctlogical
kicking_extra_points_madelogical
kicking_fair_catcheslogical
kicking_fair_catch_pctlogical
kicking_field_goal_attemptslogical
kicking_field_goal_attempts1_19logical
kicking_field_goal_attempts20_29logical
kicking_field_goal_attempts30_39logical
kicking_field_goal_attempts40_49logical
kicking_field_goal_attempts50_59logical
kicking_field_goal_attempts60_99logical
kicking_field_goal_attempts50logical
kicking_field_goal_attempt_yardslogical
kicking_field_goal_pctlogical
kicking_field_goals_blockedlogical
kicking_field_goals_blocked_pctlogical
kicking_field_goals_madelogical
kicking_field_goals_made1_19logical
kicking_field_goals_made20_29logical
kicking_field_goals_made30_39logical
kicking_field_goals_made40_49logical
kicking_field_goals_made50_59logical
kicking_field_goals_made60_99logical
kicking_field_goals_made50logical
kicking_field_goals_made_yardslogical
kicking_field_goals_missed_yardslogical
kicking_kickoff_returnslogical
kicking_kickoff_return_touchdownslogical
kicking_kickoff_return_yardslogical
kicking_kickoffslogical
kicking_kickoff_yardslogical
kicking_long_field_goal_attemptlogical
kicking_long_field_goal_madelogical
kicking_long_kickofflogical
kicking_team_games_playedlogical
kicking_total_kicking_pointslogical
kicking_touchback_pctlogical
kicking_touchbackslogical
returning_def_fumble_returnslogical
returning_def_fumble_return_yardslogical
returning_fumble_recoverieslogical
returning_fumble_recovery_yardslogical
returning_kick_return_fair_catcheslogical
returning_kick_return_fair_catch_pctlogical
returning_kick_return_fumbleslogical
returning_kick_return_fumbles_lostlogical
returning_kick_returnslogical
returning_kick_return_touchdownslogical
returning_kick_return_yardslogical
returning_long_kick_returnlogical
returning_long_punt_returnlogical
returning_misc_fumble_returnslogical
returning_misc_fumble_return_yardslogical
returning_opp_fumble_recoverieslogical
returning_opp_fumble_recovery_yardslogical
returning_opp_special_team_fumble_returnslogical
returning_opp_special_team_fumble_return_yardslogical
returning_punt_return_fair_catcheslogical
returning_punt_return_fair_catch_pctlogical
returning_punt_return_fumbleslogical
returning_punt_return_fumbles_lostlogical
returning_punt_returnslogical
returning_punt_returns_started_inside_the10logical
returning_punt_returns_started_inside_the20logical
returning_punt_return_touchdownslogical
returning_punt_return_yardslogical
returning_special_team_fumble_returnslogical
returning_special_team_fumble_return_yardslogical
returning_team_games_playedlogical
returning_yards_per_kick_returnlogical
returning_yards_per_punt_returnlogical
returning_yards_per_returnlogical
punting_avg_punt_return_yardslogical
punting_fair_catcheslogical
punting_gross_avg_punt_yardslogical
punting_long_puntlogical
punting_net_avg_punt_yardslogical
punting_punt_returnslogical
punting_punt_return_yardslogical
punting_puntslogical
punting_punts_blockedlogical
punting_punts_blocked_pctlogical
punting_punts_inside10logical
punting_punts_inside10pctlogical
punting_punts_inside20logical
punting_punts_inside20pctlogical
punting_punt_yardslogical
punting_team_games_playedlogical
punting_touchback_pctlogical
punting_touchbackslogical
miscellaneous_first_downslogical
miscellaneous_first_downs_passinglogical
miscellaneous_first_downs_penaltylogical
miscellaneous_first_downs_per_gamelogical
miscellaneous_first_downs_rushinglogical
miscellaneous_fourth_down_attemptslogical
miscellaneous_fourth_down_conv_pctlogical
miscellaneous_fourth_down_convslogical
miscellaneous_fumbles_lostlogical
miscellaneous_possession_time_secondslogical
miscellaneous_redzone_efficiency_pctlogical
miscellaneous_redzone_field_goal_pctlogical
miscellaneous_redzone_scoring_pctlogical
miscellaneous_redzone_touchdown_pctlogical
miscellaneous_third_down_attemptslogical
miscellaneous_third_down_conv_pctlogical
miscellaneous_third_down_convslogical
miscellaneous_total_giveawayslogical
miscellaneous_total_penaltieslogical
miscellaneous_total_penalty_yardslogical
miscellaneous_total_takeawayslogical
miscellaneous_total_driveslogical
miscellaneous_turn_over_differentiallogical
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

Author

Saiem Gilani

Examples

# \donttest{
  try(espn_cfb_player_stats(athlete_id = 530308, year = 2013))
#> ── CFB Player Season stats from ESPN.com ───────────────────── cfbfastR 1.9.5 ──
#>  Data updated: 2024-02-01 16:01:33 UTC
#> # A tibble: 1 × 334
#>   athlete_id athlete_uid    athlete_guid athlete_type sdr   first_name last_name
#>   <chr>      <chr>          <chr>        <chr>        <chr> <chr>      <chr>    
#> 1 530308     s:20~l:23~a:5… 57af2581-ce… football     2969… Jameis     Winston  
#> # ℹ 327 more variables: full_name <chr>, display_name <chr>, short_name <chr>,
#> #   weight <dbl>, display_weight <chr>, height <dbl>, display_height <chr>,
#> #   age <int>, date_of_birth <chr>, birth_place_city <chr>,
#> #   birth_place_state <chr>, birth_place_country <chr>,
#> #   birth_country_alternate_id <chr>, birth_country_abbreviation <chr>,
#> #   slug <chr>, jersey <chr>, flag_href <chr>, flag_alt <chr>,
#> #   flag_x_country_flag <chr>, position_id <chr>, position_name <chr>, …
  try(espn_cfb_player_stats(athlete_id = 4360799, year = 2022))
#> ── CFB Player Season stats from ESPN.com ───────────────────── cfbfastR 1.9.5 ──
#>  Data updated: 2024-02-01 16:01:33 UTC
#> # A tibble: 1 × 337
#>   athlete_id athlete_uid    athlete_guid athlete_type sdr   first_name last_name
#>   <chr>      <chr>          <chr>        <chr>        <chr> <chr>      <chr>    
#> 1 4360799    s:20~l:23~a:4… 3deb6032-be… football     4360… Jordan     Travis   
#> # ℹ 330 more variables: full_name <chr>, display_name <chr>, short_name <chr>,
#> #   weight <dbl>, display_weight <chr>, height <dbl>, display_height <chr>,
#> #   birth_place_city <chr>, birth_place_state <chr>, birth_place_country <chr>,
#> #   birth_country_alternate_id <chr>, birth_country_abbreviation <chr>,
#> #   slug <chr>, headshot_href <chr>, headshot_alt <chr>, jersey <chr>,
#> #   flag_href <chr>, flag_alt <chr>, flag_x_country_flag <chr>,
#> #   position_id <chr>, position_name <chr>, position_display_name <chr>, …
# }