Get play-by-play data for a single game from the CollegeBasketballData API.
Get play-by-play data for a single player from the CollegeBasketballData API.
Get play-by-play data for a team-season from the CollegeBasketballData API.
Get play-by-play data for all games on a date from the CollegeBasketballData API.
Get play-by-play data for a tournament from the CollegeBasketballData API.
Get the list of play types from the CollegeBasketballData API.
Usage
cbbd_plays_game(game_id, shooting_plays_only = FALSE)
cbbd_plays_player(
player_id,
season = most_recent_mbb_season(),
shooting_plays_only = FALSE
)
cbbd_plays_team(
season = most_recent_mbb_season(),
team,
shooting_plays_only = FALSE
)
cbbd_plays_date(date, shooting_plays_only = FALSE, utc_offset = NULL)
cbbd_plays_tournament(
tournament,
season = most_recent_mbb_season(),
shooting_plays_only = FALSE
)
cbbd_play_types()Arguments
- game_id
(integer required): CollegeBasketballData game id. See
cbbd_games().- shooting_plays_only
(logical optional): If
TRUE, return only shooting plays. Defaults toFALSE.- player_id
(integer required): Athlete id.
- season
(integer required): Season, 4-digit ending-year (e.g.
2024). Defaults tomost_recent_mbb_season().- team
(character required): Team name (e.g.
Duke).- date
(character required): Date-time in ISO 8601 format (e.g.
2024-02-01T00:00:00.000Z).- utc_offset
(numeric optional): UTC offset (hours) for the date.
- tournament
(character required): Tournament name (e.g.
NCAA).
Value
A hoopR_data tibble with one row per play.
Its columns are listed in return_columns
(subset(return_columns, fn == "cbbd_plays_game")) and in the searchable
return columns article.
A hoopR_data tibble with one row per play (same columns as
cbbd_plays_game()).
A hoopR_data tibble with one row per play (same columns as
cbbd_plays_game()).
A hoopR_data tibble with one row per play (same columns as
cbbd_plays_game()).
A hoopR_data tibble with one row per play (same columns as
cbbd_plays_game()).
A hoopR_data tibble with one row per play type.
Its columns are listed in return_columns
(subset(return_columns, fn == "cbbd_play_types")) and in the searchable
return columns article.
Examples
# \donttest{
try(cbbd_plays_game(game_id = 5881))
#> ✖ 2026-11-13 21:11:17.424061: Invalid arguments or no play data available for 5881!
#> ✖ Args: game_id = 5881, shooting_plays_only = FALSE
#> ✖ Error: api.collegebasketballdata.com requires an API key. See ?register_cbbd for details.
#> data frame with 0 columns and 0 rows
# }
# \donttest{
try(cbbd_plays_player(player_id = 160, season = 2024))
#> ✖ 2026-11-13 21:11:17.434981: Invalid arguments or no play data available for player 160!
#> ✖ Args: player_id = 160, season = 2024, shooting_plays_only = FALSE
#> ✖ Error: api.collegebasketballdata.com requires an API key. See ?register_cbbd for details.
#> data frame with 0 columns and 0 rows
# }
# \donttest{
try(cbbd_plays_team(season = 2024, team = "Duke"))
#> ✖ 2026-11-13 21:11:17.445178: Invalid arguments or no play data available for Duke!
#> ✖ Args: season = 2024, team = "Duke", shooting_plays_only = FALSE
#> ✖ Error: api.collegebasketballdata.com requires an API key. See ?register_cbbd for details.
#> data frame with 0 columns and 0 rows
# }
# \donttest{
try(cbbd_plays_date(date = "2024-04-09T00:00:00.000Z"))
#> ✖ 2026-11-13 21:11:17.455045: Invalid arguments or no play data available for 2024-04-09T00:00:00.000Z!
#> ✖ Args: date = "2024-04-09T00:00:00.000Z", shooting_plays_only = FALSE, utc_offset = 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_plays_tournament(tournament = "CIT", season = 2024))
#> ✖ 2026-11-13 21:11:17.464813: Invalid arguments or no play data available for CIT!
#> ✖ Args: tournament = "CIT", season = 2024, shooting_plays_only = FALSE
#> ✖ Error: api.collegebasketballdata.com requires an API key. See ?register_cbbd for details.
#> data frame with 0 columns and 0 rows
# }
# \donttest{
try(cbbd_play_types())
#> ✖ 2026-11-13 21:11:17.47546: Invalid arguments or no play types available!
#> ✖ Error: api.collegebasketballdata.com requires an API key. See ?register_cbbd for details.
#> data frame with 0 columns and 0 rows
# }
