Skip to contents

Get historical Coaches and AP poll data

Usage

cfbd_rankings(year, week = NULL, season_type = "regular")

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 regular): Season type - regular or postseason

Value

cfbd_rankings() - A data frame with 9 variables:

season: integer.

Rankings season.

season_type: character.

Season type of rankings.

week: integer.

Week of rankings.

poll: character.

Name of the poll.

rank: integer.

Rank in the poll.

school: character.

Team name.

conference: character.

Conference of the team.

first_place_votes: integer.

Number of first place votes.

points: integer.

Total poll points.

Examples

# \donttest{
  try(cfbd_rankings(year = 2019, week = 12))
#> ── Rankings data from CollegeFootballData.com ──────────────── cfbfastR 1.9.5 ──
#>  Data updated: 2024-02-01 16:00:59 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 1.9.5 ──
#>  Data updated: 2024-02-01 16:00:59 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 1.9.5 ──
#>  Data updated: 2024-02-01 16:00:59 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 Color… 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>
# }