Skip to contents

Get college basketball teams from the CollegeBasketballData API.

Usage

cbbd_teams(conference = NULL, season = most_recent_mbb_season())

Arguments

conference

(character optional): Conference abbreviation filter (e.g. ACC). See cbbd_conferences() for valid values.

season

(integer optional): Season, in 4-digit format ending-year (e.g. 2024 for the 2023-24 season). Defaults to most_recent_mbb_season().

Value

A hoopR_data tibble with one row per team:

col_nametypesdescription
idintegerCollegeBasketballData team id.
source_idcharacterSource (ESPN) team id.
schoolcharacterSchool name.
mascotcharacterTeam mascot.
abbreviationcharacterTeam abbreviation.
display_namecharacterFull team display name.
short_display_namecharacterShort team display name.
primary_colorcharacterPrimary team color (hex).
secondary_colorcharacterSecondary team color (hex).
current_venue_idintegerCurrent home venue id.
current_venuecharacterCurrent home venue name.
current_citycharacterCurrent home venue city.
current_statecharacterCurrent home venue state.
conference_idintegerConference id.
conferencecharacterConference name.

See also

Other CBD Teams Functions: cbbd_teams_roster()

Examples

# \donttest{
  try(cbbd_teams(conference = "ACC"))
#>  2026-06-09 22:48:27.234835: Invalid arguments or no teams data available!
#>  Args: conference = "ACC", season = 2026
#>  Error: api.collegebasketballdata.com requires an API key.        See ?register_cbbd for details.
#> data frame with 0 columns and 0 rows
# }