Get player statistics by game

Get player statistics by game

Usage

cfbd_game_player_stats(
  year = NULL,
  week = NULL,
  season_type = "regular",
  team = NULL,
  conference = NULL,
  category = NULL,
  game_id = NULL,
  division = NULL
)

Arguments

year

(Integer required unless game_id is supplied): Year, 4 digit format(YYYY)
Minimum value accepted: 2004

week

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

season_type

(String default regular): Select 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

category

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

game_id

(Integer optional): Game ID filter for querying a single game. When supplied it is sent alone as id; year, week, season_type, team and conference are omitted (CFBD rejects them alongside id). Can be found using the cfbd_game_info() function

division

(String optional): Division/classification filter – one of fbs, fcs, ii, ii/iii, iii. Sent to CFBD as classification.

Value

cfbd_game_player_stats() - A data frame with 32 variables:

col_name	type	description
game_id	integer	CFBD-internal game id; join key to other CFBD endpoints.
team	character	Full team name (e.g. "Alabama") for the player's team.
conference	character	Conference name of the player's team (e.g. "SEC").
home_away	character	Whether the player's team played at home or away ("home"/"away").
team_points	integer	Total points scored by the player's team in this game.
athlete_id	integer	CFBD-internal athlete id for the player.
athlete_name	character	Player's display name as reported by CFBD.
defensive_td	double	Defensive touchdowns scored by the player.
defensive_qb_hur	double	Quarterback hurries credited to the player.
defensive_pd	double	Passes defended (pass breakups) by the player.
defensive_tfl	double	Tackles for loss credited to the player.
defensive_sacks	double	Sacks credited to the player.
defensive_solo	double	Solo (unassisted) tackles by the player.
defensive_tot	double	Total tackles (solo plus assisted) by the player.
fumbles_rec	double	Fumbles recovered by the player.
fumbles_lost	double	Fumbles by the player that were lost to the opposing team.
fumbles_fum	double	Fumbles committed by the player.
punting_long	double	Longest punt by the player, in yards.
punting_in_20	double	Punts downed inside the opponent 20-yard line.
punting_tb	double	Punts resulting in a touchback.
punting_avg	double	Average yards per punt.
punting_yds	double	Total punting yards (gross).
punting_no	double	Number of punts attempted.
kicking_pts	double	Total points scored by the kicker (FGs + XPs).
kicking_long	double	Longest made field goal, in yards.
kicking_pct	double	Field-goal percentage (made / attempted), 0-100.
punt_returns_td	double	Touchdowns scored on punt returns.
punt_returns_long	double	Longest punt return, in yards.
punt_returns_avg	double	Average yards per punt return.
punt_returns_yds	double	Total punt-return yards.
punt_returns_no	double	Number of punt returns.
kick_returns_td	double	Touchdowns scored on kickoff returns.
kick_returns_long	double	Longest kickoff return, in yards.
kick_returns_avg	double	Average yards per kickoff return.
kick_returns_yds	double	Total kickoff-return yards.
kick_returns_no	double	Number of kickoff returns.
interceptions_td	double	Touchdowns scored on interception returns (pick-sixes).
interceptions_yds	double	Interception-return yards.
interceptions_int	double	Number of interceptions made by the player.
receiving_long	double	Longest reception by the player, in yards.
receiving_td	double	Receiving touchdowns.
receiving_avg	double	Average yards per reception.
receiving_yds	double	Total receiving yards.
receiving_rec	double	Number of receptions (catches).
rushing_long	double	Longest rush by the player, in yards.
rushing_td	double	Rushing touchdowns.
rushing_avg	double	Average yards per rushing attempt.
rushing_yds	double	Total rushing yards.
rushing_car	double	Rushing carries (attempts).
passing_int	double	Interceptions thrown by the passer.
passing_td	double	Passing touchdowns thrown.
passing_avg	double	Yards per pass attempt.
passing_yds	double	Total passing yards.
passing_completions	double	Pass completions (split from CFBD's C/ATT field).
passing_attempts	double	Pass attempts (split from CFBD's C/ATT field).
passing_qbr	double	ESPN Quarterback Rating (QBR) for the player in this game.
kicking_xpm	double	Extra points made (split from CFBD's XP field).
kicking_xpa	double	Extra points attempted (split from CFBD's XP field).
kicking_fgm	double	Field goals made (split from CFBD's FG field).
kicking_fga	double	Field goals attempted (split from CFBD's FG field).

See also

Other CFBD Games: cfbd_calendar(), cfbd_game_box_advanced(), cfbd_game_info(), cfbd_game_media(), cfbd_game_preview(), cfbd_game_preview_adjusted(), cfbd_game_records(), cfbd_game_schedule(), cfbd_game_team_stats(), cfbd_game_weather(), cfbd_live_scoreboard()

Examples

# \donttest{
  try(cfbd_game_player_stats(year = 2020, week = 15, team = "Alabama"))
#> ── Game player stats data from CollegeFootballData.com ── cfbfastR 3.0.0.9000 ──
#> ℹ Data updated: 2026-10-11 01:03:26 UTC
#> # A tibble: 48 × 60
#>      game_id team     conference home_away team_points athlete_id athlete_name  
#>        <int> <chr>    <chr>      <chr>           <int>      <int> <chr>         
#>  1 401267164 Arkansas SEC        home                3    4034948 Feleipe Franks
#>  2 401267164 Arkansas SEC        home                3    4567149 KJ Jefferson  
#>  3 401267164 Arkansas SEC        home                3    4567156 Treylon Burks 
#>  4 401267164 Arkansas SEC        home                3    4242881 Trelon Smith  
#>  5 401267164 Arkansas SEC        home                3    4035576 T.J. Hammonds 
#>  6 401267164 Arkansas SEC        home                3    4360174 Michael Woods 
#>  7 401267164 Arkansas SEC        home                3    4079623 Blake Kern    
#>  8 401267164 Arkansas SEC        home                3    4567151 Trey Knox     
#>  9 401267164 Arkansas SEC        home                3    4372007 Nathan Parodi 
#> 10 401267164 Arkansas SEC        home                3    4391568 M Phillips    
#> # ℹ 38 more rows
#> # ℹ 53 more variables: defensive_td <dbl>, defensive_qb_hur <dbl>,
#> #   defensive_pd <dbl>, defensive_tfl <dbl>, defensive_sacks <dbl>,
#> #   defensive_solo <dbl>, defensive_tot <dbl>, fumbles_rec <dbl>,
#> #   fumbles_lost <dbl>, fumbles_fum <dbl>, punting_long <dbl>,
#> #   punting_in_20 <dbl>, punting_tb <dbl>, punting_avg <dbl>,
#> #   punting_yds <dbl>, punting_no <dbl>, kicking_pts <dbl>, …

  try(cfbd_game_player_stats(2013, week = 1, team = "Florida State", category = "passing"))
#> ── Game player stats data from CollegeFootballData.com ── cfbfastR 3.0.0.9000 ──
#> ℹ Data updated: 2026-10-11 01:03:27 UTC
#> # A tibble: 3 × 60
#>     game_id team        conference home_away team_points athlete_id athlete_name
#>       <int> <chr>       <chr>      <chr>           <int>      <int> <chr>       
#> 1 332450221 Pittsburgh  ACC        home               13     514116 Tom Savage  
#> 2 332450221 Florida St… ACC        away               41     530308 Jameis Wins…
#> 3 332450221 Florida St… ACC        away               41     514124 Jake Coker  
#> # ℹ 53 more variables: defensive_td <dbl>, defensive_qb_hur <dbl>,
#> #   defensive_pd <dbl>, defensive_tfl <dbl>, defensive_sacks <dbl>,
#> #   defensive_solo <dbl>, defensive_tot <dbl>, fumbles_rec <dbl>,
#> #   fumbles_lost <dbl>, fumbles_fum <dbl>, punting_long <dbl>,
#> #   punting_in_20 <dbl>, punting_tb <dbl>, punting_avg <dbl>,
#> #   punting_yds <dbl>, punting_no <dbl>, kicking_pts <dbl>, kicking_long <dbl>,
#> #   kicking_pct <dbl>, punt_returns_td <dbl>, punt_returns_long <dbl>, …
# }