Skip to contents

Get poll rankings (AP / Coaches) from the CollegeBasketballData API.

Usage

cbbd_rankings(
  season = most_recent_mbb_season(),
  season_type = NULL,
  week = NULL,
  poll_type = NULL,
  team = NULL,
  conference = NULL
)

Arguments

season

(integer optional): Season, 4-digit ending-year (e.g. 2024). Defaults to most_recent_mbb_season().

season_type

(character optional): One of regular, postseason, preseason.

week

(integer optional): Poll week filter.

poll_type

(character optional): One of ap, coaches.

team

(character optional): Team name filter.

conference

(character optional): Conference abbreviation filter.

Value

A hoopR_data tibble with one row per ranked team per poll:

col_nametypesdescription
seasonintegerSeason (4-digit ending-year).
season_typecharacterSeason type.
weekintegerPoll week.
poll_datecharacterDate the poll was released.
poll_typecharacterPoll type (ap or coaches).
team_idintegerCollegeBasketballData team id.
teamcharacterTeam name.
conferencecharacterConference name.
rankingintegerPoll rank.
pointsnumericPoll points received.
first_place_votesnumericNumber of first-place votes.

Examples

# \donttest{
  try(cbbd_rankings(season = 2024, poll_type = "ap"))
#>  2026-06-09 22:48:23.611763: Invalid arguments or no rankings data available!
#>  Args: season = 2024, season_type = NULL, week = NULL, poll_type = "ap", team = NULL, conference = NULL
#>  Error: api.collegebasketballdata.com requires an API key.        See ?register_cbbd for details.
#> data frame with 0 columns and 0 rows
# }