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.3 ──
#>  Data updated: 2022-09-23 03:23:31 UTC
#> # A tibble: 100 × 9
#>    season season_type  week poll       rank school     conference first…¹ points
#>     <int> <chr>       <int> <chr>     <int> <chr>      <chr>        <int>  <int>
#>  1   2019 regular        12 AP Top 25     1 LSU        SEC             54   1542
#>  2   2019 regular        12 AP Top 25     2 Ohio State Big Ten          5   1480
#>  3   2019 regular        12 AP Top 25     3 Clemson    ACC              3   1441
#>  4   2019 regular        12 AP Top 25     4 Alabama    SEC              0   1312
#>  5   2019 regular        12 AP Top 25     5 Georgia    SEC              0   1267
#>  6   2019 regular        12 AP Top 25     6 Oregon     Pac-12           0   1224
#>  7   2019 regular        12 AP Top 25     7 Minnesota  Big Ten          0   1164
#>  8   2019 regular        12 AP Top 25     8 Utah       Pac-12           0   1099
#>  9   2019 regular        12 AP Top 25     9 Penn State Big Ten          0   1003
#> 10   2019 regular        12 AP Top 25    10 Oklahoma   Big 12           0   1000
#> # … with 90 more rows, and abbreviated variable name ¹​first_place_votes

  try(cfbd_rankings(year = 2018, week = 14))
#> ── Rankings data from CollegeFootballData.com ──────────────── cfbfastR 1.9.3 ──
#>  Data updated: 2022-09-23 03:23:31 UTC
#> # A tibble: 75 × 9
#>    season season_type  week poll       rank school     conference first…¹ points
#>     <int> <chr>       <int> <chr>     <int> <chr>      <chr>        <int>  <int>
#>  1   2018 regular        14 AP Top 25     1 Alabama    SEC             61   1525
#>  2   2018 regular        14 AP Top 25     2 Clemson    ACC              0   1458
#>  3   2018 regular        14 AP Top 25     3 Notre Dame FBS Indep…       0   1409
#>  4   2018 regular        14 AP Top 25     4 Georgia    SEC              0   1336
#>  5   2018 regular        14 AP Top 25     5 Oklahoma   Big 12           0   1266
#>  6   2018 regular        14 AP Top 25     6 Ohio State Big Ten          0   1229
#>  7   2018 regular        14 AP Top 25     7 UCF        American …       0   1146
#>  8   2018 regular        14 AP Top 25     8 Michigan   Big Ten          0   1058
#>  9   2018 regular        14 AP Top 25     9 Texas      Big 12           0    959
#> 10   2018 regular        14 AP Top 25    10 Washington Pac-12           0    897
#> # … with 65 more rows, and abbreviated variable name ¹​first_place_votes

  try(cfbd_rankings(year = 2013, season_type = "postseason"))
#> ── Rankings data from CollegeFootballData.com ──────────────── cfbfastR 1.9.3 ──
#>  Data updated: 2022-09-23 03:23:31 UTC
#> # A tibble: 75 × 9
#>    season season_type  week poll              rank school confe…¹ first…² points
#>     <int> <chr>       <int> <chr>            <int> <chr>  <chr>     <int>  <int>
#>  1   2013 postseason      1 AFCA Division I…     1 North… NA           32      0
#>  2   2013 postseason      1 AFCA Division I…     2 Lenoi… NA            0      0
#>  3   2013 postseason      1 AFCA Division I…     3 Grand… NA            0      0
#>  4   2013 postseason      1 AFCA Division I…     4 West … NA            0      0
#>  5   2013 postseason      1 AFCA Division I…     5 St. C… NA            0      0
#>  6   2013 postseason      1 AFCA Division I…     6 Minne… NA            0      0
#>  7   2013 postseason      1 AFCA Division I…     7 Color… NA            0      0
#>  8   2013 postseason      1 AFCA Division I…     8 Minne… NA            0      0
#>  9   2013 postseason      1 AFCA Division I…     9 Sheph… NA            0      0
#> 10   2013 postseason      1 AFCA Division I…    10 North… NA            0      0
#> # … with 65 more rows, and abbreviated variable names ¹​conference,
#> #   ²​first_place_votes
# }