Skip to contents

Get historical Coaches and AP poll data

Usage

cfbd_rankings(year, week = NULL, 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)

season_type

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

Value

cfbd_rankings() - A data frame with 9 variables:

col_nametypes
seasoninteger
season_typecharacter
weekinteger
pollcharacter
rankinteger
schoolcharacter
conferencecharacter
first_place_votesinteger
pointsinteger

See also

Examples

# \donttest{
  try(cfbd_rankings(year = 2019, week = 12))
#> ── Rankings data from CollegeFootballData.com ──────────────── cfbfastR 2.0.0 ──
#>  Data updated: 2025-08-30 00:55:54 UTC
#> # A tibble: 100 × 9
#>    season season_type  week poll       rank school  conference first_place_votes
#>     <int> <chr>       <int> <chr>     <int> <chr>   <chr>                  <int>
#>  1   2019 regular        12 AP Top 25     1 LSU     SEC                       54
#>  2   2019 regular        12 AP Top 25     2 Ohio S… Big Ten                    5
#>  3   2019 regular        12 AP Top 25     3 Clemson ACC                        3
#>  4   2019 regular        12 AP Top 25     4 Alabama SEC                        0
#>  5   2019 regular        12 AP Top 25     5 Georgia SEC                        0
#>  6   2019 regular        12 AP Top 25     6 Oregon  Pac-12                     0
#>  7   2019 regular        12 AP Top 25     7 Minnes… Big Ten                    0
#>  8   2019 regular        12 AP Top 25     8 Utah    Pac-12                     0
#>  9   2019 regular        12 AP Top 25     9 Penn S… Big Ten                    0
#> 10   2019 regular        12 AP Top 25    10 Oklaho… Big 12                     0
#> # ℹ 90 more rows
#> # ℹ 1 more variable: points <int>

  try(cfbd_rankings(year = 2018, week = 14))
#> ── Rankings data from CollegeFootballData.com ──────────────── cfbfastR 2.0.0 ──
#>  Data updated: 2025-08-30 00:55:55 UTC
#> # A tibble: 75 × 9
#>    season season_type  week poll       rank school  conference first_place_votes
#>     <int> <chr>       <int> <chr>     <int> <chr>   <chr>                  <int>
#>  1   2018 regular        14 AP Top 25     1 Alabama SEC                       61
#>  2   2018 regular        14 AP Top 25     2 Clemson ACC                        0
#>  3   2018 regular        14 AP Top 25     3 Notre … FBS Indep…                 0
#>  4   2018 regular        14 AP Top 25     4 Georgia SEC                        0
#>  5   2018 regular        14 AP Top 25     5 Oklaho… Big 12                     0
#>  6   2018 regular        14 AP Top 25     6 Ohio S… Big Ten                    0
#>  7   2018 regular        14 AP Top 25     7 UCF     American …                 0
#>  8   2018 regular        14 AP Top 25     8 Michig… Big Ten                    0
#>  9   2018 regular        14 AP Top 25     9 Texas   Big 12                     0
#> 10   2018 regular        14 AP Top 25    10 Washin… Pac-12                     0
#> # ℹ 65 more rows
#> # ℹ 1 more variable: points <int>

  try(cfbd_rankings(year = 2013, season_type = "postseason"))
#> ── Rankings data from CollegeFootballData.com ──────────────── cfbfastR 2.0.0 ──
#>  Data updated: 2025-08-30 00:55:55 UTC
#> # A tibble: 75 × 9
#>    season season_type  week poll        rank school conference first_place_votes
#>     <int> <chr>       <int> <chr>      <int> <chr>  <chr>                  <int>
#>  1   2013 postseason      1 AFCA Divi…     1 North… NA                        32
#>  2   2013 postseason      1 AFCA Divi…     2 Lenoi… NA                         0
#>  3   2013 postseason      1 AFCA Divi…     3 Grand… NA                         0
#>  4   2013 postseason      1 AFCA Divi…     4 West … NA                         0
#>  5   2013 postseason      1 AFCA Divi…     5 St. C… NA                         0
#>  6   2013 postseason      1 AFCA Divi…     6 Minne… NA                         0
#>  7   2013 postseason      1 AFCA Divi…     7 CSU P… NA                         0
#>  8   2013 postseason      1 AFCA Divi…     8 Minne… NA                         0
#>  9   2013 postseason      1 AFCA Divi…     9 Sheph… NA                         0
#> 10   2013 postseason      1 AFCA Divi…    10 North… NA                         0
#> # ℹ 65 more rows
#> # ℹ 1 more variable: points <int>
# }