Breaking in 4.0.0

• Public names are sportsdataverse-py's — athlete → player, event → game on every ESPN league; sdv-py's name_pattern on the native families (nhlApiWeb* → nhl*, nflApi* → nfl*, CBS's 16 shorts, the 3.0.0 file-stem names). Every pre-v4 name still works as a deprecated alias that warns once. (changelog)
• Integer id columns are decimal strings — Every id column of integers (id, *_id, game_pk, playerId, …) comes back as exact decimal strings on every surface — parsers, producers, loaders, HockeyTech analytics. Compare and join ids as strings; Number(row.game_id) for a safe number back. (changelog)
• 400 / 422 raise InvalidParameterError — For every family (it was AssetFetchError), never retried; the message names host, path and status with a redacted excerpt of the body. (changelog)
• Typed returns — generated row types for parsed: true — TypeScript only. A wrapper's raw payload resolves to unknown (was any); verified endpoints resolve to their row interfaces; the summary dispatchers to ParsedTables. Narrow or cast a raw payload. (changelog)
• Typed wrapper params and loader rows; strict mode — TypeScript only. A param the endpoint does not have, a missing required path param or a non-boolean bool param is a type error; parser rows are Record<string, unknown>; loader rows are their generated row types. (changelog)
• Wrapper failures raise NoDataError / AssetFetchError — Instead of raw axios errors. NoDataError = the fetch worked and there is nothing there (404, ESPN { code: 404 }); AssetFetchError = the fetch failed (403 / 429 / 5xx after retries, network). Retries follow DEFAULT_RETRY_STATUSES with backoff. (changelog)

ligue1 — Core API

82 endpoints on sdv.ligue1. 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).

espnLigue1PlayerAwards

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

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_athlete_awards / espnLigue1AthleteAwards

API param	JS	required	description
{athlete_id}	athlete_id	yes	number | string — the ESPN athlete id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1PlayerAwards({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_player_awards(...)

espnLigue1PlayerCareerStats

LIGUE1 — player career stats (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_athlete_career_stats / espnLigue1AthleteCareerStats

API param	JS	required	description
{athlete_id}	athlete_id	yes	number | string — the ESPN athlete id
{stat_type}	stat_type	no	number | string — the {stat_type} path segment; optional
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1PlayerCareerStats({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_player_career_stats(...)

espnLigue1PlayerContracts

LIGUE1 — player contracts (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_athlete_contracts / espnLigue1AthleteContracts

API param	JS	required	description
{athlete_id}	athlete_id	yes	number | string — the ESPN athlete id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1PlayerContracts({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_player_contracts(...)

espnLigue1PlayerCore

LIGUE1 — player core (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_athlete_core / espnLigue1AthleteCore

API param	JS	required	description
{athlete_id}	athlete_id	yes	number | string — the ESPN athlete id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1PlayerCore({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_player_core(...)

espnLigue1PlayerEventlog

LIGUE1 — player eventlog (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_athlete_eventlog / espnLigue1AthleteEventlog

API param	JS	required	description
{athlete_id}	athlete_id	yes	number | string — the ESPN athlete id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1PlayerEventlog({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_player_eventlog(...)

espnLigue1PlayerInjuries

LIGUE1 — player injuries (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_athlete_injuries / espnLigue1AthleteInjuries

API param	JS	required	description
{athlete_id}	athlete_id	yes	number | string — the ESPN athlete id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
id	character	ESPN numeric identifier for the athlete.
display_name	character	Athlete's full display name as shown on ESPN.
injuries	character	Injury entries for the athlete (list of dicts, stringified): status, type, details, dates.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1PlayerInjuries({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_player_injuries(...)

espnLigue1PlayerNotes

LIGUE1 — player notes (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_athlete_notes / espnLigue1AthleteNotes

API param	JS	required	description
{athlete_id}	athlete_id	yes	number | string — the ESPN athlete id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1PlayerNotes({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_player_notes(...)

espnLigue1PlayerRecords

LIGUE1 — player records (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_athlete_records / espnLigue1AthleteRecords

API param	JS	required	description
{athlete_id}	athlete_id	yes	number | string — the ESPN athlete id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1PlayerRecords({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_player_records(...)

espnLigue1PlayerSeasons

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

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_athlete_seasons / espnLigue1AthleteSeasons

API param	JS	required	description
{athlete_id}	athlete_id	yes	number | string — the ESPN athlete id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1PlayerSeasons({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_player_seasons(...)

espnLigue1PlayerStatisticslog

LIGUE1 — player statisticslog (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_athlete_statisticslog / espnLigue1AthleteStatisticslog

API param	JS	required	description
{athlete_id}	athlete_id	yes	number | string — the ESPN athlete id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1PlayerStatisticslog({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_player_statisticslog(...)

espnLigue1PlayerVsPlayer

LIGUE1 — player vs player (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_athlete_vs_athlete / espnLigue1AthleteVsAthlete

API param	JS	required	description
{athlete_id}	athlete_id	yes	number | string — the ESPN athlete id
{opp_id}	opp_id	yes	number | string — the {opp_id} path segment
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1PlayerVsPlayer({ athlete_id: '…', opp_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_player_vs_player(...)

espnLigue1PlayersIndex

LIGUE1 — players index (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_athletes_index / espnLigue1AthletesIndex

API param	JS	required	description
active	active	no	boolean — the active ESPN query parameter; default true
limit	limit	no	number | string — the maximum number of items to return; default 100
page	page	no	number | string — the page of a paginated Core v2 list (1-based); default 1
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1PlayersIndex({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_players_index(...)

espnLigue1Award

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

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

API param	JS	required	description
{award_id}	award_id	yes	number | string — the ESPN award id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1Award({ award_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_award(...)

espnLigue1Awards

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

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

API param	JS	required	description
limit	limit	no	number | string — the maximum number of items to return; default 200
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1Awards({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_awards(...)

espnLigue1Coach

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

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

API param	JS	required	description
{coach_id}	coach_id	yes	number | string — the ESPN coach id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1Coach({ coach_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_coach(...)

espnLigue1CoachRecord

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

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

API param	JS	required	description
{coach_id}	coach_id	yes	number | string — the ESPN coach id
{record_type}	record_type	no	number | string — the {record_type} path segment; optional; default 0
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1CoachRecord({ coach_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_coach_record(...)

espnLigue1CoachSeason

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

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

API param	JS	required	description
{coach_id}	coach_id	yes	number | string — the ESPN coach id
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1CoachSeason({ coach_id: '…', season: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_coach_season(...)

espnLigue1Game

LIGUE1 — game (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event / espnLigue1Event

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1Game({ event_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game(...)

espnLigue1GameBroadcasts

LIGUE1 — game broadcasts (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_broadcasts / espnLigue1EventBroadcasts

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameBroadcasts({ event_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_broadcasts(...)

espnLigue1GameCompetition

LIGUE1 — game competition (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_competition / espnLigue1EventCompetition

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameCompetition({ event_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_competition(...)

espnLigue1GameTeam

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

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_competitor / espnLigue1EventCompetitor

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameTeam({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_team(...)

espnLigue1GameTeamLeaders

LIGUE1 — game team leaders (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_competitor_leaders / espnLigue1EventCompetitorLeaders

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameTeamLeaders({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_team_leaders(...)

espnLigue1GameTeamLinescores

LIGUE1 — game team linescores (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_competitor_linescores / espnLigue1EventCompetitorLinescores

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_event_competitor_linescores for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameTeamLinescores({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_team_linescores(...)

espnLigue1GameTeamRecord

LIGUE1 — game team record (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_competitor_record / espnLigue1EventCompetitorRecord

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameTeamRecord({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_team_record(...)

espnLigue1GameTeamRoster

LIGUE1 — game team roster (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_competitor_roster / espnLigue1EventCompetitorRoster

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_event_competitor_roster for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameTeamRoster({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_team_roster(...)

espnLigue1GameTeamStatistics

LIGUE1 — game team statistics (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_competitor_statistics / espnLigue1EventCompetitorStatistics

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
split_name	character	Split / season-segment name
category_name	character	Statistic category name
stat_name	character	Statistic name
stat_abbreviation	character	Statistic abbreviation
stat_value	number	Numeric statistic value
stat_display_value	character	Formatted statistic value
stat_description	character	Statistic description

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameTeamStatistics({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_team_statistics(...)

espnLigue1GameTeams

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

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_competitors / espnLigue1EventCompetitors

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameTeams({ event_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_teams(...)

espnLigue1GameLeaders

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

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_leaders / espnLigue1EventLeaders

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameLeaders({ event_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_leaders(...)

espnLigue1GameOdds

LIGUE1 — game odds (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_odds / espnLigue1EventOdds

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameOdds({ event_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_odds(...)

espnLigue1GameOfficialDetail

LIGUE1 — game official detail (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_official_detail / espnLigue1EventOfficialDetail

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{official_id}	official_id	yes	number | string — the {official_id} path segment
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameOfficialDetail({ event_id: '…', official_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_official_detail(...)

espnLigue1GameOfficials

LIGUE1 — game officials (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_officials / espnLigue1EventOfficials

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameOfficials({ event_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_officials(...)

espnLigue1GamePlay

LIGUE1 — game play (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_play / espnLigue1EventPlay

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{play_id}	play_id	yes	number | string — the {play_id} path segment
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GamePlay({ event_id: '…', play_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_play(...)

espnLigue1GamePlayPersonnel

LIGUE1 — game play personnel (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_play_personnel / espnLigue1EventPlayPersonnel

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{play_id}	play_id	yes	number | string — the {play_id} path segment
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GamePlayPersonnel({ event_id: '…', play_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_play_personnel(...)

espnLigue1GamePlays

LIGUE1 — game plays (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_plays / espnLigue1EventPlays

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
limit	limit	no	number | string — the maximum number of items to return; default 1000
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_event_plays for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GamePlays({ event_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_plays(...)

espnLigue1GamePowerindex

LIGUE1 — game powerindex (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_powerindex / espnLigue1EventPowerindex

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GamePowerindex({ event_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_powerindex(...)

espnLigue1GamePredictor

LIGUE1 — game predictor (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_predictor / espnLigue1EventPredictor

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GamePredictor({ event_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_predictor(...)

espnLigue1GameProbabilities

LIGUE1 — game probabilities (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_probabilities / espnLigue1EventProbabilities

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
limit	limit	no	number | string — the maximum number of items to return; default 300
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameProbabilities({ event_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_probabilities(...)

espnLigue1GamePropbets

LIGUE1 — game propbets (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_propbets / espnLigue1EventPropbets

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GamePropbets({ event_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_propbets(...)

espnLigue1GameScoringplays

LIGUE1 — game scoringplays (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_scoringplays / espnLigue1EventScoringplays

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameScoringplays({ event_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_scoringplays(...)

espnLigue1GameSituation

LIGUE1 — game situation (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_situation / espnLigue1EventSituation

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameSituation({ event_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_situation(...)

espnLigue1GameStatus

LIGUE1 — game status (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_event_status / espnLigue1EventStatus

API param	JS	required	description
{event_id}	event_id	yes	number | string — the ESPN event (game) id
{cid}	cid	no	number | string — the {cid} path segment; optional; default from event_id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1GameStatus({ event_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_game_status(...)

espnLigue1Games

LIGUE1 — games (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_events / espnLigue1Events

API param	JS	required	description
dates	dates	no	number | string — a date YYYYMMDD, a range YYYYMMDD-YYYYMMDD or a season year YYYY
limit	limit	no	number | string — the maximum number of items to return; default 500
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1Games({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_games(...)

espnLigue1Franchise

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

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

API param	JS	required	description
{franchise_id}	franchise_id	yes	number | string — the ESPN franchise id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1Franchise({ franchise_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_franchise(...)

espnLigue1Franchises

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

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

API param	JS	required	description
limit	limit	no	number | string — the maximum number of items to return; default 200
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1Franchises({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_franchises(...)

espnLigue1LeadersCore

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

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

API param	JS	required	description
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1LeadersCore({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_leaders_core(...)

espnLigue1LeagueNotes

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

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

API param	JS	required	description
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1LeagueNotes({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_league_notes(...)

espnLigue1LeagueRoot

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

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

API param	JS	required	description
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1LeagueRoot({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_league_root(...)

espnLigue1Position

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

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

API param	JS	required	description
{position_id}	position_id	yes	number | string — the ESPN position id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1Position({ position_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_position(...)

espnLigue1Positions

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

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

API param	JS	required	description
limit	limit	no	number | string — the maximum number of items to return; default 200
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1Positions({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_positions(...)

espnLigue1SeasonPlayers

LIGUE1 — season players (ESPN sports.core.api.espn.com (core v2)).

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_season_athletes / espnLigue1SeasonAthletes

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
limit	limit	no	number | string — the maximum number of items to return; default 100
page	page	no	number | string — the page of a paginated Core v2 list (1-based); default 1
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonPlayers({ season: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_players(...)

espnLigue1SeasonAwards

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
limit	limit	no	number | string — the maximum number of items to return; default 200
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonAwards({ season: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_awards(...)

espnLigue1SeasonCoaches

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
limit	limit	no	number | string — the maximum number of items to return; default 500
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_coaches for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonCoaches({ season: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_coaches(...)

espnLigue1SeasonDraft

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_draft for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonDraft({ season: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_draft(...)

espnLigue1SeasonDraftRoundPicks

LIGUE1 — 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/fra.1/seasons/{season}/draft/rounds/{round_num}/picks

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
{round_num}	round_num	yes	number | string — the {round_num} path segment
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonDraftRoundPicks({ season: '…', round_num: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_draft_round_picks(...)

espnLigue1SeasonFreeagents

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonFreeagents({ season: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_freeagents(...)

espnLigue1SeasonFutures

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonFutures({ season: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_futures(...)

espnLigue1SeasonGroup

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
{season_type}	season_type	yes	number | string — the season type: 1 preseason, 2 regular season, 3 postseason
{group_id}	group_id	yes	number | string — the {group_id} path segment
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonGroup({ season: '…', season_type: '…', group_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_group(...)

espnLigue1SeasonGroupChildren

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
{season_type}	season_type	yes	number | string — the season type: 1 preseason, 2 regular season, 3 postseason
{group_id}	group_id	yes	number | string — the {group_id} path segment
limit	limit	no	number | string — the maximum number of items to return; default 500
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonGroupChildren({ season: '…', season_type: '…', group_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_group_children(...)

espnLigue1SeasonGroupTeams

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
{season_type}	season_type	yes	number | string — the season type: 1 preseason, 2 regular season, 3 postseason
{group_id}	group_id	yes	number | string — the {group_id} path segment
limit	limit	no	number | string — the maximum number of items to return; default 500
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonGroupTeams({ season: '…', season_type: '…', group_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_group_teams(...)

espnLigue1SeasonGroups

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
{season_type}	season_type	yes	number | string — the season type: 1 preseason, 2 regular season, 3 postseason
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonGroups({ season: '…', season_type: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_groups(...)

espnLigue1SeasonInfo

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonInfo({ season: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_info(...)

espnLigue1SeasonPointer

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

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

API param	JS	required	description
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonPointer({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_pointer(...)

espnLigue1SeasonPowerindex

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
{team_id}	team_id	no	number | string — the ESPN team id (see espn_<league>_teams); optional
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonPowerindex({ season: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_powerindex(...)

espnLigue1SeasonPowerindexLeaders

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonPowerindexLeaders({ season: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_powerindex_leaders(...)

espnLigue1SeasonTeam

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonTeam({ season: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_team(...)

espnLigue1SeasonTeams

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
limit	limit	no	number | string — the maximum number of items to return; default 1000
page	page	no	number | string — the page of a paginated Core v2 list (1-based); default 1
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonTeams({ season: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_teams(...)

espnLigue1SeasonType

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
{season_type}	season_type	yes	number | string — the season type: 1 preseason, 2 regular season, 3 postseason
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonType({ season: '…', season_type: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_type(...)

espnLigue1SeasonTypeCorrections

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
{season_type}	season_type	yes	number | string — the season type: 1 preseason, 2 regular season, 3 postseason
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonTypeCorrections({ season: '…', season_type: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_type_corrections(...)

espnLigue1SeasonTypeLeaders

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
{season_type}	season_type	yes	number | string — the season type: 1 preseason, 2 regular season, 3 postseason
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonTypeLeaders({ season: '…', season_type: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_type_leaders(...)

espnLigue1SeasonTypes

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonTypes({ season: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_types(...)

espnLigue1SeasonWeek

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
{season_type}	season_type	yes	number | string — the season type: 1 preseason, 2 regular season, 3 postseason
{week}	week	yes	number | string — the week of the season (football)
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonWeek({ season: '…', season_type: '…', week: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_week(...)

espnLigue1SeasonWeekGames

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

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

Deprecated aliases (pre-v4 names, still callable): espn_ligue1_season_week_events / espnLigue1SeasonWeekEvents

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
{season_type}	season_type	yes	number | string — the season type: 1 preseason, 2 regular season, 3 postseason
{week}	week	yes	number | string — the week of the season (football)
limit	limit	no	number | string — the maximum number of items to return; default 500
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonWeekGames({ season: '…', season_type: '…', week: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_week_games(...)

espnLigue1SeasonWeekPowerindex

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
{season_type}	season_type	yes	number | string — the season type: 1 preseason, 2 regular season, 3 postseason
{week}	week	yes	number | string — the week of the season (football)
limit	limit	no	number | string — Page size for this weekly power-index table; pass a limit large enough to avoid paging (table size varies by sport/league -- CFB's FBS table alone is ~134 rows)
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonWeekPowerindex({ season: '…', season_type: '…', week: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_week_powerindex(...)

espnLigue1SeasonWeeks

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

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

API param	JS	required	description
{season}	season	yes	number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25)
{season_type}	season_type	yes	number | string — the season type: 1 preseason, 2 regular season, 3 postseason
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1SeasonWeeks({ season: '…', season_type: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_season_weeks(...)

espnLigue1Seasons

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

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

API param	JS	required	description
limit	limit	no	number | string — the maximum number of items to return; default 200
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1Seasons({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_seasons(...)

espnLigue1StandingsCore

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

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

API param	JS	required	description
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
group_name	character
group_abbreviation	character
team_id	character	ESPN team id
team_name	character
team_abbreviation	character	Team abbreviation
team_display_name	character	Team display name
team_location	character
team_logo	character
avg_points_against	number
avg_points_for	number
clincher	integer
differential	integer
division_win_percent	number
games_behind	integer
league_win_percent	number
losses	integer	Number of matches the team has lost.
playoff_seed	integer
point_differential	integer	Goal difference (for minus against).
points	integer	Competition points.
points_against	integer	Goals conceded.
points_for	integer	Goals (or runs) scored by the team.
streak	integer
win_percent	number
wins	integer	Number of matches the team has won.
games_ahead	integer
overall	character	Overall record summary as published by ESPN.
home	character
road	character
vs_div	character
vs_conf	character
last_ten_games	character

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1StandingsCore({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_standings_core(...)

espnLigue1Talentpicks

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

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

API param	JS	required	description
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1Talentpicks({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_talentpicks(...)

espnLigue1TeamCore

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

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

API param	JS	required	description
{team_id}	team_id	yes	number | string — the ESPN team id (see espn_<league>_teams)
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1TeamCore({ team_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_team_core(...)

espnLigue1TeamsCore

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

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

API param	JS	required	description
limit	limit	no	number | string — the maximum number of items to return; default 1000
page	page	no	number | string — the page of a paginated Core v2 list (1-based); default 1
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_teams for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1TeamsCore({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_teams_core(...)

espnLigue1Tournaments

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

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

API param	JS	required	description
limit	limit	no	number | string — the maximum number of items to return; default 200
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1Tournaments({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_tournaments(...)

espnLigue1Venue

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

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

API param	JS	required	description
{venue_id}	venue_id	yes	number | string — the ESPN venue id
—	parsed	no	boolean — return 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 and payload, so no fixed table is published. This endpoint is exposed on 30 leagues (nba, wnba, nbagl, mbb, wbb, cfb, nfl, mlb, nhl, mch, wch, college_baseball, college_softball, ufl, xfl, cfl, soccer, epl, laliga, bundesliga, seriea, ligue1, mls, ligamx, ucl, uel, nwsl, wwc, wc, cricket) — see parse_single_entity for the shared parser note.

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1Venue({ venue_id: '…' });
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_venue(...)

espnLigue1Venues

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

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

API param	JS	required	description
limit	limit	no	number | string — the maximum number of items to return; default 1000
—	parsed	no	boolean — return tidy rows instead of raw JSON

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

col_name	type	description
$ref	character	Core v2 $ref URL to the resource

Rows are untyped Row[] (not parity-verified yet).

Example:

await sdv.ligue1.espnLigue1Venues({});
// snake_case alias (py/R parity): sdv.ligue1.espn_ligue1_venues(...)

Generated by tools/codegen/generate.mjs from tools/codegen/endpoints/espn*.yaml (vendored from sdv-py) — see How this library is built._