mls — ESPN reference
- sport slug:
soccer - league slug:
usa.1 - scopes:
universal - wrappers: 110
Every endpoint is called as sdv.mls.espnMls<Endpoint>(params). Each method is also available under its snake_case name (espn_mls_<endpoint>) for parity with the Python / R packages. Parameters accept snake_case or camelCase. Required path params are marked *.
import sdv from 'sportsdataverse';
await sdv.mls.espnMlsScoreboard({});
Universal endpoints
| Method | HTTP | Path params | Query params |
|---|---|---|---|
espnMlsAthleteAwards | core_v2 /soccer/leagues/usa.1/athletes/{athlete_id}/awards | athlete_id* | — |
espnMlsAthleteBio | site_v2 /soccer/usa.1/athletes/{athlete_id}/bio | athlete_id* | — |
espnMlsAthleteCareerStats | core_v2 /soccer/leagues/usa.1/athletes/{athlete_id}/statistics[/{stat_type}] | athlete_id*, stat_type | — |
espnMlsAthleteContracts | core_v2 /soccer/leagues/usa.1/athletes/{athlete_id}/contracts | athlete_id* | — |
espnMlsAthleteCore | core_v2 /soccer/leagues/usa.1/athletes/{athlete_id} | athlete_id* | — |
espnMlsAthleteEventlog | core_v2 /soccer/leagues/usa.1/athletes/{athlete_id}/eventlog | athlete_id* | — |
espnMlsAthleteGamelog | web_v3 /soccer/usa.1/athletes/{athlete_id}/gamelog | athlete_id* | season |
espnMlsAthleteInfo | site_v2 /soccer/usa.1/athletes/{athlete_id} | athlete_id* | — |
espnMlsAthleteInjuries | core_v2 /soccer/leagues/usa.1/athletes/{athlete_id}/injuries | athlete_id* | — |
espnMlsAthleteNews | site_v2 /soccer/usa.1/athletes/{athlete_id}/news | athlete_id* | — |
espnMlsAthleteNotes | core_v2 /soccer/leagues/usa.1/athletes/{athlete_id}/notes | athlete_id* | — |
espnMlsAthleteOverview | web_v3 /soccer/usa.1/athletes/{athlete_id}/overview | athlete_id* | — |
espnMlsAthleteRecords | core_v2 /soccer/leagues/usa.1/athletes/{athlete_id}/records | athlete_id* | — |
espnMlsAthleteSeasons | core_v2 /soccer/leagues/usa.1/athletes/{athlete_id}/seasons | athlete_id* | — |
espnMlsAthleteSplits | web_v3 /soccer/usa.1/athletes/{athlete_id}/splits | athlete_id* | season |
espnMlsAthleteStatisticslog | core_v2 /soccer/leagues/usa.1/athletes/{athlete_id}/statisticslog | athlete_id* | — |
espnMlsAthleteStats | web_v3 /soccer/usa.1/athletes/{athlete_id}/stats | athlete_id* | season |
espnMlsAthleteVsAthlete | core_v2 /soccer/leagues/usa.1/athletes/{athlete_id}/vsathlete/{opp_id} | athlete_id*, opp_id* | — |
espnMlsAthletesIndex | core_v2 /soccer/leagues/usa.1/athletes | — | active, limit, page |
espnMlsAward | core_v2 /soccer/leagues/usa.1/awards/{award_id} | award_id* | — |
espnMlsAwards | core_v2 /soccer/leagues/usa.1/awards | — | — |
espnMlsCalendar | site_v2 /soccer/usa.1/calendar | — | — |
espnMlsCoach | core_v2 /soccer/leagues/usa.1/coaches/{coach_id} | coach_id* | — |
espnMlsCoachRecord | core_v2 /soccer/leagues/usa.1/coaches/{coach_id}/record/{record_type} | coach_id*, record_type | — |
espnMlsCoachSeason | core_v2 /soccer/leagues/usa.1/coaches/{coach_id}/seasons/{season} | coach_id*, season* | — |
espnMlsConferences | site_v2 /soccer/usa.1/groups | — | — |
espnMlsDraft | site_v2 /soccer/usa.1/draft | — | — |
espnMlsEvent | core_v2 /soccer/leagues/usa.1/events/{event_id} | event_id* | — |
espnMlsEventBroadcasts | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/broadcasts | event_id*, cid | — |
espnMlsEventCompetition | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid} | event_id*, cid | — |
espnMlsEventCompetitor | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/competitors/{team_id} | event_id*, team_id*, cid | — |
espnMlsEventCompetitorLeaders | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/leaders | event_id*, team_id*, cid | — |
espnMlsEventCompetitorLinescores | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/linescores | event_id*, team_id*, cid | — |
espnMlsEventCompetitorRecord | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/record | event_id*, team_id*, cid | — |
espnMlsEventCompetitorRoster | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/roster | event_id*, team_id*, cid | — |
espnMlsEventCompetitorStatistics | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/statistics | event_id*, team_id*, cid | — |
espnMlsEventCompetitors | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/competitors | event_id*, cid | — |
espnMlsEventLeaders | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/leaders | event_id*, cid | — |
espnMlsEventOdds | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/odds | event_id*, cid | — |
espnMlsEventOfficialDetail | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/officials/{official_id} | event_id*, official_id*, cid | — |
espnMlsEventOfficials | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/officials | event_id*, cid | — |
espnMlsEventPlay | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/plays/{play_id} | event_id*, play_id*, cid | — |
espnMlsEventPlayPersonnel | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/plays/{play_id}/personnel | event_id*, play_id*, cid | — |
espnMlsEventPlays | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/plays | event_id*, cid | limit |
espnMlsEventPowerindex | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/powerindex | event_id*, cid | — |
espnMlsEventPredictor | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/predictor | event_id*, cid | — |
espnMlsEventProbabilities | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/probabilities | event_id*, cid | limit |
espnMlsEventPropbets | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/propbets | event_id*, cid | — |
espnMlsEventScoringplays | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/scoringplays | event_id*, cid | — |
espnMlsEventSituation | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/situation | event_id*, cid | — |
espnMlsEventStatus | core_v2 /soccer/leagues/usa.1/events/{event_id}/competitions/{cid}/status | event_id*, cid | — |
espnMlsEvents | core_v2 /soccer/leagues/usa.1/events | — | dates, limit |
espnMlsFranchise | core_v2 /soccer/leagues/usa.1/franchises/{franchise_id} | franchise_id* | — |
espnMlsFranchises | core_v2 /soccer/leagues/usa.1/franchises | — | limit |
espnMlsInjuries | site_v2 /soccer/usa.1/injuries | — | — |
espnMlsLeaders | web_v3 /soccer/usa.1/statistics/byathlete | — | category, season, season_type → seasontype, limit, page, sort |
espnMlsLeadersCore | core_v2 /soccer/leagues/usa.1/leaders | — | — |
espnMlsLeagueNotes | core_v2 /soccer/leagues/usa.1/notes | — | — |
espnMlsLeagueRoot | core_v2 /soccer/leagues/usa.1 | — | — |
espnMlsNews | site_v2 /soccer/usa.1/news | — | limit |
espnMlsPosition | core_v2 /soccer/leagues/usa.1/positions/{position_id} | position_id* | — |
espnMlsPositions | core_v2 /soccer/leagues/usa.1/positions | — | — |
espnMlsScoreboard | site_v2 /soccer/usa.1/scoreboard | — | dates, week, season_type → seasontype, groups, limit |
espnMlsSeasonAthletes | core_v2 /soccer/leagues/usa.1/seasons/{season}/athletes | season* | limit, page |
espnMlsSeasonAwards | core_v2 /soccer/leagues/usa.1/seasons/{season}/awards | season* | — |
espnMlsSeasonCoaches | core_v2 /soccer/leagues/usa.1/seasons/{season}/coaches | season* | limit |
espnMlsSeasonDraft | core_v2 /soccer/leagues/usa.1/seasons/{season}/draft | season* | — |
espnMlsSeasonDraftRoundPicks | core_v2 /soccer/leagues/usa.1/seasons/{season}/draft/rounds/{round_num}/picks | season*, round_num* | — |
espnMlsSeasonFreeagents | core_v2 /soccer/leagues/usa.1/seasons/{season}/freeagents | season* | — |
espnMlsSeasonFutures | core_v2 /soccer/leagues/usa.1/seasons/{season}/futures | season* | — |
espnMlsSeasonGroup | core_v2 /soccer/leagues/usa.1/seasons/{season}/types/{season_type}/groups/{group_id} | season*, season_type*, group_id* | — |
espnMlsSeasonGroupChildren | core_v2 /soccer/leagues/usa.1/seasons/{season}/types/{season_type}/groups/{group_id}/children | season*, season_type*, group_id* | — |
espnMlsSeasonGroupTeams | core_v2 /soccer/leagues/usa.1/seasons/{season}/types/{season_type}/groups/{group_id}/teams | season*, season_type*, group_id* | limit |
espnMlsSeasonGroups | core_v2 /soccer/leagues/usa.1/seasons/{season}/types/{season_type}/groups | season*, season_type* | — |
espnMlsSeasonInfo | core_v2 /soccer/leagues/usa.1/seasons/{season} | season* | — |
espnMlsSeasonPointer | core_v2 /soccer/leagues/usa.1/season | — | — |
espnMlsSeasonPowerindex | core_v2 /soccer/leagues/usa.1/seasons/{season}/powerindex[/{team_id}] | season*, team_id | — |
espnMlsSeasonPowerindexLeaders | core_v2 /soccer/leagues/usa.1/seasons/{season}/powerindex/leaders | season* | — |
espnMlsSeasonTeam | core_v2 /soccer/leagues/usa.1/seasons/{season}/teams/{team_id} | season*, team_id* | — |
espnMlsSeasonTeams | core_v2 /soccer/leagues/usa.1/seasons/{season}/teams | season* | limit |
espnMlsSeasonType | core_v2 /soccer/leagues/usa.1/seasons/{season}/types/{season_type} | season*, season_type* | — |
espnMlsSeasonTypeCorrections | core_v2 /soccer/leagues/usa.1/seasons/{season}/types/{season_type}/corrections | season*, season_type* | — |
espnMlsSeasonTypeLeaders | core_v2 /soccer/leagues/usa.1/seasons/{season}/types/{season_type}/leaders | season*, season_type* | — |
espnMlsSeasonTypes | core_v2 /soccer/leagues/usa.1/seasons/{season}/types | season* | — |
espnMlsSeasonWeek | core_v2 /soccer/leagues/usa.1/seasons/{season}/types/{season_type}/weeks/{week} | season*, season_type*, week* | — |
espnMlsSeasonWeekEvents | core_v2 /soccer/leagues/usa.1/seasons/{season}/types/{season_type}/weeks/{week}/events | season*, season_type*, week* | limit |
espnMlsSeasonWeeks | core_v2 /soccer/leagues/usa.1/seasons/{season}/types/{season_type}/weeks | season*, season_type* | — |
espnMlsSeasons | core_v2 /soccer/leagues/usa.1/seasons | — | limit |
espnMlsStandings | site_v2_alt /soccer/usa.1/standings | — | season, group, standings_type → type |
espnMlsStandingsCore | core_v2 /soccer/leagues/usa.1/standings | — | — |
espnMlsStatisticsLeague | site_v2 /soccer/usa.1/statistics | — | — |
espnMlsSummary | site_v2 /soccer/usa.1/summary | — | event_id → event |
espnMlsTalentpicks | core_v2 /soccer/leagues/usa.1/talentpicks | — | — |
espnMlsTeam | site_v2 /soccer/usa.1/teams/{team_id} | team_id* | — |
espnMlsTeamCore | core_v2 /soccer/leagues/usa.1/teams/{team_id} | team_id* | — |
espnMlsTeamDepthcharts | site_v2 /soccer/usa.1/teams/{team_id}/depthcharts | team_id* | — |
espnMlsTeamHistory | site_v2 /soccer/usa.1/teams/{team_id}/history | team_id* | — |
espnMlsTeamInjuries | site_v2 /soccer/usa.1/teams/{team_id}/injuries | team_id* | — |
espnMlsTeamLeaders | site_v2 /soccer/usa.1/teams/{team_id}/leaders | team_id* | — |
espnMlsTeamNews | site_v2 /soccer/usa.1/teams/{team_id}/news | team_id* | limit |
espnMlsTeamRecord | site_v2 /soccer/usa.1/teams/{team_id}/record | team_id* | — |
espnMlsTeamRoster | site_v2 /soccer/usa.1/teams/{team_id}/roster | team_id* | — |
espnMlsTeamSchedule | site_v2 /soccer/usa.1/teams/{team_id}/schedule | team_id* | season |
espnMlsTeamTransactions | site_v2 /soccer/usa.1/teams/{team_id}/transactions | team_id* | — |
espnMlsTeamsCore | core_v2 /soccer/leagues/usa.1/teams | — | limit |
espnMlsTeamsSite | site_v2 /soccer/usa.1/teams | — | limit |
espnMlsTournaments | core_v2 /soccer/leagues/usa.1/tournaments | — | — |
espnMlsTransactions | site_v2 /soccer/usa.1/transactions | — | — |
espnMlsVenue | core_v2 /soccer/leagues/usa.1/venues/{venue_id} | venue_id* | — |
espnMlsVenues | core_v2 /soccer/leagues/usa.1/venues | — | limit |
Parsed output: pass
{ parsed: true }to any endpoint above to get tidy rows instead of raw JSON. The columns are determined by each endpoint's parser — see ESPN parsed returns for the full column reference (and thesummarydispatcher's 21 sub-frames).