cbbd_games_media: *CBD Games*

View source: R/cbbd_games.R

cbbd_gamesR Documentation

CBD Games

Description

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 (key columns; period-point arrays are returned as list-columns):

col_name types description
id integer CollegeBasketballData game id.
source_id character Source (ESPN) game id.
season integer Season (4-digit ending-year).
season_type character Season type.
start_date character Game start date (ISO 8601).
neutral_site logical Whether the game was at a neutral site.
conference_game logical Whether the game was a conference game.
status character Game status.
home_team_id integer Home team id.
home_team character Home team name.
home_points integer Home team points.
home_winner logical Whether the home team won.
away_team_id integer Away team id.
away_team character Away team name.
away_points integer Away team points.
away_winner logical Whether the away team won.
venue_id integer Venue id.
venue character Venue name.

A hoopR_data tibble with one row per game. The broadcasts column is a nested list of broadcast outlets:

col_name types description
game_id integer CollegeBasketballData game id.
season integer Season (4-digit ending-year).
season_type character Season type.
start_date character Game start date (ISO 8601).
home_team_id integer Home team id.
home_team character Home team name.
away_team_id integer Away team id.
away_team character Away team name.
neutral_site logical Whether the game was at a neutral site.
conference_game logical Whether the game was a conference game.
broadcasts list Nested list of broadcast outlets.

A hoopR_data tibble with one row per team-game. Per-team statistic objects (team_stats, opponent_stats) are flattened into ⁠team_stats_*⁠ / ⁠opponent_stats_*⁠ columns. Key identifying columns:

col_name types description
game_id integer CollegeBasketballData game id.
season integer Season (4-digit ending-year).
start_date character Game start date (ISO 8601).
team_id integer Team id.
team character Team name.
conference character Team conference.
opponent_id integer Opponent team id.
opponent character Opponent team name.
is_home logical Whether the team was home.
neutral_site logical Whether the game was at a neutral site.
game_minutes numeric Total team minutes.
pace numeric Game pace (possessions).

A hoopR_data tibble with one row per team-game. The players column is a nested list of per-player box scores. Key identifying columns:

col_name types description
game_id integer CollegeBasketballData game id.
season integer Season (4-digit ending-year).
start_date character Game start date (ISO 8601).
team_id integer Team id.
team character Team name.
conference character Team conference.
opponent_id integer Opponent team id.
opponent character Opponent team name.
is_home logical Whether the team was home.
game_minutes numeric Total team minutes.
game_pace numeric Game pace (possessions).
players list Nested list of per-player box scores.

A hoopR_data tibble with one row per game. The home_team, away_team and betting objects are flattened into ⁠home_team_*⁠, ⁠away_team_*⁠ and ⁠betting_*⁠ columns. Key identifying columns:

col_name types description
id integer CollegeBasketballData game id.
start_date character Game start date (ISO 8601).
tv character Broadcast TV network.
neutral_site logical Whether the game is at a neutral site.
conference_game logical Whether the game is a conference game.
status character Game status.
period integer Current period.
clock character Game clock.
venue character Venue name.

Examples


  try(cbbd_games(season = 2024, team = "Duke"))


  try(cbbd_games_media(season = 2024, team = "Duke"))


  try(cbbd_games_teams(season = 2024, team = "Duke"))


  try(cbbd_games_players(season = 2024, team = "Duke"))


  try(cbbd_scoreboard(conference = "ACC"))


hoopR documentation built on Aug. 25, 2026, 9:07 a.m.