Get NBA Stats API play-by-play
Get NBA Stats API play-by-play
nba_pbp(game_id, on_court = TRUE, version = "v3", p = NULL, ...)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 |
Game ID - 10-digit zero-padded ID (e.g., '0022201086')
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.
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.
Optional progress object from progressr (default: NULL). Used internally by nba_pbps().
Additional arguments passed to an underlying function like httr.
Jason Lee
nba_pbp(game_id = '0022201086')
nba_pbp(game_id = '0022201086', version = "v2")
Other NBA PBP Functions:
nba_data_pbp(),
nba_live_pbp(),
nba_pbps(),
nba_playbyplayv3(),
nba_winprobabilitypbp()