Skip to main content

WNBA — ESPN core API (v2) — Player

espn_wnba_players_index​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes?active=true&limit=100&page=1

API ParameterPythonPatternRequiredNullableDescription
activeactiveYactive query parameter.
limitlimitYMaximum number of items to return.
pagepageYpage 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_nametypedescription
$refcharacter

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

espn_wnba_players_index()

Last validated n/a.

espn_wnba_player_core​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/{athlete_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/4239

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_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_nametypedescription
$refcharacter
activelogicalTRUE if the row represents an active record (player / team / season).
ageintegerPlayer age (in years).
date_of_birthcharacterDate of birth (YYYY-MM-DD).
debut_yearintegerYear of professional debut.
display_heightcharacterPlayer height in display format (e.g. '6-2').
display_namecharacterDisplay name.
display_weightcharacterPlayer weight in display format (e.g. '180 lbs').
first_namecharacterPlayer's first name.
full_namecharacterPlayer's full name.
guidcharacterStable cross-league team GUID.
heightdoublePlayer height (string e.g. '6-2' or inches).
idcharacterUnique play identification number
jerseycharacterJersey number worn by the player.
last_namecharacterPlayer's last name.
linkedlogicalTRUE if the record is linked to a related entity.
linkscharacter
short_namecharacterShort display name.
slugcharacterURL-safe identifier.
typecharacterRecord type / category.
uidcharacterESPN UID string.
weightdoublePlayer weight in pounds.
alternate_ids_sdrcharacter
birth_place_citycharacterBirth place city.
birth_place_statecharacterBirth place state.
college_$refcharacter
college_athlete_$refcharacter
contracts_$refcharacter
draft_display_textcharacterDraft display text.
draft_pick_$refcharacter
draft_roundintegerRound of the draft selection.
draft_selectionintegerDraft selection.
draft_team_$refcharacter
draft_yearintegerDraft year (4-digit).
experience_yearsintegerExperience years.
hand_abbreviationcharacterHand abbreviation.
hand_display_valuecharacterHand display value.
hand_typecharacterHand type.
headshot_altcharacterAlternative-text label for the headshot.
headshot_hrefcharacterHeadshot image URL.
position_$refcharacter
position_abbreviationcharacterPosition abbreviation ('G' / 'F' / 'C').
position_display_namecharacterPosition display name.
position_idcharacterUnique position identifier.
position_leaflogicalPosition leaf.
position_namecharacterListed roster position ('Guard', 'Forward', 'Center').
seasons_$refcharacter
statistics_$refcharacter
statisticslog_$refcharacter
status_abbreviationcharacterStatus abbreviation.
status_idcharacterStatus identifier.
status_namecharacterStatus label.
status_typecharacterStatus type.
team_$refcharacter

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

espn_wnba_player_core(athlete_id='4239')

Last validated n/a.

espn_wnba_player_career_stats​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/{athlete_id}/statistics[/{stat_type}]

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/4239/statistics

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_id path parameter.
stat_typestat_typeYstat_type path parameter.

Returns​

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: parser: parse_items returns no columns on the live payload (nba, mlb, mbb, 2026-10-07); its rows sit under keys it does not read (top level: $ref, athlete, splits).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

espn_wnba_player_career_stats(athlete_id='4239')

Last validated n/a.

espn_wnba_player_statisticslog​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/{athlete_id}/statisticslog

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/4239/statisticslog

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_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_nametypedescription
statisticscharacter
season_$refcharacter

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

espn_wnba_player_statisticslog(athlete_id='4239')

Last validated n/a.

espn_wnba_player_eventlog​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/{athlete_id}/eventlog

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/4239/eventlog

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_id path parameter.

Returns​

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: 404 in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

espn_wnba_player_eventlog(athlete_id='4239')

Last validated n/a.

espn_wnba_player_contracts​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/{athlete_id}/contracts

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/4239/contracts

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_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_nametypedescription
$refcharacter

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

espn_wnba_player_contracts(athlete_id='4239')

Last validated n/a.

espn_wnba_player_awards​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/{athlete_id}/awards

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/4239/awards

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_id path parameter.

Returns​

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: the page holds zero items (count 0) in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

espn_wnba_player_awards(athlete_id='4239')

Last validated n/a.

espn_wnba_player_seasons​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/{athlete_id}/seasons

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/4239/seasons

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_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_nametypedescription
$refcharacter

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

espn_wnba_player_seasons(athlete_id='4239')

Last validated n/a.

espn_wnba_player_records​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/{athlete_id}/records

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/4239/records

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_id path parameter.

Returns​

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: the page holds zero items (count 0) in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

espn_wnba_player_records(athlete_id='4239')

Last validated n/a.

espn_wnba_player_injuries​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/{athlete_id}/injuries

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/4239/injuries

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_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_nametypedescription
idcharacterESPN numeric identifier for the athlete.
display_namecharacterAthlete's full display name as shown on ESPN.
injuriescharacterInjury entries for the athlete (list of dicts, stringified): status, type, details, dates.

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

espn_wnba_player_injuries(athlete_id='4239')

Last validated n/a.

espn_wnba_player_notes​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/{athlete_id}/notes

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/4239/notes

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_id path parameter.

Returns​

return_parsed=True (default) — the output of parse_items; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: 404 in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

espn_wnba_player_notes(athlete_id='4239')

Last validated n/a.

espn_wnba_player_vs_player​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/{athlete_id}/vsathlete/{opp_id}

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/athletes/4239/vsathlete/5

API ParameterPythonPatternRequiredNullableDescription
athlete_idathlete_idYathlete_id path parameter.
opp_idopp_idYopp_id path parameter.

Returns​

return_parsed=True (default) — the output of parse_single_entity; pass return_as_pandas=True for a pandas.DataFrame.

No returns table is published for this endpoint: no capture: 404 in nba, nfl, mlb, nhl, wnba, cfb, mbb, wbb with the documented example arguments (2026-10-07).

return_parsed=False — the raw JSON Dict payload, unparsed.

Example​

espn_wnba_player_vs_player(athlete_id='4239', opp_id='5')

Last validated n/a.