wnba_shot_zones: *Fetch WNBA Play-by-Play and Classify Field-Goal Attempts by...

In wehoop: Access Women's Basketball Play by Play Data

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

Description

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).

Details

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

Value

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

col_name	types	description
event_type	character	Play event type code. "1" = MadeShot, "2" = MissedShot, "3" = FreeThrow, etc.
shot_value	integer	Point value of the shot attempt (2 or 3); 0 for non-FGA events.
x_legacy	numeric	Horizontal court coordinate (legacy units). Negative = left side of the court.
y_legacy	numeric	Vertical court coordinate (legacy units). Values near 0 = baseline.
shot_distance	numeric	Distance from the basket in feet.
shot_zone	character	Shot-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.

Author(s)

Saiem Gilani

See Also

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

Examples

  try({
    df <- wnba_shot_zones(game_id = "1022400003")
    print(df[!is.na(df$shot_zone), c("shot_distance", "shot_zone")])
  })

wehoop documentation built on Aug. 25, 2026, 1:06 a.m.