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)

cfb — Core API

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

espnCfbPlayerAwards

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/athletes/{athlete_id}/awards

Deprecated aliases (pre-v4 names, still callable): espn_cfb_athlete_awards / espnCfbAthleteAwards

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.cfb.espnCfbPlayerAwards({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_player_awards(...)

espnCfbPlayerCareerStats

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/athletes/{athlete_id}/statistics[/{stat_type}]

Deprecated aliases (pre-v4 names, still callable): espn_cfb_athlete_career_stats / espnCfbAthleteCareerStats

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.cfb.espnCfbPlayerCareerStats({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_player_career_stats(...)

espnCfbPlayerContracts

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/athletes/{athlete_id}/contracts

Deprecated aliases (pre-v4 names, still callable): espn_cfb_athlete_contracts / espnCfbAthleteContracts

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.cfb.espnCfbPlayerContracts({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_player_contracts(...)

espnCfbPlayerCore

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/athletes/{athlete_id}

Deprecated aliases (pre-v4 names, still callable): espn_cfb_athlete_core / espnCfbAthleteCore

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.cfb.espnCfbPlayerCore({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_player_core(...)

espnCfbPlayerEventlog

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/athletes/{athlete_id}/eventlog

Deprecated aliases (pre-v4 names, still callable): espn_cfb_athlete_eventlog / espnCfbAthleteEventlog

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.cfb.espnCfbPlayerEventlog({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_player_eventlog(...)

espnCfbPlayerInjuries

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/athletes/{athlete_id}/injuries

Deprecated aliases (pre-v4 names, still callable): espn_cfb_athlete_injuries / espnCfbAthleteInjuries

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.cfb.espnCfbPlayerInjuries({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_player_injuries(...)

espnCfbPlayerNotes

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/athletes/{athlete_id}/notes

Deprecated aliases (pre-v4 names, still callable): espn_cfb_athlete_notes / espnCfbAthleteNotes

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.cfb.espnCfbPlayerNotes({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_player_notes(...)

espnCfbPlayerRecords

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/athletes/{athlete_id}/records

Deprecated aliases (pre-v4 names, still callable): espn_cfb_athlete_records / espnCfbAthleteRecords

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.cfb.espnCfbPlayerRecords({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_player_records(...)

espnCfbPlayerSeasons

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/athletes/{athlete_id}/seasons

Deprecated aliases (pre-v4 names, still callable): espn_cfb_athlete_seasons / espnCfbAthleteSeasons

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.cfb.espnCfbPlayerSeasons({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_player_seasons(...)

espnCfbPlayerStatisticslog

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/athletes/{athlete_id}/statisticslog

Deprecated aliases (pre-v4 names, still callable): espn_cfb_athlete_statisticslog / espnCfbAthleteStatisticslog

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.cfb.espnCfbPlayerStatisticslog({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_player_statisticslog(...)

espnCfbPlayerVsPlayer

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/athletes/{athlete_id}/vsathlete/{opp_id}

Deprecated aliases (pre-v4 names, still callable): espn_cfb_athlete_vs_athlete / espnCfbAthleteVsAthlete

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.cfb.espnCfbPlayerVsPlayer({ athlete_id: '…', opp_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_player_vs_player(...)

espnCfbPlayersIndex

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/athletes

Deprecated aliases (pre-v4 names, still callable): espn_cfb_athletes_index / espnCfbAthletesIndex

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.cfb.espnCfbPlayersIndex({});
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_players_index(...)

espnCfbAward

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbAward({ award_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_award(...)

espnCfbAwards

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbAwards({});
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_awards(...)

espnCfbCoach

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbCoach({ coach_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_coach(...)

espnCfbCoachRecord

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbCoachRecord({ coach_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_coach_record(...)

espnCfbCoachSeason

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbCoachSeason({ coach_id: '…', season: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_coach_season(...)

espnCfbGame

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event / espnCfbEvent

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.cfb.espnCfbGame({ event_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game(...)

espnCfbGameBroadcasts

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/broadcasts

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_broadcasts / espnCfbEventBroadcasts

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.cfb.espnCfbGameBroadcasts({ event_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_broadcasts(...)

espnCfbGameCompetition

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_competition / espnCfbEventCompetition

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.cfb.espnCfbGameCompetition({ event_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_competition(...)

espnCfbGameTeam

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/competitors/{team_id}

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_competitor / espnCfbEventCompetitor

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.cfb.espnCfbGameTeam({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_team(...)

espnCfbGameTeamLeaders

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/competitors/{team_id}/leaders

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_competitor_leaders / espnCfbEventCompetitorLeaders

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.cfb.espnCfbGameTeamLeaders({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_team_leaders(...)

espnCfbGameTeamLinescores

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/competitors/{team_id}/linescores

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_competitor_linescores / espnCfbEventCompetitorLinescores

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.cfb.espnCfbGameTeamLinescores({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_team_linescores(...)

espnCfbGameTeamRecord

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/competitors/{team_id}/record

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_competitor_record / espnCfbEventCompetitorRecord

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.cfb.espnCfbGameTeamRecord({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_team_record(...)

espnCfbGameTeamRoster

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/competitors/{team_id}/roster

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_competitor_roster / espnCfbEventCompetitorRoster

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.cfb.espnCfbGameTeamRoster({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_team_roster(...)

espnCfbGameTeamStatistics

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/competitors/{team_id}/statistics

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_competitor_statistics / espnCfbEventCompetitorStatistics

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.cfb.espnCfbGameTeamStatistics({ event_id: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_team_statistics(...)

espnCfbGameTeams

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/competitors

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_competitors / espnCfbEventCompetitors

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.cfb.espnCfbGameTeams({ event_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_teams(...)

espnCfbGameLeaders

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/leaders

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_leaders / espnCfbEventLeaders

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.cfb.espnCfbGameLeaders({ event_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_leaders(...)

espnCfbGameOdds

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/odds

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_odds / espnCfbEventOdds

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.cfb.espnCfbGameOdds({ event_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_odds(...)

espnCfbGameOfficialDetail

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/officials/{official_id}

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_official_detail / espnCfbEventOfficialDetail

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.cfb.espnCfbGameOfficialDetail({ event_id: '…', official_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_official_detail(...)

espnCfbGameOfficials

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/officials

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_officials / espnCfbEventOfficials

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.cfb.espnCfbGameOfficials({ event_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_officials(...)

espnCfbGamePlay

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/plays/{play_id}

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_play / espnCfbEventPlay

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.cfb.espnCfbGamePlay({ event_id: '…', play_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_play(...)

espnCfbGamePlayPersonnel

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/plays/{play_id}/personnel

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_play_personnel / espnCfbEventPlayPersonnel

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.cfb.espnCfbGamePlayPersonnel({ event_id: '…', play_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_play_personnel(...)

espnCfbGamePlays

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/plays

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_plays / espnCfbEventPlays

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.cfb.espnCfbGamePlays({ event_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_plays(...)

espnCfbGamePowerindex

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/powerindex

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_powerindex / espnCfbEventPowerindex

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.cfb.espnCfbGamePowerindex({ event_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_powerindex(...)

espnCfbGamePredictor

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/predictor

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_predictor / espnCfbEventPredictor

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.cfb.espnCfbGamePredictor({ event_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_predictor(...)

espnCfbGameProbabilities

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/probabilities

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_probabilities / espnCfbEventProbabilities

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.cfb.espnCfbGameProbabilities({ event_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_probabilities(...)

espnCfbGamePropbets

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/propbets

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_propbets / espnCfbEventPropbets

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.cfb.espnCfbGamePropbets({ event_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_propbets(...)

espnCfbGameScoringplays

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/scoringplays

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_scoringplays / espnCfbEventScoringplays

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.cfb.espnCfbGameScoringplays({ event_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_scoringplays(...)

espnCfbGameSituation

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/situation

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_situation / espnCfbEventSituation

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.cfb.espnCfbGameSituation({ event_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_situation(...)

espnCfbGameStatus

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events/{event_id}/competitions/{cid}/status

Deprecated aliases (pre-v4 names, still callable): espn_cfb_event_status / espnCfbEventStatus

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.cfb.espnCfbGameStatus({ event_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_game_status(...)

espnCfbGames

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/events

Deprecated aliases (pre-v4 names, still callable): espn_cfb_events / espnCfbEvents

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.cfb.espnCfbGames({});
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_games(...)

espnCfbFranchise

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbFranchise({ franchise_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_franchise(...)

espnCfbFranchises

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbFranchises({});
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_franchises(...)

espnCfbLeadersCore

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbLeadersCore({});
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_leaders_core(...)

espnCfbLeagueNotes

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbLeagueNotes({});
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_league_notes(...)

espnCfbLeagueRoot

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football

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.cfb.espnCfbLeagueRoot({});
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_league_root(...)

espnCfbPosition

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbPosition({ position_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_position(...)

espnCfbPositions

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbPositions({});
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_positions(...)

espnCfbSeasonPlayers

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/seasons/{season}/athletes

Deprecated aliases (pre-v4 names, still callable): espn_cfb_season_athletes / espnCfbSeasonAthletes

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.cfb.espnCfbSeasonPlayers({ season: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_players(...)

espnCfbSeasonAwards

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonAwards({ season: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_awards(...)

espnCfbSeasonCoaches

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonCoaches({ season: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_coaches(...)

espnCfbSeasonDraft

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonDraft({ season: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_draft(...)

espnCfbSeasonDraftRoundPicks

CFB — season draft round picks (ESPN sports.core.api.espn.com (core v2)).

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonDraftRoundPicks({ season: '…', round_num: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_draft_round_picks(...)

espnCfbSeasonFreeagents

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonFreeagents({ season: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_freeagents(...)

espnCfbFutures

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/seasons/{season}/futures

Deprecated aliases (pre-v4 names, still callable): espn_cfb_season_futures / espnCfbSeasonFutures

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.cfb.espnCfbFutures({ season: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_futures(...)

espnCfbSeasonGroup

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonGroup({ season: '…', season_type: '…', group_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_group(...)

espnCfbSeasonGroupChildren

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonGroupChildren({ season: '…', season_type: '…', group_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_group_children(...)

espnCfbSeasonGroupTeams

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonGroupTeams({ season: '…', season_type: '…', group_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_group_teams(...)

espnCfbGroups

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/seasons/{season}/types/{season_type}/groups

Deprecated aliases (pre-v4 names, still callable): espn_cfb_season_groups / espnCfbSeasonGroups

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.cfb.espnCfbGroups({ season: '…', season_type: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_groups(...)

espnCfbSeasonInfo

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonInfo({ season: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_info(...)

espnCfbSeasonPointer

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonPointer({});
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_pointer(...)

espnCfbTeamPowerindex

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/seasons/{season}/powerindex[/{team_id}]

Deprecated aliases (pre-v4 names, still callable): espn_cfb_season_powerindex / espnCfbSeasonPowerindex

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.cfb.espnCfbTeamPowerindex({ season: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_team_powerindex(...)

espnCfbSeasonPowerindexLeaders

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonPowerindexLeaders({ season: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_powerindex_leaders(...)

espnCfbSeasonTeam

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonTeam({ season: '…', team_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_team(...)

espnCfbSeasonTeams

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonTeams({ season: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_teams(...)

espnCfbSeasonType

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonType({ season: '…', season_type: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_type(...)

espnCfbSeasonTypeCorrections

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonTypeCorrections({ season: '…', season_type: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_type_corrections(...)

espnCfbSeasonTypeLeaders

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonTypeLeaders({ season: '…', season_type: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_type_leaders(...)

espnCfbSeasonTypes

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonTypes({ season: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_types(...)

espnCfbSeasonWeek

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonWeek({ season: '…', season_type: '…', week: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_week(...)

espnCfbSeasonWeekGames

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/seasons/{season}/types/{season_type}/weeks/{week}/events

Deprecated aliases (pre-v4 names, still callable): espn_cfb_season_week_events / espnCfbSeasonWeekEvents

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.cfb.espnCfbSeasonWeekGames({ season: '…', season_type: '…', week: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_week_games(...)

espnCfbSeasonWeekPowerindex

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonWeekPowerindex({ season: '…', season_type: '…', week: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_week_powerindex(...)

espnCfbSeasonWeeks

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasonWeeks({ season: '…', season_type: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_season_weeks(...)

espnCfbSeasons

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbSeasons({});
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_seasons(...)

espnCfbStandingsCore

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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 nickname.
team_abbreviation	character	Team abbreviation
team_display_name	character	Team display name
team_location	character	Team location / school name.
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	Home team name.
road	character
vs_div	character
vs_conf	character
last_ten_games	character

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

Example:

await sdv.cfb.espnCfbStandingsCore({});
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_standings_core(...)

espnCfbTalentpicks

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbTalentpicks({});
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_talentpicks(...)

espnCfbTeamCore

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbTeamCore({ team_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_team_core(...)

espnCfbTeamsCore

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbTeamsCore({});
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_teams_core(...)

espnCfbTournaments

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbTournaments({});
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_tournaments(...)

espnCfbVenue

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbVenue({ venue_id: '…' });
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_venue(...)

espnCfbVenues

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

Endpoint URL: GET https://sports.core.api.espn.com/v2/sports/football/leagues/college-football/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.cfb.espnCfbVenues({});
// snake_case alias (py/R parity): sdv.cfb.espn_cfb_venues(...)

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