Skip to contents

Get player success rates by game Game-level player success-rate metrics.

Usage

cfbd_stats_player_success_game(
  year,
  week = NULL,
  season_type = "regular",
  conference = NULL,
  team = NULL,
  athlete_id = NULL,
  threshold = NULL,
  excl_garbage_time = NULL,
  proxy = NULL
)

Arguments

year

(Integer required): Season, 4 digits (YYYY).
Minimum value accepted: 2013

week

(Integer optional): Week filter.

season_type

(String optional): Season type – regular, postseason, both, allstar, spring_regular or spring_postseason.

conference

(String optional): Conference abbreviation filter.

team

(String optional): Team filter.

athlete_id

(Integer optional): Player identifier.

threshold

(Numeric optional): Minimum success-rate threshold.

excl_garbage_time

(Logical optional): Exclude garbage-time plays.

proxy

(List optional): Per-call proxy override passed to get_req(). NULL (default) falls back to getOption("cfbfastR.proxy") and then the http(s)_proxy environment variables, so a caller can override the shared setting for one endpoint.

Value

cfbd_stats_player_success_game() - A tibble with 16 columns:

col_nametypesdescription
seasonintegerFour-digit season year.
season_typecharacterSeason type (regular, postseason, both, allstar, spring_regular, spring_postseason).
weekintegerWeek of the season.
game_idintegerReferencing game id.
idcharacterRecord identifier.
namecharacterDisplay name.
positioncharacterPosition.
teamcharacterTeam name.
conferencecharacterConference name.
opponentcharacterOpponent.
passing_playsintegerPassing plays.
passing_successesintegerPassing successes.
passing_success_ratenumericPassing success rate.
rushing_playsintegerRushing plays.
rushing_successesintegerRushing successes.
rushing_success_ratenumericRushing success rate.

See also

Other CFBD Stats Functions: cfbd_stats_player_success()

Examples

# \donttest{
  try(cfbd_stats_player_success_game(year = 2024, week = 5))
#> ── Get player success rates by game from CollegeFootballData.com ───────────────
#>  Data updated: 2026-08-19 17:56:04 UTC
#> # A tibble: 1,052 × 16
#>    season season_type  week   game_id id      name     position team  conference
#>     <int> <chr>       <int>     <int> <chr>   <chr>    <chr>    <chr> <chr>     
#>  1   2024 regular         5 401632103 4686606 Isaiah … RB       Abil… UAC       
#>  2   2024 regular         5 401632103 4701592 Jordon … RB       Abil… UAC       
#>  3   2024 regular         5 401632103 4427966 Maveric… QB       Abil… UAC       
#>  4   2024 regular         5 401632103 5086218 Sam Hic… RB       Abil… UAC       
#>  5   2024 regular         5 401643718 5085138 Aiden C… RB       Air … MWC       
#>  6   2024 regular         5 401643718 5085137 Cade Ha… WR       Air … MWC       
#>  7   2024 regular         5 401643718 5151903 Christo… RB       Air … MWC       
#>  8   2024 regular         5 401643718 5151906 Dylan C… RB       Air … MWC       
#>  9   2024 regular         5 401643718 5151904 John Bu… QB       Air … MWC       
#> 10   2024 regular         5 401643718 5223112 Kemper … QB       Air … MWC       
#> # ℹ 1,042 more rows
#> # ℹ 7 more variables: opponent <chr>, passing_plays <int>,
#> #   passing_successes <int>, passing_success_rate <dbl>, rushing_plays <int>,
#> #   rushing_successes <int>, rushing_success_rate <dbl>
# }