Get ESPN men's college basketball data (Pbp, Team and Player Box)

Get ESPN men's college basketball data (Pbp, Team and Player Box)

Usage

espn_mbb_game_all(game_id)

Arguments

game_id

Game ID

Value

A named list of data frames: Plays, Team, Player

Plays

col_name	types	description
id	character	Id.
sequence_number	character	Sequence number representing a shot-possession (V3 PBP).
text	character	Text description of the play / record.
away_score	integer	Away team score at the time of the play.
home_score	integer	Home team score at the time of the play.
scoring_play	logical	TRUE if the play resulted in points scored.
score_value	integer	Point value of the play (2 / 3 / 1).
wallclock	character	Wallclock.
shooting_play	logical	TRUE if the play was a shooting attempt.
type_id	integer	Type identifier (numeric).
type_text	character	Display text for the type field.
period_number	integer	Numeric period (1-4 for quarters; 5+ for OT).
period_display_value	character	Period display label (e.g. '1st Quarter', 'OT').
clock_display_value	character	Game clock display string (e.g. '8:32').
team_id	integer	Unique team identifier.
coordinate_x_raw	numeric	X coordinate as returned by the API before any adjustment.
coordinate_y_raw	numeric	Y coordinate as returned by the API before any adjustment.
coordinate_x	numeric	X coordinate on the court (half-court layout).
coordinate_y	numeric	Y coordinate on the court (half-court layout).
play_id	character	Unique play identifier within a game.
athlete_id_1	integer	Primary athlete identifier (e.g. shooter).
athlete_id_2	integer	Secondary athlete identifier (e.g. assister / fouler).
home_team_id	integer	Unique identifier for the home team.
home_team_mascot	character	Home team mascot.
home_team_name	character	Home team name.
home_team_abbrev	character	Home team three-letter abbreviation.
home_team_logo	character	Home team logo URL.
home_team_logo_dark	character	Home team logo URL for dark backgrounds.
home_team_full_name	character	Full home team name (e.g. 'Las Vegas Aces').
home_team_color	character	Home team primary color (hex).
home_team_alternate_color	character	Home team alternate color (hex).
home_team_score	integer	Home team's score.
home_team_winner	logical	TRUE if the home team won this game.
home_team_record	character	Home team's win-loss record.
away_team_id	integer	Unique identifier for the away team.
away_team_mascot	character	Away team mascot.
away_team_name	character	Away team name.
away_team_abbrev	character	Away team three-letter abbreviation.
away_team_logo	character	Away team logo URL.
away_team_logo_dark	character	Away team logo URL for dark backgrounds.
away_team_full_name	character	Full away team name (e.g. 'Las Vegas Aces').
away_team_color	character	Away team primary color (hex).
away_team_alternate_color	character	Away team alternate color (hex).
away_team_score	integer	Away team's score.
away_team_winner	logical	TRUE if the away team won this game.
away_team_record	character	Away team's win-loss record.
game_id	integer	Unique game identifier.
season	integer	Season identifier (4-digit year or 'YYYY-YY' string).
season_type	integer	Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date	Date	Game date (YYYY-MM-DD).
game_date_time	POSIXct	Game start date/time (ISO 8601).

Team

col_name	types	description
game_id	integer	Unique game identifier.
season	integer	Season identifier (4-digit year or 'YYYY-YY' string).
season_type	integer	Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date	Date	Game date (YYYY-MM-DD).
game_date_time	POSIXct	Game start date/time (ISO 8601).
team_id	integer	Unique team identifier.
team_uid	character	ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug	character	URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_location	character	Team city or location string.
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
team_display_name	character	Full team display name.
team_short_display_name	character	Short team display name (e.g. 'Aces').
team_color	character	Team primary color (hex without leading '#').
team_alternate_color	character	Team alternate color (hex without leading '#').
team_logo	character	Team logo image URL.
team_home_away	character	Team home away.
team_score	integer	Team's score / final score.
team_winner	logical	TRUE if the team won this game.
assists	integer	Total assists.
blocks	integer	Total blocks.
defensive_rebounds	integer	Defensive rebounds.
field_goal_pct	numeric	Field goal percentage (0-1).
field_goals_made	integer	Field goals made (2-pt + 3-pt).
field_goals_attempted	integer	Field goal attempts (2-pt + 3-pt).
flagrant_fouls	integer	Total flagrant fouls.
fouls	integer	Personal fouls.
free_throw_pct	numeric	Free throw percentage (0-1).
free_throws_made	integer	Free throws made.
free_throws_attempted	integer	Free throw attempts.
largest_lead	character	Largest lead during the game.
offensive_rebounds	integer	Offensive rebounds.
steals	integer	Total steals.
team_turnovers	integer	Team turnovers (turnovers credited to the team rather than a player).
technical_fouls	integer	Total technical fouls.
three_point_field_goal_pct	numeric	Three-point field goal percentage (0-1).
three_point_field_goals_made	integer	Three-point field goals made.
three_point_field_goals_attempted	integer	Three-point field goal attempts.
total_rebounds	integer	Total rebounds.
total_technical_fouls	integer	Total technical fouls (player + team).
total_turnovers	integer	Total turnovers (player + team).
turnovers	integer	Total turnovers.
opponent_team_id	integer	Unique identifier for the opponent team.
opponent_team_uid	character	Opponent team uid.
opponent_team_slug	character	Opponent team slug.
opponent_team_location	character	Opponent team city / location.
opponent_team_name	character	Opponent team display name.
opponent_team_abbreviation	character	Opponent team abbreviation.
opponent_team_display_name	character	Opponent team full display name.
opponent_team_short_display_name	character	Opponent team short display name.
opponent_team_color	character	Opponent team primary color (hex).
opponent_team_alternate_color	character	Opponent team alternate color (hex).
opponent_team_logo	character	Opponent team logo URL.
opponent_team_score	integer	Opponent team's score.

Player

col_name	types	description
game_id	integer	Unique game identifier.
season	integer	Season identifier (4-digit year or 'YYYY-YY' string).
season_type	integer	Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_date	Date	Game date (YYYY-MM-DD).
game_date_time	POSIXct	Game start date/time (ISO 8601).
athlete_id	integer	Unique athlete identifier (ESPN).
athlete_display_name	character	Athlete display name (full).
team_id	integer	Unique team identifier.
team_name	character	Full team display name (e.g. 'Las Vegas Aces').
team_location	character	Team city or location string.
team_short_display_name	character	Short team display name (e.g. 'Aces').
minutes	numeric	Minutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_made	integer	Field goals made (2-pt + 3-pt).
field_goals_attempted	integer	Field goal attempts (2-pt + 3-pt).
three_point_field_goals_made	integer	Three-point field goals made.
three_point_field_goals_attempted	integer	Three-point field goal attempts.
free_throws_made	integer	Free throws made.
free_throws_attempted	integer	Free throw attempts.
offensive_rebounds	integer	Offensive rebounds.
defensive_rebounds	integer	Defensive rebounds.
rebounds	integer	Total rebounds.
assists	integer	Total assists.
steals	integer	Total steals.
blocks	integer	Total blocks.
turnovers	integer	Total turnovers.
fouls	integer	Personal fouls.
points	integer	Points scored.
starter	logical	TRUE if the player was in the starting lineup; FALSE otherwise.
ejected	logical	TRUE if the player was ejected from the game.
did_not_play	logical	TRUE if the player did not appear in the game.
active	logical	TRUE if the row represents an active record (player / team / season).
athlete_jersey	character	Athlete jersey number.
athlete_short_name	character	Athlete short display name.
athlete_headshot_href	character	Athlete headshot image URL.
athlete_position_name	character	Athlete position ('Guard', 'Forward', 'Center').
athlete_position_abbreviation	character	Athlete position abbreviation (G / F / C).
team_display_name	character	Full team display name.
team_uid	character	ESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slug	character	URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_logo	character	Team logo image URL.
team_abbreviation	character	Short team abbreviation (e.g. 'LAS').
team_color	character	Team primary color (hex without leading '#').
team_alternate_color	character	Team alternate color (hex without leading '#').
home_away	character	Game venue label ('home' or 'away').
team_winner	logical	TRUE if the team won this game.
team_score	integer	Team's score / final score.
opponent_team_id	integer	Unique identifier for the opponent team.
opponent_team_name	character	Opponent team display name.
opponent_team_location	character	Opponent team city / location.
opponent_team_display_name	character	Opponent team full display name.
opponent_team_abbreviation	character	Opponent team abbreviation.
opponent_team_logo	character	Opponent team logo URL.
opponent_team_color	character	Opponent team primary color (hex).
opponent_team_alternate_color	character	Opponent team alternate color (hex).
opponent_team_score	integer	Opponent team's score.

See also

Other ESPN MBB Functions: espn_mbb_athlete_awards(), espn_mbb_athlete_career_stats(), espn_mbb_athlete_eventlog(), espn_mbb_athlete_eventlog_v2(), espn_mbb_athlete_gamelog(), espn_mbb_athlete_info(), espn_mbb_athlete_overview(), espn_mbb_athlete_seasons(), espn_mbb_athlete_splits(), espn_mbb_athlete_statisticslog(), espn_mbb_athlete_stats(), espn_mbb_athletes_index(), espn_mbb_award(), espn_mbb_betting(), espn_mbb_calendar(), espn_mbb_coach(), espn_mbb_coach_season(), espn_mbb_coaches(), espn_mbb_conferences(), espn_mbb_event_broadcasts(), espn_mbb_event_odds(), espn_mbb_event_officials(), espn_mbb_event_powerindex(), espn_mbb_event_predictor(), espn_mbb_event_probabilities(), espn_mbb_event_propbets(), espn_mbb_event_situation(), espn_mbb_franchise(), espn_mbb_franchises(), espn_mbb_futures(), espn_mbb_game_rosters(), espn_mbb_injuries(), espn_mbb_leaders(), espn_mbb_news(), espn_mbb_pbp(), espn_mbb_player_box(), espn_mbb_player_stats(), espn_mbb_powerindex(), espn_mbb_rankings(), espn_mbb_scoreboard(), espn_mbb_season_awards(), espn_mbb_season_group(), espn_mbb_season_group_children(), espn_mbb_season_group_teams(), espn_mbb_season_groups(), espn_mbb_season_info(), espn_mbb_season_leaders(), espn_mbb_season_ranking(), espn_mbb_season_rankings(), espn_mbb_season_type(), espn_mbb_season_types(), espn_mbb_season_week(), espn_mbb_season_weeks(), espn_mbb_seasons(), espn_mbb_standings(), espn_mbb_team(), espn_mbb_team_box(), espn_mbb_team_current_roster(), espn_mbb_team_injuries(), espn_mbb_team_leaders(), espn_mbb_team_news(), espn_mbb_team_odds_records(), espn_mbb_team_record(), espn_mbb_team_roster(), espn_mbb_team_schedule(), espn_mbb_team_season_profile(), espn_mbb_team_season_roster(), espn_mbb_team_stats(), espn_mbb_teams(), espn_mbb_tournament(), espn_mbb_tournament_seasons(), espn_mbb_tournaments(), espn_mbb_venues(), espn_mbb_week_ranking(), espn_mbb_week_rankings(), espn_mbb_wp()

Author

Saiem Gilani

Examples

# \donttest{
try(espn_mbb_game_all(game_id = 401479672))
#> $Plays
#> ── ESPN MBB Play-by-Play Information from ESPN.com ────────────── hoopR 3.1.0 ──
#> ℹ Data updated: 2026-05-19 01:33:07 UTC
#> # A tibble: 360 × 53
#>    id       sequence_number text  away_score home_score scoring_play score_value
#>    <chr>    <chr>           <chr>      <int>      <int> <lgl>              <int>
#>  1 4014796… 101799901       Jump…          0          0 FALSE                  0
#>  2 4014796… 101805501       Jess…          0          0 FALSE                  2
#>  3 4014796… 101805502       RJ M…          0          0 FALSE                  0
#>  4 4014796… 101805503       Skyy…          0          0 FALSE                  0
#>  5 4014796… 101808101       Terr…          0          0 FALSE                  3
#>  6 4014796… 101808102       RJ M…          0          0 FALSE                  0
#>  7 4014796… 101809301       RJ M…          0          0 FALSE                  2
#>  8 4014796… 101809302       Benn…          0          0 FALSE                  0
#>  9 4014796… 101809501       Foul…          0          0 FALSE                  0
#> 10 4014796… 101814601       Juda…          0          0 FALSE                  2
#> # ℹ 350 more rows
#> # ℹ 46 more variables: wallclock <chr>, shooting_play <lgl>,
#> #   points_attempted <int>, short_description <chr>, type_id <int>,
#> #   type_text <chr>, period_number <int>, period_display_value <chr>,
#> #   clock_display_value <chr>, team_id <int>, coordinate_x_raw <dbl>,
#> #   coordinate_y_raw <dbl>, coordinate_x <dbl>, coordinate_y <dbl>,
#> #   play_id <chr>, athlete_id_1 <int>, athlete_id_2 <int>, …
#> 
#> $Team
#> ── ESPN MBB Team Box Information from ESPN.com ────────────────── hoopR 3.1.0 ──
#> ℹ Data updated: 2026-05-19 01:33:08 UTC
#> # A tibble: 2 × 57
#>     game_id season season_type game_date  game_date_time      team_id team_uid  
#>       <int>  <int>       <int> <date>     <dttm>                <int> <chr>     
#> 1 401479672   2023           2 2022-11-29 2022-11-29 19:30:00     183 s:40~l:41…
#> 2 401479672   2023           2 2022-11-29 2022-11-29 19:30:00     356 s:40~l:41…
#> # ℹ 50 more variables: team_slug <chr>, team_location <chr>, team_name <chr>,
#> #   team_abbreviation <chr>, team_display_name <chr>,
#> #   team_short_display_name <chr>, team_color <chr>,
#> #   team_alternate_color <chr>, team_logo <chr>, team_home_away <chr>,
#> #   team_score <int>, team_winner <lgl>, assists <int>, blocks <int>,
#> #   defensive_rebounds <int>, fast_break_points <chr>, field_goal_pct <dbl>,
#> #   field_goals_made <int>, field_goals_attempted <int>, …
#> 
#> $Player
#> ── ESPN MBB Player Box Information from ESPN.com ──────────────── hoopR 3.1.0 ──
#> ℹ Data updated: 2026-05-19 01:33:08 UTC
#> # A tibble: 30 × 54
#>      game_id season season_type game_date  game_date_time      athlete_id
#>        <int>  <int>       <int> <date>     <dttm>                   <int>
#>  1 401479672   2023           2 2022-11-29 2022-11-29 19:30:00    4684627
#>  2 401479672   2023           2 2022-11-29 2022-11-29 19:30:00    4575472
#>  3 401479672   2023           2 2022-11-29 2022-11-29 19:30:00    4431816
#>  4 401479672   2023           2 2022-11-29 2022-11-29 19:30:00    4684729
#>  5 401479672   2023           2 2022-11-29 2022-11-29 19:30:00    4431746
#>  6 401479672   2023           2 2022-11-29 2022-11-29 19:30:00    4700878
#>  7 401479672   2023           2 2022-11-29 2022-11-29 19:30:00    5105337
#>  8 401479672   2023           2 2022-11-29 2022-11-29 19:30:00    4592369
#>  9 401479672   2023           2 2022-11-29 2022-11-29 19:30:00    4684746
#> 10 401479672   2023           2 2022-11-29 2022-11-29 19:30:00    4683860
#> # ℹ 20 more rows
#> # ℹ 48 more variables: athlete_display_name <chr>, team_id <int>,
#> #   team_name <chr>, team_location <chr>, team_short_display_name <chr>,
#> #   minutes <dbl>, field_goals_made <int>, field_goals_attempted <int>,
#> #   three_point_field_goals_made <int>,
#> #   three_point_field_goals_attempted <int>, free_throws_made <int>,
#> #   free_throws_attempted <int>, offensive_rebounds <int>, …
#> 
# }