Skip to contents

Get ESPN women's college basketball play by play data

Usage

espn_wbb_pbp(game_id)

Arguments

game_id

Game ID

Value

Returns a play-by-play data frame

Plays

col_nametypesdescription
idcharacterUnique play identifcation number
sequence_numbercharacterSequence number representing a shot-possession (V3 PBP).
textcharacterText description of the play / record.
away_scoreintegerAway team score at the time of the play.
home_scoreintegerHome team score at the time of the play.
scoring_playlogicalTRUE if the play resulted in points scored.
score_valueintegerPoint value of the play (2 / 3 / 1).
wallclockcharacterWallclock.
shooting_playlogicalTRUE if the play was a shooting attempt.
type_idintegerType identifier (numeric).
type_textcharacterDisplay text for the type field.
period_numberintegerNumeric period (1-4 for quarters; 5+ for OT).
period_display_valuecharacterPeriod display label (e.g. '1st Quarter', 'OT').
clock_display_valuecharacterGame clock display string (e.g. '8:32').
team_idintegerUnique team identifier.
coordinate_x_rawnumericX coordinate as returned by the API before any adjustment.
coordinate_y_rawnumericY coordinate as returned by the API before any adjustment.
coordinate_xnumericX coordinate on the court (half-court layout).
coordinate_ynumericY coordinate on the court (half-court layout).
play_idcharacterUnique play identifier within a game.
athlete_id_1integerPrimary athlete identifier (e.g. shooter).
athlete_id_2integerSecondary athlete identifier (e.g. assister / fouler).
home_team_idintegerUnique identifier for the home team.
home_team_mascotcharacterHome team mascot.
home_team_namecharacterHome team name.
home_team_abbrevcharacterHome team three-letter abbreviation.
home_team_logocharacterHome team logo URL.
home_team_logo_darkcharacterHome team logo URL for dark backgrounds.
home_team_full_namecharacterFull home team name (e.g. 'Las Vegas Aces').
home_team_colorcharacterHome team primary color (hex).
home_team_alternate_colorcharacterHome team alternate color (hex).
home_team_scoreintegerHome team's score.
home_team_winnerlogicalTRUE if the home team won this game.
home_team_recordcharacterHome team's win-loss record.
away_team_idintegerUnique identifier for the away team.
away_team_mascotcharacterAway team mascot.
away_team_namecharacterAway team name.
away_team_abbrevcharacterAway team three-letter abbreviation.
away_team_logocharacterAway team logo URL.
away_team_logo_darkcharacterAway team logo URL for dark backgrounds.
away_team_full_namecharacterFull away team name (e.g. 'Las Vegas Aces').
away_team_colorcharacterAway team primary color (hex).
away_team_alternate_colorcharacterAway team alternate color (hex).
away_team_scoreintegerAway team's score.
away_team_winnerlogicalTRUE if the away team won this game.
away_team_recordcharacterAway team's win-loss record.
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).

See also

Other ESPN WBB Functions: espn_wbb_athletes_index(), espn_wbb_award(), espn_wbb_calendar(), espn_wbb_coach(), espn_wbb_coach_record(), espn_wbb_coach_season(), espn_wbb_coaches(), espn_wbb_conferences(), espn_wbb_franchise(), espn_wbb_franchises(), espn_wbb_game_all(), espn_wbb_game_broadcasts(), espn_wbb_game_odds(), espn_wbb_game_official_detail(), espn_wbb_game_officials(), espn_wbb_game_play(), espn_wbb_game_play_personnel(), espn_wbb_game_player_box(), espn_wbb_game_powerindex(), espn_wbb_game_predictor(), espn_wbb_game_probabilities(), espn_wbb_game_propbets(), espn_wbb_game_rosters(), espn_wbb_game_situation(), espn_wbb_game_team_leaders(), espn_wbb_game_team_linescores(), espn_wbb_game_team_records(), espn_wbb_game_team_roster(), espn_wbb_game_team_roster_entry(), espn_wbb_game_team_score(), espn_wbb_game_team_statistics(), espn_wbb_injuries(), espn_wbb_leaders(), espn_wbb_news(), espn_wbb_player_awards(), espn_wbb_player_box(), espn_wbb_player_career_stats(), espn_wbb_player_eventlog(), espn_wbb_player_eventlog_v2(), espn_wbb_player_gamelog(), espn_wbb_player_info(), espn_wbb_player_overview(), espn_wbb_player_seasons(), espn_wbb_player_splits(), espn_wbb_player_statisticslog(), espn_wbb_player_stats(), espn_wbb_player_stats_v3(), espn_wbb_position(), espn_wbb_positions(), espn_wbb_powerindex(), espn_wbb_rankings(), espn_wbb_scoreboard(), espn_wbb_season_awards(), espn_wbb_season_group(), espn_wbb_season_group_children(), espn_wbb_season_group_teams(), espn_wbb_season_groups(), espn_wbb_season_info(), espn_wbb_season_leaders(), espn_wbb_season_ranking(), espn_wbb_season_rankings(), espn_wbb_season_type(), espn_wbb_season_types(), espn_wbb_season_week(), espn_wbb_season_weeks(), espn_wbb_seasons(), espn_wbb_standings(), espn_wbb_team(), espn_wbb_team_box(), espn_wbb_team_injuries(), espn_wbb_team_leaders(), espn_wbb_team_news(), espn_wbb_team_record_detail(), espn_wbb_team_roster(), espn_wbb_team_schedule(), espn_wbb_team_season_profile(), espn_wbb_team_season_roster(), espn_wbb_team_season_statistics(), espn_wbb_team_stats(), espn_wbb_teams(), espn_wbb_tournament(), espn_wbb_tournament_season(), espn_wbb_tournament_seasons(), espn_wbb_tournaments(), espn_wbb_venues(), espn_wbb_week_ranking(), espn_wbb_week_rankings()

Author

Saiem Gilani

Examples

# \donttest{
  try(espn_wbb_pbp(game_id = 401498717))
#> ── ESPN WBB Play-by-Play Information from ESPN.com ───────────── wehoop 3.0.0 ──
#>  Data updated: 2026-06-12 14:51:51 UTC
#> # A tibble: 369 × 49
#>    id       sequence_number text  away_score home_score scoring_play score_value
#>    <chr>    <chr>           <chr>      <int>      <int> <lgl>              <int>
#>  1 4014987… 101905701       Agne…          0          0 FALSE                  3
#>  2 4014987… 101906001       Isab…          0          0 FALSE                  0
#>  3 4014987… 101907101       Alis…          0          0 FALSE                  2
#>  4 4014987… 101907301       Came…          0          0 FALSE                  0
#>  5 4014987… 101908001       Hale…          0          0 FALSE                  2
#>  6 4014987… 101908201       Kenn…          0          0 FALSE                  0
#>  7 4014987… 101909401       Jenn…          0          0 FALSE                  2
#>  8 4014987… 101909402       Hale…          0          0 FALSE                  0
#>  9 4014987… 101909801       Hale…          0          0 FALSE                  0
#> 10 4014987… 101914101       Agne…          3          0 TRUE                   3
#> # ℹ 359 more rows
#> # ℹ 42 more variables: wallclock <chr>, shooting_play <lgl>,
#> #   points_attempted <int>, short_description <chr>, type_id <int>,
#> #   type_text <chr>, period_number <int>, period_display_value <chr>,
#> #   clock_display_value <chr>, team_id <int>, play_id <chr>,
#> #   athlete_id_1 <int>, athlete_id_2 <int>, home_team_id <int>,
#> #   home_team_mascot <chr>, home_team_name <chr>, home_team_abbrev <chr>, …
# }