WNBA — ESPN CDN API (cdn.espn.com)

sportsdataverse.wnba — 4 endpoints.

espn_wnba_cdn_playbyplay

One game's espn.com play-by-play page data. The gamepackageJSON block is a Site v2 summary (header, boxscore, plays or drives, win probability, ...), so the parsed result is the same dict of frames that parse_summary returns.

Endpoint URL: GET https://cdn.espn.com/core/wnba/playbyplay

Valid URL: https://cdn.espn.com/core/wnba/playbyplay?xhr=1&gameId=401705127

API Parameter	Python	Pattern	Required	Nullable	Description
gameId	game_id		Y		ESPN game (event) id.

Returns

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

col_name	type	description
team_id	character	Team id.
team_abbreviation	character	Team abbreviation.
team_display_name	character	Team display name.
team_location	character	Team location.
athlete_id	character	Athlete id.
athlete_display_name	character	Athlete display name.
athlete_short_name	character	Athlete short name.
athlete_jersey	character	Athlete jersey.
athlete_position	character	Athlete position.
starter	logical	Starter.
active	logical	Active.
did_not_play	logical	Did not play.
ejected	logical	Ejected.
reason	character	Reason.
minutes	character	Minutes.
points	character	Points.
field_goals_made_field_goals_attempted	character	Field goals made field goals attempted.
three_point_field_goals_made_three_point_field_goals_attempted	character	Three point field goals made three point field goals attempted.
free_throws_made_free_throws_attempted	character	Free throws made free throws attempted.
rebounds	character	Rebounds.
assists	character	Assists.
turnovers	character	Turnovers.
steals	character	Steals.
blocks	character	Blocks.
offensive_rebounds	character	Offensive rebounds.
defensive_rebounds	character	Defensive rebounds.
fouls	character	Fouls.
plus_minus	character	Plus minus.

boxscore_team

col_name	type	description
team_id	character	Team id.
team_abbreviation	character	Team abbreviation.
team_display_name	character	Team display name.
home_away	character	Home away.
display_order	integer	Display order.
stat_name	character	Stat name.
stat_label	character	Stat label.
stat_display_value	character	Stat display value.
stat_value	character	Stat value.

plays

col_name	type	description
id	character	Id.
sequence_number	character	Sequence number.
text	character	Text.
away_score	integer	Away score.
home_score	integer	Home score.
scoring_play	logical	Scoring play.
score_value	integer	Score value.
participants	character	Participants.
wallclock	character	Wallclock.
shooting_play	logical	Shooting play.
points_attempted	integer	Points attempted.
short_description	character	Short description.
type_id	character	Type id.
type_text	character	Type text.
period_number	integer	Period number.
period_display_value	character	Period display value.
clock_display_value	character	Clock display value.
team_id	character	Team id.
coordinate_x	integer	Coordinate x.
coordinate_y	integer	Coordinate y.

winprobability

col_name	type	description
home_win_percentage	double	Home win percentage.
tie_percentage	double	Tie percentage.
play_id	character	Play id.

leaders

col_name	type	description
team_id	character	Team id.
team_abbreviation	character	Team abbreviation.
category_name	character	Category name.
category_display_name	character	Category display name.
athlete_id	character	Athlete id.
athlete_display_name	character	Athlete display name.
athlete_position	character	Athlete position.
value	double	Value.
display_value	character	Display value.
main_stat	character	Main stat.
summary	character	Summary.

game_info

col_name	type	description
attendance	integer	Attendance.
venue_id	character	Venue id.
venue_guid	character	Venue guid.
venue_full_name	character	Venue full name.
venue_address_city	character	Venue address city.
venue_address_state	character	Venue address state.
venue_grass	logical	Venue grass.

officials

col_name	type	description
full_name	character	Full name.
display_name	character	Display name.
order	integer	Order.
position_name	character	Position name.
position_display_name	character	Position display name.
position_id	character	Position id.

header

col_name	type	description
id	character	Id.
uid	character	Uid.
time_valid	logical	Time valid.
competitions	character	Competitions.
links	character	Links.
game_note	character	Optional editorial note or context annotation attached to the game in the header.
season_year	integer	Season year.
season_current	logical	Season current.
season_type	integer	Season type.
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_is_tournament	logical	League is tournament.
league_links	character	League links.
league_logos	character	League logos.

season_series

col_name	type	description
type	character	Type.
title	character	Title.
description	character	Description.
summary	character	Summary.
completed	logical	Completed.
total_competitions	integer	Total competitions.
series_label	character	Series label.
series_score	character	Series score.
short_summary	character	Short summary.
events	character	Events.
round	character	Tournament / playoff round.

standings

col_name	type	description
group_header	character	Group header.
conference_header	character	Conference header.
division_header	character	Division header.
team_id	character	Team id.
team_uid	character	Team uid.
team_location	character	Team location.
games_behind	character	Games behind.
losses	character	Losses.
streak	character	Streak.
win_percent	character	Win percent.
wins	character	Wins.

format

col_name	type	description
regulation_periods	integer	Regulation periods.
regulation_display_name	character	Regulation display name.
regulation_slug	character	Regulation slug.
regulation_clock	double	Regulation clock.
overtime_display_name	character	Overtime display name.
overtime_slug	character	Overtime slug.
overtime_clock	double	Overtime clock.

article

col_name	type	description
id	integer	Id.
now_id	character	Now id.
content_key	character	Content key.
data_source_identifier	character	Data source identifier.
publishedkey	character	Publishedkey.
type	character	Type.
game_id	character	Game id.
headline	character	Headline.
description	character	Description.
link_text	character	Link text.
categorized	character	Categorized.
originally_posted	character	Originally posted.
last_modified	character	Last modified.
published	character	Published.
section	character	Section.
source	character	Source.
images	character	Images.
video	character	Video.
categories	character	Categories.
keywords	character	Keywords.
story	character	Story.
premium	logical	Premium.
is_live_blog	logical	Is live blog.
allow_comments	logical	Allow comments.
allow_search	logical	Allow search.
allow_content_reactions	logical	Allow content reactions.
links_web_href	character	Links web href.
links_mobile_href	character	Links mobile href.
links_api_self_href	character	Links api self href.
links_app_sportscenter_href	character	Links app sportscenter href.

injuries

col_name	type	description
injuries	character	Injuries.
team_id	character	Team id.
team_uid	character	Team uid.
team_display_name	character	Team display name.
team_abbreviation	character	Team abbreviation.
team_links	character	Team links.
team_logo	character	Team logo.
team_logos	character	Team logos.

news

col_name	type	description
id	integer	Id.
now_id	character	Now id.
content_key	character	Content key.
data_source_identifier	character	Data source identifier.
type	character	Type.
headline	character	Headline.
description	character	Description.
last_modified	character	Last modified.
published	character	Published.
images	character	Images.
categories	character	Categories.
premium	logical	Premium.
links_web_href	character	Links web href.
links_mobile_href	character	Links mobile href.
links_api_self_href	character	Links api self href.
links_app_sportscenter_href	character	Links app sportscenter href.
byline	character	Byline.
links_web_self_href	character	URL for the canonical web page of the associated article or editorial content.
links_web_self_dsi_href	character	Data-source-identified URL for the web page of the associated article content.
links_api_artwork_href	character	API endpoint URL for artwork or imagery associated with the article.
links_sportscenter_href	character	URL for the article's page on ESPN's SportsCenter platform.

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

Example

espn_wnba_cdn_playbyplay(game_id='401705127')

Last validated n/a.

espn_wnba_cdn_boxscore

One game's espn.com box-score page data, parsed like a Site v2 summary. For football the drives and scoring plays are only on the playbyplay page.

Endpoint URL: GET https://cdn.espn.com/core/wnba/boxscore

Valid URL: https://cdn.espn.com/core/wnba/boxscore?xhr=1&gameId=401705127

API Parameter	Python	Pattern	Required	Nullable	Description
gameId	game_id		Y		ESPN game (event) id.

Returns

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

col_name	type	description
team_id	character	Team id.
team_abbreviation	character	Team abbreviation.
team_display_name	character	Team display name.
team_location	character	Team location.
athlete_id	character	Athlete id.
athlete_display_name	character	Athlete display name.
athlete_short_name	character	Athlete short name.
athlete_jersey	character	Athlete jersey.
athlete_position	character	Athlete position.
starter	logical	Starter.
active	logical	Active.
did_not_play	logical	Did not play.
ejected	logical	Ejected.
reason	character	Reason.
minutes	character	Minutes.
points	character	Points.
field_goals_made_field_goals_attempted	character	Field goals made field goals attempted.
three_point_field_goals_made_three_point_field_goals_attempted	character	Three point field goals made three point field goals attempted.
free_throws_made_free_throws_attempted	character	Free throws made free throws attempted.
rebounds	character	Rebounds.
assists	character	Assists.
turnovers	character	Turnovers.
steals	character	Steals.
blocks	character	Blocks.
offensive_rebounds	character	Offensive rebounds.
defensive_rebounds	character	Defensive rebounds.
fouls	character	Fouls.
plus_minus	character	Plus minus.

boxscore_team

col_name	type	description
team_id	character	Team id.
team_abbreviation	character	Team abbreviation.
team_display_name	character	Team display name.
home_away	character	Home away.
display_order	integer	Display order.
stat_name	character	Stat name.
stat_label	character	Stat label.
stat_display_value	character	Stat display value.
stat_value	character	Stat value.

plays

col_name	type	description
id	character	Id.
sequence_number	character	Sequence number.
text	character	Text.
away_score	integer	Away score.
home_score	integer	Home score.
scoring_play	logical	Scoring play.
score_value	integer	Score value.
participants	character	Participants.
wallclock	character	Wallclock.
shooting_play	logical	Shooting play.
points_attempted	integer	Points attempted.
short_description	character	Short description.
type_id	character	Type id.
type_text	character	Type text.
period_number	integer	Period number.
period_display_value	character	Period display value.
clock_display_value	character	Clock display value.
team_id	character	Team id.
coordinate_x	integer	Coordinate x.
coordinate_y	integer	Coordinate y.

winprobability

col_name	type	description
home_win_percentage	double	Home win percentage.
tie_percentage	double	Tie percentage.
play_id	character	Play id.

leaders

col_name	type	description
team_id	character	Team id.
team_abbreviation	character	Team abbreviation.
category_name	character	Category name.
category_display_name	character	Category display name.
athlete_id	character	Athlete id.
athlete_display_name	character	Athlete display name.
athlete_position	character	Athlete position.
value	double	Value.
display_value	character	Display value.
main_stat	character	Main stat.
summary	character	Summary.

game_info

col_name	type	description
attendance	integer	Attendance.
venue_id	character	Venue id.
venue_guid	character	Venue guid.
venue_full_name	character	Venue full name.
venue_address_city	character	Venue address city.
venue_address_state	character	Venue address state.
venue_grass	logical	Venue grass.

officials

col_name	type	description
full_name	character	Full name.
display_name	character	Display name.
order	integer	Order.
position_name	character	Position name.
position_display_name	character	Position display name.
position_id	character	Position id.

header

col_name	type	description
id	character	Id.
uid	character	Uid.
time_valid	logical	Time valid.
competitions	character	Competitions.
links	character	Links.
game_note	character	Optional editorial note or context annotation attached to the game in the header.
season_year	integer	Season year.
season_current	logical	Season current.
season_type	integer	Season type.
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_is_tournament	logical	League is tournament.
league_links	character	League links.
league_logos	character	League logos.

season_series

col_name	type	description
type	character	Type.
title	character	Title.
description	character	Description.
summary	character	Summary.
completed	logical	Completed.
total_competitions	integer	Total competitions.
series_label	character	Series label.
series_score	character	Series score.
short_summary	character	Short summary.
events	character	Events.
round	character	Tournament / playoff round.

standings

col_name	type	description
group_header	character	Group header.
conference_header	character	Conference header.
division_header	character	Division header.
team_id	character	Team id.
team_uid	character	Team uid.
team_location	character	Team location.
games_behind	character	Games behind.
losses	character	Losses.
streak	character	Streak.
win_percent	character	Win percent.
wins	character	Wins.

format

col_name	type	description
regulation_periods	integer	Regulation periods.
regulation_display_name	character	Regulation display name.
regulation_slug	character	Regulation slug.
regulation_clock	double	Regulation clock.
overtime_display_name	character	Overtime display name.
overtime_slug	character	Overtime slug.
overtime_clock	double	Overtime clock.

article

col_name	type	description
id	integer	Id.
now_id	character	Now id.
content_key	character	Content key.
data_source_identifier	character	Data source identifier.
publishedkey	character	Publishedkey.
type	character	Type.
game_id	character	Game id.
headline	character	Headline.
description	character	Description.
link_text	character	Link text.
categorized	character	Categorized.
originally_posted	character	Originally posted.
last_modified	character	Last modified.
published	character	Published.
section	character	Section.
source	character	Source.
images	character	Images.
video	character	Video.
categories	character	Categories.
keywords	character	Keywords.
story	character	Story.
premium	logical	Premium.
is_live_blog	logical	Is live blog.
allow_comments	logical	Allow comments.
allow_search	logical	Allow search.
allow_content_reactions	logical	Allow content reactions.
links_web_href	character	Links web href.
links_mobile_href	character	Links mobile href.
links_api_self_href	character	Links api self href.
links_app_sportscenter_href	character	Links app sportscenter href.

injuries

col_name	type	description
injuries	character	Injuries.
team_id	character	Team id.
team_uid	character	Team uid.
team_display_name	character	Team display name.
team_abbreviation	character	Team abbreviation.
team_links	character	Team links.
team_logo	character	Team logo.
team_logos	character	Team logos.

news

col_name	type	description
id	integer	Id.
now_id	character	Now id.
content_key	character	Content key.
data_source_identifier	character	Data source identifier.
type	character	Type.
headline	character	Headline.
description	character	Description.
last_modified	character	Last modified.
published	character	Published.
images	character	Images.
categories	character	Categories.
premium	logical	Premium.
links_web_href	character	Links web href.
links_mobile_href	character	Links mobile href.
links_api_self_href	character	Links api self href.
links_app_sportscenter_href	character	Links app sportscenter href.
byline	character	Byline.
links_web_self_href	character	URL for the canonical web page of the associated article or editorial content.
links_web_self_dsi_href	character	Data-source-identified URL for the web page of the associated article content.
links_api_artwork_href	character	API endpoint URL for artwork or imagery associated with the article.
links_sportscenter_href	character	URL for the article's page on ESPN's SportsCenter platform.

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

Example

espn_wnba_cdn_boxscore(game_id='401705127')

Last validated n/a.

espn_wnba_cdn_schedule

espn.com schedule page data, one row per game: up to 7 days starting at date (mbb and wbb: that day only; cfb and nfl: one week).

Endpoint URL: GET https://cdn.espn.com/core/wnba/schedule

Valid URL: https://cdn.espn.com/core/wnba/schedule?xhr=1&date=20250115

API Parameter	Python	Pattern	Required	Nullable	Description
date	date			Y	Single date (YYYYMMDD). Ignored by cfb and nfl, which are week-oriented. Defaults to today.
week	week			Y	Week number (cfb and nfl).
year	season			Y	Season year that week belongs to (cfb and nfl).
seasontype	season_type			Y	Season phase for week: 1=preseason, 2=regular season, 3=postseason (cfb and nfl).

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
game_id	character	ESPN event id.
uid	character	ESPN UID string.
date	character	Match start timestamp (ISO 8601, UTC).
name	character	Full event name (e.g. 'Team A at Team B').
short_name	character	Abbreviated event name (e.g. 'TA @ TB').
season_year	integer	Season year string ('YYYY-YY' format).
season_type	integer	Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
season_slug	character	Season slug.
status_type_id	character	Unique identifier for status type.
status_type_name	character	Status type name.
status_type_state	character	Status type state.
status_type_completed	logical	Status type completed.
status_type_description	character	Status type description.
status_type_detail	character	Status type detail.
status_type_short_detail	character	Status type short detail.
status_clock	double	Status clock.
status_display_clock	character	Status display clock.
status_period	integer	Status period.
neutral_site	logical	Whether the match is played at a neutral venue.
conference_competition	logical	Conference competition.
attendance	integer	Reported attendance.
venue_id	character	Unique venue identifier.
venue_full_name	character	Venue full name.
venue_city	character	Venue city.
venue_state	character	Venue state / region.
venue_indoor	logical	TRUE if the venue is indoors.
broadcast	character	Broadcast information string.
note	character	Injury status and description.
home_id	character	Unique identifier for home.
home_name	character	Home name.
home_abbreviation	character	Home team's abbreviation.
home_display_name	character	Home display name.
home_location	character	Home team's location.
home_color	character	Color code (hex) for home.
home_alternate_color	character	Color code (hex) for home alternate.
home_logo	character	Home team logo URL.
home_score	character	Home team's score. For cricket, the innings string (e.g. '161/5 (18/20 ov, target 156)').
home_winner	logical	Home team's winner.
home_rank	character	Home team rank (if ranked).
away_id	character	Unique identifier for away.
away_name	character	Away name.
away_abbreviation	character	Away team's abbreviation.
away_display_name	character	Away display name.
away_location	character	Away team's location.
away_color	character	Color code (hex) for away.
away_alternate_color	character	Color code (hex) for away alternate.
away_logo	character	Away team logo URL.
away_score	character	Away team's score. For cricket, the innings string.
away_winner	logical	Away team's winner.
away_rank	character	Away team rank (if ranked).

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

Example

espn_wnba_cdn_schedule(date='20250115')

Last validated n/a.

espn_wnba_cdn_scoreboard

espn.com scoreboard page data for one day (one week for football), one row per game. The page's sbData block is a Site v2 scoreboard payload.

Endpoint URL: GET https://cdn.espn.com/core/wnba/scoreboard

Valid URL: https://cdn.espn.com/core/wnba/scoreboard?xhr=1&date=20250115

API Parameter	Python	Pattern	Required	Nullable	Description
date	date			Y	Single date (YYYYMMDD). Ignored by cfb and nfl, which are week-oriented. Defaults to today.
week	week			Y	Week number (cfb and nfl).
year	season			Y	Season year that week belongs to (cfb and nfl).
seasontype	season_type			Y	Season phase for week: 1=preseason, 2=regular season, 3=postseason (cfb and nfl).

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
game_id	character	ESPN event id.
uid	character	ESPN UID string.
date	character	Match start timestamp (ISO 8601, UTC).
name	character	Full event name (e.g. 'Team A at Team B').
short_name	character	Abbreviated event name (e.g. 'TA @ TB').
season_year	integer	Season year string ('YYYY-YY' format).
season_type	integer	Season type (1=pre-season, 2=regular season, 3=postseason, 4=off-season for ESPN; or string label for WNBA Stats).
season_slug	character	Season slug.
status_type_id	character	Unique identifier for status type.
status_type_name	character	Status type name.
status_type_state	character	Status type state.
status_type_completed	logical	Status type completed.
status_type_description	character	Status type description.
status_type_detail	character	Status type detail.
status_type_short_detail	character	Status type short detail.
status_clock	double	Status clock.
status_display_clock	character	Status display clock.
status_period	integer	Status period.
neutral_site	logical	Whether the match is played at a neutral venue.
conference_competition	logical	Conference competition.
attendance	integer	Reported attendance.
venue_id	character	Unique venue identifier.
venue_full_name	character	Venue full name.
venue_city	character	Venue city.
venue_state	character	Venue state / region.
venue_indoor	logical	TRUE if the venue is indoors.
broadcast	character	Broadcast information string.
note	character	Injury status and description.
home_id	character	Unique identifier for home.
home_name	character	Home name.
home_abbreviation	character	Home team's abbreviation.
home_display_name	character	Home display name.
home_location	character	Home team's location.
home_color	character	Color code (hex) for home.
home_alternate_color	character	Color code (hex) for home alternate.
home_logo	character	Home team logo URL.
home_score	character	Home team's score. For cricket, the innings string (e.g. '161/5 (18/20 ov, target 156)').
home_winner	logical	Home team's winner.
home_rank	character	Home team rank (if ranked).
away_id	character	Unique identifier for away.
away_name	character	Away name.
away_abbreviation	character	Away team's abbreviation.
away_display_name	character	Away display name.
away_location	character	Away team's location.
away_color	character	Color code (hex) for away.
away_alternate_color	character	Color code (hex) for away alternate.
away_logo	character	Away team logo URL.
away_score	character	Away team's score. For cricket, the innings string.
away_winner	logical	Away team's winner.
away_rank	character	Away team rank (if ranked).

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

Example

espn_wnba_cdn_scoreboard(date='20250115')

Last validated n/a.