Get NBA Stats API play-by-play
Get NBA Stats API play-by-play
Arguments
- game_id
Game ID - 10-digit zero-padded ID (e.g., '0022201086')
- on_court
If TRUE (default), on-court player IDs are added for each play event. V3 uses
nba_gamerotation()stint data; V2 infers lineups from substitution events.- version
Play-by-play version -
"v3"(default) or"v2". V3 returns richer data with shot coordinates, shot values, and V3 action types. V2 is available from 2016-17 onwards.- p
Optional progress object from
progressr(default: NULL). Used internally bynba_pbps().- ...
Additional arguments passed to an underlying function like httr.
Value
Returns a data frame: PlayByPlay
| col_name | types |
| game_id | character |
| event_num | character |
| event_type | character |
| event_action_type | character |
| period | numeric |
| clock | character |
| minute_game | numeric |
| time_remaining | numeric |
| wc_time_string | character |
| time_quarter | character |
| minute_remaining_quarter | numeric |
| seconds_remaining_quarter | numeric |
| action_type | character |
| sub_type | character |
| home_description | character |
| neutral_description | character |
| visitor_description | character |
| description | character |
| location | character |
| score | character |
| away_score | numeric |
| home_score | numeric |
| score_margin | character |
| person1type | character |
| player1_id | character |
| player1_name | character |
| player1_team_id | character |
| player1_team_city | character |
| player1_team_nickname | character |
| player1_team_abbreviation | character |
| person2type | character |
| player2_id | character |
| player2_name | character |
| player2_team_id | character |
| player2_team_city | character |
| player2_team_nickname | character |
| player2_team_abbreviation | character |
| person3type | character |
| player3_id | character |
| player3_name | character |
| player3_team_id | character |
| player3_team_city | character |
| player3_team_nickname | character |
| player3_team_abbreviation | character |
| video_available_flag | character |
| team_leading | character |
| x_legacy | integer |
| y_legacy | integer |
| shot_distance | numeric |
| shot_result | character |
| is_field_goal | integer |
| points_total | integer |
| shot_value | integer |
| away_player1 | numeric |
| away_player2 | numeric |
| away_player3 | numeric |
| away_player4 | numeric |
| away_player5 | numeric |
| home_player1 | numeric |
| home_player2 | numeric |
| home_player3 | numeric |
| home_player4 | numeric |
| home_player5 | numeric |
See also
Other NBA PBP Functions:
nba_data_pbp(),
nba_live_pbp(),
nba_pbps(),
nba_playbyplayv3(),
nba_winprobabilitypbp()