WBB — ESPN site API (v2)

sportsdataverse.wbb — 25 endpoints.

espn_wbb_scoreboard

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/scoreboard

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/scoreboard?dates=20240115

API Parameter	Python	Pattern	Required	Nullable	Description
dates	dates			Y	Date or date range filter (YYYYMMDD or YYYYMMDD-YYYYMMDD).
week	week			Y	Week number within the season (football).
seasontype	season_type			Y	Season phase: 1=preseason, 2=regular season, 3=postseason.
groups	groups			Y	Conference or group id filter (e.g. an ESPN conference id).
limit	limit			Y	Maximum number of items to return.

Returns

col_name	type	description
game_id	character	ESPN event id.
uid	character	ESPN UID string.
date	character	Date in YYYY-MM-DD format.
name	character	Display name.
short_name	character	Short display name.
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 state (pre/in/post).
status_type_completed	logical	Whether the game is complete.
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	Game clock in seconds.
status_display_clock	character	Status display clock.
status_period	integer	Current period.
neutral_site	logical	Neutral site.
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	Whether the home venue is indoors.
broadcast	character	Broadcast information string.
note	character	Game note or headline.
home_id	character	Unique identifier for home.
home_name	character	Home team display name.
home_abbreviation	character	Home team's abbreviation.
home_display_name	character	Home team display name.
home_location	character	Home team's location.
home_color	character	Home team primary color hex.
home_alternate_color	character	Color code (hex) for home alternate.
home_logo	character	Home team logo URL.
home_score	character	Home team score at the time of the play.
home_winner	logical	Whether the home team won.
home_rank	integer	Home team rank (if ranked).
away_id	character	Unique identifier for away.
away_name	character	Away team display name.
away_abbreviation	character	Away team's abbreviation.
away_display_name	character	Away team display name.
away_location	character	Away team's location.
away_color	character	Away team primary color hex.
away_alternate_color	character	Color code (hex) for away alternate.
away_logo	character	Away team logo URL.
away_score	character	Away team score at the time of the play.
away_winner	logical	Whether the away team won.
away_rank	integer	Away team rank (if ranked).

Example

espn_wbb_scoreboard(dates='20240115')

Last validated n/a.

espn_wbb_summary

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/summary

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/summary

API Parameter	Python	Pattern	Required	Nullable	Description
event	event_id			Y	event query parameter.

Returns

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
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
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
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

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
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
links_web_self_dsi_href	character
links_api_artwork_href	character
links_sportscenter_href	character

Example

espn_wbb_summary()

Last validated n/a.

espn_wbb_calendar

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/calendar

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/calendar

API Parameter	Python	Pattern	Required	Nullable	Description

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_calendar()

Last validated n/a.

espn_wbb_news

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/news

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/news

API Parameter	Python	Pattern	Required	Nullable	Description
limit	limit			Y	Maximum number of items to return.

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_news()

Last validated n/a.

espn_wbb_injuries

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/injuries

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/injuries

API Parameter	Python	Pattern	Required	Nullable	Description

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_injuries()

Last validated n/a.

espn_wbb_transactions

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/transactions

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/transactions

API Parameter	Python	Pattern	Required	Nullable	Description

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_transactions()

Last validated n/a.

espn_wbb_conferences

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/groups

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/groups

API Parameter	Python	Pattern	Required	Nullable	Description

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_conferences()

Last validated n/a.

espn_wbb_statistics_league

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/statistics

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/statistics

API Parameter	Python	Pattern	Required	Nullable	Description

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_statistics_league()

Last validated n/a.

espn_wbb_draft

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/draft

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/draft

API Parameter	Python	Pattern	Required	Nullable	Description

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_draft()

Last validated n/a.

espn_wbb_teams_site

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams

API Parameter	Python	Pattern	Required	Nullable	Description
limit	limit			Y	Maximum number of items to return.

Returns

col_name	type	description
team_abbreviation	character	Short team abbreviation (e.g. "BOS").
team_alternate_color	character	Secondary team color as a hex string (no leading '#').
team_color	character	Primary team color as a hex string (no leading '#').
team_display_name	character	Full team display name (location + nickname).
team_id	character	ESPN team id (stable join key across ESPN endpoints).
team_is_active	logical	Whether the team is currently active.
team_is_all_star	logical	Whether the entry is an all-star squad rather than a franchise.
team_location	character	Team location / city (e.g. "Boston").
team_logos	character	Pipe-delimited logo image URLs.
team_name	character	Team nickname/mascot (e.g. "Celtics").
team_nickname	character	Team nickname as ESPN labels it (often equals team_name).
team_short_display_name	character	Abbreviated display name for compact UIs.
team_slug	character	URL slug used in ESPN web paths.
team_uid	character	ESPN global UID (encodes sport/league/team).

Example

espn_wbb_teams_site()

Last validated n/a.

espn_wbb_team

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/{team_id}

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/4

API Parameter	Python	Pattern	Required	Nullable	Description
team_id	team_id		Y		team_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_team(team_id='4')

Last validated n/a.

espn_wbb_team_roster

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/{team_id}/roster

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/4/roster

API Parameter	Python	Pattern	Required	Nullable	Description
team_id	team_id		Y		ESPN team identifier (e.g. 2509 for UConn).

Returns

col_name	type	description
id	character	Id.
uid	character	Uid.
guid	character	Guid.
first_name	character	First name.
last_name	character	Last name.
full_name	character	Full name.
display_name	character	Display name.
short_name	character	Short name.
height	double	Height.
display_height	character	Display height.
links	character	Links.
slug	character	Slug.
jersey	character	Jersey.
injuries	character	Injuries.
teams	character	Teams.
alternate_ids_sdr	character	Alternate ids sdr.
birth_place_city	character	Birth place city.
birth_place_state	character	Birth place state.
birth_place_country	character	Birth place country.
birth_place_display_text	character	Birth place display text.
birth_country_alternate_id	character
birth_country_abbreviation	character	Birth country abbreviation.
headshot_href	character	Headshot href.
headshot_alt	character	Headshot alt.
hand_type	character	Hand type.
hand_abbreviation	character	Hand abbreviation.
hand_display_value	character	Hand display value.
flag_href	character
flag_alt	character
flag_rel	character
position_id	character	Position id.
position_name	character	Position name.
position_display_name	character	Position display name.
position_abbreviation	character	Position abbreviation.
position_leaf	logical	Position leaf.
experience_years	integer	Experience years.
experience_display_value	character	Experience display value.
experience_abbreviation	character	Experience abbreviation.
status_id	character	Status id.
status_name	character	Status name.
status_type	character	Status type.
status_abbreviation	character	Status abbreviation.

Example

espn_wbb_team_roster(team_id='4')

Last validated n/a.

espn_wbb_team_schedule

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/{team_id}/schedule

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/4/schedule

API Parameter	Python	Pattern	Required	Nullable	Description
team_id	team_id		Y		team_id path parameter.
season	season			Y	Season year (e.g. 2024).

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_team_schedule(team_id='4')

Last validated n/a.

espn_wbb_team_record

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/{team_id}/record

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/4/record

API Parameter	Python	Pattern	Required	Nullable	Description
team_id	team_id		Y		team_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_team_record(team_id='4')

Last validated n/a.

espn_wbb_team_depthcharts

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/{team_id}/depthcharts

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/4/depthcharts

API Parameter	Python	Pattern	Required	Nullable	Description
team_id	team_id		Y		team_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_team_depthcharts(team_id='4')

Last validated n/a.

espn_wbb_team_injuries

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/{team_id}/injuries

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/4/injuries

API Parameter	Python	Pattern	Required	Nullable	Description
team_id	team_id		Y		team_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_team_injuries(team_id='4')

Last validated n/a.

espn_wbb_team_transactions

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/{team_id}/transactions

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/4/transactions

API Parameter	Python	Pattern	Required	Nullable	Description
team_id	team_id		Y		team_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_team_transactions(team_id='4')

Last validated n/a.

espn_wbb_team_history

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/{team_id}/history

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/4/history

API Parameter	Python	Pattern	Required	Nullable	Description
team_id	team_id		Y		team_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_team_history(team_id='4')

Last validated n/a.

espn_wbb_team_news

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/{team_id}/news

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/4/news

API Parameter	Python	Pattern	Required	Nullable	Description
team_id	team_id		Y		team_id path parameter.
limit	limit			Y	Maximum number of items to return.

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_team_news(team_id='4')

Last validated n/a.

espn_wbb_team_leaders

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/{team_id}/leaders

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/teams/4/leaders

API Parameter	Python	Pattern	Required	Nullable	Description
team_id	team_id		Y		team_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_team_leaders(team_id='4')

Last validated n/a.

espn_wbb_player_info

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/athletes/{athlete_id}

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/athletes/4239

API Parameter	Python	Pattern	Required	Nullable	Description
athlete_id	athlete_id		Y		athlete_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_player_info(athlete_id='4239')

Last validated n/a.

espn_wbb_player_bio

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/athletes/{athlete_id}/bio

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/athletes/4239/bio

API Parameter	Python	Pattern	Required	Nullable	Description
athlete_id	athlete_id		Y		athlete_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_player_bio(athlete_id='4239')

Last validated n/a.

espn_wbb_player_news

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/athletes/{athlete_id}/news

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/athletes/4239/news

API Parameter	Python	Pattern	Required	Nullable	Description
athlete_id	athlete_id		Y		athlete_id path parameter.

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_player_news(athlete_id='4239')

Last validated n/a.

espn_wbb_standings

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/v2/sports/basketball/womens-college-basketball/standings

Valid URL: https://site.api.espn.com/apis/v2/sports/basketball/womens-college-basketball/standings

API Parameter	Python	Pattern	Required	Nullable	Description
season	season			Y	Season year (e.g. 2024).
group	group			Y	Conference or group id filter (e.g. an ESPN conference id).
type	standings_type			Y	Standings variant (e.g. 'by-division' or 'by-conference').

Returns

col_name	type	description
group_name	character	Group name.
group_abbreviation	character	Group abbreviation.
team_id	character	Team id.
team_name	character	Team name.
team_abbreviation	character	Team abbreviation.
team_display_name	character	Team display name.
team_location	character	Team location.
team_logo	character	Team logo.
avg_points_against	double	Avg points against.
avg_points_for	double	Avg points for.
games_behind	double	Games behind.
league_win_percent	double	League win percent.
losses	double	Losses.
playoff_seed	double	Playoff seed.
point_differential	double	Point differential.
points_against	double	Points against.
points_for	double	Points for.
streak	double	Streak.
win_percent	double	Win percent.
wins	double	Wins.
games_ahead	double	Games ahead.
overall	character	Overall.
home	character	Home.
road	character	Road.
vs ap top 25	character
vs usa ranked teams	character
vs. conf.	character	Vs. conf..

Example

espn_wbb_standings()

Last validated n/a.

espn_wbb_rankings

ESPN endpoint.

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/rankings

Valid URL: https://site.api.espn.com/apis/site/v2/sports/basketball/womens-college-basketball/rankings

API Parameter	Python	Pattern	Required	Nullable	Description

Returns

Raw JSON Dict (no parser registered).

Example

espn_wbb_rankings()

Last validated n/a.