Skip to contents

Get historical Coaches and AP poll data

Source: R/cfbd_ratings.R
cfbd_rankings.Rd

Get historical Coaches and AP poll data

Usage

cfbd_rankings(
  year,
  week = NULL,
  season_type = "both",
  poll = NULL,
  latest = NULL,
  final = NULL
)

Arguments

year

(Integer required): Year, 4 digit format (YYYY)
Minimum value accepted: 1936

week

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

season_type

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

poll

(String optional): Poll filter. CFBD accepts only "cfp" here – any other value returns HTTP 400, so it is validated rather than passed through. Omit it to get every poll (AP, Coaches, CFP) and filter the result frame.

latest

(Logical optional): Return the latest College Football Playoff snapshot, preferring the one marked final. Requires poll = "cfp" and cannot be combined with final.

final

(Logical optional): Return the College Football Playoff snapshot marked final. Requires poll = "cfp" and cannot be combined with latest.

Value

cfbd_rankings() - A data frame with 9 variables:

col_nametypesdescription
seasonintegerFour-digit year of the season (e.g. 2019).
season_typecharacterCFBD season type: "regular", "postseason", "both", or "allstar".
weekintegerWeek number within the season (1-15 regular, 1 for postseason).
pollcharacterPoll name (e.g. "AP Top 25", "Coaches Poll", "Playoff Committee Rankings").
rankintegerPosition of the school within the poll for the given week (1 = top-ranked).
schoolcharacterFull school/team name as reported by the poll (e.g. "Georgia").
conferencecharacterConference affiliation of the ranked school (e.g. "SEC", "ACC").
first_place_votesintegerNumber of first-place votes the school received in this poll week.
pointsintegerTotal points accumulated by the school in the poll's weighted voting.

See also

Other CFBD Ratings and Rankings: cfbd_ratings_elo(), cfbd_ratings_fpi(), cfbd_ratings_sp(), cfbd_ratings_sp_conference(), cfbd_ratings_srs()

Examples

# \donttest{
  try(cfbd_rankings(year = 2019, week = 12))
#> ── Rankings data from CollegeFootballData.com ──────────────── cfbfastR 2.3.0 ──
#> ℹ Data updated: 2026-08-19 17:55:36 UTC
#> # A tibble: 100 × 11
#>    season season_type  week poll      isFinal  rank teamId school     conference
#>     <int> <chr>       <int> <chr>     <lgl>   <int>  <int> <chr>      <chr>     
#>  1   2019 regular        12 AP Top 25 NA          1     99 LSU        SEC       
#>  2   2019 regular        12 AP Top 25 NA          2    194 Ohio State Big Ten   
#>  3   2019 regular        12 AP Top 25 NA          3    228 Clemson    ACC       
#>  4   2019 regular        12 AP Top 25 NA          4    333 Alabama    SEC       
#>  5   2019 regular        12 AP Top 25 NA          5     61 Georgia    SEC       
#>  6   2019 regular        12 AP Top 25 NA          6   2483 Oregon     Pac-12    
#>  7   2019 regular        12 AP Top 25 NA          7    135 Minnesota  Big Ten   
#>  8   2019 regular        12 AP Top 25 NA          8    254 Utah       Pac-12    
#>  9   2019 regular        12 AP Top 25 NA          9    213 Penn State Big Ten   
#> 10   2019 regular        12 AP Top 25 NA         10    201 Oklahoma   Big 12    
#> # ℹ 90 more rows
#> # ℹ 2 more variables: first_place_votes <int>, points <int>

  try(cfbd_rankings(year = 2018, week = 14))
#> ── Rankings data from CollegeFootballData.com ──────────────── cfbfastR 2.3.0 ──
#> ℹ Data updated: 2026-08-19 17:55:37 UTC
#> # A tibble: 75 × 11
#>    season season_type  week poll      isFinal  rank teamId school     conference
#>     <int> <chr>       <int> <chr>     <lgl>   <int>  <int> <chr>      <chr>     
#>  1   2018 regular        14 AP Top 25 NA          1    333 Alabama    SEC       
#>  2   2018 regular        14 AP Top 25 NA          2    228 Clemson    ACC       
#>  3   2018 regular        14 AP Top 25 NA          3     87 Notre Dame FBS Indep…
#>  4   2018 regular        14 AP Top 25 NA          4     61 Georgia    SEC       
#>  5   2018 regular        14 AP Top 25 NA          5    201 Oklahoma   Big 12    
#>  6   2018 regular        14 AP Top 25 NA          6    194 Ohio State Big Ten   
#>  7   2018 regular        14 AP Top 25 NA          7   2116 UCF        American …
#>  8   2018 regular        14 AP Top 25 NA          8    130 Michigan   Big Ten   
#>  9   2018 regular        14 AP Top 25 NA          9    251 Texas      Big 12    
#> 10   2018 regular        14 AP Top 25 NA         10    264 Washington Pac-12    
#> # ℹ 65 more rows
#> # ℹ 2 more variables: first_place_votes <int>, points <int>

  try(cfbd_rankings(year = 2013, season_type = "postseason"))
#> ── Rankings data from CollegeFootballData.com ──────────────── cfbfastR 2.3.0 ──
#> ℹ Data updated: 2026-08-19 17:55:37 UTC
#> # A tibble: 75 × 11
#>    season season_type  week poll          isFinal  rank teamId school conference
#>     <int> <chr>       <int> <chr>         <lgl>   <int>  <int> <chr>  <chr>     
#>  1   2013 postseason      1 AFCA Divisio… NA          1    138 North… NA        
#>  2   2013 postseason      1 AFCA Divisio… NA          2   2331 Lenoi… NA        
#>  3   2013 postseason      1 AFCA Divisio… NA          3    125 Grand… NA        
#>  4   2013 postseason      1 AFCA Divisio… NA          4    223 West … NA        
#>  5   2013 postseason      1 AFCA Divisio… NA          5   2594 St. C… NA        
#>  6   2013 postseason      1 AFCA Divisio… NA          6   2364 Minne… NA        
#>  7   2013 postseason      1 AFCA Divisio… NA          7   2570 CSU P… NA        
#>  8   2013 postseason      1 AFCA Divisio… NA          8    134 Minne… NA        
#>  9   2013 postseason      1 AFCA Divisio… NA          9   2974 Sheph… NA        
#> 10   2013 postseason      1 AFCA Divisio… NA         10   2453 North… Gulf South
#> # ℹ 65 more rows
#> # ℹ 2 more variables: first_place_votes <int>, points <int>
# }