Skip to contents

Get college basketball games from the CollegeBasketballData API.

Get game broadcast media information from the CollegeBasketballData API.

Get team box score statistics from the CollegeBasketballData API.

Get player box score statistics from the CollegeBasketballData API.

Get the current scoreboard from the CollegeBasketballData API.

Usage

cbbd_games(
  season = most_recent_mbb_season(),
  season_type = NULL,
  team = NULL,
  conference = NULL,
  start_date_range = NULL,
  end_date_range = NULL,
  status = NULL,
  tournament = NULL
)

cbbd_games_media(
  season = most_recent_mbb_season(),
  season_type = NULL,
  team = NULL,
  conference = NULL,
  start_date_range = NULL,
  end_date_range = NULL,
  tournament = NULL
)

cbbd_games_teams(
  season = most_recent_mbb_season(),
  season_type = NULL,
  team = NULL,
  conference = NULL,
  start_date_range = NULL,
  end_date_range = NULL,
  tournament = NULL
)

cbbd_games_players(
  season = most_recent_mbb_season(),
  season_type = NULL,
  team = NULL,
  conference = NULL,
  start_date_range = NULL,
  end_date_range = NULL,
  tournament = NULL
)

cbbd_scoreboard(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.

team

(character optional): Team name filter.

conference

(character optional): Conference abbreviation filter.

start_date_range

(character optional): ISO 8601 start of date range.

end_date_range

(character optional): ISO 8601 end of date range.

status

(character optional): One of scheduled, in_progress, final, postponed, cancelled.

tournament

(character optional): Tournament filter.

Value

A hoopR_data tibble with one row per game. Its columns are listed in return_columns (subset(return_columns, fn == "cbbd_games")) and in the searchable return columns article.

A hoopR_data tibble with one row per game. Its columns are listed in return_columns (subset(return_columns, fn == "cbbd_games_media")) and in the searchable return columns article.

A hoopR_data tibble with one row per team-game. Its columns are listed in return_columns (subset(return_columns, fn == "cbbd_games_teams")) and in the searchable return columns article.

A hoopR_data tibble with one row per team-game. Its columns are listed in return_columns (subset(return_columns, fn == "cbbd_games_players")) and in the searchable return columns article.

A hoopR_data tibble with one row per game. Its columns are listed in return_columns (subset(return_columns, fn == "cbbd_scoreboard")) and in the searchable return columns article.

Examples

# \donttest{
  try(cbbd_games(season = 2024, team = "Duke"))
#> ✖ 2026-11-13 21:11:16.735497: Invalid arguments or no games data available!
#> ✖ Args: season = 2024, season_type = NULL, team = "Duke", conference = NULL, start_date_range = NULL, end_date_range = NULL, status = NULL, tournament = NULL
#> ✖ Error: api.collegebasketballdata.com requires an API key.        See ?register_cbbd for details.
#> data frame with 0 columns and 0 rows
# }
# \donttest{
  try(cbbd_games_media(season = 2024, team = "Duke"))
#> ✖ 2026-11-13 21:11:16.746706: Invalid arguments or no game media available!
#> ✖ Args: season = 2024, season_type = NULL, team = "Duke", conference = NULL, start_date_range = NULL, end_date_range = NULL, tournament = NULL
#> ✖ Error: api.collegebasketballdata.com requires an API key.        See ?register_cbbd for details.
#> data frame with 0 columns and 0 rows
# }
# \donttest{
  try(cbbd_games_teams(season = 2024, team = "Duke"))
#> ✖ 2026-11-13 21:11:16.758147: Invalid arguments or no team box score data available!
#> ✖ Args: season = 2024, season_type = NULL, team = "Duke", conference = NULL, start_date_range = NULL, end_date_range = NULL, tournament = NULL
#> ✖ Error: api.collegebasketballdata.com requires an API key.        See ?register_cbbd for details.
#> data frame with 0 columns and 0 rows
# }
# \donttest{
  try(cbbd_games_players(season = 2024, team = "Duke"))
#> ✖ 2026-11-13 21:11:16.768262: Invalid arguments or no player box score data available!
#> ✖ Args: season = 2024, season_type = NULL, team = "Duke", conference = NULL, start_date_range = NULL, end_date_range = NULL, tournament = NULL
#> ✖ Error: api.collegebasketballdata.com requires an API key.        See ?register_cbbd for details.
#> data frame with 0 columns and 0 rows
# }
# \donttest{
  try(cbbd_scoreboard(conference = "ACC"))
#> ✖ 2026-11-13 21:11:16.778629: Invalid arguments or no scoreboard data available!
#> ✖ Args: conference = "ACC"
#> ✖ Error: api.collegebasketballdata.com requires an API key.        See ?register_cbbd for details.
#> data frame with 0 columns and 0 rows
# }