soccer — ESPN reference
- sport slug:
soccer - league slug:
eng.1(default; override with aleagueparam) - scopes:
universal - wrappers: 110
Every endpoint is called as sdv.soccer.espnSoccer<Endpoint>(params). Each method is also available under its snake_case name (espn_soccer_<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.soccer.espnSoccerScoreboard({ league: 'eng.1' });
Universal endpoints
| Method | HTTP | Path params | Query params |
|---|---|---|---|
espnSoccerAthleteAwards | core_v2 /soccer/leagues/{league}/athletes/{athlete_id}/awards | athlete_id* | — |
espnSoccerAthleteBio | site_v2 /soccer/{league}/athletes/{athlete_id}/bio | athlete_id* | — |
espnSoccerAthleteCareerStats | core_v2 /soccer/leagues/{league}/athletes/{athlete_id}/statistics[/{stat_type}] | athlete_id*, stat_type | — |
espnSoccerAthleteContracts | core_v2 /soccer/leagues/{league}/athletes/{athlete_id}/contracts | athlete_id* | — |
espnSoccerAthleteCore | core_v2 /soccer/leagues/{league}/athletes/{athlete_id} | athlete_id* | — |
espnSoccerAthleteEventlog | core_v2 /soccer/leagues/{league}/athletes/{athlete_id}/eventlog | athlete_id* | — |
espnSoccerAthleteGamelog | web_v3 /soccer/{league}/athletes/{athlete_id}/gamelog | athlete_id* | season |
espnSoccerAthleteInfo | site_v2 /soccer/{league}/athletes/{athlete_id} | athlete_id* | — |
espnSoccerAthleteInjuries | core_v2 /soccer/leagues/{league}/athletes/{athlete_id}/injuries | athlete_id* | — |
espnSoccerAthleteNews | site_v2 /soccer/{league}/athletes/{athlete_id}/news | athlete_id* | — |
espnSoccerAthleteNotes | core_v2 /soccer/leagues/{league}/athletes/{athlete_id}/notes | athlete_id* | — |
espnSoccerAthleteOverview | web_v3 /soccer/{league}/athletes/{athlete_id}/overview | athlete_id* | — |
espnSoccerAthleteRecords | core_v2 /soccer/leagues/{league}/athletes/{athlete_id}/records | athlete_id* | — |
espnSoccerAthleteSeasons | core_v2 /soccer/leagues/{league}/athletes/{athlete_id}/seasons | athlete_id* | — |
espnSoccerAthleteSplits | web_v3 /soccer/{league}/athletes/{athlete_id}/splits | athlete_id* | season |
espnSoccerAthleteStatisticslog | core_v2 /soccer/leagues/{league}/athletes/{athlete_id}/statisticslog | athlete_id* | — |
espnSoccerAthleteStats | web_v3 /soccer/{league}/athletes/{athlete_id}/stats | athlete_id* | season |
espnSoccerAthleteVsAthlete | core_v2 /soccer/leagues/{league}/athletes/{athlete_id}/vsathlete/{opp_id} | athlete_id*, opp_id* | — |
espnSoccerAthletesIndex | core_v2 /soccer/leagues/{league}/athletes | — | active, limit, page |
espnSoccerAward | core_v2 /soccer/leagues/{league}/awards/{award_id} | award_id* | — |
espnSoccerAwards | core_v2 /soccer/leagues/{league}/awards | — | — |
espnSoccerCalendar | site_v2 /soccer/{league}/calendar | — | — |
espnSoccerCoach | core_v2 /soccer/leagues/{league}/coaches/{coach_id} | coach_id* | — |
espnSoccerCoachRecord | core_v2 /soccer/leagues/{league}/coaches/{coach_id}/record/{record_type} | coach_id*, record_type | — |
espnSoccerCoachSeason | core_v2 /soccer/leagues/{league}/coaches/{coach_id}/seasons/{season} | coach_id*, season* | — |
espnSoccerConferences | site_v2 /soccer/{league}/groups | — | — |
espnSoccerDraft | site_v2 /soccer/{league}/draft | — | — |
espnSoccerEvent | core_v2 /soccer/leagues/{league}/events/{event_id} | event_id* | — |
espnSoccerEventBroadcasts | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/broadcasts | event_id*, cid | — |
espnSoccerEventCompetition | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid} | event_id*, cid | — |
espnSoccerEventCompetitor | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/competitors/{team_id} | event_id*, team_id*, cid | — |
espnSoccerEventCompetitorLeaders | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/competitors/{team_id}/leaders | event_id*, team_id*, cid | — |
espnSoccerEventCompetitorLinescores | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/competitors/{team_id}/linescores | event_id*, team_id*, cid | — |
espnSoccerEventCompetitorRecord | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/competitors/{team_id}/record | event_id*, team_id*, cid | — |
espnSoccerEventCompetitorRoster | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/competitors/{team_id}/roster | event_id*, team_id*, cid | — |
espnSoccerEventCompetitorStatistics | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/competitors/{team_id}/statistics | event_id*, team_id*, cid | — |
espnSoccerEventCompetitors | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/competitors | event_id*, cid | — |
espnSoccerEventLeaders | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/leaders | event_id*, cid | — |
espnSoccerEventOdds | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/odds | event_id*, cid | — |
espnSoccerEventOfficialDetail | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/officials/{official_id} | event_id*, official_id*, cid | — |
espnSoccerEventOfficials | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/officials | event_id*, cid | — |
espnSoccerEventPlay | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/plays/{play_id} | event_id*, play_id*, cid | — |
espnSoccerEventPlayPersonnel | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/plays/{play_id}/personnel | event_id*, play_id*, cid | — |
espnSoccerEventPlays | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/plays | event_id*, cid | limit |
espnSoccerEventPowerindex | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/powerindex | event_id*, cid | — |
espnSoccerEventPredictor | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/predictor | event_id*, cid | — |
espnSoccerEventProbabilities | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/probabilities | event_id*, cid | limit |
espnSoccerEventPropbets | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/propbets | event_id*, cid | — |
espnSoccerEventScoringplays | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/scoringplays | event_id*, cid | — |
espnSoccerEventSituation | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/situation | event_id*, cid | — |
espnSoccerEventStatus | core_v2 /soccer/leagues/{league}/events/{event_id}/competitions/{cid}/status | event_id*, cid | — |
espnSoccerEvents | core_v2 /soccer/leagues/{league}/events | — | dates, limit |
espnSoccerFranchise | core_v2 /soccer/leagues/{league}/franchises/{franchise_id} | franchise_id* | — |
espnSoccerFranchises | core_v2 /soccer/leagues/{league}/franchises | — | limit |
espnSoccerInjuries | site_v2 /soccer/{league}/injuries | — | — |
espnSoccerLeaders | web_v3 /soccer/{league}/statistics/byathlete | — | category, season, season_type → seasontype, limit, page, sort |
espnSoccerLeadersCore | core_v2 /soccer/leagues/{league}/leaders | — | — |
espnSoccerLeagueNotes | core_v2 /soccer/leagues/{league}/notes | — | — |
espnSoccerLeagueRoot | core_v2 /soccer/leagues/{league} | — | — |
espnSoccerNews | site_v2 /soccer/{league}/news | — | limit |
espnSoccerPosition | core_v2 /soccer/leagues/{league}/positions/{position_id} | position_id* | — |
espnSoccerPositions | core_v2 /soccer/leagues/{league}/positions | — | — |
espnSoccerScoreboard | site_v2 /soccer/{league}/scoreboard | — | dates, week, season_type → seasontype, groups, limit |
espnSoccerSeasonAthletes | core_v2 /soccer/leagues/{league}/seasons/{season}/athletes | season* | limit, page |
espnSoccerSeasonAwards | core_v2 /soccer/leagues/{league}/seasons/{season}/awards | season* | — |
espnSoccerSeasonCoaches | core_v2 /soccer/leagues/{league}/seasons/{season}/coaches | season* | limit |
espnSoccerSeasonDraft | core_v2 /soccer/leagues/{league}/seasons/{season}/draft | season* | — |
espnSoccerSeasonDraftRoundPicks | core_v2 /soccer/leagues/{league}/seasons/{season}/draft/rounds/{round_num}/picks | season*, round_num* | — |
espnSoccerSeasonFreeagents | core_v2 /soccer/leagues/{league}/seasons/{season}/freeagents | season* | — |
espnSoccerSeasonFutures | core_v2 /soccer/leagues/{league}/seasons/{season}/futures | season* | — |
espnSoccerSeasonGroup | core_v2 /soccer/leagues/{league}/seasons/{season}/types/{season_type}/groups/{group_id} | season*, season_type*, group_id* | — |
espnSoccerSeasonGroupChildren | core_v2 /soccer/leagues/{league}/seasons/{season}/types/{season_type}/groups/{group_id}/children | season*, season_type*, group_id* | — |
espnSoccerSeasonGroupTeams | core_v2 /soccer/leagues/{league}/seasons/{season}/types/{season_type}/groups/{group_id}/teams | season*, season_type*, group_id* | limit |
espnSoccerSeasonGroups | core_v2 /soccer/leagues/{league}/seasons/{season}/types/{season_type}/groups | season*, season_type* | — |
espnSoccerSeasonInfo | core_v2 /soccer/leagues/{league}/seasons/{season} | season* | — |
espnSoccerSeasonPointer | core_v2 /soccer/leagues/{league}/season | — | — |
espnSoccerSeasonPowerindex | core_v2 /soccer/leagues/{league}/seasons/{season}/powerindex[/{team_id}] | season*, team_id | — |
espnSoccerSeasonPowerindexLeaders | core_v2 /soccer/leagues/{league}/seasons/{season}/powerindex/leaders | season* | — |
espnSoccerSeasonTeam | core_v2 /soccer/leagues/{league}/seasons/{season}/teams/{team_id} | season*, team_id* | — |
espnSoccerSeasonTeams | core_v2 /soccer/leagues/{league}/seasons/{season}/teams | season* | limit |
espnSoccerSeasonType | core_v2 /soccer/leagues/{league}/seasons/{season}/types/{season_type} | season*, season_type* | — |
espnSoccerSeasonTypeCorrections | core_v2 /soccer/leagues/{league}/seasons/{season}/types/{season_type}/corrections | season*, season_type* | — |
espnSoccerSeasonTypeLeaders | core_v2 /soccer/leagues/{league}/seasons/{season}/types/{season_type}/leaders | season*, season_type* | — |
espnSoccerSeasonTypes | core_v2 /soccer/leagues/{league}/seasons/{season}/types | season* | — |
espnSoccerSeasonWeek | core_v2 /soccer/leagues/{league}/seasons/{season}/types/{season_type}/weeks/{week} | season*, season_type*, week* | — |
espnSoccerSeasonWeekEvents | core_v2 /soccer/leagues/{league}/seasons/{season}/types/{season_type}/weeks/{week}/events | season*, season_type*, week* | limit |
espnSoccerSeasonWeeks | core_v2 /soccer/leagues/{league}/seasons/{season}/types/{season_type}/weeks | season*, season_type* | — |
espnSoccerSeasons | core_v2 /soccer/leagues/{league}/seasons | — | limit |
espnSoccerStandings | site_v2_alt /soccer/{league}/standings | — | season, group, standings_type → type |
espnSoccerStandingsCore | core_v2 /soccer/leagues/{league}/standings | — | — |
espnSoccerStatisticsLeague | site_v2 /soccer/{league}/statistics | — | — |
espnSoccerSummary | site_v2 /soccer/{league}/summary | — | event_id → event |
espnSoccerTalentpicks | core_v2 /soccer/leagues/{league}/talentpicks | — | — |
espnSoccerTeam | site_v2 /soccer/{league}/teams/{team_id} | team_id* | — |
espnSoccerTeamCore | core_v2 /soccer/leagues/{league}/teams/{team_id} | team_id* | — |
espnSoccerTeamDepthcharts | site_v2 /soccer/{league}/teams/{team_id}/depthcharts | team_id* | — |
espnSoccerTeamHistory | site_v2 /soccer/{league}/teams/{team_id}/history | team_id* | — |
espnSoccerTeamInjuries | site_v2 /soccer/{league}/teams/{team_id}/injuries | team_id* | — |
espnSoccerTeamLeaders | site_v2 /soccer/{league}/teams/{team_id}/leaders | team_id* | — |
espnSoccerTeamNews | site_v2 /soccer/{league}/teams/{team_id}/news | team_id* | limit |
espnSoccerTeamRecord | site_v2 /soccer/{league}/teams/{team_id}/record | team_id* | — |
espnSoccerTeamRoster | site_v2 /soccer/{league}/teams/{team_id}/roster | team_id* | — |
espnSoccerTeamSchedule | site_v2 /soccer/{league}/teams/{team_id}/schedule | team_id* | season |
espnSoccerTeamTransactions | site_v2 /soccer/{league}/teams/{team_id}/transactions | team_id* | — |
espnSoccerTeamsCore | core_v2 /soccer/leagues/{league}/teams | — | limit |
espnSoccerTeamsSite | site_v2 /soccer/{league}/teams | — | limit |
espnSoccerTournaments | core_v2 /soccer/leagues/{league}/tournaments | — | — |
espnSoccerTransactions | site_v2 /soccer/{league}/transactions | — | — |
espnSoccerVenue | core_v2 /soccer/leagues/{league}/venues/{venue_id} | venue_id* | — |
espnSoccerVenues | core_v2 /soccer/leagues/{league}/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).