Skip to contents

load_wnba_shots_manifest() returns the per-season manifest CSV (season, row_count, generated_at_utc, source_endpoint) for the shots release tag without downloading any season's full data.

Loads shot events parsed from ESPN WNBA play-by-play feeds. One row per shot attempt (made or missed), with court coordinates and shot metadata. Backed by the wehoop-wnba-data pipeline that reads raw JSONs from wehoop-wnba-raw and publishes parquet/rds artifacts to the espn_wnba_shots release tag.

Usage

load_wnba_shots_manifest()

load_wnba_shots(
  seasons = most_recent_wnba_season(),
  ...,
  dbConnection = NULL,
  tablename = NULL
)

Arguments

seasons

A vector of 4-digit years associated with given WNBA seasons. (Min: 2002)

...

Additional arguments passed to an underlying function that writes the season data into a database.

dbConnection

A DBIConnection object, as returned by DBI::dbConnect()

tablename

The name of the shots data table within the database

Value

Returns a wehoop_data tibble with one row per shot attempt.

col_nametypes
game_idcharacter
seasoninteger
period_numberinteger
clock_display_valuecharacter
team_idcharacter
athlete_id_1character
athlete_id_2character
type_idcharacter
type_textcharacter
scoring_playlogical
score_valueinteger
coordinate_xnumeric
coordinate_ynumeric
coordinate_x_rawnumeric
coordinate_y_rawnumeric

Examples

# \donttest{
  try(load_wnba_shots(seasons = most_recent_wnba_season()))
#> ──────────────────────────────────────────────────────────────── wehoop 3.0.0 ──
#> # A tibble: 4,369 × 15
#>      game_id season period_number clock_display_value team_id athlete_id_1
#>        <int>  <int>         <int> <chr>                 <int>        <int>
#>  1 401856910   2026             1 9:45                     17      3149391
#>  2 401856910   2026             1 9:22                     18      4898898
#>  3 401856910   2026             1 9:20                     18      3922628
#>  4 401856910   2026             1 9:04                     17      4065870
#>  5 401856910   2026             1 8:32                     18      4433635
#>  6 401856910   2026             1 8:22                     17      3149391
#>  7 401856910   2026             1 8:11                     18      3922628
#>  8 401856910   2026             1 7:58                     18      4433635
#>  9 401856910   2026             1 7:49                     17      4398776
#> 10 401856910   2026             1 7:28                     18      3922628
#> # ℹ 4,359 more rows
#> # ℹ 9 more variables: athlete_id_2 <int>, type_id <int>, type_text <chr>,
#> #   scoring_play <lgl>, score_value <int>, coordinate_x <dbl>,
#> #   coordinate_y <dbl>, coordinate_x_raw <dbl>, coordinate_y_raw <dbl>
# }