Skip to main content

mls — Core API

81 endpoints on sdv.mls. 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).

espnMlsAthleteAwards

MLS — athlete awards (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/athletes/{athlete_id}/awards

API paramJSrequireddescription
{athlete_id}athlete_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.mls.espnMlsAthleteAwards({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_athlete_awards(...)

espnMlsAthleteCareerStats

MLS — athlete career stats (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/athletes/{athlete_id}/statistics[/{stat_type}]

API paramJSrequireddescription
{athlete_id}athlete_idyespath parameter
{stat_type}stat_typenopath 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.mls.espnMlsAthleteCareerStats({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_athlete_career_stats(...)

espnMlsAthleteContracts

MLS — athlete contracts (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/athletes/{athlete_id}/contracts

API paramJSrequireddescription
{athlete_id}athlete_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.mls.espnMlsAthleteContracts({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_athlete_contracts(...)

espnMlsAthleteCore

MLS — athlete core (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/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.mls.espnMlsAthleteCore({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_athlete_core(...)

espnMlsAthleteEventlog

MLS — athlete eventlog (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/athletes/{athlete_id}/eventlog

API paramJSrequireddescription
{athlete_id}athlete_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.mls.espnMlsAthleteEventlog({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_athlete_eventlog(...)

espnMlsAthleteInjuries

MLS — athlete injuries (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/athletes/{athlete_id}/injuries

API paramJSrequireddescription
{athlete_id}athlete_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.mls.espnMlsAthleteInjuries({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_athlete_injuries(...)

espnMlsAthleteNotes

MLS — athlete notes (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/athletes/{athlete_id}/notes

API paramJSrequireddescription
{athlete_id}athlete_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.mls.espnMlsAthleteNotes({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_athlete_notes(...)

espnMlsAthleteRecords

MLS — athlete records (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/athletes/{athlete_id}/records

API paramJSrequireddescription
{athlete_id}athlete_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.mls.espnMlsAthleteRecords({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_athlete_records(...)

espnMlsAthleteSeasons

MLS — athlete seasons (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/athletes/{athlete_id}/seasons

API paramJSrequireddescription
{athlete_id}athlete_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.mls.espnMlsAthleteSeasons({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_athlete_seasons(...)

espnMlsAthleteStatisticslog

MLS — athlete statisticslog (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/athletes/{athlete_id}/statisticslog

API paramJSrequireddescription
{athlete_id}athlete_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.mls.espnMlsAthleteStatisticslog({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_athlete_statisticslog(...)

espnMlsAthleteVsAthlete

MLS — athlete vs athlete (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/athletes/{athlete_id}/vsathlete/{opp_id}

API paramJSrequireddescription
{athlete_id}athlete_idyespath parameter
{opp_id}opp_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.mls.espnMlsAthleteVsAthlete({ athlete_id: '…', opp_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_athlete_vs_athlete(...)

espnMlsAthletesIndex

MLS — athletes index (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/athletes

API paramJSrequireddescription
activeactivenoquery parameter (default true)
limitlimitnoquery parameter (default 100)
pagepagenoquery parameter (default 1)
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.mls.espnMlsAthletesIndex({});
// snake_case alias (py/R parity): sdv.mls.espn_mls_athletes_index(...)

espnMlsAward

MLS — award (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/awards/{award_id}

API paramJSrequireddescription
{award_id}award_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.mls.espnMlsAward({ award_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_award(...)

espnMlsAwards

MLS — awards (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/awards

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.mls.espnMlsAwards({});
// snake_case alias (py/R parity): sdv.mls.espn_mls_awards(...)

espnMlsCoach

MLS — coach (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/coaches/{coach_id}

API paramJSrequireddescription
{coach_id}coach_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.mls.espnMlsCoach({ coach_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_coach(...)

espnMlsCoachRecord

MLS — coach record (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/coaches/{coach_id}/record/{record_type}

API paramJSrequireddescription
{coach_id}coach_idyespath parameter
{record_type}record_typenopath 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.mls.espnMlsCoachRecord({ coach_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_coach_record(...)

espnMlsCoachSeason

MLS — coach season (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/coaches/{coach_id}/seasons/{season}

API paramJSrequireddescription
{coach_id}coach_idyespath parameter
{season}seasonyespath 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.mls.espnMlsCoachSeason({ coach_id: '…', season: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_coach_season(...)

espnMlsEvent

MLS — event (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}

API paramJSrequireddescription
{event_id}event_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.mls.espnMlsEvent({ event_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event(...)

espnMlsEventBroadcasts

MLS — event broadcasts (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/broadcasts

API paramJSrequireddescription
{event_id}event_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventBroadcasts({ event_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_broadcasts(...)

espnMlsEventCompetition

MLS — event competition (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}

API paramJSrequireddescription
{event_id}event_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventCompetition({ event_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_competition(...)

espnMlsEventCompetitor

MLS — event competitor (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/competitors/{team_id}

API paramJSrequireddescription
{event_id}event_idyespath parameter
{team_id}team_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventCompetitor({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_competitor(...)

espnMlsEventCompetitorLeaders

MLS — event competitor leaders (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/leaders

API paramJSrequireddescription
{event_id}event_idyespath parameter
{team_id}team_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventCompetitorLeaders({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_competitor_leaders(...)

espnMlsEventCompetitorLinescores

MLS — event competitor linescores (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/linescores

API paramJSrequireddescription
{event_id}event_idyespath parameter
{team_id}team_idyespath parameter
{cid}cidnopath 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_event_competitor_linescores); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.mls.espnMlsEventCompetitorLinescores({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_competitor_linescores(...)

espnMlsEventCompetitorRecord

MLS — event competitor record (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/record

API paramJSrequireddescription
{event_id}event_idyespath parameter
{team_id}team_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventCompetitorRecord({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_competitor_record(...)

espnMlsEventCompetitorRoster

MLS — event competitor roster (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/roster

API paramJSrequireddescription
{event_id}event_idyespath parameter
{team_id}team_idyespath parameter
{cid}cidnopath 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_event_competitor_roster); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.mls.espnMlsEventCompetitorRoster({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_competitor_roster(...)

espnMlsEventCompetitorStatistics

MLS — event competitor statistics (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/statistics

API paramJSrequireddescription
{event_id}event_idyespath parameter
{team_id}team_idyespath parameter
{cid}cidnopath parameter
parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
split_namecharacterSplit / season-segment name
category_namecharacterStatistic category name
stat_namecharacterStatistic name
stat_abbreviationcharacterStatistic abbreviation
stat_valuenumberNumeric statistic value
stat_display_valuecharacterFormatted statistic value
stat_descriptioncharacterStatistic description

Example:

await sdv.mls.espnMlsEventCompetitorStatistics({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_competitor_statistics(...)

espnMlsEventCompetitors

MLS — event competitors (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/competitors

API paramJSrequireddescription
{event_id}event_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventCompetitors({ event_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_competitors(...)

espnMlsEventLeaders

MLS — event leaders (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/leaders

API paramJSrequireddescription
{event_id}event_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventLeaders({ event_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_leaders(...)

espnMlsEventOdds

MLS — event odds (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/odds

API paramJSrequireddescription
{event_id}event_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventOdds({ event_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_odds(...)

espnMlsEventOfficialDetail

MLS — event official detail (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/officials/{official_id}

API paramJSrequireddescription
{event_id}event_idyespath parameter
{official_id}official_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventOfficialDetail({ event_id: '…', official_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_official_detail(...)

espnMlsEventOfficials

MLS — event officials (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/officials

API paramJSrequireddescription
{event_id}event_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventOfficials({ event_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_officials(...)

espnMlsEventPlay

MLS — event play (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/plays/{play_id}

API paramJSrequireddescription
{event_id}event_idyespath parameter
{play_id}play_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventPlay({ event_id: '…', play_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_play(...)

espnMlsEventPlayPersonnel

MLS — event play personnel (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/plays/{play_id}/personnel

API paramJSrequireddescription
{event_id}event_idyespath parameter
{play_id}play_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventPlayPersonnel({ event_id: '…', play_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_play_personnel(...)

espnMlsEventPlays

MLS — event plays (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/plays

API paramJSrequireddescription
{event_id}event_idyespath parameter
{cid}cidnopath parameter
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_event_plays); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.mls.espnMlsEventPlays({ event_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_plays(...)

espnMlsEventPowerindex

MLS — event powerindex (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/powerindex

API paramJSrequireddescription
{event_id}event_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventPowerindex({ event_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_powerindex(...)

espnMlsEventPredictor

MLS — event predictor (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/predictor

API paramJSrequireddescription
{event_id}event_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventPredictor({ event_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_predictor(...)

espnMlsEventProbabilities

MLS — event probabilities (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/probabilities

API paramJSrequireddescription
{event_id}event_idyespath parameter
{cid}cidnopath parameter
limitlimitnoquery parameter (default 300)
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.mls.espnMlsEventProbabilities({ event_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_probabilities(...)

espnMlsEventPropbets

MLS — event propbets (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/propbets

API paramJSrequireddescription
{event_id}event_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventPropbets({ event_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_propbets(...)

espnMlsEventScoringplays

MLS — event scoringplays (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/scoringplays

API paramJSrequireddescription
{event_id}event_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventScoringplays({ event_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_scoringplays(...)

espnMlsEventSituation

MLS — event situation (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/situation

API paramJSrequireddescription
{event_id}event_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventSituation({ event_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_situation(...)

espnMlsEventStatus

MLS — event status (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/status

API paramJSrequireddescription
{event_id}event_idyespath parameter
{cid}cidnopath 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.mls.espnMlsEventStatus({ event_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_event_status(...)

espnMlsEvents

MLS — events (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/events

API paramJSrequireddescription
datesdatesnoquery parameter
limitlimitnoquery parameter (default 500)
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.mls.espnMlsEvents({});
// snake_case alias (py/R parity): sdv.mls.espn_mls_events(...)

espnMlsFranchise

MLS — franchise (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/franchises/{franchise_id}

API paramJSrequireddescription
{franchise_id}franchise_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.mls.espnMlsFranchise({ franchise_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_franchise(...)

espnMlsFranchises

MLS — franchises (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/franchises

API paramJSrequireddescription
limitlimitnoquery parameter (default 200)
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.mls.espnMlsFranchises({});
// snake_case alias (py/R parity): sdv.mls.espn_mls_franchises(...)

espnMlsLeadersCore

MLS — leaders core (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/leaders

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.mls.espnMlsLeadersCore({});
// snake_case alias (py/R parity): sdv.mls.espn_mls_leaders_core(...)

espnMlsLeagueNotes

MLS — league notes (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/notes

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.mls.espnMlsLeagueNotes({});
// snake_case alias (py/R parity): sdv.mls.espn_mls_league_notes(...)

espnMlsLeagueRoot

MLS — league root (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1

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_single_entity); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.mls.espnMlsLeagueRoot({});
// snake_case alias (py/R parity): sdv.mls.espn_mls_league_root(...)

espnMlsPosition

MLS — position (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/positions/{position_id}

API paramJSrequireddescription
{position_id}position_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.mls.espnMlsPosition({ position_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_position(...)

espnMlsPositions

MLS — positions (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/positions

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.mls.espnMlsPositions({});
// snake_case alias (py/R parity): sdv.mls.espn_mls_positions(...)

espnMlsSeasonAthletes

MLS — season athletes (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/athletes

API paramJSrequireddescription
{season}seasonyespath parameter
limitlimitnoquery parameter (default 100)
pagepagenoquery parameter (default 1)
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.mls.espnMlsSeasonAthletes({ season: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_athletes(...)

espnMlsSeasonAwards

MLS — season awards (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/awards

API paramJSrequireddescription
{season}seasonyespath 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.mls.espnMlsSeasonAwards({ season: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_awards(...)

espnMlsSeasonCoaches

MLS — season coaches (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/coaches

API paramJSrequireddescription
{season}seasonyespath parameter
limitlimitnoquery parameter (default 200)
parsednoreturn tidy rows instead of raw JSON

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

Example:

await sdv.mls.espnMlsSeasonCoaches({ season: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_coaches(...)

espnMlsSeasonDraft

MLS — season draft (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/draft

API paramJSrequireddescription
{season}seasonyespath 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_draft); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.mls.espnMlsSeasonDraft({ season: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_draft(...)

espnMlsSeasonDraftRoundPicks

MLS — season draft round picks (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/draft/rounds/{round_num}/picks

API paramJSrequireddescription
{season}seasonyespath parameter
{round_num}round_numyespath 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.mls.espnMlsSeasonDraftRoundPicks({ season: '…', round_num: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_draft_round_picks(...)

espnMlsSeasonFreeagents

MLS — season freeagents (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/freeagents

API paramJSrequireddescription
{season}seasonyespath 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.mls.espnMlsSeasonFreeagents({ season: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_freeagents(...)

espnMlsSeasonFutures

MLS — season futures (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/futures

API paramJSrequireddescription
{season}seasonyespath 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.mls.espnMlsSeasonFutures({ season: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_futures(...)

espnMlsSeasonGroup

MLS — season group (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/types/{season_type}/groups/{group_id}

API paramJSrequireddescription
{season}seasonyespath parameter
{season_type}season_typeyespath parameter
{group_id}group_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.mls.espnMlsSeasonGroup({ season: '…', season_type: '…', group_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_group(...)

espnMlsSeasonGroupChildren

MLS — season group children (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/types/{season_type}/groups/{group_id}/children

API paramJSrequireddescription
{season}seasonyespath parameter
{season_type}season_typeyespath parameter
{group_id}group_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.mls.espnMlsSeasonGroupChildren({ season: '…', season_type: '…', group_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_group_children(...)

espnMlsSeasonGroupTeams

MLS — season group teams (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/types/{season_type}/groups/{group_id}/teams

API paramJSrequireddescription
{season}seasonyespath parameter
{season_type}season_typeyespath parameter
{group_id}group_idyespath parameter
limitlimitnoquery parameter (default 500)
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.mls.espnMlsSeasonGroupTeams({ season: '…', season_type: '…', group_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_group_teams(...)

espnMlsSeasonGroups

MLS — season groups (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/types/{season_type}/groups

API paramJSrequireddescription
{season}seasonyespath parameter
{season_type}season_typeyespath 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.mls.espnMlsSeasonGroups({ season: '…', season_type: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_groups(...)

espnMlsSeasonInfo

MLS — season info (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}

API paramJSrequireddescription
{season}seasonyespath 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.mls.espnMlsSeasonInfo({ season: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_info(...)

espnMlsSeasonPointer

MLS — season pointer (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/season

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_single_entity); the column set varies by league — see ESPN parsed returns.

Example:

await sdv.mls.espnMlsSeasonPointer({});
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_pointer(...)

espnMlsSeasonPowerindex

MLS — season powerindex (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/powerindex[/{team_id}]

API paramJSrequireddescription
{season}seasonyespath parameter
{team_id}team_idnopath 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.mls.espnMlsSeasonPowerindex({ season: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_powerindex(...)

espnMlsSeasonPowerindexLeaders

MLS — season powerindex leaders (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/powerindex/leaders

API paramJSrequireddescription
{season}seasonyespath 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.mls.espnMlsSeasonPowerindexLeaders({ season: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_powerindex_leaders(...)

espnMlsSeasonTeam

MLS — season team (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/teams/{team_id}

API paramJSrequireddescription
{season}seasonyespath parameter
{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.mls.espnMlsSeasonTeam({ season: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_team(...)

espnMlsSeasonTeams

MLS — season teams (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/teams

API paramJSrequireddescription
{season}seasonyespath parameter
limitlimitnoquery parameter (default 500)
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.mls.espnMlsSeasonTeams({ season: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_teams(...)

espnMlsSeasonType

MLS — season type (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/types/{season_type}

API paramJSrequireddescription
{season}seasonyespath parameter
{season_type}season_typeyespath 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.mls.espnMlsSeasonType({ season: '…', season_type: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_type(...)

espnMlsSeasonTypeCorrections

MLS — season type corrections (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/types/{season_type}/corrections

API paramJSrequireddescription
{season}seasonyespath parameter
{season_type}season_typeyespath 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.mls.espnMlsSeasonTypeCorrections({ season: '…', season_type: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_type_corrections(...)

espnMlsSeasonTypeLeaders

MLS — season type leaders (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/types/{season_type}/leaders

API paramJSrequireddescription
{season}seasonyespath parameter
{season_type}season_typeyespath 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.mls.espnMlsSeasonTypeLeaders({ season: '…', season_type: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_type_leaders(...)

espnMlsSeasonTypes

MLS — season types (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/types

API paramJSrequireddescription
{season}seasonyespath 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.mls.espnMlsSeasonTypes({ season: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_types(...)

espnMlsSeasonWeek

MLS — season week (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/types/{season_type}/weeks/{week}

API paramJSrequireddescription
{season}seasonyespath parameter
{season_type}season_typeyespath parameter
{week}weekyespath 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.mls.espnMlsSeasonWeek({ season: '…', season_type: '…', week: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_week(...)

espnMlsSeasonWeekEvents

MLS — season week events (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/types/{season_type}/weeks/{week}/events

API paramJSrequireddescription
{season}seasonyespath parameter
{season_type}season_typeyespath parameter
{week}weekyespath parameter
limitlimitnoquery parameter (default 500)
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.mls.espnMlsSeasonWeekEvents({ season: '…', season_type: '…', week: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_week_events(...)

espnMlsSeasonWeeks

MLS — season weeks (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons/{season}/types/{season_type}/weeks

API paramJSrequireddescription
{season}seasonyespath parameter
{season_type}season_typeyespath 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.mls.espnMlsSeasonWeeks({ season: '…', season_type: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_season_weeks(...)

espnMlsSeasons

MLS — seasons (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/seasons

API paramJSrequireddescription
limitlimitnoquery parameter (default 200)
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.mls.espnMlsSeasons({});
// snake_case alias (py/R parity): sdv.mls.espn_mls_seasons(...)

espnMlsStandingsCore

MLS — standings core (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/standings

API paramJSrequireddescription
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.mls.espnMlsStandingsCore({});
// snake_case alias (py/R parity): sdv.mls.espn_mls_standings_core(...)

espnMlsTalentpicks

MLS — talentpicks (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/talentpicks

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.mls.espnMlsTalentpicks({});
// snake_case alias (py/R parity): sdv.mls.espn_mls_talentpicks(...)

espnMlsTeamCore

MLS — team core (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/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.mls.espnMlsTeamCore({ team_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_team_core(...)

espnMlsTeamsCore

MLS — teams core (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/teams

API paramJSrequireddescription
limitlimitnoquery parameter (default 500)
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.mls.espnMlsTeamsCore({});
// snake_case alias (py/R parity): sdv.mls.espn_mls_teams_core(...)

espnMlsTournaments

MLS — tournaments (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/tournaments

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.mls.espnMlsTournaments({});
// snake_case alias (py/R parity): sdv.mls.espn_mls_tournaments(...)

espnMlsVenue

MLS — venue (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/venues/{venue_id}

API paramJSrequireddescription
{venue_id}venue_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.mls.espnMlsVenue({ venue_id: '…' });
// snake_case alias (py/R parity): sdv.mls.espn_mls_venue(...)

espnMlsVenues

MLS — venues (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/soccer/leagues/usa.1/venues

API paramJSrequireddescription
limitlimitnoquery parameter (default 200)
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.mls.espnMlsVenues({});
// snake_case alias (py/R parity): sdv.mls.espn_mls_venues(...)