epl — ESPN reference
- sport slug:
soccer - league slug:
eng.1 - scopes:
universal - wrappers: 110
Every endpoint is called as sdv.epl.espnEpl<Endpoint>(params). Each method is also available under its snake_case name (espn_epl_<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.epl.espnEplScoreboard({});
Universal endpoints
| Method | HTTP | Path params | Query params |
|---|---|---|---|
espnEplAthleteAwards | core_v2 /soccer/leagues/eng.1/athletes/{athlete_id}/awards | athlete_id* | — |
espnEplAthleteBio | site_v2 /soccer/eng.1/athletes/{athlete_id}/bio | athlete_id* | — |
espnEplAthleteCareerStats | core_v2 /soccer/leagues/eng.1/athletes/{athlete_id}/statistics[/{stat_type}] | athlete_id*, stat_type | — |
espnEplAthleteContracts | core_v2 /soccer/leagues/eng.1/athletes/{athlete_id}/contracts | athlete_id* | — |
espnEplAthleteCore | core_v2 /soccer/leagues/eng.1/athletes/{athlete_id} | athlete_id* | — |
espnEplAthleteEventlog | core_v2 /soccer/leagues/eng.1/athletes/{athlete_id}/eventlog | athlete_id* | — |
espnEplAthleteGamelog | web_v3 /soccer/eng.1/athletes/{athlete_id}/gamelog | athlete_id* | season |
espnEplAthleteInfo | site_v2 /soccer/eng.1/athletes/{athlete_id} | athlete_id* | — |
espnEplAthleteInjuries | core_v2 /soccer/leagues/eng.1/athletes/{athlete_id}/injuries | athlete_id* | — |
espnEplAthleteNews | site_v2 /soccer/eng.1/athletes/{athlete_id}/news | athlete_id* | — |
espnEplAthleteNotes | core_v2 /soccer/leagues/eng.1/athletes/{athlete_id}/notes | athlete_id* | — |
espnEplAthleteOverview | web_v3 /soccer/eng.1/athletes/{athlete_id}/overview | athlete_id* | — |
espnEplAthleteRecords | core_v2 /soccer/leagues/eng.1/athletes/{athlete_id}/records | athlete_id* | — |
espnEplAthleteSeasons | core_v2 /soccer/leagues/eng.1/athletes/{athlete_id}/seasons | athlete_id* | — |
espnEplAthleteSplits | web_v3 /soccer/eng.1/athletes/{athlete_id}/splits | athlete_id* | season |
espnEplAthleteStatisticslog | core_v2 /soccer/leagues/eng.1/athletes/{athlete_id}/statisticslog | athlete_id* | — |
espnEplAthleteStats | web_v3 /soccer/eng.1/athletes/{athlete_id}/stats | athlete_id* | season |
espnEplAthleteVsAthlete | core_v2 /soccer/leagues/eng.1/athletes/{athlete_id}/vsathlete/{opp_id} | athlete_id*, opp_id* | — |
espnEplAthletesIndex | core_v2 /soccer/leagues/eng.1/athletes | — | active, limit, page |
espnEplAward | core_v2 /soccer/leagues/eng.1/awards/{award_id} | award_id* | — |
espnEplAwards | core_v2 /soccer/leagues/eng.1/awards | — | — |
espnEplCalendar | site_v2 /soccer/eng.1/calendar | — | — |
espnEplCoach | core_v2 /soccer/leagues/eng.1/coaches/{coach_id} | coach_id* | — |
espnEplCoachRecord | core_v2 /soccer/leagues/eng.1/coaches/{coach_id}/record/{record_type} | coach_id*, record_type | — |
espnEplCoachSeason | core_v2 /soccer/leagues/eng.1/coaches/{coach_id}/seasons/{season} | coach_id*, season* | — |
espnEplConferences | site_v2 /soccer/eng.1/groups | — | — |
espnEplDraft | site_v2 /soccer/eng.1/draft | — | — |
espnEplEvent | core_v2 /soccer/leagues/eng.1/events/{event_id} | event_id* | — |
espnEplEventBroadcasts | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/broadcasts | event_id*, cid | — |
espnEplEventCompetition | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid} | event_id*, cid | — |
espnEplEventCompetitor | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/competitors/{team_id} | event_id*, team_id*, cid | — |
espnEplEventCompetitorLeaders | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/leaders | event_id*, team_id*, cid | — |
espnEplEventCompetitorLinescores | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/linescores | event_id*, team_id*, cid | — |
espnEplEventCompetitorRecord | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/record | event_id*, team_id*, cid | — |
espnEplEventCompetitorRoster | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/roster | event_id*, team_id*, cid | — |
espnEplEventCompetitorStatistics | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/statistics | event_id*, team_id*, cid | — |
espnEplEventCompetitors | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/competitors | event_id*, cid | — |
espnEplEventLeaders | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/leaders | event_id*, cid | — |
espnEplEventOdds | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/odds | event_id*, cid | — |
espnEplEventOfficialDetail | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/officials/{official_id} | event_id*, official_id*, cid | — |
espnEplEventOfficials | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/officials | event_id*, cid | — |
espnEplEventPlay | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/plays/{play_id} | event_id*, play_id*, cid | — |
espnEplEventPlayPersonnel | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/plays/{play_id}/personnel | event_id*, play_id*, cid | — |
espnEplEventPlays | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/plays | event_id*, cid | limit |
espnEplEventPowerindex | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/powerindex | event_id*, cid | — |
espnEplEventPredictor | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/predictor | event_id*, cid | — |
espnEplEventProbabilities | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/probabilities | event_id*, cid | limit |
espnEplEventPropbets | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/propbets | event_id*, cid | — |
espnEplEventScoringplays | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/scoringplays | event_id*, cid | — |
espnEplEventSituation | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/situation | event_id*, cid | — |
espnEplEventStatus | core_v2 /soccer/leagues/eng.1/events/{event_id}/competitions/{cid}/status | event_id*, cid | — |
espnEplEvents | core_v2 /soccer/leagues/eng.1/events | — | dates, limit |
espnEplFranchise | core_v2 /soccer/leagues/eng.1/franchises/{franchise_id} | franchise_id* | — |
espnEplFranchises | core_v2 /soccer/leagues/eng.1/franchises | — | limit |
espnEplInjuries | site_v2 /soccer/eng.1/injuries | — | — |
espnEplLeaders | web_v3 /soccer/eng.1/statistics/byathlete | — | category, season, season_type → seasontype, limit, page, sort |
espnEplLeadersCore | core_v2 /soccer/leagues/eng.1/leaders | — | — |
espnEplLeagueNotes | core_v2 /soccer/leagues/eng.1/notes | — | — |
espnEplLeagueRoot | core_v2 /soccer/leagues/eng.1 | — | — |
espnEplNews | site_v2 /soccer/eng.1/news | — | limit |
espnEplPosition | core_v2 /soccer/leagues/eng.1/positions/{position_id} | position_id* | — |
espnEplPositions | core_v2 /soccer/leagues/eng.1/positions | — | — |
espnEplScoreboard | site_v2 /soccer/eng.1/scoreboard | — | dates, week, season_type → seasontype, groups, limit |
espnEplSeasonAthletes | core_v2 /soccer/leagues/eng.1/seasons/{season}/athletes | season* | limit, page |
espnEplSeasonAwards | core_v2 /soccer/leagues/eng.1/seasons/{season}/awards | season* | — |
espnEplSeasonCoaches | core_v2 /soccer/leagues/eng.1/seasons/{season}/coaches | season* | limit |
espnEplSeasonDraft | core_v2 /soccer/leagues/eng.1/seasons/{season}/draft | season* | — |
espnEplSeasonDraftRoundPicks | core_v2 /soccer/leagues/eng.1/seasons/{season}/draft/rounds/{round_num}/picks | season*, round_num* | — |
espnEplSeasonFreeagents | core_v2 /soccer/leagues/eng.1/seasons/{season}/freeagents | season* | — |
espnEplSeasonFutures | core_v2 /soccer/leagues/eng.1/seasons/{season}/futures | season* | — |
espnEplSeasonGroup | core_v2 /soccer/leagues/eng.1/seasons/{season}/types/{season_type}/groups/{group_id} | season*, season_type*, group_id* | — |
espnEplSeasonGroupChildren | core_v2 /soccer/leagues/eng.1/seasons/{season}/types/{season_type}/groups/{group_id}/children | season*, season_type*, group_id* | — |
espnEplSeasonGroupTeams | core_v2 /soccer/leagues/eng.1/seasons/{season}/types/{season_type}/groups/{group_id}/teams | season*, season_type*, group_id* | limit |
espnEplSeasonGroups | core_v2 /soccer/leagues/eng.1/seasons/{season}/types/{season_type}/groups | season*, season_type* | — |
espnEplSeasonInfo | core_v2 /soccer/leagues/eng.1/seasons/{season} | season* | — |
espnEplSeasonPointer | core_v2 /soccer/leagues/eng.1/season | — | — |
espnEplSeasonPowerindex | core_v2 /soccer/leagues/eng.1/seasons/{season}/powerindex[/{team_id}] | season*, team_id | — |
espnEplSeasonPowerindexLeaders | core_v2 /soccer/leagues/eng.1/seasons/{season}/powerindex/leaders | season* | — |
espnEplSeasonTeam | core_v2 /soccer/leagues/eng.1/seasons/{season}/teams/{team_id} | season*, team_id* | — |
espnEplSeasonTeams | core_v2 /soccer/leagues/eng.1/seasons/{season}/teams | season* | limit |
espnEplSeasonType | core_v2 /soccer/leagues/eng.1/seasons/{season}/types/{season_type} | season*, season_type* | — |
espnEplSeasonTypeCorrections | core_v2 /soccer/leagues/eng.1/seasons/{season}/types/{season_type}/corrections | season*, season_type* | — |
espnEplSeasonTypeLeaders | core_v2 /soccer/leagues/eng.1/seasons/{season}/types/{season_type}/leaders | season*, season_type* | — |
espnEplSeasonTypes | core_v2 /soccer/leagues/eng.1/seasons/{season}/types | season* | — |
espnEplSeasonWeek | core_v2 /soccer/leagues/eng.1/seasons/{season}/types/{season_type}/weeks/{week} | season*, season_type*, week* | — |
espnEplSeasonWeekEvents | core_v2 /soccer/leagues/eng.1/seasons/{season}/types/{season_type}/weeks/{week}/events | season*, season_type*, week* | limit |
espnEplSeasonWeeks | core_v2 /soccer/leagues/eng.1/seasons/{season}/types/{season_type}/weeks | season*, season_type* | — |
espnEplSeasons | core_v2 /soccer/leagues/eng.1/seasons | — | limit |
espnEplStandings | site_v2_alt /soccer/eng.1/standings | — | season, group, standings_type → type |
espnEplStandingsCore | core_v2 /soccer/leagues/eng.1/standings | — | — |
espnEplStatisticsLeague | site_v2 /soccer/eng.1/statistics | — | — |
espnEplSummary | site_v2 /soccer/eng.1/summary | — | event_id → event |
espnEplTalentpicks | core_v2 /soccer/leagues/eng.1/talentpicks | — | — |
espnEplTeam | site_v2 /soccer/eng.1/teams/{team_id} | team_id* | — |
espnEplTeamCore | core_v2 /soccer/leagues/eng.1/teams/{team_id} | team_id* | — |
espnEplTeamDepthcharts | site_v2 /soccer/eng.1/teams/{team_id}/depthcharts | team_id* | — |
espnEplTeamHistory | site_v2 /soccer/eng.1/teams/{team_id}/history | team_id* | — |
espnEplTeamInjuries | site_v2 /soccer/eng.1/teams/{team_id}/injuries | team_id* | — |
espnEplTeamLeaders | site_v2 /soccer/eng.1/teams/{team_id}/leaders | team_id* | — |
espnEplTeamNews | site_v2 /soccer/eng.1/teams/{team_id}/news | team_id* | limit |
espnEplTeamRecord | site_v2 /soccer/eng.1/teams/{team_id}/record | team_id* | — |
espnEplTeamRoster | site_v2 /soccer/eng.1/teams/{team_id}/roster | team_id* | — |
espnEplTeamSchedule | site_v2 /soccer/eng.1/teams/{team_id}/schedule | team_id* | season |
espnEplTeamTransactions | site_v2 /soccer/eng.1/teams/{team_id}/transactions | team_id* | — |
espnEplTeamsCore | core_v2 /soccer/leagues/eng.1/teams | — | limit |
espnEplTeamsSite | site_v2 /soccer/eng.1/teams | — | limit |
espnEplTournaments | core_v2 /soccer/leagues/eng.1/tournaments | — | — |
espnEplTransactions | site_v2 /soccer/eng.1/transactions | — | — |
espnEplVenue | core_v2 /soccer/leagues/eng.1/venues/{venue_id} | venue_id* | — |
espnEplVenues | core_v2 /soccer/leagues/eng.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).