WBB — 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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
gameId | game_id | Y | ESPN game (event) id. |
Returns
return_parsed=True (default) — a dict of polars.DataFrames keyed by summary section (representative columns below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).
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 | character | 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. |
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. |
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. |
participants | character | Participants. |
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_address_zip_code | character | Postal zip code of the venue where the game was played. |
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. |
week | integer | Week number. |
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_midsize_name | character | Medium-length display name for the league or competition as shown in the game header. |
league_slug | character | League slug. |
league_is_tournament | logical | League is tournament. |
league_links | character | League links. |
league_logos | character | League logos. |
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. |
overall | character | Overall. |
games_behind | character | Games behind. |
vs. conf. | character | Team's record against conference opponents, shown as part of the standings snapshot in the box score. |
broadcasts
| col_name | type | description |
|---|---|---|
station | character | Station full name (e.g. "FanDuel Sports Network Detroit"). |
lang | character | Lang. |
region | character | Region label. |
is_national | logical | Boolean flag indicating whether the broadcast is a nationally distributed feed. |
type_id | character | Type id. |
type_short_name | character | Type short name. |
type_long_name | character | Type long name. |
type_slug | character | Broadcast-type slug (e.g. streaming, tv). |
market_id | character | Unique identifier for market. |
market_type | character | Market type. |
media_call_letters | character | Broadcast call letters for the outlet. |
media_name | character | ESPN media name for the outlet. |
media_short_name | character | Short ESPN media name for the outlet. |
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. |
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_wbb_cdn_playbyplay(game_id='401725017')
Last validated n/a.
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 Parameter | Python | Pattern | Required | Nullable | Description |
|---|---|---|---|---|---|
gameId | game_id | Y | ESPN game (event) id. |
Returns
return_parsed=True (default) — a dict of polars.DataFrames keyed by summary section (representative columns below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).
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 | character | 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. |
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. |
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. |
participants | character | Participants. |
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_address_zip_code | character | Postal zip code of the venue where the game was played. |
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. |
week | integer | Week number. |
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_midsize_name | character | Medium-length display name for the league or competition as shown in the game header. |
league_slug | character | League slug. |
league_is_tournament | logical | League is tournament. |
league_links | character | League links. |
league_logos | character | League logos. |
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. |
overall | character | Overall. |
games_behind | character | Games behind. |
vs. conf. | character | Team's record against conference opponents, shown as part of the standings snapshot in the box score. |
broadcasts
| col_name | type | description |
|---|---|---|
station | character | Station full name (e.g. "FanDuel Sports Network Detroit"). |
lang | character | Lang. |
region | character | Region label. |
is_national | logical | Boolean flag indicating whether the broadcast is a nationally distributed feed. |
type_id | character | Type id. |
type_short_name | character | Type short name. |
type_long_name | character | Type long name. |
type_slug | character | Broadcast-type slug (e.g. streaming, tv). |
market_id | character | Unique identifier for market. |
market_type | character | Market type. |
media_call_letters | character | Broadcast call letters for the outlet. |
media_name | character | ESPN media name for the outlet. |
media_short_name | character | Short ESPN media name for the outlet. |
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. |
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_wbb_cdn_boxscore(game_id='401725017')
Last validated n/a.
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 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_wbb_cdn_schedule(date='20250115')
Last validated n/a.
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 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_wbb_cdn_scoreboard(date='20250115')
Last validated n/a.