Skip to main content

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_nametypedescription
game_idInt32Unique game identifier.
seasonInt32Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
season_typeInt32Season 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_timeDatetime(time_unit='us', time_zone='America/New_York')Game start date/time (ISO 8601).
team_idInt32Unique team identifier.
team_uidStringESPN universal team identifier (UID format 's:40~l:...~t:...').
team_slugStringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_locationStringTeam city or location string.
team_nameStringFull team display name (e.g. 'Las Vegas Aces').
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
team_display_nameStringFull team display name.
team_short_display_nameStringShort team display name (e.g. 'Aces').
team_colorStringTeam primary color (hex without leading '#').
team_alternate_colorStringTeam alternate color (hex without leading '#').
team_logoStringTeam logo image URL.
team_home_awayStringTeam home away.
team_scoreInt32Team's score / final score.
team_winnerBooleanTRUE if the team won this game.
assistsInt32Total assists.
blocksInt32Total blocks.
defensive_reboundsInt32Defensive rebounds.
fast_break_pointsStringFast-break points scored.
field_goal_pctFloat64Field goal percentage (0-1).
field_goals_madeInt32Field goals made (2-pt + 3-pt).
field_goals_attemptedInt32Field goal attempts (2-pt + 3-pt).
flagrant_foulsInt32Total flagrant fouls.
foulsInt32Personal fouls.
free_throw_pctFloat64Free throw percentage (0-1).
free_throws_madeInt32Free throws made.
free_throws_attemptedInt32Free throw attempts.
largest_leadStringLargest lead during the game.
lead_changesStringLead changes.
lead_percentageStringShare of game time the team spent in the lead, as reported by ESPN.
offensive_reboundsInt32Offensive rebounds.
points_in_paintStringPoints scored in the paint.
stealsInt32Total steals.
team_turnoversInt32Team turnovers (turnovers credited to the team rather than a player).
technical_foulsInt32Total technical fouls.
three_point_field_goal_pctFloat64Three-point field goal percentage (0-1).
three_point_field_goals_madeInt32Three-point field goals made.
three_point_field_goals_attemptedInt32Three-point field goal attempts.
total_reboundsInt32Total rebounds.
total_technical_foulsInt32Total technical fouls (player + team).
total_turnoversInt32Total turnovers (player + team).
turnover_pointsStringTurnover points.
turnoversInt32Total turnovers.
opponent_team_idInt32Unique identifier for the opponent team.
opponent_team_uidStringOpponent team uid.
opponent_team_slugStringOpponent team slug.
opponent_team_locationStringOpponent team city / location.
opponent_team_nameStringOpponent team display name.
opponent_team_abbreviationStringOpponent team abbreviation.
opponent_team_display_nameStringOpponent team full display name.
opponent_team_short_display_nameStringOpponent team short display name.
opponent_team_colorStringOpponent team primary color (hex).
opponent_team_alternate_colorStringOpponent team alternate color (hex).
opponent_team_logoStringOpponent team logo URL.
opponent_team_scoreInt32Opponent 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

Coverage

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_nametypedescription
seasonInt32Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
team_idInt32Unique team identifier.
team_slugStringURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_abbreviationStringShort team abbreviation (e.g. 'LAS').
team_display_nameStringFull team display name.
team_short_display_nameStringShort team display name (e.g. 'Aces').
team_colorStringTeam primary color (hex without leading '#').
team_alternate_colorStringTeam alternate color (hex without leading '#').
team_logoStringTeam logo image URL.
categoryStringCategory label.
stat_labelString
stat_nameStringInternal stat key.
stat_display_nameStringStat display name.
stat_descriptionStringHuman-readable description of the statistic the row reports.
display_valueStringDisplay-formatted value.
valueFloat64Numeric 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

Coverage

wnba_team_id is Int64, as WNBA Stats ships team_id, so the bridge joins without a cast.

Returns​

col_nametypedescription
seasonInt32Season as a 4-digit starting year (integer). A 'YYYY-YY' string is not accepted.
espn_team_idInt32ESPN team id (canonical key).
espn_abbreviationStringESPN abbreviation.
espn_display_nameStringESPN display name (school + mascot).
espn_short_nameStringESPN short name.
espn_locationStringESPN school/location only.
espn_mascotStringESPN team mascot/nickname.
wnba_team_idInt64WNBA Stats team id.
wnba_team_tricodeStringWNBA Stats tricode.
wnba_team_nameStringWNBA Stats team name.
wnba_team_cityStringWNBA Stats team city.
wnba_team_slugStringWNBA Stats team slug.
fox_team_idStringFox Bifrost team id (NA if unmatched).
fox_team_nameStringFox team name (NA if unmatched).
yahoo_team_idStringDotted 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_abbreviationStringYahoo Sports team abbreviation for yahoo_team_id; null when yahoo_team_id is.
yahoo_team_nameStringYahoo Sports full team name for yahoo_team_id; null when yahoo_team_id is.
match_methodStringCombination of matched sources, e.g. "fox+bart" / "fox_only" / "bart_only" / "espn_only".
match_confidenceFloat64Jaro-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

Coverage

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_nametypedescription
leagueStringLeague code of the table ("wnba"); the prefix of every group_id in it.
seasonInt32Season of the membership (calendar year).
team_idStringTeam 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_sourceStringId space of team_id (in this table: espn).
team_nameStringTeam name as of that season, not today's.
subdivision_idStringSDV group_id of the team's subdivision that season (e.g. FBS / FCS, Division I); null where the league has no subdivision level.
conference_idStringSDV 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_idStringSDV group_id of the team's division that season; null where the level does not apply.
sourceStringSource the membership was taken from -- the most reliable per-season source for that era.
sources_agreeBooleanWhether a second source agreed on the membership; null when only one source covers the season.
notesStringBuilder 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

Coverage

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_nametypedescription
leagueStringLeague code of the table ("wnba").
team_idStringESPN 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_sourceStringId space of team_id; always "espn" in this table.
sourceStringProvider that uses this id or name (in this table: fox, wnba_stats, yahoo).
source_idStringThe 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_kindString"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_kindStringKind 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.
valueStringThe source's own spelling of the team name or abbreviation; null when the row carries only an id.
valid_fromInt32First season the source shows this id or name on the team, inclusive (calendar year); null, with valid_to, for an undated curated map.
valid_toInt32Last 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_methodStringHow 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).
evidenceStringThe release asset or sportsdataverse/sdv-reference-data file the row came from.
load_wnba_team_aliases()