Skip to contents

Get ESPN NBA game data (Pbp, Team and Player Box)

Usage

espn_nba_game_all(game_id)

Arguments

game_id

Game ID

Value

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

Plays

col_nametypes
idcharacter
sequence_numbercharacter
textcharacter
away_scoreinteger
home_scoreinteger
scoring_playlogical
score_valueinteger
wallclockcharacter
shooting_playlogical
type_idinteger
type_textcharacter
period_numberinteger
period_display_valuecharacter
clock_display_valuecharacter
team_idinteger
coordinate_x_rawnumeric
coordinate_y_rawnumeric
coordinate_xnumeric
coordinate_ynumeric
play_idcharacter
athlete_id_1integer
athlete_id_2integer
athlete_id_3integer
home_team_idinteger
home_team_mascotcharacter
home_team_namecharacter
home_team_abbrevcharacter
home_team_logocharacter
home_team_logo_darkcharacter
home_team_full_namecharacter
home_team_colorcharacter
home_team_alternate_colorcharacter
home_team_scoreinteger
home_team_winnerlogical
home_team_recordcharacter
away_team_idinteger
away_team_mascotcharacter
away_team_namecharacter
away_team_abbrevcharacter
away_team_logocharacter
away_team_logo_darkcharacter
away_team_full_namecharacter
away_team_colorcharacter
away_team_alternate_colorcharacter
away_team_scoreinteger
away_team_winnerlogical
away_team_recordcharacter
game_idinteger
seasoninteger
season_typeinteger
game_dateDate
game_date_timePOSIXct

Team

col_nametypes
game_idinteger
seasoninteger
season_typeinteger
game_dateDate
game_date_timePOSIXct
team_idinteger
team_uidcharacter
team_slugcharacter
team_locationcharacter
team_namecharacter
team_abbreviationcharacter
team_display_namecharacter
team_short_display_namecharacter
team_colorcharacter
team_alternate_colorcharacter
team_logocharacter
team_home_awaycharacter
team_scoreinteger
team_winnerlogical
assistsinteger
blocksinteger
defensive_reboundsinteger
fast_break_pointscharacter
field_goal_pctnumeric
field_goals_madeinteger
field_goals_attemptedinteger
flagrant_foulsinteger
foulsinteger
free_throw_pctnumeric
free_throws_madeinteger
free_throws_attemptedinteger
largest_leadcharacter
offensive_reboundsinteger
points_in_paintcharacter
stealsinteger
team_turnoversinteger
technical_foulsinteger
three_point_field_goal_pctnumeric
three_point_field_goals_madeinteger
three_point_field_goals_attemptedinteger
total_reboundsinteger
total_technical_foulsinteger
total_turnoversinteger
turnover_pointscharacter
turnoversinteger
opponent_team_idinteger
opponent_team_uidcharacter
opponent_team_slugcharacter
opponent_team_locationcharacter
opponent_team_namecharacter
opponent_team_abbreviationcharacter
opponent_team_display_namecharacter
opponent_team_short_display_namecharacter
opponent_team_colorcharacter
opponent_team_alternate_colorcharacter
opponent_team_logocharacter
opponent_team_scoreinteger

Player

col_nametypes
game_idinteger
seasoninteger
season_typeinteger
game_dateDate
game_date_timePOSIXct
athlete_idinteger
athlete_display_namecharacter
team_idinteger
team_namecharacter
team_locationcharacter
team_short_display_namecharacter
minutesnumeric
field_goals_madeinteger
field_goals_attemptedinteger
three_point_field_goals_madeinteger
three_point_field_goals_attemptedinteger
free_throws_madeinteger
free_throws_attemptedinteger
offensive_reboundsinteger
defensive_reboundsinteger
reboundsinteger
assistsinteger
stealsinteger
blocksinteger
turnoversinteger
foulsinteger
plus_minuscharacter
pointsinteger
starterlogical
ejectedlogical
did_not_playlogical
reasoncharacter
activelogical
athlete_jerseycharacter
athlete_short_namecharacter
athlete_headshot_hrefcharacter
athlete_position_namecharacter
athlete_position_abbreviationcharacter
team_display_namecharacter
team_uidcharacter
team_slugcharacter
team_logocharacter
team_abbreviationcharacter
team_colorcharacter
team_alternate_colorcharacter
home_awaycharacter
team_winnerlogical
team_scoreinteger
opponent_team_idinteger
opponent_team_namecharacter
opponent_team_locationcharacter
opponent_team_display_namecharacter
opponent_team_abbreviationcharacter
opponent_team_logocharacter
opponent_team_colorcharacter
opponent_team_alternate_colorcharacter
opponent_team_scoreinteger

Author

Saiem Gilani

Examples

# \donttest{
  try(espn_nba_game_all(game_id = 401283399))
#> $Plays
#> ── ESPN NBA Play-by-Play Information from ESPN.com ────────────── hoopR 2.1.0 ──
#>  Data updated: 2023-11-28 22:10:01 UTC
#> # A tibble: 472 × 52
#>    id       sequence_number text  away_score home_score scoring_play score_value
#>    <chr>    <chr>           <chr>      <int>      <int> <lgl>              <int>
#>  1 4012833… 4               Isai…          0          0 FALSE                  0
#>  2 4012833… 7               Jona…          0          0 FALSE                  0
#>  3 4012833… 8               Dari…          0          0 FALSE                  0
#>  4 4012833… 9               Dill…          0          0 FALSE                  0
#>  5 4012833… 11              Dari…          0          0 FALSE                  0
#>  6 4012833… 12              Ja M…          0          0 FALSE                  0
#>  7 4012833… 13              Gray…          0          0 FALSE                  0
#>  8 4012833… 14              Isai…          0          0 FALSE                  0
#>  9 4012833… 15              Shai…          3          0 TRUE                   3
#> 10 4012833… 16              Theo…          3          0 FALSE                  0
#> # ℹ 462 more rows
#> # ℹ 45 more variables: wallclock <chr>, shooting_play <lgl>, 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>, athlete_id_3 <int>,
#> #   home_team_id <int>, home_team_mascot <chr>, home_team_name <chr>, …
#> 
#> $Team
#> ── ESPN NBA Team Box Information from ESPN.com ────────────────── hoopR 2.1.0 ──
#>  Data updated: 2023-11-28 22:10:01 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 401283399   2021           2 2021-02-17 2021-02-17 21:00:00      25 s:40~l:46…
#> 2 401283399   2021           2 2021-02-17 2021-02-17 21:00:00      29 s:40~l:46…
#> # ℹ 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 NBA Player Box Information from ESPN.com ──────────────── hoopR 2.1.0 ──
#>  Data updated: 2023-11-28 22:10:01 UTC
#> # A tibble: 24 × 57
#>      game_id season season_type game_date  game_date_time      athlete_id
#>        <int>  <int>       <int> <date>     <dttm>                   <int>
#>  1 401283399   2021           2 2021-02-17 2021-02-17 21:00:00    4423545
#>  2 401283399   2021           2 2021-02-17 2021-02-17 21:00:00    4066392
#>  3 401283399   2021           2 2021-02-17 2021-02-17 21:00:00    4278073
#>  4 401283399   2021           2 2021-02-17 2021-02-17 21:00:00    4683027
#>  5 401283399   2021           2 2021-02-17 2021-02-17 21:00:00    4397020
#>  6 401283399   2021           2 2021-02-17 2021-02-17 21:00:00       6610
#>  7 401283399   2021           2 2021-02-17 2021-02-17 21:00:00    3133626
#>  8 401283399   2021           2 2021-02-17 2021-02-17 21:00:00    3138156
#>  9 401283399   2021           2 2021-02-17 2021-02-17 21:00:00    2490089
#> 10 401283399   2021           2 2021-02-17 2021-02-17 21:00:00    4080610
#> # ℹ 14 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>, …
#> 
# }