WNBA dataset loaders — Team
load_wnba_team_boxscore
Release: espn_wnba_team_boxscores · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_wnba_team_boxscores/team_box_{season}.parquet
Returns
| col_name | type | description |
|---|---|---|
game_id | Int32 | Unique game identifier. |
season | Int32 | Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted. |
season_type | Int32 | Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats). |
game_date | Date | Game date (YYYY-MM-DD). |
game_date_time | Datetime(time_unit='us', time_zone='America/New_York') | Game start date/time (ISO 8601). |
team_id | Int32 | Unique team identifier. |
team_uid | String | ESPN universal team identifier (UID format 's:40~l:...~t:...'). |
team_slug | String | URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces'). |
team_location | String | Team city or location string. |
team_name | String | Full team display name (e.g. 'Las Vegas Aces'). |
team_abbreviation | String | Short team abbreviation (e.g. 'LAS'). |
team_display_name | String | Full team display name. |
team_short_display_name | String | Short team display name (e.g. 'Aces'). |
team_color | String | Team primary color (hex without leading '#'). |
team_alternate_color | String | Team alternate color (hex without leading '#'). |
team_logo | String | Team logo image URL. |
team_home_away | String | Team home away. |
team_score | Int32 | Team's score / final score. |
team_winner | Boolean | TRUE if the team won this game. |
assists | Int32 | Total assists. |
blocks | Int32 | Total blocks. |
defensive_rebounds | Int32 | Defensive rebounds. |
fast_break_points | String | Fast-break points scored. |
field_goal_pct | Float64 | Field goal percentage (0-1). |
field_goals_made | Int32 | Field goals made (2-pt + 3-pt). |
field_goals_attempted | Int32 | Field goal attempts (2-pt + 3-pt). |
flagrant_fouls | Int32 | Total flagrant fouls. |
fouls | Int32 | Personal fouls. |
free_throw_pct | Float64 | Free throw percentage (0-1). |
free_throws_made | Int32 | Free throws made. |
free_throws_attempted | Int32 | Free throw attempts. |
largest_lead | String | Largest lead during the game. |
lead_changes | String | Lead changes. |
lead_percentage | String | Share of game time the team spent in the lead, as reported by ESPN. |
offensive_rebounds | Int32 | Offensive rebounds. |
points_in_paint | String | Points scored in the paint. |
steals | Int32 | Total steals. |
team_turnovers | Int32 | Team turnovers (turnovers credited to the team rather than a player). |
technical_fouls | Int32 | Total technical fouls. |
three_point_field_goal_pct | Float64 | Three-point field goal percentage (0-1). |
three_point_field_goals_made | Int32 | Three-point field goals made. |
three_point_field_goals_attempted | Int32 | Three-point field goal attempts. |
total_rebounds | Int32 | Total rebounds. |
total_technical_fouls | Int32 | Total technical fouls (player + team). |
total_turnovers | Int32 | Total turnovers (player + team). |
turnover_points | String | Turnover points. |
turnovers | Int32 | Total turnovers. |
opponent_team_id | Int32 | Unique identifier for the opponent team. |
opponent_team_uid | String | Opponent team uid. |
opponent_team_slug | String | Opponent team slug. |
opponent_team_location | String | Opponent team city / location. |
opponent_team_name | String | Opponent team display name. |
opponent_team_abbreviation | String | Opponent team abbreviation. |
opponent_team_display_name | String | Opponent team full display name. |
opponent_team_short_display_name | String | Opponent team short display name. |
opponent_team_color | String | Opponent team primary color (hex). |
opponent_team_alternate_color | String | Opponent team alternate color (hex). |
opponent_team_logo | String | Opponent team logo URL. |
opponent_team_score | Int32 | Opponent team's score. |
load_wnba_team_boxscore(seasons=2024)
load_wnba_team_season_stats
Release: espn_wnba_team_season_stats · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/espn_wnba_team_season_stats/team_season_stats_{season}.parquet
Published seasons: every season from the floor except 2022 and 2023, which the release has no asset for; a request for one is skipped with a warning.
Returns
| col_name | type | description |
|---|---|---|
season | Int32 | Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted. |
team_id | Int32 | Unique team identifier. |
team_slug | String | URL-safe team identifier (e.g. 'lasvegas-aces' / 'aces'). |
team_abbreviation | String | Short team abbreviation (e.g. 'LAS'). |
team_display_name | String | Full team display name. |
team_short_display_name | String | Short team display name (e.g. 'Aces'). |
team_color | String | Team primary color (hex without leading '#'). |
team_alternate_color | String | Team alternate color (hex without leading '#'). |
team_logo | String | Team logo image URL. |
category | String | Category label. |
stat_label | String | |
stat_name | String | Internal stat key. |
stat_display_name | String | Stat display name. |
stat_description | String | Human-readable description of the statistic the row reports. |
display_value | String | Display-formatted value. |
value | Float64 | Numeric or string value field. |
load_wnba_team_season_stats(seasons=2024)
load_wnba_team_crosswalk
Release: wnba_crosswalk · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wnba_crosswalk/wnba_team_crosswalk_{season}.parquet
wnba_team_id is Int64, as WNBA Stats ships team_id, so the bridge joins without a cast.
Returns
| col_name | type | description |
|---|---|---|
season | Int32 | Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted. |
espn_team_id | Int32 | ESPN team id (canonical key). |
espn_abbreviation | String | ESPN abbreviation. |
espn_display_name | String | ESPN display name (school + mascot). |
espn_short_name | String | ESPN short name. |
espn_location | String | ESPN school/location only. |
espn_mascot | String | ESPN team mascot/nickname. |
wnba_team_id | Int64 | WNBA Stats team id. |
wnba_team_tricode | String | WNBA Stats tricode. |
wnba_team_name | String | WNBA Stats team name. |
wnba_team_city | String | WNBA Stats team city. |
wnba_team_slug | String | WNBA Stats team slug. |
fox_team_id | String | Fox Bifrost team id (NA if unmatched). |
fox_team_name | String | Fox team name (NA if unmatched). |
yahoo_team_id | String | Dotted Yahoo Sports team id (e.g. 'wnba.t.4'), filled when built with yahoo=True from Yahoo's team listing joined on full name, short name, then nickname; null otherwise and where no Yahoo team matched. |
yahoo_team_abbreviation | String | Yahoo Sports team abbreviation for yahoo_team_id; null when yahoo_team_id is. |
yahoo_team_name | String | Yahoo Sports full team name for yahoo_team_id; null when yahoo_team_id is. |
match_method | String | Combination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only". |
match_confidence | Float64 | Jaro-Winkler score or 1 for exact (NA if none). |
load_wnba_team_crosswalk(seasons=2026)
load_wnba_team_group_seasons
Release: wnba_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wnba_groups/wnba_team_group_seasons_{season}.parquet
One row per team per season: the SDV subdivision, conference and division group ids the team belonged to that season (null where a level does not apply), the team name as of that season, where the membership came from, and whether a second source agreed (null when only one source covers the season). team_id is a string: the ESPN team id; team_id_source names the id space. season is the calendar year; seasons 1997-2026.
Returns
| col_name | type | description |
|---|---|---|
league | String | League code of the table ("wnba"); the prefix of every group_id in it. |
season | Int32 | Season of the membership (calendar year). |
team_id | String | Team id as a string: the ESPN team id where ESPN covers the team, otherwise the league's own id; team_id_source says which. |
team_id_source | String | Id space of team_id (in this table: espn). |
team_name | String | Team name as of that season, not today's. |
subdivision_id | String | SDV group_id of the team's subdivision that season (e.g. FBS / FCS, Division I); null where the league has no subdivision level. |
conference_id | String | SDV group_id of the team's conference that season; null where the team had no conference (an independent, or a season played without conferences). |
division_id | String | SDV group_id of the team's division that season; null where the level does not apply. |
source | String | Source the membership was taken from -- the most reliable per-season source for that era. |
sources_agree | Boolean | Whether a second source agreed on the membership; null when only one source covers the season. |
notes | String | Builder notes on the team-season, such as a source disagreement or which of several listed memberships was kept. |
load_wnba_team_group_seasons(seasons=2024)
load_wnba_team_aliases
Release: wnba_groups · asset https://github.com/sportsdataverse/sportsdataverse-data/releases/download/wnba_groups/wnba_team_aliases.parquet
One season-less file: every id and name another source (fox, wnba_stats, yahoo) uses for a team, keyed on the ESPN team id (team_id, a string; team_id_source = espn), with the seasons the source shows it on that team (valid_from / valid_to, inclusive; both null for an undated curated map). id_kind says whether source_id is the source's id for this sport's team or one id for every sport of a school; a name-only row has a null source_id. A source id means something only within its source (Fox 25 is not ESPN 25), so filter on source before joining on source_id. Seasons are the calendar year.
Returns
| col_name | type | description |
|---|---|---|
league | String | League code of the table ("wnba"). |
team_id | String | ESPN team id the alias points to, as a string (e.g. "150"); the same id as team_id in load_wnba_team_group_seasons. Join on it to reach ESPN team data. |
team_id_source | String | Id space of team_id; always "espn" in this table. |
source | String | Provider that uses this id or name (in this table: fox, wnba_stats, yahoo). |
source_id | String | The source's own id for the team (e.g. Fox 25, Yahoo nba.t.1); null for a name-only row. It means something only within its source (Fox 25 is Ohio State, ESPN 25 is California), so filter on source first. |
id_kind | String | "team" when source_id is the source's id for this sport's team, or "school" when it is one id for every sport of a school (the stats.ncaa.org org id, 247Sports institutionKey, On3 orgKey). |
name_kind | String | Kind of label in value: "name" or "abbreviation"; null when the row carries only an id. An id with both a name and an abbreviation is two rows. |
value | String | The source's own spelling of the team name or abbreviation; null when the row carries only an id. |
valid_from | Int32 | First season the source shows this id or name on the team, inclusive (calendar year); null, with valid_to, for an undated curated map. |
valid_to | Int32 | Last season the source shows this id or name on the team, inclusive (calendar year); null, with valid_from, for an undated curated map. A gap in the source splits the window into two rows. |
match_method | String | How the row was tied to the ESPN team: "deterministic" (a formula or shared key, e.g. Yahoo {league}.t.{espn id}; CFBD ids are ESPN ids), "crosswalk" (carried from a published crosswalk leg), "curated" (a cited map), or for a hand-captured team directory row "alias", "exact_name" (normalized name) or "dict" (curated name dictionary). |
evidence | String | The release asset or sportsdataverse/sdv-reference-data file the row came from. |
load_wnba_team_aliases()