Skip to contents

Get ESPN NBA player box scores

Usage

espn_nba_player_box(game_id)

Arguments

game_id

Game ID

Value

A player boxscore data frame

Player

col_nametypesdescription
game_idintegerUnique game identifier.
seasonintegerSeason identifier (4-digit year or 'YYYY-YY' string).
season_typeintegerSeason type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
game_dateDateGame date (YYYY-MM-DD).
game_date_timePOSIXctGame start date/time (ISO 8601).
athlete_idintegerUnique athlete identifier (ESPN).
athlete_display_namecharacterAthlete display name (full).
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_locationcharacterTeam city or location string.
team_short_display_namecharacterShort team display name (e.g. 'Aces').
minutesnumericMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_madeintegerField goals made (2-pt + 3-pt).
field_goals_attemptedintegerField goal attempts (2-pt + 3-pt).
three_point_field_goals_madeintegerThree-point field goals made.
three_point_field_goals_attemptedintegerThree-point field goal attempts.
free_throws_madeintegerFree throws made.
free_throws_attemptedintegerFree throw attempts.
offensive_reboundsintegerOffensive rebounds.
defensive_reboundsintegerDefensive rebounds.
reboundsintegerTotal rebounds.
assistsintegerTotal assists.
stealsintegerTotal steals.
blocksintegerTotal blocks.
turnoversintegerTotal turnovers.
foulsintegerPersonal fouls.
plus_minuscharacterPlus/minus point differential while on court.
pointsintegerPoints scored.
starterlogicalTRUE if the player was in the starting lineup; FALSE otherwise.
ejectedlogicalTRUE if the player was ejected from the game.
did_not_playlogicalTRUE if the player did not appear in the game.
reasoncharacterReason.
activelogicalTRUE if the row represents an active record (player / team / season).
athlete_jerseycharacterAthlete jersey number.
athlete_short_namecharacterAthlete short display name.
athlete_headshot_hrefcharacterAthlete headshot image URL.
athlete_position_namecharacterAthlete position ('Guard', 'Forward', 'Center').
athlete_position_abbreviationcharacterAthlete position abbreviation (G / F / C).
team_display_namecharacterFull team display name.
team_uidcharacterESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_logocharacterTeam logo image URL.
team_abbreviationcharacterShort team abbreviation (e.g. 'LAS').
team_colorcharacterTeam primary color (hex without leading '#').
team_alternate_colorcharacterTeam alternate color (hex without leading '#').
home_awaycharacterGame venue label ('home' or 'away').
team_winnerlogicalTRUE if the team won this game.
team_scoreintegerTeam's score / final score.
opponent_team_idintegerUnique identifier for the opponent team.
opponent_team_namecharacterOpponent team display name.
opponent_team_locationcharacterOpponent team city / location.
opponent_team_display_namecharacterOpponent team full display name.
opponent_team_abbreviationcharacterOpponent team abbreviation.
opponent_team_logocharacterOpponent team logo URL.
opponent_team_colorcharacterOpponent team primary color (hex).
opponent_team_alternate_colorcharacterOpponent team alternate color (hex).
opponent_team_scoreintegerOpponent team's score.

See also

Other ESPN NBA Functions: espn_nba_athlete_awards(), espn_nba_athlete_career_stats(), espn_nba_athlete_contract(), espn_nba_athlete_contracts(), espn_nba_athlete_eventlog(), espn_nba_athlete_eventlog_v2(), espn_nba_athlete_gamelog(), espn_nba_athlete_info(), espn_nba_athlete_overview(), espn_nba_athlete_seasons(), espn_nba_athlete_splits(), espn_nba_athlete_statisticslog(), espn_nba_athlete_stats(), espn_nba_athletes_index(), espn_nba_award(), espn_nba_betting(), espn_nba_calendar(), espn_nba_coach(), espn_nba_coach_season(), espn_nba_coaches(), espn_nba_conferences(), espn_nba_draft(), espn_nba_draft_athletes(), espn_nba_draft_pick(), espn_nba_draft_rounds(), espn_nba_draft_status(), espn_nba_event_broadcasts(), espn_nba_event_odds(), espn_nba_event_officials(), espn_nba_event_powerindex(), espn_nba_event_predictor(), espn_nba_event_probabilities(), espn_nba_event_propbets(), espn_nba_event_situation(), espn_nba_franchise(), espn_nba_franchises(), espn_nba_freeagents(), espn_nba_futures(), espn_nba_game_all(), espn_nba_game_rosters(), espn_nba_injuries(), espn_nba_leaders(), espn_nba_news(), espn_nba_pbp(), espn_nba_player_stats(), espn_nba_powerindex(), espn_nba_scoreboard(), espn_nba_season_awards(), espn_nba_season_group(), espn_nba_season_group_children(), espn_nba_season_group_teams(), espn_nba_season_groups(), espn_nba_season_info(), espn_nba_season_leaders(), espn_nba_season_ranking(), espn_nba_season_rankings(), espn_nba_season_type(), espn_nba_season_types(), espn_nba_season_week(), espn_nba_season_weeks(), espn_nba_seasons(), espn_nba_standings(), espn_nba_team(), espn_nba_team_box(), espn_nba_team_current_roster(), espn_nba_team_depthchart(), espn_nba_team_injuries(), espn_nba_team_leaders(), espn_nba_team_news(), espn_nba_team_odds_records(), espn_nba_team_record(), espn_nba_team_roster(), espn_nba_team_schedule(), espn_nba_team_season_profile(), espn_nba_team_season_roster(), espn_nba_team_stats(), espn_nba_teams(), espn_nba_tournament(), espn_nba_tournament_seasons(), espn_nba_tournaments(), espn_nba_transactions(), espn_nba_venues(), espn_nba_week_ranking(), espn_nba_week_rankings(), espn_nba_wp()

Author

Saiem Gilani

Examples

# \donttest{
try(espn_nba_player_box(game_id = 401071880))
#> ── ESPN NBA Player Box Information from ESPN.com ──────────────── hoopR 3.1.0 ──
#>  Data updated: 2026-05-19 01:33:59 UTC
#> # A tibble: 26 × 57
#>      game_id season season_type game_date  game_date_time      athlete_id
#>        <int>  <int>       <int> <date>     <dttm>                   <int>
#>  1 401071880   2019           2 2019-04-07 2019-04-07 21:00:00    3058254
#>  2 401071880   2019           2 2019-04-07 2019-04-07 21:00:00    3135048
#>  3 401071880   2019           2 2019-04-07 2019-04-07 21:00:00    2489785
#>  4 401071880   2019           2 2019-04-07 2019-04-07 21:00:00    2583639
#>  5 401071880   2019           2 2019-04-07 2019-04-07 21:00:00    3133626
#>  6 401071880   2019           2 2019-04-07 2019-04-07 21:00:00    3919335
#>  7 401071880   2019           2 2019-04-07 2019-04-07 21:00:00    2488958
#>  8 401071880   2019           2 2019-04-07 2019-04-07 21:00:00    2585637
#>  9 401071880   2019           2 2019-04-07 2019-04-07 21:00:00       6583
#> 10 401071880   2019           2 2019-04-07 2019-04-07 21:00:00    3064514
#> # ℹ 16 more rows
#> # ℹ 51 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>, …
# }