WNBA — ESPN web API (v3)
sportsdataverse.wnba — 5 endpoints.
espn_wnba_player_overview
ESPN endpoint.
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/wnba/athletes/{athlete_id}/overview
Valid URL: https://site.web.api.espn.com/apis/common/v3/sports/basketball/wnba/athletes/4239/overview
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
athlete_id | athlete_id | Y | athlete_id path parameter. |
Returns
return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.
| col_name | type | description |
|---|---|---|
athlete_id | character | Unique athlete identifier (ESPN). |
athlete_display_name | character | Athlete display name (full). |
athlete_short_name | character | Athlete short display name. |
athlete_position | character | Athlete position. |
athlete_jersey | character | Athlete jersey number. |
athlete_team_id | character | |
athlete_team_abbreviation | character | |
split_name | character | Split name (typically "All Splits"). |
split_category | character | |
games_played | character | Games played. |
avg_minutes | character | |
field_goal_pct | character | Field goal percentage (0-1). |
three_point_pct | character | |
free_throw_pct | character | Free throw percentage (0-1). |
avg_rebounds | character | |
avg_assists | character | |
avg_blocks | character | |
avg_steals | character | |
avg_fouls | character | |
avg_turnovers | character | |
avg_points | character |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
espn_wnba_player_overview(athlete_id='4239')
Last validated n/a.
espn_wnba_player_stats_v3
ESPN endpoint.
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/wnba/athletes/{athlete_id}/stats
Valid URL: https://site.web.api.espn.com/apis/common/v3/sports/basketball/wnba/athletes/4239/stats
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
athlete_id | athlete_id | Y | athlete_id path parameter. | ||
season | season | Y | Season year (e.g. 2024). |
Returns
return_parsed=True (default) — the output of parse_athlete_stats; pass return_as_pandas=True for a pandas.DataFrame.
No returns table is published for this endpoint: parser: parse_athlete_stats returns no columns on the live payload (nba, mlb, mbb, 2026-10-07); its rows sit under keys it does not read (top level: categories, filters, glossary, teams).
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
espn_wnba_player_stats_v3(athlete_id='4239')
Last validated n/a.
espn_wnba_player_gamelog
ESPN endpoint.
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/wnba/athletes/{athlete_id}/gamelog
Valid URL: https://site.web.api.espn.com/apis/common/v3/sports/basketball/wnba/athletes/4239/gamelog
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
athlete_id | athlete_id | Y | athlete_id path parameter. | ||
season | season | Y | Season year (e.g. 2024). |
Returns
return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.
| col_name | type | description |
|---|---|---|
season_type_id | character | Unique identifier for season type. |
season_type_name | character | Season type name. |
category | character | Category label. |
event_id | character | Unique event / game identifier (ESPN). |
event_date | character | |
home_away | character | Game venue label ('home' or 'away'). |
score | character | Final score. |
opponent_id | character | Unique identifier for opponent. |
opponent_abbreviation | character | |
opponent_display_name | character | |
game_result | character | |
game_processed | character | |
stat_0 | character | |
stat_1 | character | |
stat_2 | character | |
stat_3 | character | |
stat_4 | character | |
stat_5 | character | |
stat_6 | character | |
stat_7 | character | |
stat_8 | character | |
stat_9 | character | |
stat_10 | character | |
stat_11 | character | |
stat_12 | character | |
stat_13 | character |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
espn_wnba_player_gamelog(athlete_id='4239')
Last validated n/a.
espn_wnba_player_splits
ESPN endpoint.
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/wnba/athletes/{athlete_id}/splits
Valid URL: https://site.web.api.espn.com/apis/common/v3/sports/basketball/wnba/athletes/4239/splits
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
athlete_id | athlete_id | Y | athlete_id path parameter. | ||
season | season | Y | Season year (e.g. 2024). |
Returns
return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.
| col_name | type | description |
|---|---|---|
descriptions | character | |
display_name | character | Display name. |
display_names | character | |
filters | character | |
labels | character | |
names | character | Names. |
split_categories | character |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
espn_wnba_player_splits(athlete_id='4239')
Last validated n/a.
espn_wnba_leaders
ESPN endpoint.
Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/wnba/statistics/byathlete
| API Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
category | category | Y | category query parameter. | ||
season | season | Y | Season year (e.g. 2024). | ||
seasontype | season_type | Y | Season phase: 1=preseason, 2=regular season, 3=postseason. | ||
limit | limit | Y | Maximum number of items to return. | ||
page | page | Y | page query parameter. | ||
sort | sort | Y | sort query parameter. |
Returns
return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.
| col_name | type | description |
|---|---|---|
athletes | character | Athletes. |
glossary | character | Glossary. |
categories | character | Categories. |
pagination_count | integer | Pagination count. |
pagination_limit | integer | Pagination limit. |
pagination_page | integer | Pagination page. |
pagination_pages | integer | Pagination pages. |
pagination_first | character | Pagination first. |
pagination_next | character | Pagination next. |
pagination_last | character | Pagination last. |
league_id | character | League id. |
league_uid | character | League uid. |
league_name | character | League name. |
league_abbreviation | character | League abbreviation. |
league_slug | character | League slug. |
league_short_name | character | League short name. |
current_season_year | integer | Current season year. |
current_season_display_name | character | Current season display name. |
current_season_start_date | character | Current season start date. |
current_season_end_date | character | Current season end date. |
current_season_type_id | character | Current season type id. |
current_season_type_type | integer | Current season type type. |
current_season_type_name | character | Current season type name. |
current_season_type_start_date | character | Current season type start date. |
current_season_type_end_date | character | Current season type end date. |
requested_season_year | integer | Requested season year. |
requested_season_display_name | character | Requested season display name. |
requested_season_start_date | character | Requested season start date. |
requested_season_end_date | character | Requested season end date. |
requested_season_type_id | character | Requested season type id. |
requested_season_type_type | integer | Requested season type type. |
requested_season_type_name | character | Requested season type name. |
requested_season_type_start_date | character | Requested season type start date. |
requested_season_type_end_date | character | Requested season type end date. |
return_parsed=False — the raw JSON Dict payload, unparsed.
Example
espn_wnba_leaders()
Last validated n/a.