Skip to main content
Version: 0.1.5

WNBA — ESPN core API (v2) — Other

espn_wnba_league_root​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription

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
abbreviationcharacterShort abbreviation.
colorcharacterPrimary color (hex without leading '#').
display_namecharacterDisplay name.
gendercharacter
guidcharacterStable cross-league team GUID.
idcharacterUnique play identification number
is_tournamentlogical
linkscharacter
logoscharacterLogos.
namecharacterDisplay name.
short_namecharacterShort display name.
slugcharacterURL-safe identifier.
uidcharacterESPN UID string.
athletes_$refcharacter
awards_$refcharacter
calendar_$refcharacter
draft_$refcharacter
events_$refcharacter
franchises_$refcharacter
group_$refcharacter
groups_$refcharacter
leaders_$refcharacter
notes_$refcharacter
rankings_$refcharacter
season_$refcharacter
season_athletes_$refcharacter
season_coaches_$refcharacter
season_display_namecharacterSeason display label.
season_end_datecharacterDate in YYYY-MM-DD format.
season_futures_$refcharacter
season_power_index_leaders_$refcharacter
season_power_indexes_$refcharacter
season_rankings_$refcharacter
season_start_datecharacterDate in YYYY-MM-DD format.
season_type_$refcharacter
season_type_abbreviationcharacterSeason type abbreviation.
season_type_corrections_$refcharacter
season_type_end_datecharacter
season_type_groups_$refcharacter
season_type_has_groupslogical
season_type_has_legslogical
season_type_has_standingslogical
season_type_idcharacterUnique identifier for season type.
season_type_namecharacterSeason type name.
season_type_slugcharacter
season_type_start_datecharacter
season_type_typeintegerSeason type type.
season_type_weeks_$refcharacter
season_type_yearinteger
season_types_$refcharacter
season_types_countinteger
season_types_itemscharacter
season_types_page_countinteger
season_types_page_indexinteger
season_types_page_sizeinteger
season_yearintegerSeason year string ('YYYY-YY' format).
seasons_$refcharacter
teams_$refcharacter
transactions_$refcharacter

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

Example​

espn_wnba_league_root()

Last validated n/a.

espn_wnba_seasons​

ESPN endpoint.

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

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/seasons?limit=200

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

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_seasons()

Last validated n/a.

espn_wnba_games​

ESPN endpoint.

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

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/events?limit=500

API ParameterPythonPatternRequiredNullableDescription
datesdatesYDate or date range filter (YYYYMMDD or YYYYMMDD-YYYYMMDD).
limitlimitYMaximum number of items to return.

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_games()

Last validated n/a.

espn_wnba_game​

ESPN endpoint.

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

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/events/401584793

API ParameterPythonPatternRequiredNullableDescription
event_idevent_idYevent_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
competitionscharacter
datecharacterDate in YYYY-MM-DD format.
idcharacterUnique play identification number
linkscharacter
namecharacterDisplay name.
short_namecharacterShort display name.
time_validlogicalTime valid.
uidcharacterESPN UID string.
venuescharacter
league_$refcharacter
season_$refcharacter
season_type_$refcharacter

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

Example​

espn_wnba_game(event_id='401584793')

Last validated n/a.

espn_wnba_teams_core​

ESPN endpoint.

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

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/teams?limit=1000&page=1

API ParameterPythonPatternRequiredNullableDescription
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
team_abbreviationcharacterShort team abbreviation (e.g. "BOS").
team_alternate_colorcharacterSecondary team color as a hex string (no leading '#').
team_colorcharacterPrimary team color as a hex string (no leading '#').
team_display_namecharacterFull team display name (location + nickname).
team_idcharacterESPN team id (stable join key across ESPN endpoints).
team_is_activelogicalWhether the team is currently active.
team_is_all_starlogicalWhether the entry is an all-star squad rather than a franchise.
team_locationcharacterTeam location / city (e.g. "Boston").
team_logoscharacterPipe-delimited logo image URLs.
team_namecharacterTeam nickname/mascot (e.g. "Celtics").
team_nicknamecharacterTeam nickname as ESPN labels it (often equals team_name).
team_short_display_namecharacterAbbreviated display name for compact UIs.
team_slugcharacterURL slug used in ESPN web paths.
team_uidcharacterESPN global UID (encodes sport/league/team).

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

Example​

espn_wnba_teams_core()

Last validated n/a.

espn_wnba_team_core​

ESPN endpoint.

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

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/teams/4

API ParameterPythonPatternRequiredNullableDescription
team_idteam_idYteam_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
abbreviationcharacterShort abbreviation.
alternate_colorcharacterAlternate color (hex without leading '#').
colorcharacterPrimary color (hex without leading '#').
display_namecharacterDisplay name.
guidcharacterStable cross-league team GUID.
idcharacterUnique play identification number
is_activelogicalWhether the team was active in this season.
is_all_starlogicalIs all star.
linkscharacter
locationcharacterFilter results by game location.
logoscharacterLogos.
namecharacterDisplay name.
short_display_namecharacterShort display name.
slugcharacterURL-safe identifier.
uidcharacterESPN UID string.
against_the_spread_records_$refcharacter
athletes_$refcharacter
awards_$refcharacter
coaches_$refcharacter
depth_charts_$refcharacter
events_$refcharacter
franchise_$refcharacter
groups_$refcharacter
injuries_$refcharacter
notes_$refcharacter
odds_records_$refcharacter
ranks_$refcharacter
record_$refcharacter
transactions_$refcharacter
venue_$refcharacter
venue_address_citycharacterVenue address city.
venue_address_statecharacterVenue address state / region.
venue_full_namecharacterVenue full name.
venue_grasslogical
venue_guidcharacter
venue_idcharacterUnique venue identifier.
venue_imagescharacter
venue_indoorlogicalTRUE if the venue is indoors.
venue_short_namecharacter

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

Example​

espn_wnba_team_core(team_id='4')

Last validated n/a.

espn_wnba_venues​

ESPN endpoint.

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

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/venues?limit=1000

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

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_venues()

Last validated n/a.

espn_wnba_venue​

ESPN endpoint.

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

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/venues/3663

API ParameterPythonPatternRequiredNullableDescription
venue_idvenue_idYvenue_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
full_namecharacterPlayer's full name.
grasslogicalGrass.
guidcharacterStable cross-league team GUID.
idcharacterUnique play identification number
imagescharacter
indoorlogicalIndoor.

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

Example​

espn_wnba_venue(venue_id='3663')

Last validated n/a.

espn_wnba_franchises​

ESPN endpoint.

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

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/franchises?limit=200

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

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_franchises()

Last validated n/a.

espn_wnba_franchise​

ESPN endpoint.

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

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/franchises/2

API ParameterPythonPatternRequiredNullableDescription
franchise_idfranchise_idYfranchise_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
abbreviationcharacterShort abbreviation.
colorcharacterPrimary color (hex without leading '#').
display_namecharacterDisplay name.
idcharacterUnique play identification number
is_activelogicalWhether the team was active in this season.
locationcharacterFilter results by game location.
namecharacterDisplay name.
short_display_namecharacterShort display name.
slugcharacterURL-safe identifier.
uidcharacterESPN UID string.
team_$refcharacter
venue_$refcharacter
venue_address_citycharacterVenue address city.
venue_address_statecharacterVenue address state / region.
venue_full_namecharacterVenue full name.
venue_grasslogical
venue_guidcharacter
venue_idcharacterUnique venue identifier.
venue_imagescharacter
venue_indoorlogicalTRUE if the venue is indoors.
venue_short_namecharacter

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

Example​

espn_wnba_franchise(franchise_id='2')

Last validated n/a.

espn_wnba_coach​

ESPN endpoint.

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

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/coaches/1

API ParameterPythonPatternRequiredNullableDescription
coach_idcoach_idYcoach_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
career_recordscharacter
coach_seasonscharacter
experienceintegerYears of professional experience.
first_namecharacterPlayer's first name.
idcharacterUnique play identification number
last_namecharacterPlayer's last name.
uidcharacterESPN UID string.
birth_place_citycharacterBirth place city.
birth_place_statecharacterBirth place state.

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

Example​

espn_wnba_coach(coach_id='1')

Last validated n/a.

espn_wnba_coach_record​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/coaches/{coach_id}/record/{record_type}

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/coaches/1/record/0

API ParameterPythonPatternRequiredNullableDescription
coach_idcoach_idYcoach_id path parameter.
record_typerecord_typeYrecord_type 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
display_valuecharacterDisplay-formatted value.
idcharacterUnique play identification number
namecharacterDisplay name.
statscharacterStats.
summarycharacterSummary.
typecharacterRecord type / category.
valuedoubleNumeric or string value field.

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

Example​

espn_wnba_coach_record(coach_id='1')

Last validated n/a.

espn_wnba_coach_season​

ESPN endpoint.

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/coaches/{coach_id}/seasons/{season}

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/coaches/1/seasons/2024

API ParameterPythonPatternRequiredNullableDescription
coach_idcoach_idYcoach_id path parameter.
seasonseasonYseason 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_coach_season(coach_id='1', season=2024)

Last validated n/a.

espn_wnba_positions​

ESPN endpoint.

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

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/positions?limit=200

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

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_positions()

Last validated n/a.

espn_wnba_position​

ESPN endpoint.

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

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/positions/1

API ParameterPythonPatternRequiredNullableDescription
position_idposition_idYposition_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
abbreviationcharacterShort abbreviation.
display_namecharacterDisplay name.
idcharacterUnique play identification number
leaflogical
namecharacterDisplay name.
parent_$refcharacter

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

Example​

espn_wnba_position(position_id='1')

Last validated n/a.

espn_wnba_tournaments​

ESPN endpoint.

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

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/tournaments?limit=200

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

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_tournaments()

Last validated n/a.

espn_wnba_awards​

ESPN endpoint.

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

Valid URL: https://sports.core.api.espn.com/v2/sports/basketball/leagues/wnba/awards?limit=200

API ParameterPythonPatternRequiredNullableDescription
limitlimitYMaximum number of items to return.

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_awards()

Last validated n/a.

espn_wnba_award​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription
award_idaward_idYaward_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
countintegerCount of count.
itemscharacter
page_countinteger
page_indexinteger
page_sizeinteger

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

Example​

espn_wnba_award(award_id='1')

Last validated n/a.

espn_wnba_standings_core​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
group_namecharacterGroup name.
group_abbreviationcharacterGroup abbreviation.
team_idcharacterTeam id.
team_namecharacterTeam name.
team_abbreviationcharacterTeam abbreviation.
team_display_namecharacterTeam display name.
team_locationcharacterTeam location.
team_logocharacterTeam logo.
avg_points_againstdoubleAvg points against.
avg_points_fordoubleAvg points for.
clincherdoubleClincher.
differentialdoubleDifferential.
division_win_percentdoubleDivision win percent.
games_behinddoubleGames behind.
league_win_percentdoubleLeague win percent.
lossesdoubleLosses.
playoff_seeddoublePlayoff seed.
point_differentialdoublePoint differential.
pointsdoublePoints.
points_againstdoublePoints against.
points_fordoublePoints for.
streakdoubleStreak.
win_percentdoubleWin percent.
winsdoubleWins.
games_aheaddoubleGames ahead.
overallcharacterOverall.
homecharacterHome.
roadcharacterRoad.
vs. div.characterVs. div..
vs. conf.characterVs. conf..
last ten gamescharacterLast ten games.

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

Example​

espn_wnba_standings_core()

Last validated n/a.

espn_wnba_leaders_core​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription

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, nfl, mlb, nhl, 2026-10-07); its rows sit under keys it does not read (top level: $ref, abbreviation, categories, id, name, type).

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

Example​

espn_wnba_leaders_core()

Last validated n/a.

espn_wnba_league_notes​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription

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_league_notes()

Last validated n/a.

espn_wnba_talentpicks​

ESPN endpoint.

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

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

API ParameterPythonPatternRequiredNullableDescription

Returns​

return_parsed=True (default) — a tidy polars.DataFrame with the columns below; pass return_as_pandas=True for a pandas.DataFrame.

col_nametypedescription
pick_competition_$refcharacter
pick_competitor_$refcharacter
pick_correctlogical
pick_person_display_namecharacter
pick_person_first_namecharacter
pick_person_headshot_altcharacter
pick_person_headshot_hrefcharacter
pick_person_idcharacter
pick_person_last_namecharacter
week_record_display_valuecharacter
week_record_season_$refcharacter
week_record_statscharacter

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

Example​

espn_wnba_talentpicks()

Last validated n/a.