Skip to main content

nba — CDN (espn.com page data)

4 endpoints on sdv.nba. 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).

espnNbaCdnBoxscore​

NBA — cdn boxscore (ESPN cdn.espn.com (espn.com page data)).

Endpoint URL: GET https://cdn.espn.com/core/nba/boxscore?xhr=1

API paramJSrequireddescription
gameIdgame_idnoquery parameter
—parsednoreturn tidy rows instead of raw JSON
—sectionnowith parsed, return one named sub-frame (e.g. boxscore, plays, winprobability) instead of all

Returns: raw ESPN Dict by default. With { parsed: true } the page's gamepackageJSON (a Site v2 summary) goes through the summary dispatcher, which returns an object of 21 sub-frames keyed by section ({ parsed: true, section: '<name>' } for one); see ESPN parsed returns.

Example:

await sdv.nba.espnNbaCdnBoxscore({});
// snake_case alias (py/R parity): sdv.nba.espn_nba_cdn_boxscore(...)

espnNbaCdnPlaybyplay​

NBA — cdn playbyplay (ESPN cdn.espn.com (espn.com page data)).

Endpoint URL: GET https://cdn.espn.com/core/nba/playbyplay?xhr=1

API paramJSrequireddescription
gameIdgame_idnoquery parameter
—parsednoreturn tidy rows instead of raw JSON
—sectionnowith parsed, return one named sub-frame (e.g. boxscore, plays, winprobability) instead of all

Returns: raw ESPN Dict by default. With { parsed: true } the page's gamepackageJSON (a Site v2 summary) goes through the summary dispatcher, which returns an object of 21 sub-frames keyed by section ({ parsed: true, section: '<name>' } for one); see ESPN parsed returns.

Example:

await sdv.nba.espnNbaCdnPlaybyplay({});
// snake_case alias (py/R parity): sdv.nba.espn_nba_cdn_playbyplay(...)

espnNbaCdnSchedule​

NBA — cdn schedule (ESPN cdn.espn.com (espn.com page data)).

Endpoint URL: GET https://cdn.espn.com/core/nba/schedule?xhr=1

API paramJSrequireddescription
datedatenoquery parameter
weekweeknoquery parameter
yearseasonnoquery parameter
seasontypeseason_typenoquery parameter
—parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
game_idcharacter
uidcharacter
datecharacter
namecharacter
short_namecharacter
season_yearinteger
season_typeinteger
season_slugcharacter
status_type_idcharacter
status_type_namecharacter
status_type_statecharacter
status_type_completedlogical
status_type_descriptioncharacter
status_type_detailcharacter
status_type_short_detailcharacter
status_clockinteger
status_display_clockcharacter
status_periodinteger
neutral_sitelogical
conference_competitionlogical
attendanceinteger
venue_idcharacter
venue_full_namecharacter
venue_citycharacter
venue_statecharacter
venue_indoorlogical
broadcastcharacter
notecharacter
home_idcharacter
home_namecharacter
home_abbreviationcharacter
home_display_namecharacter
home_locationcharacter
home_colorcharacter
home_alternate_colorcharacter
home_logocharacter
home_scorecharacter
home_winnerlogical
home_rankcharacter
away_idcharacter
away_namecharacter
away_abbreviationcharacter
away_display_namecharacter
away_locationcharacter
away_colorcharacter
away_alternate_colorcharacter
away_logocharacter
away_scorecharacter
away_winnerlogical
away_rankcharacter

Example:

await sdv.nba.espnNbaCdnSchedule({});
// snake_case alias (py/R parity): sdv.nba.espn_nba_cdn_schedule(...)

espnNbaCdnScoreboard​

NBA — cdn scoreboard (ESPN cdn.espn.com (espn.com page data)).

Endpoint URL: GET https://cdn.espn.com/core/nba/scoreboard?xhr=1

API paramJSrequireddescription
datedatenoquery parameter
weekweeknoquery parameter
yearseasonnoquery parameter
seasontypeseason_typenoquery parameter
—parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
game_idcharacter
uidcharacter
datecharacter
namecharacter
short_namecharacter
season_yearinteger
season_typeinteger
season_slugcharacter
status_type_idcharacter
status_type_namecharacter
status_type_statecharacter
status_type_completedlogical
status_type_descriptioncharacter
status_type_detailcharacter
status_type_short_detailcharacter
status_clockinteger
status_display_clockcharacter
status_periodinteger
neutral_sitelogical
conference_competitionlogical
attendanceinteger
venue_idcharacter
venue_full_namecharacter
venue_citycharacter
venue_statecharacter
venue_indoorlogical
broadcastcharacter
notecharacter
home_idcharacter
home_namecharacter
home_abbreviationcharacter
home_display_namecharacter
home_locationcharacter
home_colorcharacter
home_alternate_colorcharacter
home_logocharacter
home_scorecharacter
home_winnerlogical
home_rankcharacter
away_idcharacter
away_namecharacter
away_abbreviationcharacter
away_display_namecharacter
away_locationcharacter
away_colorcharacter
away_alternate_colorcharacter
away_logocharacter
away_scorecharacter
away_winnerlogical
away_rankcharacter

Example:

await sdv.nba.espnNbaCdnScoreboard({});
// snake_case alias (py/R parity): sdv.nba.espn_nba_cdn_scoreboard(...)