Skip to main content

nwsl — Site API

24 endpoints on sdv.nwsl. 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).

espnNwslAthleteBio

NWSL — athlete bio (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/athletes/{athlete_id}/bio

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

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_single_entity); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.nwsl.espnNwslAthleteBio({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_athlete_bio(...)

espnNwslAthleteInfo

NWSL — athlete info (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/athletes/{athlete_id}

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

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_single_entity); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.nwsl.espnNwslAthleteInfo({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_athlete_info(...)

espnNwslAthleteNews

NWSL — athlete news (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/athletes/{athlete_id}/news

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

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

col_nametypedescription
idinteger
now_idcharacter
content_keycharacter
data_source_identifiercharacter
typecharacter
headlinecharacter
descriptioncharacter
last_modifiedcharacter
publishedcharacter
imagescharacter
categoriescharacter
premiumlogical
links_web_hrefcharacter
links_mobile_hrefcharacter
links_api_self_hrefcharacter
links_app_sportscenter_hrefcharacter
bylinecharacter

Example:

await sdv.nwsl.espnNwslAthleteNews({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_athlete_news(...)

espnNwslCalendar

NWSL — calendar (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/calendar

API paramJSrequireddescription
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
$refcharacterCore v2 $ref URL to the resource

Example:

await sdv.nwsl.espnNwslCalendar({});
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_calendar(...)

espnNwslConferences

NWSL — conferences (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/groups

API paramJSrequireddescription
parsednoreturn tidy rows instead of raw JSON

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_groups); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.nwsl.espnNwslConferences({});
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_conferences(...)

espnNwslDraft

NWSL — draft (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/draft

API paramJSrequireddescription
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
$refcharacterCore v2 $ref URL to the resource

Example:

await sdv.nwsl.espnNwslDraft({});
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_draft(...)

espnNwslInjuries

NWSL — injuries (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/injuries

API paramJSrequireddescription
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
idcharacter
display_namecharacter
injuriescharacter

Example:

await sdv.nwsl.espnNwslInjuries({});
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_injuries(...)

espnNwslNews

NWSL — news (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/news

API paramJSrequireddescription
limitlimitnoquery parameter (default 50)
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
idinteger
now_idcharacter
content_keycharacter
data_source_identifiercharacter
typecharacter
headlinecharacter
descriptioncharacter
last_modifiedcharacter
publishedcharacter
imagescharacter
categoriescharacter
premiumlogical
links_web_hrefcharacter
links_mobile_hrefcharacter
links_api_self_hrefcharacter
links_app_sportscenter_hrefcharacter
bylinecharacter

Example:

await sdv.nwsl.espnNwslNews({});
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_news(...)

espnNwslScoreboard

NWSL — scoreboard (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/scoreboard

API paramJSrequireddescription
datesdatesnoquery parameter
weekweeknoquery parameter
seasontypeseason_typenoquery parameter
groupsgroupsnoquery parameter
limitlimitnoquery parameter (default 500)
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
game_idcharacter
uidcharacter
datecharacter
namecharacter
short_namecharacter
season_yearinteger
season_typeinteger
season_slugcharacter
status_type_idcharacter
status_type_namecharacter
status_type_statecharacter
status_type_completedlogical
status_type_descriptioncharacter
status_type_detailcharacter
status_type_short_detailcharacter
status_clockinteger
status_display_clockcharacter
status_periodinteger
neutral_sitelogical
conference_competitionlogical
attendanceinteger
venue_idcharacter
venue_full_namecharacter
venue_citycharacter
venue_statecharacter
venue_indoorlogical
broadcastcharacter
notecharacter
home_idcharacter
home_namecharacter
home_abbreviationcharacter
home_display_namecharacter
home_locationcharacter
home_colorcharacter
home_alternate_colorcharacter
home_logocharacter
home_scorecharacter
home_winnerlogical
home_rankcharacter
away_idcharacter
away_namecharacter
away_abbreviationcharacter
away_display_namecharacter
away_locationcharacter
away_colorcharacter
away_alternate_colorcharacter
away_logocharacter
away_scorecharacter
away_winnerlogical
away_rankcharacter

Example:

await sdv.nwsl.espnNwslScoreboard({});
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_scoreboard(...)

espnNwslStandings

NWSL — standings (ESPN site.api.espn.com (v2)).

Endpoint URL: GET https://site.api.espn.com/apis/v2/sports/soccer/usa.nwsl/standings

API paramJSrequireddescription
seasonseasonnoquery parameter
groupgroupnoquery parameter
typestandings_typenoquery parameter
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
group_namecharacter
group_abbreviationcharacter
team_idcharacterESPN team id
team_namecharacter
team_abbreviationcharacterTeam abbreviation
team_display_namecharacterTeam display name
team_locationcharacter
team_logocharacter
avg_points_againstnumber
avg_points_fornumber
clincherinteger
differentialinteger
division_win_percentnumber
games_behindinteger
league_win_percentnumber
lossesinteger
playoff_seedinteger
point_differentialinteger
pointsinteger
points_againstinteger
points_forinteger
streakinteger
win_percentnumber
winsinteger
games_aheadinteger
overallcharacter
homecharacter
roadcharacter
vs_divcharacter
vs_confcharacter
last_ten_gamescharacter

Example:

await sdv.nwsl.espnNwslStandings({});
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_standings(...)

espnNwslStatisticsLeague

NWSL — statistics league (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/statistics

API paramJSrequireddescription
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
$refcharacterCore v2 $ref URL to the resource

Example:

await sdv.nwsl.espnNwslStatisticsLeague({});
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_statistics_league(...)

espnNwslSummary

NWSL — summary (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/summary

API paramJSrequireddescription
eventevent_idnoquery parameter
parsednoreturn tidy rows instead of raw JSON
sectionnowith parsed, return one named sub-frame (e.g. boxscore, plays, winprobability) instead of all

Returns: raw ESPN Dict by default. With { parsed: true } the summary dispatcher returns an object of 21 sub-frames keyed by section ({ parsed: true, section: '<name>' } for one); see ESPN parsed returns.

Example:

await sdv.nwsl.espnNwslSummary({});
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_summary(...)

espnNwslTeam

NWSL — team (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/teams/{team_id}

API paramJSrequireddescription
{team_id}team_idyespath parameter
parsednoreturn tidy rows instead of raw JSON

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_single_entity); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.nwsl.espnNwslTeam({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_team(...)

espnNwslTeamDepthcharts

NWSL — team depthcharts (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/teams/{team_id}/depthcharts

API paramJSrequireddescription
{team_id}team_idyespath parameter
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
$refcharacterCore v2 $ref URL to the resource

Example:

await sdv.nwsl.espnNwslTeamDepthcharts({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_team_depthcharts(...)

espnNwslTeamHistory

NWSL — team history (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/teams/{team_id}/history

API paramJSrequireddescription
{team_id}team_idyespath parameter
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
$refcharacterCore v2 $ref URL to the resource

Example:

await sdv.nwsl.espnNwslTeamHistory({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_team_history(...)

espnNwslTeamInjuries

NWSL — team injuries (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/teams/{team_id}/injuries

API paramJSrequireddescription
{team_id}team_idyespath parameter
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
idcharacter
display_namecharacter
injuriescharacter

Example:

await sdv.nwsl.espnNwslTeamInjuries({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_team_injuries(...)

espnNwslTeamLeaders

NWSL — team leaders (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/teams/{team_id}/leaders

API paramJSrequireddescription
{team_id}team_idyespath parameter
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
$refcharacterCore v2 $ref URL to the resource

Example:

await sdv.nwsl.espnNwslTeamLeaders({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_team_leaders(...)

espnNwslTeamNews

NWSL — team news (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/teams/{team_id}/news

API paramJSrequireddescription
{team_id}team_idyespath parameter
limitlimitnoquery parameter (default 50)
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
idinteger
now_idcharacter
content_keycharacter
data_source_identifiercharacter
typecharacter
headlinecharacter
descriptioncharacter
last_modifiedcharacter
publishedcharacter
imagescharacter
categoriescharacter
premiumlogical
links_web_hrefcharacter
links_mobile_hrefcharacter
links_api_self_hrefcharacter
links_app_sportscenter_hrefcharacter
bylinecharacter

Example:

await sdv.nwsl.espnNwslTeamNews({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_team_news(...)

espnNwslTeamRecord

NWSL — team record (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/teams/{team_id}/record

API paramJSrequireddescription
{team_id}team_idyespath parameter
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
$refcharacterCore v2 $ref URL to the resource

Example:

await sdv.nwsl.espnNwslTeamRecord({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_team_record(...)

espnNwslTeamRoster

NWSL — team roster (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/teams/{team_id}/roster

API paramJSrequireddescription
{team_id}team_idyespath parameter
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
idcharacter
uidcharacter
guidcharacter
alternate_ids_sdrcharacter
first_namecharacter
last_namecharacter
full_namecharacter
display_namecharacter
short_namecharacter
weightinteger
display_weightcharacter
heightinteger
display_heightcharacter
ageinteger
date_of_birthcharacter
debut_yearinteger
linkscharacter
birth_place_citycharacter
birth_place_countrycharacter
college_idcharacter
college_guidcharacter
college_mascotcharacter
college_namecharacter
college_short_namecharacter
college_abbrevcharacter
college_logoscharacter
slugcharacter
headshot_hrefcharacter
headshot_altcharacter
jerseycharacter
position_idcharacter
position_namecharacter
position_display_namecharacter
position_abbreviationcharacter
position_leaflogical
injuriescharacter
teamscharacter
contractscharacter
experience_yearsinteger
contract_bird_statusinteger
contract_base_year_compensation_activelogical
contract_poison_pill_provision_activelogical
contract_incoming_trade_valueinteger
contract_outgoing_trade_valueinteger
contract_minimum_salary_exceptionlogical
contract_option_typeinteger
contract_salaryinteger
contract_salary_remaininginteger
contract_years_remaininginteger
contract_season_yearinteger
contract_season_start_datecharacter
contract_season_end_datecharacter
contract_trade_kicker_activelogical
contract_trade_kicker_percentageinteger
contract_trade_kicker_valueinteger
contract_trade_kicker_trade_valueinteger
contract_trade_restrictionlogical
contract_unsigned_foreign_picklogical
contract_activelogical
status_idcharacter
status_namecharacter
status_typecharacter
status_abbreviationcharacter
citizenshipcharacter
birth_place_statecharacter
hand_typecharacter
hand_abbreviationcharacter
hand_display_valuecharacter

Example:

await sdv.nwsl.espnNwslTeamRoster({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_team_roster(...)

espnNwslTeamSchedule

NWSL — team schedule (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/teams/{team_id}/schedule

API paramJSrequireddescription
{team_id}team_idyespath parameter
seasonseasonnoquery parameter
parsednoreturn tidy rows instead of raw JSON

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_team_schedule); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.nwsl.espnNwslTeamSchedule({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_team_schedule(...)

espnNwslTeamTransactions

NWSL — team transactions (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/teams/{team_id}/transactions

API paramJSrequireddescription
{team_id}team_idyespath parameter
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
$refcharacterCore v2 $ref URL to the resource

Example:

await sdv.nwsl.espnNwslTeamTransactions({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_team_transactions(...)

espnNwslTeamsSite

NWSL — teams site (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/teams

API paramJSrequireddescription
limitlimitnoquery parameter (default 1000)
parsednoreturn tidy rows instead of raw JSON

Returns: raw ESPN Dict by default. With { parsed: true } the payload is routed through its parser (parse_teams); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.nwsl.espnNwslTeamsSite({});
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_teams_site(...)

espnNwslTransactions

NWSL — transactions (ESPN site.api.espn.com).

Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/soccer/usa.nwsl/transactions

API paramJSrequireddescription
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
$refcharacterCore v2 $ref URL to the resource

Example:

await sdv.nwsl.espnNwslTransactions({});
// snake_case alias (py/R parity): sdv.nwsl.espn_nwsl_transactions(...)