Skip to main content

wnba — Web API

5 endpoints on sdv.wnba. Each is exposed under a camelCase canonical name and a snake_case alias (py/R parity), accepts snake_case or camelCase params, and returns raw ESPN JSON by default ({ parsed: true } for tidy rows).

espnWnbaAthleteGamelog

WNBA — athlete gamelog (ESPN site.web.api.espn.com (web v3)).

Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/wnba/athletes/{athlete_id}/gamelog

API paramJSrequireddescription
{athlete_id}athlete_idyespath parameter
seasonseasonnoquery parameter
parsednoreturn tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_athlete_gamelog):

col_nametypedescription
season_type_idcharacterSeason type id (regular/post)
season_type_namecharacterSeason type name
categorycharacterStat / leader category name
event_idcharacterESPN event/game id
event_datecharacterEvent date (ISO 8601)
home_awaycharacterhome or away
scorecharacterFinal score for the athlete's team
opponent_idcharacterOpponent ESPN team id
opponent_abbreviationcharacterOpponent abbreviation
opponent_display_namecharacterOpponent display name
game_resultcharacterGame result (W/L)
game_processedlogicalWhether the game has been processed

Example:

await sdv.wnba.espnWnbaAthleteGamelog({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.wnba.espn_wnba_athlete_gamelog(...)

espnWnbaAthleteOverview

WNBA — athlete overview (ESPN site.web.api.espn.com (web v3)).

Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/wnba/athletes/{athlete_id}/overview

API paramJSrequireddescription
{athlete_id}athlete_idyespath parameter
parsednoreturn tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_athlete_overview):

col_nametypedescription
athlete_idcharacterESPN athlete id
athlete_display_namecharacterAthlete display name
athlete_short_namecharacterAthlete short name
athlete_positioncharacterPosition abbreviation
athlete_jerseycharacterJersey number
athlete_team_idcharacterAthlete's team id
athlete_team_abbreviationcharacterAthlete's team abbreviation
split_namecharacterSplit / season-segment name
split_categorycharacterSplit category

Example:

await sdv.wnba.espnWnbaAthleteOverview({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.wnba.espn_wnba_athlete_overview(...)

espnWnbaAthleteSplits

WNBA — athlete splits (ESPN site.web.api.espn.com (web v3)).

Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/wnba/athletes/{athlete_id}/splits

API paramJSrequireddescription
{athlete_id}athlete_idyespath parameter
seasonseasonnoquery parameter
parsednoreturn tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_athlete_splits):

col_nametypedescription
categorycharacterStat / leader category name
split_namecharacterSplit / season-segment name
split_abbreviationcharacterSplit abbreviation
split_categorycharacterSplit category
split_valuecharacterSplit value
split_descriptioncharacterSplit description

Example:

await sdv.wnba.espnWnbaAthleteSplits({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.wnba.espn_wnba_athlete_splits(...)

espnWnbaAthleteStats

WNBA — athlete stats (ESPN site.web.api.espn.com (web v3)).

Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/wnba/athletes/{athlete_id}/stats

API paramJSrequireddescription
{athlete_id}athlete_idyespath parameter
seasonseasonnoquery parameter
parsednoreturn tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_athlete_stats):

col_nametypedescription
categorycharacterStat / leader category name
split_namecharacterSplit / season-segment name
split_categorycharacterSplit category
split_valuecharacterSplit value

Example:

await sdv.wnba.espnWnbaAthleteStats({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.wnba.espn_wnba_athlete_stats(...)

espnWnbaLeaders

WNBA — leaders (ESPN site.web.api.espn.com (web v3)).

Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/wnba/statistics/byathlete

API paramJSrequireddescription
categorycategorynoquery parameter
seasonseasonnoquery parameter
seasontypeseason_typenoquery parameter
limitlimitnoquery parameter (default 50)
pagepagenoquery parameter (default 1)
sortsortnoquery parameter
parsednoreturn tidy rows instead of raw JSON

Returns (with { parsed: true }, via parse_leaders):

col_nametypedescription
categorycharacterStat / leader category name
rankintegerRank within the category
athlete_idcharacterESPN athlete id
athlete_display_namecharacterAthlete display name
athlete_short_namecharacterAthlete short name
athlete_jerseycharacterJersey number
athlete_positioncharacterPosition abbreviation
team_idcharacterESPN team id
team_abbreviationcharacterTeam abbreviation
team_display_namecharacterTeam display name

Example:

await sdv.wnba.espnWnbaLeaders({});
// snake_case alias (py/R parity): sdv.wnba.espn_wnba_leaders(...)