cfbd_rankings: *Get historical Coaches and AP poll data*

In cfbfastR: Access College Football Play by Play Data

Get historical Coaches and AP poll data

Description

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_name	types	description
season	integer	Four-digit year of the season (e.g. 2019).
season_type	character	CFBD season type: "regular", "postseason", "both", or "allstar".
week	integer	Week number within the season (1-15 regular, 1 for postseason).
poll	character	Poll name (e.g. "AP Top 25", "Coaches Poll", "Playoff Committee Rankings").
rank	integer	Position of the school within the poll for the given week (1 = top-ranked).
school	character	Full school/team name as reported by the poll (e.g. "Georgia").
conference	character	Conference affiliation of the ranked school (e.g. "SEC", "ACC").
first_place_votes	integer	Number of first-place votes the school received in this poll week.
points	integer	Total 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

  try(cfbd_rankings(year = 2019, week = 12))

  try(cfbd_rankings(year = 2018, week = 14))

  try(cfbd_rankings(year = 2013, season_type = "postseason"))

cfbfastR documentation built on Aug. 24, 2026, 5:13 p.m.