Skip to contents

Get WNBA Stats API play-by-play

Get WNBA Stats API play-by-play

Usage

wnba_pbp(game_id, on_court = TRUE, version = "v3", p = NULL, ...)

Arguments

game_id

Game ID

on_court

IF TRUE will be added ID of players on court

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

Progress bar

...

Additional arguments passed to an underlying function like httr.

Value

Returns a data frame: PlayByPlay

col_nametypesdescription
game_idcharacterUnique game identifier.
event_numcharacterSequential event number within the game (V2 PBP).
event_typecharacterEvent / play type code (V2 PBP).
event_action_typecharacterNumeric event-action-type code (V2 PBP).
periodnumericPeriod of the game (1-4 quarters; 5+ for OT).
minute_gamenumericMinute game.
time_remainingnumericTime remaining.
wc_time_stringcharacterWc time string.
time_quartercharacterTime quarter.
minute_remaining_quarternumericMinute remaining quarter.
seconds_remaining_quarternumericSeconds remaining quarter.
home_descriptioncharacterHome team's description.
neutral_descriptioncharacterNeutral description.
visitor_descriptioncharacterVisitor description.
scorecharacterFinal score.
away_scorenumericAway team score at the time of the play.
home_scorenumericHome team score at the time of the play.
score_margincharacterScore margin.
person1typecharacterPerson1type.
player1_idcharacterV2 PBP primary player ID (e.g. shooter / fouler).
player1_namecharacterV2 PBP primary player name.
player1_team_idcharacterTeam ID of player1.
player1_team_citycharacterPlayer1 team city.
player1_team_nicknamecharacterPlayer1 team nickname.
player1_team_abbreviationcharacterPlayer1 team abbreviation.
person2typecharacterPerson2type.
player2_idcharacterV2 PBP secondary player ID (e.g. assister / fouled-by).
player2_namecharacterV2 PBP secondary player name.
player2_team_idcharacterTeam ID of player2.
player2_team_citycharacterPlayer2 team city.
player2_team_nicknamecharacterPlayer2 team nickname.
player2_team_abbreviationcharacterPlayer2 team abbreviation.
person3typecharacterPerson3type.
player3_idcharacterV2 PBP tertiary player ID (e.g. blocker).
player3_namecharacterV2 PBP tertiary player name.
player3_team_idcharacterTeam ID of player3.
player3_team_citycharacterPlayer3 team city.
player3_team_nicknamecharacterPlayer3 team nickname.
player3_team_abbreviationcharacterPlayer3 team abbreviation.
video_available_flagcharacterVideo available flag.
team_leadingcharacterTeam leading.

Details

 wnba_pbp(game_id = "1022200034", on_court = TRUE)

See also