- Public names are sportsdataverse-py's —
athlete→player,event→gameon every ESPN league; sdv-py'sname_patternon 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 wasAssetFetchError), 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 tounknown(wasany); verified endpoints resolve to their row interfaces; the summary dispatchers toParsedTables. Narrow or cast a raw payload. (changelog) - Typed wrapper params and loader rows;
strictmode — TypeScript only. A param the endpoint does not have, a missing required path param or a non-booleanboolparam is a type error; parser rows areRecord<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 followDEFAULT_RETRY_STATUSESwith backoff. (changelog)
nbasl_lv — Site API
24 endpoints on sdv.nbasl_lv. 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).
espnNbaslLvPlayerBio
NBASL_LV — player bio (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/athletes/{athlete_id}/bio
| 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 40 leagues (nba, wnba, nbagl, nbl, fiba, olympics_mbk, olympics_wbk, nbasl_lv, nbasl_ut, nbasl_ca, nbasl_sac, nbasl_orl, nbasl_gs, 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.nbasl_lv.espnNbaslLvPlayerBio({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_player_bio(...)
espnNbaslLvPlayerInfo
NBASL_LV — player info (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/athletes/{athlete_id}
| 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 40 leagues (nba, wnba, nbagl, nbl, fiba, olympics_mbk, olympics_wbk, nbasl_lv, nbasl_ut, nbasl_ca, nbasl_sac, nbasl_orl, nbasl_gs, 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.nbasl_lv.espnNbaslLvPlayerInfo({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_player_info(...)
espnNbaslLvPlayerNews
NBASL_LV — player news (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/athletes/{athlete_id}/news
| 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_news):
| col_name | type | description |
|---|---|---|
id | integer | ESPN numeric identifier for the article. |
now_id | character | ESPN 'now' feed id. |
content_key | character | Internal content key. |
data_source_identifier | character | Source-system identifier. |
type | character | Article type (Story, Media, HeadlineNews, etc.). |
headline | character | Article headline. |
description | character | Article summary/description. |
last_modified | character | Last-modified timestamp (ISO 8601). |
published | character | Publish timestamp (ISO 8601). |
images | character | Article images (list, stringified). |
categories | character | Article categories (list, stringified). |
premium | logical | Whether the article is premium/paywalled. |
links_web_href | character | Web article URL. |
links_mobile_href | character | Mobile article URL. |
links_api_self_href | character | ESPN API canonical self-link for the article resource. |
links_app_sportscenter_href | character | SportsCenter app deep link. |
byline | character | Author byline string as published by ESPN. |
Rows are untyped Row[] (not parity-verified yet).
Example:
await sdv.nbasl_lv.espnNbaslLvPlayerNews({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_player_news(...)
espnNbaslLvCalendar
NBASL_LV — calendar (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/calendar
| 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.nbasl_lv.espnNbaslLvCalendar({});
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_calendar(...)
espnNbaslLvConferences
NBASL_LV — conferences (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/groups
| 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_groups); the column set varies by league and payload, so no fixed table is published. This endpoint is exposed on 40 leagues (nba, wnba, nbagl, nbl, fiba, olympics_mbk, olympics_wbk, nbasl_lv, nbasl_ut, nbasl_ca, nbasl_sac, nbasl_orl, nbasl_gs, 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_groups for the shared parser note.
Rows are untyped Row[] (not parity-verified yet).
Example:
await sdv.nbasl_lv.espnNbaslLvConferences({});
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_conferences(...)
espnNbaslLvDraft
NBASL_LV — draft (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/draft
| 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.nbasl_lv.espnNbaslLvDraft({});
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_draft(...)
espnNbaslLvInjuries
NBASL_LV — injuries (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/injuries
| API param | JS | required | description |
|---|---|---|---|
| — | 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.nbasl_lv.espnNbaslLvInjuries({});
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_injuries(...)
espnNbaslLvNews
NBASL_LV — news (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/news
| API param | JS | required | description |
|---|---|---|---|
limit | limit | no | number | string — the maximum number of items to return; default 50 |
| — | parsed | no | boolean — return tidy rows instead of raw JSON |
Returns (with { parsed: true }, via parse_news):
| col_name | type | description |
|---|---|---|
id | integer | ESPN numeric identifier for the article. |
now_id | character | ESPN 'now' feed id. |
content_key | character | Internal content key. |
data_source_identifier | character | Source-system identifier. |
type | character | Article type (Story, Media, HeadlineNews, etc.). |
headline | character | Article headline. |
description | character | Article summary/description. |
last_modified | character | Last-modified timestamp (ISO 8601). |
published | character | Publish timestamp (ISO 8601). |
images | character | Article images (list, stringified). |
categories | character | Article categories (list, stringified). |
premium | logical | Whether the article is premium/paywalled. |
links_web_href | character | Web article URL. |
links_mobile_href | character | Mobile article URL. |
links_api_self_href | character | ESPN API canonical self-link for the article resource. |
links_app_sportscenter_href | character | SportsCenter app deep link. |
byline | character | Author byline string as published by ESPN. |
Rows are untyped Row[] (not parity-verified yet).
Example:
await sdv.nbasl_lv.espnNbaslLvNews({});
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_news(...)
espnNbaslLvScoreboard
NBASL_LV — scoreboard (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/scoreboard
| API param | JS | required | description |
|---|---|---|---|
dates | dates | no | number | string — a date YYYYMMDD, a range YYYYMMDD-YYYYMMDD or a season year YYYY |
week | week | no | number | string — the week of the season (football) |
seasontype | season_type | no | number | string — the season type: 1 preseason, 2 regular season, 3 postseason |
groups | groups | no | number | string — an ESPN group (conference / division) id, e.g. 50 for all of men's college basketball |
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_scoreboard):
| col_name | type | description |
|---|---|---|
game_id | character | Unique game identifier. |
uid | character | ESPN UID string. |
date | character | Match start timestamp (ISO 8601, UTC). |
name | character | Full event name (e.g. 'Team A at Team B'). |
short_name | character | Abbreviated event name (e.g. 'TA @ TB'). |
season_year | integer | Integer season year ESPN assigns the event (e.g. 2025 for the 2025-26 season). |
season_type | integer | ESPN season-type id of the event's season: 1 preseason, 2 regular season, 3 postseason, 4 offseason for the US leagues; soccer competitions carry their own competition-specific ids (e.g. 13481). |
season_slug | character | ESPN slug of the event's season type (e.g. 'regular-season', 'post-season'; soccer competitions use their own, such as 'final' or 'torneo-apertura'). |
status_type_id | character | Unique identifier for status type. |
status_type_name | character | Status type name. |
status_type_state | character | Status type state. |
status_type_completed | logical | Status type completed. |
status_type_description | character | Status type description. |
status_type_detail | character | Status type detail. |
status_type_short_detail | character | Status type short detail. |
status_clock | integer | Game clock in seconds as ESPN reports it: time remaining in the period for clock sports, elapsed seconds for soccer (e.g. 5400.0 at full time); 0.0 once a game has ended. |
status_display_clock | character | Status display clock. |
status_period | integer | Current or final period number (quarter, half, inning or period, depending on the sport). |
neutral_site | logical | Whether the match is played at a neutral venue. |
conference_competition | logical | Conference competition. |
attendance | integer | Reported attendance. |
venue_id | character | Unique venue identifier. |
venue_full_name | character | Venue full name. |
venue_city | character | Venue city. |
venue_state | character | Venue state / region. |
venue_indoor | logical | TRUE if the venue is indoors. |
broadcast | character | Every network name of the competition in feed order, deduped and ", "-joined (an entry with no names gives its market); "" when the game lists no broadcast. |
note | character | Event note text from the competition (e.g. a series or game label such as 'World Series - Game 1', or a shootout result); an empty string when there is none. |
home_id | character | Unique identifier for home. |
home_name | character | Home name. |
home_abbreviation | character | Home team's abbreviation. |
home_display_name | character | Home display name. |
home_location | character | Home team's location. |
home_color | character | Color code (hex) for home. |
home_alternate_color | character | Color code (hex) for home alternate. |
home_logo | character | Home team logo URL. |
home_score | character | Home team's score. For cricket, the innings string (e.g. '161/5 (18/20 ov, target 156)'). |
home_winner | logical | Home team's winner. |
home_rank | character | |
away_id | character | Unique identifier for away. |
away_name | character | Away name. |
away_abbreviation | character | Away team's abbreviation. |
away_display_name | character | Away display name. |
away_location | character | Away team's location. |
away_color | character | Color code (hex) for away. |
away_alternate_color | character | Color code (hex) for away alternate. |
away_logo | character | Away team logo URL. |
away_score | character | Away team's score. For cricket, the innings string. |
away_winner | logical | Away team's winner. |
away_rank | character |
Rows are untyped Row[] (not parity-verified yet).
Example:
await sdv.nbasl_lv.espnNbaslLvScoreboard({});
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_scoreboard(...)
espnNbaslLvStandings
NBASL_LV — standings (ESPN site.api.espn.com (v2)).
Endpoint URL: GET https://site.api.espn.com/apis/v2/sports/basketball/nba-summer-las-vegas/standings
| API param | JS | required | description |
|---|---|---|---|
season | season | no | number | string — the season year (the year the season ends for winter sports, e.g. 2025 for 2024-25) |
group | group | no | number | string — an ESPN group (conference / division) id |
type | standings_type | no | number | string — the type ESPN query parameter |
| — | 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 | Full team display name (e.g. 'Las Vegas Aces'). |
team_abbreviation | character | Team abbreviation |
team_display_name | character | Team display name |
team_location | character | Team city or location string. |
team_logo | character | Team logo image URL. |
avg_points_against | number | |
avg_points_for | number | |
clincher | integer | Clincher. |
differential | integer | Differential. |
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 | Current streak (e.g. 'W3' for three-game win streak). |
win_percent | number | Win percent. |
wins | integer | Number of matches the team has won. |
games_ahead | integer | |
overall | character | Overall record summary as published by ESPN. |
home | character | Home. |
road | character | Road. |
vs_div | character | |
vs_conf | character | |
last_ten_games | character |
Rows are untyped Row[] (not parity-verified yet).
Example:
await sdv.nbasl_lv.espnNbaslLvStandings({});
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_standings(...)
espnNbaslLvStatisticsLeague
NBASL_LV — statistics league (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/statistics
| 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.nbasl_lv.espnNbaslLvStatisticsLeague({});
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_statistics_league(...)
espnNbaslLvSummary
NBASL_LV — summary (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/summary
| API param | JS | required | description |
|---|---|---|---|
event | event_id | no | number | string — the ESPN event (game) id |
| — | parsed | no | boolean — return tidy rows instead of raw JSON |
| — | section | no | with parsed, return one named sub-frame (e.g. boxscore, plays, winprobability) instead of all |
Returns: raw ESPN Dict by default. With { parsed: true } the summary dispatcher returns an object of 21 sub-frames keyed by section ({ parsed: true, section: '<name>' } for one); see ESPN parsed returns.
Rows are untyped Row[] (not parity-verified yet).
Example:
await sdv.nbasl_lv.espnNbaslLvSummary({});
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_summary(...)
espnNbaslLvTeam
NBASL_LV — team (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/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 40 leagues (nba, wnba, nbagl, nbl, fiba, olympics_mbk, olympics_wbk, nbasl_lv, nbasl_ut, nbasl_ca, nbasl_sac, nbasl_orl, nbasl_gs, 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.nbasl_lv.espnNbaslLvTeam({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_team(...)
espnNbaslLvTeamDepthcharts
NBASL_LV — team depthcharts (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/teams/{team_id}/depthcharts
| 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 (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.nbasl_lv.espnNbaslLvTeamDepthcharts({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_team_depthcharts(...)
espnNbaslLvTeamHistory
NBASL_LV — team history (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/teams/{team_id}/history
| 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 (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.nbasl_lv.espnNbaslLvTeamHistory({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_team_history(...)
espnNbaslLvTeamInjuries
NBASL_LV — team injuries (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/teams/{team_id}/injuries
| 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 (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.nbasl_lv.espnNbaslLvTeamInjuries({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_team_injuries(...)
espnNbaslLvTeamLeaders
NBASL_LV — team leaders (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/teams/{team_id}/leaders
| 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 (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.nbasl_lv.espnNbaslLvTeamLeaders({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_team_leaders(...)
espnNbaslLvTeamNews
NBASL_LV — team news (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/teams/{team_id}/news
| API param | JS | required | description |
|---|---|---|---|
{team_id} | team_id | yes | number | string — the ESPN team id (see espn_<league>_teams) |
limit | limit | no | number | string — the maximum number of items to return; default 50 |
| — | parsed | no | boolean — return tidy rows instead of raw JSON |
Returns (with { parsed: true }, via parse_news):
| col_name | type | description |
|---|---|---|
id | integer | ESPN numeric identifier for the article. |
now_id | character | ESPN 'now' feed id. |
content_key | character | Internal content key. |
data_source_identifier | character | Source-system identifier. |
type | character | Article type (Story, Media, HeadlineNews, etc.). |
headline | character | Article headline. |
description | character | Article summary/description. |
last_modified | character | Last-modified timestamp (ISO 8601). |
published | character | Publish timestamp (ISO 8601). |
images | character | Article images (list, stringified). |
categories | character | Article categories (list, stringified). |
premium | logical | Whether the article is premium/paywalled. |
links_web_href | character | Web article URL. |
links_mobile_href | character | Mobile article URL. |
links_api_self_href | character | ESPN API canonical self-link for the article resource. |
links_app_sportscenter_href | character | SportsCenter app deep link. |
byline | character | Author byline string as published by ESPN. |
Rows are untyped Row[] (not parity-verified yet).
Example:
await sdv.nbasl_lv.espnNbaslLvTeamNews({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_team_news(...)
espnNbaslLvTeamRecord
NBASL_LV — team record (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/teams/{team_id}/record
| 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 (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.nbasl_lv.espnNbaslLvTeamRecord({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_team_record(...)
espnNbaslLvTeamRoster
NBASL_LV — team roster (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/teams/{team_id}/roster
| API param | JS | required | description |
|---|---|---|---|
{team_id} | team_id | yes | number | string — the ESPN team id (see espn_<league>_teams) |
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_team_roster):
| col_name | type | description |
|---|---|---|
id | character | Id. |
uid | character | ESPN universal id for the athlete. |
guid | character | Stable cross-league team GUID. |
alternate_ids_sdr | character | |
first_name | character | Athlete's first (given) name. |
last_name | character | Athlete's last (family) name. |
full_name | character | Player's full name. |
display_name | character | Athlete's full display name as shown on ESPN. |
short_name | character | Athlete's abbreviated display name (e.g. 'L. James'). |
weight | integer | Athlete weight in pounds. |
display_weight | character | Athlete weight, formatted for display. |
height | integer | Athlete height in inches. |
display_height | character | Athlete height, formatted for display. |
age | integer | Athlete age in years. |
date_of_birth | character | Athlete date of birth (ISO 8601). |
debut_year | integer | Year of professional debut. |
links | character | |
birth_place_city | character | Birth place city. |
birth_place_country | character | Birth place country. |
college_id | character | Unique identifier for college. |
college_guid | character | |
college_mascot | character | |
college_name | character | College / pre-draft team. |
college_short_name | character | |
college_abbrev | character | |
college_logos | character | |
slug | character | URL slug for the athlete. |
headshot_href | character | Headshot image URL. |
headshot_alt | character | Alternative-text label for the headshot. |
jersey | character | Athlete's jersey number as a string. |
position_id | character | Unique position identifier. |
position_name | character | Full position name (e.g. 'Point Guard', 'Goalkeeper'). |
position_display_name | character | Position display name. |
position_abbreviation | character | Position abbreviation ('G' / 'F' / 'C'). |
position_leaf | logical | Position leaf. |
injuries | character | |
teams | character | Nested list of member-team membership spans. |
contracts | character | |
experience_years | integer | Experience years. |
contract_bird_status | integer | Contract bird status. |
contract_base_year_compensation_active | logical | Contract base year compensation active. |
contract_poison_pill_provision_active | logical | |
contract_incoming_trade_value | integer | Contract incoming trade value. |
contract_outgoing_trade_value | integer | Contract outgoing trade value. |
contract_minimum_salary_exception | logical | Contract minimum salary exception. |
contract_option_type | integer | Contract option type. |
contract_salary | integer | Contract salary. |
contract_salary_remaining | integer | Contract salary remaining. |
contract_years_remaining | integer | Contract years remaining. |
contract_season_year | integer | |
contract_season_start_date | character | |
contract_season_end_date | character | |
contract_trade_kicker_active | logical | Contract trade kicker active. |
contract_trade_kicker_percentage | integer | Contract trade kicker percentage (0-1 decimal). |
contract_trade_kicker_value | integer | Contract trade kicker value. |
contract_trade_kicker_trade_value | integer | Contract trade kicker trade value. |
contract_trade_restriction | logical | Contract trade restriction. |
contract_unsigned_foreign_pick | logical | Contract unsigned foreign pick. |
contract_active | logical | Contract active. |
status_id | character | Status identifier. |
status_name | character | Status label. |
status_type | character | Status type. |
status_abbreviation | character | Status abbreviation. |
citizenship | character | Athlete citizenship. |
birth_place_state | character | Birth place state. |
hand_type | character | Hand type. |
hand_abbreviation | character | Hand abbreviation. |
hand_display_value | character | Hand display value. |
Rows are untyped Row[] (not parity-verified yet).
Example:
await sdv.nbasl_lv.espnNbaslLvTeamRoster({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_team_roster(...)
espnNbaslLvTeamSchedule
NBASL_LV — team schedule (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/teams/{team_id}/schedule
| API param | JS | required | description |
|---|---|---|---|
{team_id} | team_id | yes | number | string — the ESPN team id (see espn_<league>_teams) |
season | season | no | 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_team_schedule); the column set varies by league and payload, so no fixed table is published. This endpoint is exposed on 40 leagues (nba, wnba, nbagl, nbl, fiba, olympics_mbk, olympics_wbk, nbasl_lv, nbasl_ut, nbasl_ca, nbasl_sac, nbasl_orl, nbasl_gs, 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_team_schedule for the shared parser note.
Rows are untyped Row[] (not parity-verified yet).
Example:
await sdv.nbasl_lv.espnNbaslLvTeamSchedule({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_team_schedule(...)
espnNbaslLvTeamTransactions
NBASL_LV — team transactions (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/teams/{team_id}/transactions
| 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 (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.nbasl_lv.espnNbaslLvTeamTransactions({ team_id: '…' });
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_team_transactions(...)
espnNbaslLvTeamsSite
NBASL_LV — teams site (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/teams
| 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: 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 40 leagues (nba, wnba, nbagl, nbl, fiba, olympics_mbk, olympics_wbk, nbasl_lv, nbasl_ut, nbasl_ca, nbasl_sac, nbasl_orl, nbasl_gs, 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.nbasl_lv.espnNbaslLvTeamsSite({});
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_teams_site(...)
espnNbaslLvTransactions
NBASL_LV — transactions (ESPN site.api.espn.com).
Endpoint URL: GET https://site.api.espn.com/apis/site/v2/sports/basketball/nba-summer-las-vegas/transactions
| API param | JS | required | description |
|---|---|---|---|
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.nbasl_lv.espnNbaslLvTransactions({});
// snake_case alias (py/R parity): sdv.nbasl_lv.espn_nbasl_lv_transactions(...)
Generated by tools/codegen/generate.mjs from tools/codegen/endpoints/espn*.yaml (vendored from sdv-py) — see How this library is built._