Skip to contents

Fetch WNBA Play-by-Play and Classify Field-Goal Attempts by Shot Zone

Source: R/wnba_shot_zones.R
wnba_shot_zones.Rd

Fetch WNBA Play-by-Play and Classify Field-Goal Attempts by Shot Zone

Fetch WNBA Play-by-Play and Classify Field-Goal Attempts by Shot Zone

Usage

wnba_shot_zones(game_id, ...)

Arguments

game_id

A length-1 character string — the ten-character WNBA Stats game identifier (e.g. "1022400003" for a 2024 WNBA game).

...

Reserved for future keyword arguments (currently ignored).

Value

Returns a data.frame containing the full V3 play-by-play for game_id with an appended shot_zone column:

col_nametypesdescription
event_typecharacterPlay event type code. "1" = MadeShot, "2" = MissedShot, "3" = FreeThrow, etc.
shot_valueintegerPoint value of the shot attempt (2 or 3); 0 for non-FGA events.
x_legacynumericHorizontal court coordinate (legacy units). Negative = left side of the court.
y_legacynumericVertical court coordinate (legacy units). Values near 0 = baseline.
shot_distancenumericDistance from the basket in feet.
shot_zonecharacterShot-zone classification. One of "corner_3", "above_the_break_3", "restricted_area", "in_the_paint_non_ra", "mid_range". NA on non-field-goal rows.

All other columns from the V3 PBP schema (wnba_pbp()) are also present. Returns a 0-row frame when the game cannot be fetched (never-raise).

Shot zone definitions (pbpstats-core aligned):

  • "corner_3" — three-point attempt with abs(x_legacy) >= 220 and y_legacy <= 87.5 (baseline corner area).

  • "above_the_break_3" — all other three-point attempts.

  • "restricted_area" — two-point attempt within 4 ft of the basket.

  • "in_the_paint_non_ra" — two-point attempt 4–8 ft from the basket and within 80 legacy units of the paint center (abs(x_legacy) <= 80).

  • "mid_range" — all remaining two-point attempts.

Details

 df <- wnba_shot_zones(game_id = "1022400003")
 print(table(df$shot_zone, useNA = "ifany"))

See also

Other WNBA Lineup Functions: wnba_gamerotation(), wnba_leaguedashlineups(), wnba_leaguelineupviz(), wnba_possession_lineups(), wnba_rapm(), wnba_shotchartlineupdetail(), wnba_teamdashlineups()

Author

Saiem Gilani

Examples

# \donttest{
  try({
    df <- wnba_shot_zones(game_id = "1022400003")
    print(df[!is.na(df$shot_zone), c("shot_distance", "shot_zone")])
  })
#> ── WNBA Shot Zones ───────────────────────────────────────────── wehoop 3.0.0 ──
#> ℹ Data updated: 2026-08-27 11:10:22 UTC
#> # A tibble: 147 × 2
#>    shot_distance shot_zone          
#>            <int> <chr>              
#>  1            25 above_the_break_3  
#>  2            39 above_the_break_3  
#>  3            16 mid_range          
#>  4             2 restricted_area    
#>  5             4 in_the_paint_non_ra
#>  6            24 above_the_break_3  
#>  7            26 above_the_break_3  
#>  8            25 above_the_break_3  
#>  9            19 mid_range          
#> 10            28 above_the_break_3  
#> # ℹ 137 more rows
# }