Skip to contents

Get team season statistics from the CollegeBasketballData API.

Get the team statistics leaderboard from the CollegeBasketballData API.

Get team season shooting statistics from the CollegeBasketballData API.

Get player season statistics from the CollegeBasketballData API.

Get player season shooting statistics from the CollegeBasketballData API.

Usage

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

cbbd_stats_team_leaderboard(
  season = most_recent_mbb_season(),
  team = NULL,
  conference = NULL
)

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

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

cbbd_stats_player_shooting_season(
  season = most_recent_mbb_season(),
  season_type = NULL,
  team = NULL,
  conference = NULL,
  start_date_range = NULL,
  end_date_range = 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.

Value

A hoopR_data tibble with one row per team-season. The team_stats and opponent_stats objects are flattened into team_stats_* / opponent_stats_* columns. Key identifying columns:

col_nametypesdescription
seasonintegerSeason (4-digit ending-year).
team_idintegerTeam id.
teamcharacterTeam name.
conferencecharacterConference name.
gamesintegerGames played.
winsnumericWins.
lossesnumericLosses.
total_minutesnumericTotal minutes played.
pacenumericAverage pace (possessions).

A hoopR_data tibble with one row per team. Nested statistic objects (record, summary, team_stats, opponent_stats, shot_profile, adjusted_efficiency) are flattened into prefixed columns. Key identifying columns:

col_nametypesdescription
seasonintegerSeason (4-digit ending-year).
team_idintegerTeam id.
teamcharacterTeam name.

A hoopR_data tibble with one row per team-season. Shot-type objects (dunks, layups, tip_ins, two_point_jumpers, three_point_jumpers, free_throws, attempts_breakdown) are flattened into prefixed columns. Key identifying columns:

col_nametypesdescription
seasonintegerSeason (4-digit ending-year).
team_idintegerTeam id.
teamcharacterTeam name.
conferencecharacterConference name.
tracked_shotsintegerNumber of tracked shots.
assisted_pctnumericAssisted field-goal percentage.

A hoopR_data tibble with one row per player-season. Nested statistic objects (field_goals, two_point_field_goals, three_point_field_goals, free_throws, rebounds, win_shares) are flattened into prefixed columns. Key identifying columns:

col_nametypesdescription
seasonintegerSeason (4-digit ending-year).
team_idintegerTeam id.
teamcharacterTeam name.
conferencecharacterConference name.
athlete_idintegerAthlete id.
namecharacterPlayer name.
positioncharacterPlayer position.
gamesnumericGames played.
minutesnumericMinutes played.
pointsnumericTotal points.

A hoopR_data tibble with one row per player-season. Shot-type objects are flattened into prefixed columns. Key identifying columns:

col_nametypesdescription
seasonintegerSeason (4-digit ending-year).
team_idintegerTeam id.
teamcharacterTeam name.
conferencecharacterConference name.
athlete_idintegerAthlete id.
athlete_namecharacterPlayer name.
tracked_shotsintegerNumber of tracked shots.
assisted_pctnumericAssisted field-goal percentage.

Examples

# \donttest{
  try(cbbd_stats_team_season(season = 2024, team = "Duke"))
#>  2026-08-27 17:46:34.820535: Invalid arguments or no team season stats available!
#>  Args: season = 2024, season_type = NULL, team = "Duke", conference = NULL, start_date_range = NULL, end_date_range = 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_stats_team_leaderboard(season = 2024))
#>  2026-08-27 17:46:34.830838: Invalid arguments or no team stats leaderboard available!
#>  Args: season = 2024, 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
# }
# \donttest{
  try(cbbd_stats_team_shooting_season(season = 2024, team = "Duke"))
#>  2026-08-27 17:46:34.84068: Invalid arguments or no team shooting stats available!
#>  Args: season = 2024, season_type = NULL, team = "Duke", conference = NULL, start_date_range = NULL, end_date_range = 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_stats_player_season(season = 2024, team = "Duke"))
#>  2026-08-27 17:46:34.851019: Invalid arguments or no player season stats available!
#>  Args: season = 2024, season_type = NULL, team = "Duke", conference = NULL, start_date_range = NULL, end_date_range = 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_stats_player_shooting_season(season = 2024, team = "Duke"))
#>  2026-08-27 17:46:34.86129: Invalid arguments or no player shooting stats available!
#>  Args: season = 2024, season_type = NULL, team = "Duke", conference = NULL, start_date_range = NULL, end_date_range = NULL
#>  Error: api.collegebasketballdata.com requires an API key.        See ?register_cbbd for details.
#> data frame with 0 columns and 0 rows
# }