Skip to main content

Women's college basketball — ESPN CDN API (cdn.espn.com)

sportsdataverse.wbb — 4 endpoints.

espn_wbb_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/womens-college-basketball/playbyplay

Valid URL: https://cdn.espn.com/core/womens-college-basketball/playbyplay?xhr=1&gameId=401725017

API ParameterPythonPatternRequiredNullableDescription
gameIdgame_idYESPN game (event) id.

Returns​

return_parsed=True (default) — a dict of polars.DataFrames keyed by summary section (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

boxscore_player

col_nametypedescription
team_idInt64Team id.
team_abbreviationStringTeam abbreviation.
team_display_nameStringTeam display name.
team_locationStringTeam location.
athlete_idInt64Athlete id.
athlete_display_nameStringAthlete display name.
athlete_short_nameStringAthlete short name.
athlete_jerseyStringAthlete jersey.
athlete_positionStringAthlete position.
starterBooleanStarter.
activeStringActive.
did_not_playBooleanDid not play.
ejectedBooleanEjected.
reasonStringReason.
minutesStringMinutes.
pointsStringPoints.
field_goals_made_field_goals_attemptedStringField goals made field goals attempted.
three_point_field_goals_made_three_point_field_goals_attemptedStringThree point field goals made three point field goals attempted.
free_throws_made_free_throws_attemptedStringFree throws made free throws attempted.
reboundsStringRebounds.
assistsStringAssists.
turnoversStringTurnovers.
stealsStringSteals.
blocksStringBlocks.
offensive_reboundsStringOffensive rebounds.
defensive_reboundsStringDefensive rebounds.
foulsStringFouls.

boxscore_team

col_nametypedescription
team_idInt64Team id.
team_abbreviationStringTeam abbreviation.
team_display_nameStringTeam display name.
home_awayStringHome away.
display_orderInt64Display order.
stat_nameStringStat name.
stat_labelStringStat label.
stat_display_valueStringStat display value.
stat_valueStringStat value.

plays

col_nametypedescription
idInt64Id.
sequence_numberStringSequence number.
textStringText.
away_scoreInt64Away score.
home_scoreInt64Home score.
scoring_playBooleanScoring play.
score_valueInt64Score value.
wallclockStringWallclock.
shooting_playBooleanShooting play.
points_attemptedInt64Points attempted.
short_descriptionStringShort description.
type_idInt64Type id.
type_textStringType text.
period_numberInt64Period number.
period_display_valueStringPeriod display value.
clock_display_valueStringClock display value.
team_idInt64Team id.
coordinate_xInt64Coordinate x.
coordinate_yInt64Coordinate y.
participantsStringParticipants.

winprobability

col_nametypedescription
home_win_percentageFloat64Home win percentage.
tie_percentageFloat64Tie percentage.
play_idInt64Play id.

leaders

col_nametypedescription
team_idInt64Team id.
team_abbreviationStringTeam abbreviation.
category_nameStringCategory name.
category_display_nameStringCategory display name.
athlete_idInt64Athlete id.
athlete_display_nameStringAthlete display name.
athlete_positionStringAthlete position.
valueFloat64Value.
display_valueStringDisplay value.
main_statStringMain stat.
summaryStringSummary.

game_info

col_nametypedescription
attendanceInt64Attendance.
venue_idInt64Venue id.
venue_guidStringVenue guid.
venue_full_nameStringVenue full name.
venue_address_cityStringVenue address city.
venue_address_stateStringVenue address state.
venue_address_zip_codeStringPostal zip code of the venue where the game was played.
venue_grassBooleanVenue grass.

officials

col_nametypedescription
full_nameStringFull name.
display_nameStringDisplay name.
orderInt64Order.
position_nameStringPosition name.
position_display_nameStringPosition display name.
position_idInt64Position id.

header

col_nametypedescription
idInt64Id.
uidStringUid.
time_validBooleanTime valid.
competitionsStringCompetitions.
linksStringLinks.
weekInt64Week number.
game_noteStringOptional editorial note or context annotation attached to the game in the header.
season_yearInt64Season year.
season_currentBooleanSeason current.
season_typeInt64Season type.
league_idInt64League id.
league_uidStringLeague uid.
league_nameStringLeague name.
league_abbreviationStringLeague abbreviation.
league_midsize_nameStringMedium-length display name for the league or competition as shown in the game header.
league_slugStringLeague slug.
league_is_tournamentBooleanLeague is tournament.
league_linksStringLeague links.
league_logosStringLeague logos.

standings

col_nametypedescription
group_headerStringGroup header.
conference_headerStringConference header.
division_headerStringDivision header.
team_idInt64Team id.
team_uidStringTeam uid.
team_locationStringTeam location.
overallStringOverall.
games_behindStringGames behind.
vs. conf.StringTeam's record against conference opponents, shown as part of the standings snapshot in the box score.

broadcasts

col_nametypedescription
stationString
langStringLang.
regionStringRegion label.
is_nationalBooleanBoolean flag indicating whether the broadcast is a nationally distributed feed.
type_idInt64Type id.
type_short_nameStringType short name.
type_long_nameStringType long name.
type_slugString
market_idInt64Unique identifier for market.
market_typeStringMarket type.
media_call_lettersString
media_nameString
media_short_nameString

format

col_nametypedescription
regulation_periodsInt64Regulation periods.
regulation_display_nameStringRegulation display name.
regulation_slugStringRegulation slug.
regulation_clockFloat64Regulation clock.
overtime_display_nameStringOvertime display name.
overtime_slugStringOvertime slug.
overtime_clockFloat64Overtime clock.

news

col_nametypedescription
idInt64Id.
now_idStringNow id.
content_keyStringContent key.
data_source_identifierStringData source identifier.
typeStringType.
headlineStringHeadline.
descriptionStringDescription.
last_modifiedStringLast modified.
publishedStringPublished.
imagesStringImages.
categoriesStringCategories.
premiumBooleanPremium.
links_web_hrefStringLinks web href.
links_mobile_hrefStringLinks mobile href.
links_api_self_hrefStringLinks api self href.
links_app_sportscenter_hrefStringLinks app sportscenter href.
bylineStringByline.
links_web_self_hrefStringURL for the canonical web page of the associated article or editorial content.
links_web_self_dsi_hrefStringData-source-identified URL for the web page of the associated article content.
links_api_artwork_hrefStringAPI endpoint URL for artwork or imagery associated with the article.
links_sportscenter_hrefStringURL for the article's page on ESPN's SportsCenter platform.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_wbb_cdn_playbyplay(game_id='401725017')

espn_wbb_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/womens-college-basketball/boxscore

Valid URL: https://cdn.espn.com/core/womens-college-basketball/boxscore?xhr=1&gameId=401725017

API ParameterPythonPatternRequiredNullableDescription
gameIdgame_idYESPN game (event) id.

Returns​

return_parsed=True (default) — a dict of polars.DataFrames keyed by summary section (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

boxscore_player

col_nametypedescription
team_idInt64Team id.
team_abbreviationStringTeam abbreviation.
team_display_nameStringTeam display name.
team_locationStringTeam location.
athlete_idInt64Athlete id.
athlete_display_nameStringAthlete display name.
athlete_short_nameStringAthlete short name.
athlete_jerseyStringAthlete jersey.
athlete_positionStringAthlete position.
starterBooleanStarter.
activeStringActive.
did_not_playBooleanDid not play.
ejectedBooleanEjected.
reasonStringReason.
minutesStringMinutes.
pointsStringPoints.
field_goals_made_field_goals_attemptedStringField goals made field goals attempted.
three_point_field_goals_made_three_point_field_goals_attemptedStringThree point field goals made three point field goals attempted.
free_throws_made_free_throws_attemptedStringFree throws made free throws attempted.
reboundsStringRebounds.
assistsStringAssists.
turnoversStringTurnovers.
stealsStringSteals.
blocksStringBlocks.
offensive_reboundsStringOffensive rebounds.
defensive_reboundsStringDefensive rebounds.
foulsStringFouls.

boxscore_team

col_nametypedescription
team_idInt64Team id.
team_abbreviationStringTeam abbreviation.
team_display_nameStringTeam display name.
home_awayStringHome away.
display_orderInt64Display order.
stat_nameStringStat name.
stat_labelStringStat label.
stat_display_valueStringStat display value.
stat_valueStringStat value.

plays

col_nametypedescription
idInt64Id.
sequence_numberStringSequence number.
textStringText.
away_scoreInt64Away score.
home_scoreInt64Home score.
scoring_playBooleanScoring play.
score_valueInt64Score value.
wallclockStringWallclock.
shooting_playBooleanShooting play.
points_attemptedInt64Points attempted.
short_descriptionStringShort description.
type_idInt64Type id.
type_textStringType text.
period_numberInt64Period number.
period_display_valueStringPeriod display value.
clock_display_valueStringClock display value.
team_idInt64Team id.
coordinate_xInt64Coordinate x.
coordinate_yInt64Coordinate y.
participantsStringParticipants.

winprobability

col_nametypedescription
home_win_percentageFloat64Home win percentage.
tie_percentageFloat64Tie percentage.
play_idInt64Play id.

leaders

col_nametypedescription
team_idInt64Team id.
team_abbreviationStringTeam abbreviation.
category_nameStringCategory name.
category_display_nameStringCategory display name.
athlete_idInt64Athlete id.
athlete_display_nameStringAthlete display name.
athlete_positionStringAthlete position.
valueFloat64Value.
display_valueStringDisplay value.
main_statStringMain stat.
summaryStringSummary.

game_info

col_nametypedescription
attendanceInt64Attendance.
venue_idInt64Venue id.
venue_guidStringVenue guid.
venue_full_nameStringVenue full name.
venue_address_cityStringVenue address city.
venue_address_stateStringVenue address state.
venue_address_zip_codeStringPostal zip code of the venue where the game was played.
venue_grassBooleanVenue grass.

officials

col_nametypedescription
full_nameStringFull name.
display_nameStringDisplay name.
orderInt64Order.
position_nameStringPosition name.
position_display_nameStringPosition display name.
position_idInt64Position id.

header

col_nametypedescription
idInt64Id.
uidStringUid.
time_validBooleanTime valid.
competitionsStringCompetitions.
linksStringLinks.
weekInt64Week number.
game_noteStringOptional editorial note or context annotation attached to the game in the header.
season_yearInt64Season year.
season_currentBooleanSeason current.
season_typeInt64Season type.
league_idInt64League id.
league_uidStringLeague uid.
league_nameStringLeague name.
league_abbreviationStringLeague abbreviation.
league_midsize_nameStringMedium-length display name for the league or competition as shown in the game header.
league_slugStringLeague slug.
league_is_tournamentBooleanLeague is tournament.
league_linksStringLeague links.
league_logosStringLeague logos.

standings

col_nametypedescription
group_headerStringGroup header.
conference_headerStringConference header.
division_headerStringDivision header.
team_idInt64Team id.
team_uidStringTeam uid.
team_locationStringTeam location.
overallStringOverall.
games_behindStringGames behind.
vs. conf.StringTeam's record against conference opponents, shown as part of the standings snapshot in the box score.

broadcasts

col_nametypedescription
stationString
langStringLang.
regionStringRegion label.
is_nationalBooleanBoolean flag indicating whether the broadcast is a nationally distributed feed.
type_idInt64Type id.
type_short_nameStringType short name.
type_long_nameStringType long name.
type_slugString
market_idInt64Unique identifier for market.
market_typeStringMarket type.
media_call_lettersString
media_nameString
media_short_nameString

format

col_nametypedescription
regulation_periodsInt64Regulation periods.
regulation_display_nameStringRegulation display name.
regulation_slugStringRegulation slug.
regulation_clockFloat64Regulation clock.
overtime_display_nameStringOvertime display name.
overtime_slugStringOvertime slug.
overtime_clockFloat64Overtime clock.

news

col_nametypedescription
idInt64Id.
now_idStringNow id.
content_keyStringContent key.
data_source_identifierStringData source identifier.
typeStringType.
headlineStringHeadline.
descriptionStringDescription.
last_modifiedStringLast modified.
publishedStringPublished.
imagesStringImages.
categoriesStringCategories.
premiumBooleanPremium.
links_web_hrefStringLinks web href.
links_mobile_hrefStringLinks mobile href.
links_api_self_hrefStringLinks api self href.
links_app_sportscenter_hrefStringLinks app sportscenter href.
bylineStringByline.
links_web_self_hrefStringURL for the canonical web page of the associated article or editorial content.
links_web_self_dsi_hrefStringData-source-identified URL for the web page of the associated article content.
links_api_artwork_hrefStringAPI endpoint URL for artwork or imagery associated with the article.
links_sportscenter_hrefStringURL for the article's page on ESPN's SportsCenter platform.

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_wbb_cdn_boxscore(game_id='401725017')

espn_wbb_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/womens-college-basketball/schedule

Valid URL: https://cdn.espn.com/core/womens-college-basketball/schedule?xhr=1&date=20250115

API ParameterPythonPatternRequiredNullableDescription
datedateYSingle date (YYYYMMDD). Ignored by cfb and nfl, which are week-oriented. Defaults to today.
weekweekYWeek number (cfb and nfl).
yearseasonYSeason year that week belongs to (cfb and nfl).
seasontypeseason_typeYSeason 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_nametypedescription
game_idInt64ESPN event id.
uidStringESPN UID string.
dateStringMatch start timestamp (ISO 8601, UTC).
nameStringFull event name (e.g. 'Team A at Team B').
short_nameStringAbbreviated event name (e.g. 'TA @ TB').
season_yearInt64Integer season year ESPN assigns the event (e.g. 2025 for the 2025-26 season).
season_typeInt64ESPN season-type id of the event's season: 1 preseason, 2 regular season, 3 postseason, 4 offseason for the US leagues; soccer competitions carry their own competition-specific ids (e.g. 13481).
season_slugStringESPN slug of the event's season type (e.g. 'regular-season', 'post-season'; soccer competitions use their own, such as 'final' or 'torneo-apertura').
status_type_idInt64Unique identifier for status type.
status_type_nameStringStatus type name.
status_type_stateStringStatus type state.
status_type_completedBooleanStatus type completed.
status_type_descriptionStringStatus type description.
status_type_detailStringStatus type detail.
status_type_short_detailStringStatus type short detail.
status_clockFloat64Game clock in seconds as ESPN reports it: time remaining in the period for clock sports, elapsed seconds for soccer (e.g. 5400.0 at full time); 0.0 once a game has ended.
status_display_clockStringStatus display clock.
status_periodInt64Current or final period number (quarter, half, inning or period, depending on the sport).
neutral_siteBooleanWhether the match is played at a neutral venue.
conference_competitionBooleanConference competition.
attendanceInt64Reported attendance.
venue_idInt64Unique venue identifier.
venue_full_nameStringVenue full name.
venue_cityStringVenue city.
venue_stateStringVenue state / region.
venue_indoorBooleanTRUE if the venue is indoors.
broadcastStringEvery network name of the competition in feed order, deduped and ", "-joined (an entry with no names gives its market); "" when the game lists no broadcast.
noteStringEvent note text from the competition (e.g. a series or game label such as 'World Series - Game 1', or a shootout result); an empty string when there is none.
home_idInt64Unique identifier for home.
home_nameStringHome name.
home_abbreviationStringHome team's abbreviation.
home_display_nameStringHome display name.
home_locationStringHome team's location.
home_colorStringColor code (hex) for home.
home_alternate_colorStringColor code (hex) for home alternate.
home_logoStringHome team logo URL.
home_scoreStringHome team's score. For cricket, the innings string (e.g. '161/5 (18/20 ov, target 156)').
home_winnerBooleanHome team's winner.
home_rankString
away_idInt64Unique identifier for away.
away_nameStringAway name.
away_abbreviationStringAway team's abbreviation.
away_display_nameStringAway display name.
away_locationStringAway team's location.
away_colorStringColor code (hex) for away.
away_alternate_colorStringColor code (hex) for away alternate.
away_logoStringAway team logo URL.
away_scoreStringAway team's score. For cricket, the innings string.
away_winnerBooleanAway team's winner.
away_rankString

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_wbb_cdn_schedule(date='20250115')

espn_wbb_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/womens-college-basketball/scoreboard

Valid URL: https://cdn.espn.com/core/womens-college-basketball/scoreboard?xhr=1&date=20250115

API ParameterPythonPatternRequiredNullableDescription
datedateYSingle date (YYYYMMDD). Ignored by cfb and nfl, which are week-oriented. Defaults to today.
weekweekYWeek number (cfb and nfl).
yearseasonYSeason year that week belongs to (cfb and nfl).
seasontypeseason_typeYSeason 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_nametypedescription
game_idInt64ESPN event id.
uidStringESPN UID string.
dateStringMatch start timestamp (ISO 8601, UTC).
nameStringFull event name (e.g. 'Team A at Team B').
short_nameStringAbbreviated event name (e.g. 'TA @ TB').
season_yearInt64Integer season year ESPN assigns the event (e.g. 2025 for the 2025-26 season).
season_typeInt64ESPN season-type id of the event's season: 1 preseason, 2 regular season, 3 postseason, 4 offseason for the US leagues; soccer competitions carry their own competition-specific ids (e.g. 13481).
season_slugStringESPN slug of the event's season type (e.g. 'regular-season', 'post-season'; soccer competitions use their own, such as 'final' or 'torneo-apertura').
status_type_idInt64Unique identifier for status type.
status_type_nameStringStatus type name.
status_type_stateStringStatus type state.
status_type_completedBooleanStatus type completed.
status_type_descriptionStringStatus type description.
status_type_detailStringStatus type detail.
status_type_short_detailStringStatus type short detail.
status_clockFloat64Game clock in seconds as ESPN reports it: time remaining in the period for clock sports, elapsed seconds for soccer (e.g. 5400.0 at full time); 0.0 once a game has ended.
status_display_clockStringStatus display clock.
status_periodInt64Current or final period number (quarter, half, inning or period, depending on the sport).
neutral_siteBooleanWhether the match is played at a neutral venue.
conference_competitionBooleanConference competition.
attendanceInt64Reported attendance.
venue_idInt64Unique venue identifier.
venue_full_nameStringVenue full name.
venue_cityStringVenue city.
venue_stateStringVenue state / region.
venue_indoorBooleanTRUE if the venue is indoors.
broadcastStringEvery network name of the competition in feed order, deduped and ", "-joined (an entry with no names gives its market); "" when the game lists no broadcast.
noteStringEvent note text from the competition (e.g. a series or game label such as 'World Series - Game 1', or a shootout result); an empty string when there is none.
home_idInt64Unique identifier for home.
home_nameStringHome name.
home_abbreviationStringHome team's abbreviation.
home_display_nameStringHome display name.
home_locationStringHome team's location.
home_colorStringColor code (hex) for home.
home_alternate_colorStringColor code (hex) for home alternate.
home_logoStringHome team logo URL.
home_scoreStringHome team's score. For cricket, the innings string (e.g. '161/5 (18/20 ov, target 156)').
home_winnerBooleanHome team's winner.
home_rankString
away_idInt64Unique identifier for away.
away_nameStringAway name.
away_abbreviationStringAway team's abbreviation.
away_display_nameStringAway display name.
away_locationStringAway team's location.
away_colorStringColor code (hex) for away.
away_alternate_colorStringColor code (hex) for away alternate.
away_logoStringAway team logo URL.
away_scoreStringAway team's score. For cricket, the innings string.
away_winnerBooleanAway team's winner.
away_rankString

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

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.

Example​

espn_wbb_cdn_scoreboard(date='20250115')