Skip to contents

Get game advanced stats

Usage

cfbd_stats_game_advanced(
  year,
  week = NULL,
  team = NULL,
  opponent = NULL,
  excl_garbage_time = FALSE,
  season_type = "both"
)

Arguments

year

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

week

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

team

(String optional): D-I Team

opponent

(String optional): Opponent D-I Team

excl_garbage_time

(Logical default FALSE): Select whether to exclude Garbage Time (TRUE/FALSE)

season_type

(String default both): Season type - regular, postseason, both, allstar, spring_regular, spring_postseason

Value

cfbd_stats_game_advanced() - A data frame with 60 variables:

col_nametypesdescription
game_idintegerReferencing game id.
seasonintegerSeason of the game.
weekintegerGame week of the season.
teamcharacterTeam name.
opponentcharacterOpponent team name.
off_playsintegerOffense plays in the game.
off_drivesintegerOffense drives in the game.
off_ppadoubleOffense predicted points added (PPA).
off_total_ppadoubleOffense total predicted points added (PPA).
off_success_ratedoubleOffense success rate.
off_explosivenessdoubleOffense explosiveness rate.
off_power_successdoubleOffense power success rate.
off_stuff_ratedoubleOpponent stuff rate.
off_line_ydsdoubleOffensive line yards.
off_line_yds_totalintegerOffensive line yards total.
off_second_lvl_ydsdoubleOffense second-level yards.
off_second_lvl_yds_totalintegerOffense second-level yards total.
off_open_field_ydsintegerOffense open field yards.
off_open_field_yds_totalintegerOffense open field yards total.
off_standard_downs_ppadoubleOffense standard downs predicted points added (PPA).
off_standard_downs_success_ratedoubleOffense standard downs success rate.
off_standard_downs_explosivenessdoubleOffense standard downs explosiveness rate.
off_passing_downs_ppadoubleOffense passing downs predicted points added (PPA).
off_passing_downs_success_ratedoubleOffense passing downs success rate.
off_passing_downs_explosivenessdoubleOffense passing downs explosiveness rate.
off_rushing_plays_ppadoubleOffense rushing plays predicted points added (PPA).
off_rushing_plays_total_ppadoubleOffense rushing plays total predicted points added (PPA).
off_rushing_plays_success_ratedoubleOffense rushing plays success rate.
off_rushing_plays_explosivenessdoubleOffense rushing plays explosiveness rate.
off_passing_plays_ppadoubleOffense passing plays predicted points added (PPA).
off_passing_plays_total_ppadoubleOffense passing plays total predicted points added (PPA).
off_passing_plays_success_ratedoubleOffense passing plays success rate.
off_passing_plays_explosivenessdoubleOffense passing plays explosiveness rate.
def_playsintegerDefense plays in the game.
def_drivesintegerDefense drives in the game.
def_ppadoubleDefense predicted points added (PPA).
def_total_ppadoubleDefense total predicted points added (PPA).
def_success_ratedoubleDefense success rate.
def_explosivenessdoubleDefense explosiveness rate.
def_power_successdoubleDefense power success rate.
def_stuff_ratedoubleOpponent stuff rate.
def_line_ydsdoubleOffensive line yards.
def_line_yds_totalintegerOffensive line yards total.
def_second_lvl_ydsdoubleDefense second-level yards.
def_second_lvl_yds_totalintegerDefense second-level yards total.
def_open_field_ydsintegerDefense open field yards.
def_open_field_yds_totalintegerDefense open field yards total.
def_standard_downs_ppadoubleDefense standard downs predicted points added (PPA).
def_standard_downs_success_ratedoubleDefense standard downs success rate.
def_standard_downs_explosivenessdoubleDefense standard downs explosiveness rate.
def_passing_downs_ppadoubleDefense passing downs predicted points added (PPA).
def_passing_downs_success_ratedoubleDefense passing downs success rate.
def_passing_downs_explosivenessdoubleDefense passing downs explosiveness rate.
def_rushing_plays_ppadoubleDefense rushing plays predicted points added (PPA).
def_rushing_plays_total_ppadoubleDefense rushing plays total predicted points added (PPA).
def_rushing_plays_success_ratedoubleDefense rushing plays success rate.
def_rushing_plays_explosivenessdoubleDefense rushing plays explosiveness rate.
def_passing_plays_ppadoubleDefense passing plays predicted points added (PPA).
def_passing_plays_total_ppadoubleDefense passing plays total predicted points added (PPA).
def_passing_plays_success_ratedoubleDefense passing plays success rate.
def_passing_plays_explosivenessdoubleDefense passing plays explosiveness rate.

Examples

# \donttest{
   try(cfbd_stats_game_advanced(year = 2018, week = 12, team = "Texas A&M"))
#> ── Advanced game stats from CollegeFootballData.com ────────── cfbfastR 2.3.0 ──
#>  Data updated: 2026-06-13 04:20:03 UTC
#> # A tibble: 1 × 62
#>     game_id season season_type  week team  opponent off_plays off_drives off_ppa
#>       <int>  <int> <chr>       <int> <chr> <chr>        <int>      <int>   <dbl>
#> 1 401012347   2018 regular        12 Texa… UAB             56         11   0.408
#> # ℹ 53 more variables: off_total_ppa <dbl>, off_success_rate <dbl>,
#> #   off_explosiveness <dbl>, off_power_success <dbl>, off_stuff_rate <dbl>,
#> #   off_line_yds <dbl>, off_line_yds_total <int>, off_second_lvl_yds <dbl>,
#> #   off_second_lvl_yds_total <int>, off_open_field_yds <dbl>,
#> #   off_open_field_yds_total <int>, off_standard_downs_ppa <dbl>,
#> #   off_standard_downs_success_rate <dbl>,
#> #   off_standard_downs_explosiveness <dbl>, off_passing_downs_ppa <dbl>, …

   try(cfbd_stats_game_advanced(2019, team = "LSU"))
#> ── Advanced game stats from CollegeFootballData.com ────────── cfbfastR 2.3.0 ──
#>  Data updated: 2026-06-13 04:20:03 UTC
#> # A tibble: 15 × 62
#>     game_id season season_type  week team  opponent off_plays off_drives off_ppa
#>       <int>  <int> <chr>       <int> <chr> <chr>        <int>      <int>   <dbl>
#>  1   4.01e8   2019 regular         1 LSU   Georgia…        73         13   0.377
#>  2   4.01e8   2019 regular         2 LSU   Texas           70         12   0.484
#>  3   4.01e8   2019 regular         3 LSU   Northwe…        69         12   0.598
#>  4   4.01e8   2019 regular         4 LSU   Vanderb…        74         17   0.286
#>  5   4.01e8   2019 regular         6 LSU   Utah St…        90         13   0.331
#>  6   4.01e8   2019 regular         7 LSU   Florida         48         11   0.736
#>  7   4.01e8   2019 regular         8 LSU   Mississ…        63         13   0.215
#>  8   4.01e8   2019 regular         9 LSU   Auburn          88         15   0.119
#>  9   4.01e8   2019 regular        11 LSU   Alabama         82         14   0.285
#> 10   4.01e8   2019 regular        12 LSU   Ole Miss        83         14   0.493
#> 11   4.01e8   2019 regular        13 LSU   Arkansas        48         12   0.796
#> 12   4.01e8   2019 regular        14 LSU   Texas A…        77         13   0.422
#> 13   4.01e8   2019 regular        15 LSU   Georgia         77         11   0.323
#> 14   4.01e8   2019 postseason      1 LSU   Oklahoma        73         12   0.632
#> 15   4.01e8   2019 postseason      1 LSU   Clemson         80         15   0.423
#> # ℹ 53 more variables: off_total_ppa <dbl>, off_success_rate <dbl>,
#> #   off_explosiveness <dbl>, off_power_success <dbl>, off_stuff_rate <dbl>,
#> #   off_line_yds <dbl>, off_line_yds_total <int>, off_second_lvl_yds <dbl>,
#> #   off_second_lvl_yds_total <int>, off_open_field_yds <dbl>,
#> #   off_open_field_yds_total <int>, off_standard_downs_ppa <dbl>,
#> #   off_standard_downs_success_rate <dbl>,
#> #   off_standard_downs_explosiveness <dbl>, off_passing_downs_ppa <dbl>, …

   try(cfbd_stats_game_advanced(2013, team = "Florida State"))
#> ── Advanced game stats from CollegeFootballData.com ────────── cfbfastR 2.3.0 ──
#>  Data updated: 2026-06-13 04:20:04 UTC
#> # A tibble: 14 × 62
#>    game_id season season_type  week team  opponent off_plays off_drives  off_ppa
#>      <int>  <int> <chr>       <int> <chr> <chr>        <int>      <int>    <dbl>
#>  1  3.32e8   2013 regular         1 Flor… Pittsbu…        58         10  4.46e-1
#>  2  3.33e8   2013 regular         3 Flor… Nevada          56         12  4.37e-1
#>  3  3.33e8   2013 regular         4 Flor… Bethune…        55         11  3.34e-1
#>  4  3.33e8   2013 regular         5 Flor… Boston …        56         12  2.23e-1
#>  5  3.33e8   2013 regular         6 Flor… Maryland        72         12  2.76e-1
#>  6  3.33e8   2013 regular         8 Flor… Clemson         68         12  2.40e-1
#>  7  3.33e8   2013 regular         9 Flor… NC State        58         14  3.53e-1
#>  8  3.33e8   2013 regular        10 Flor… Miami           69         11  3.07e-1
#>  9  3.33e8   2013 regular        11 Flor… Wake Fo…        64         14 -4.27e-4
#> 10  3.33e8   2013 regular        12 Flor… Syracuse        36         10  4.50e-1
#> 11  3.33e8   2013 regular        13 Flor… Idaho           68         14  2.12e-1
#> 12  3.33e8   2013 regular        14 Flor… Florida         60         11  2.12e-1
#> 13  3.33e8   2013 regular        15 Flor… Duke            69         15  2.31e-1
#> 14  3.40e8   2013 postseason      1 Flor… Auburn          61         12  2.20e-1
#> # ℹ 53 more variables: off_total_ppa <dbl>, off_success_rate <dbl>,
#> #   off_explosiveness <dbl>, off_power_success <dbl>, off_stuff_rate <dbl>,
#> #   off_line_yds <dbl>, off_line_yds_total <int>, off_second_lvl_yds <dbl>,
#> #   off_second_lvl_yds_total <int>, off_open_field_yds <dbl>,
#> #   off_open_field_yds_total <int>, off_standard_downs_ppa <dbl>,
#> #   off_standard_downs_success_rate <dbl>,
#> #   off_standard_downs_explosiveness <dbl>, off_passing_downs_ppa <dbl>, …
# }