Skip to main content

ligue1 — ESPN reference

  • sport slug: soccer
  • league slug: fra.1
  • scopes: universal
  • wrappers: 110

Every endpoint is called as sdv.ligue1.espnLigue1<Endpoint>(params). Each method is also available under its snake_case name (espn_ligue1_<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.ligue1.espnLigue1Scoreboard({});

Universal endpoints

MethodHTTPPath paramsQuery params
espnLigue1AthleteAwardscore_v2 /soccer/leagues/fra.1/athletes/{athlete_id}/awardsathlete_id*
espnLigue1AthleteBiosite_v2 /soccer/fra.1/athletes/{athlete_id}/bioathlete_id*
espnLigue1AthleteCareerStatscore_v2 /soccer/leagues/fra.1/athletes/{athlete_id}/statistics[/{stat_type}]athlete_id*, stat_type
espnLigue1AthleteContractscore_v2 /soccer/leagues/fra.1/athletes/{athlete_id}/contractsathlete_id*
espnLigue1AthleteCorecore_v2 /soccer/leagues/fra.1/athletes/{athlete_id}athlete_id*
espnLigue1AthleteEventlogcore_v2 /soccer/leagues/fra.1/athletes/{athlete_id}/eventlogathlete_id*
espnLigue1AthleteGamelogweb_v3 /soccer/fra.1/athletes/{athlete_id}/gamelogathlete_id*season
espnLigue1AthleteInfosite_v2 /soccer/fra.1/athletes/{athlete_id}athlete_id*
espnLigue1AthleteInjuriescore_v2 /soccer/leagues/fra.1/athletes/{athlete_id}/injuriesathlete_id*
espnLigue1AthleteNewssite_v2 /soccer/fra.1/athletes/{athlete_id}/newsathlete_id*
espnLigue1AthleteNotescore_v2 /soccer/leagues/fra.1/athletes/{athlete_id}/notesathlete_id*
espnLigue1AthleteOverviewweb_v3 /soccer/fra.1/athletes/{athlete_id}/overviewathlete_id*
espnLigue1AthleteRecordscore_v2 /soccer/leagues/fra.1/athletes/{athlete_id}/recordsathlete_id*
espnLigue1AthleteSeasonscore_v2 /soccer/leagues/fra.1/athletes/{athlete_id}/seasonsathlete_id*
espnLigue1AthleteSplitsweb_v3 /soccer/fra.1/athletes/{athlete_id}/splitsathlete_id*season
espnLigue1AthleteStatisticslogcore_v2 /soccer/leagues/fra.1/athletes/{athlete_id}/statisticslogathlete_id*
espnLigue1AthleteStatsweb_v3 /soccer/fra.1/athletes/{athlete_id}/statsathlete_id*season
espnLigue1AthleteVsAthletecore_v2 /soccer/leagues/fra.1/athletes/{athlete_id}/vsathlete/{opp_id}athlete_id*, opp_id*
espnLigue1AthletesIndexcore_v2 /soccer/leagues/fra.1/athletesactive, limit, page
espnLigue1Awardcore_v2 /soccer/leagues/fra.1/awards/{award_id}award_id*
espnLigue1Awardscore_v2 /soccer/leagues/fra.1/awards
espnLigue1Calendarsite_v2 /soccer/fra.1/calendar
espnLigue1Coachcore_v2 /soccer/leagues/fra.1/coaches/{coach_id}coach_id*
espnLigue1CoachRecordcore_v2 /soccer/leagues/fra.1/coaches/{coach_id}/record/{record_type}coach_id*, record_type
espnLigue1CoachSeasoncore_v2 /soccer/leagues/fra.1/coaches/{coach_id}/seasons/{season}coach_id*, season*
espnLigue1Conferencessite_v2 /soccer/fra.1/groups
espnLigue1Draftsite_v2 /soccer/fra.1/draft
espnLigue1Eventcore_v2 /soccer/leagues/fra.1/events/{event_id}event_id*
espnLigue1EventBroadcastscore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/broadcastsevent_id*, cid
espnLigue1EventCompetitioncore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}event_id*, cid
espnLigue1EventCompetitorcore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/competitors/{team_id}event_id*, team_id*, cid
espnLigue1EventCompetitorLeaderscore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/leadersevent_id*, team_id*, cid
espnLigue1EventCompetitorLinescorescore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/linescoresevent_id*, team_id*, cid
espnLigue1EventCompetitorRecordcore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/recordevent_id*, team_id*, cid
espnLigue1EventCompetitorRostercore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/rosterevent_id*, team_id*, cid
espnLigue1EventCompetitorStatisticscore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/competitors/{team_id}/statisticsevent_id*, team_id*, cid
espnLigue1EventCompetitorscore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/competitorsevent_id*, cid
espnLigue1EventLeaderscore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/leadersevent_id*, cid
espnLigue1EventOddscore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/oddsevent_id*, cid
espnLigue1EventOfficialDetailcore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/officials/{official_id}event_id*, official_id*, cid
espnLigue1EventOfficialscore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/officialsevent_id*, cid
espnLigue1EventPlaycore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/plays/{play_id}event_id*, play_id*, cid
espnLigue1EventPlayPersonnelcore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/plays/{play_id}/personnelevent_id*, play_id*, cid
espnLigue1EventPlayscore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/playsevent_id*, cidlimit
espnLigue1EventPowerindexcore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/powerindexevent_id*, cid
espnLigue1EventPredictorcore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/predictorevent_id*, cid
espnLigue1EventProbabilitiescore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/probabilitiesevent_id*, cidlimit
espnLigue1EventPropbetscore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/propbetsevent_id*, cid
espnLigue1EventScoringplayscore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/scoringplaysevent_id*, cid
espnLigue1EventSituationcore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/situationevent_id*, cid
espnLigue1EventStatuscore_v2 /soccer/leagues/fra.1/events/{event_id}/competitions/{cid}/statusevent_id*, cid
espnLigue1Eventscore_v2 /soccer/leagues/fra.1/eventsdates, limit
espnLigue1Franchisecore_v2 /soccer/leagues/fra.1/franchises/{franchise_id}franchise_id*
espnLigue1Franchisescore_v2 /soccer/leagues/fra.1/franchiseslimit
espnLigue1Injuriessite_v2 /soccer/fra.1/injuries
espnLigue1Leadersweb_v3 /soccer/fra.1/statistics/byathletecategory, season, season_typeseasontype, limit, page, sort
espnLigue1LeadersCorecore_v2 /soccer/leagues/fra.1/leaders
espnLigue1LeagueNotescore_v2 /soccer/leagues/fra.1/notes
espnLigue1LeagueRootcore_v2 /soccer/leagues/fra.1
espnLigue1Newssite_v2 /soccer/fra.1/newslimit
espnLigue1Positioncore_v2 /soccer/leagues/fra.1/positions/{position_id}position_id*
espnLigue1Positionscore_v2 /soccer/leagues/fra.1/positions
espnLigue1Scoreboardsite_v2 /soccer/fra.1/scoreboarddates, week, season_typeseasontype, groups, limit
espnLigue1SeasonAthletescore_v2 /soccer/leagues/fra.1/seasons/{season}/athletesseason*limit, page
espnLigue1SeasonAwardscore_v2 /soccer/leagues/fra.1/seasons/{season}/awardsseason*
espnLigue1SeasonCoachescore_v2 /soccer/leagues/fra.1/seasons/{season}/coachesseason*limit
espnLigue1SeasonDraftcore_v2 /soccer/leagues/fra.1/seasons/{season}/draftseason*
espnLigue1SeasonDraftRoundPickscore_v2 /soccer/leagues/fra.1/seasons/{season}/draft/rounds/{round_num}/picksseason*, round_num*
espnLigue1SeasonFreeagentscore_v2 /soccer/leagues/fra.1/seasons/{season}/freeagentsseason*
espnLigue1SeasonFuturescore_v2 /soccer/leagues/fra.1/seasons/{season}/futuresseason*
espnLigue1SeasonGroupcore_v2 /soccer/leagues/fra.1/seasons/{season}/types/{season_type}/groups/{group_id}season*, season_type*, group_id*
espnLigue1SeasonGroupChildrencore_v2 /soccer/leagues/fra.1/seasons/{season}/types/{season_type}/groups/{group_id}/childrenseason*, season_type*, group_id*
espnLigue1SeasonGroupTeamscore_v2 /soccer/leagues/fra.1/seasons/{season}/types/{season_type}/groups/{group_id}/teamsseason*, season_type*, group_id*limit
espnLigue1SeasonGroupscore_v2 /soccer/leagues/fra.1/seasons/{season}/types/{season_type}/groupsseason*, season_type*
espnLigue1SeasonInfocore_v2 /soccer/leagues/fra.1/seasons/{season}season*
espnLigue1SeasonPointercore_v2 /soccer/leagues/fra.1/season
espnLigue1SeasonPowerindexcore_v2 /soccer/leagues/fra.1/seasons/{season}/powerindex[/{team_id}]season*, team_id
espnLigue1SeasonPowerindexLeaderscore_v2 /soccer/leagues/fra.1/seasons/{season}/powerindex/leadersseason*
espnLigue1SeasonTeamcore_v2 /soccer/leagues/fra.1/seasons/{season}/teams/{team_id}season*, team_id*
espnLigue1SeasonTeamscore_v2 /soccer/leagues/fra.1/seasons/{season}/teamsseason*limit
espnLigue1SeasonTypecore_v2 /soccer/leagues/fra.1/seasons/{season}/types/{season_type}season*, season_type*
espnLigue1SeasonTypeCorrectionscore_v2 /soccer/leagues/fra.1/seasons/{season}/types/{season_type}/correctionsseason*, season_type*
espnLigue1SeasonTypeLeaderscore_v2 /soccer/leagues/fra.1/seasons/{season}/types/{season_type}/leadersseason*, season_type*
espnLigue1SeasonTypescore_v2 /soccer/leagues/fra.1/seasons/{season}/typesseason*
espnLigue1SeasonWeekcore_v2 /soccer/leagues/fra.1/seasons/{season}/types/{season_type}/weeks/{week}season*, season_type*, week*
espnLigue1SeasonWeekEventscore_v2 /soccer/leagues/fra.1/seasons/{season}/types/{season_type}/weeks/{week}/eventsseason*, season_type*, week*limit
espnLigue1SeasonWeekscore_v2 /soccer/leagues/fra.1/seasons/{season}/types/{season_type}/weeksseason*, season_type*
espnLigue1Seasonscore_v2 /soccer/leagues/fra.1/seasonslimit
espnLigue1Standingssite_v2_alt /soccer/fra.1/standingsseason, group, standings_typetype
espnLigue1StandingsCorecore_v2 /soccer/leagues/fra.1/standings
espnLigue1StatisticsLeaguesite_v2 /soccer/fra.1/statistics
espnLigue1Summarysite_v2 /soccer/fra.1/summaryevent_idevent
espnLigue1Talentpickscore_v2 /soccer/leagues/fra.1/talentpicks
espnLigue1Teamsite_v2 /soccer/fra.1/teams/{team_id}team_id*
espnLigue1TeamCorecore_v2 /soccer/leagues/fra.1/teams/{team_id}team_id*
espnLigue1TeamDepthchartssite_v2 /soccer/fra.1/teams/{team_id}/depthchartsteam_id*
espnLigue1TeamHistorysite_v2 /soccer/fra.1/teams/{team_id}/historyteam_id*
espnLigue1TeamInjuriessite_v2 /soccer/fra.1/teams/{team_id}/injuriesteam_id*
espnLigue1TeamLeaderssite_v2 /soccer/fra.1/teams/{team_id}/leadersteam_id*
espnLigue1TeamNewssite_v2 /soccer/fra.1/teams/{team_id}/newsteam_id*limit
espnLigue1TeamRecordsite_v2 /soccer/fra.1/teams/{team_id}/recordteam_id*
espnLigue1TeamRostersite_v2 /soccer/fra.1/teams/{team_id}/rosterteam_id*
espnLigue1TeamSchedulesite_v2 /soccer/fra.1/teams/{team_id}/scheduleteam_id*season
espnLigue1TeamTransactionssite_v2 /soccer/fra.1/teams/{team_id}/transactionsteam_id*
espnLigue1TeamsCorecore_v2 /soccer/leagues/fra.1/teamslimit
espnLigue1TeamsSitesite_v2 /soccer/fra.1/teamslimit
espnLigue1Tournamentscore_v2 /soccer/leagues/fra.1/tournaments
espnLigue1Transactionssite_v2 /soccer/fra.1/transactions
espnLigue1Venuecore_v2 /soccer/leagues/fra.1/venues/{venue_id}venue_id*
espnLigue1Venuescore_v2 /soccer/leagues/fra.1/venueslimit

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 the summary dispatcher's 21 sub-frames).