Skip to main content

nbagl — Web API

5 endpoints on sdv.nbagl. 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).

espnNbaglPlayerGamelog​

NBAGL — player gamelog (ESPN site.web.api.espn.com (web v3)).

Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/nba-development/athletes/{athlete_id}/gamelog

API paramJSrequireddescription
{athlete_id}athlete_idyespath parameter
seasonseasonnoquery parameter
—parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
season_type_idcharacterSeason type id (regular/post)
season_type_namecharacterSeason type name
categorycharacterStat / leader category name
event_idcharacterESPN event/game id
event_datecharacterEvent date (ISO 8601)
home_awaycharacterhome or away
scorecharacterFinal score for the athlete's team
opponent_idcharacterOpponent ESPN team id
opponent_abbreviationcharacterOpponent abbreviation
opponent_display_namecharacterOpponent display name
game_resultcharacterGame result (W/L)
game_processedlogicalWhether the game has been processed

Example:

await sdv.nbagl.espnNbaglPlayerGamelog({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.nbagl.espn_nbagl_player_gamelog(...)

espnNbaglPlayerOverview​

NBAGL — player overview (ESPN site.web.api.espn.com (web v3)).

Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/nba-development/athletes/{athlete_id}/overview

API paramJSrequireddescription
{athlete_id}athlete_idyespath parameter
—parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
athlete_idcharacterESPN athlete id
athlete_display_namecharacterAthlete display name
athlete_short_namecharacterAthlete short name
athlete_positioncharacterPosition abbreviation
athlete_jerseycharacterJersey number
athlete_team_idcharacterAthlete's team id
athlete_team_abbreviationcharacterAthlete's team abbreviation
split_namecharacterSplit / season-segment name
split_categorycharacterSplit category

Example:

await sdv.nbagl.espnNbaglPlayerOverview({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.nbagl.espn_nbagl_player_overview(...)

espnNbaglPlayerSplits​

NBAGL — player splits (ESPN site.web.api.espn.com (web v3)).

Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/nba-development/athletes/{athlete_id}/splits

API paramJSrequireddescription
{athlete_id}athlete_idyespath parameter
seasonseasonnoquery parameter
—parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
categorycharacterStat / leader category name
split_namecharacterSplit / season-segment name
split_abbreviationcharacterSplit abbreviation
split_categorycharacterSplit category
split_valuecharacterSplit value
split_descriptioncharacterSplit description

Example:

await sdv.nbagl.espnNbaglPlayerSplits({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.nbagl.espn_nbagl_player_splits(...)

espnNbaglPlayerStats​

NBAGL — player stats (ESPN site.web.api.espn.com (web v3)).

Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/nba-development/athletes/{athlete_id}/stats

API paramJSrequireddescription
{athlete_id}athlete_idyespath parameter
seasonseasonnoquery parameter
—parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
categorycharacterStat / leader category name
split_namecharacterSplit / season-segment name
split_categorycharacterSplit category
split_valuecharacterSplit value

Example:

await sdv.nbagl.espnNbaglPlayerStats({ athlete_id: '…' });
// snake_case alias (py/R parity): sdv.nbagl.espn_nbagl_player_stats(...)

espnNbaglLeaders​

NBAGL — leaders (ESPN site.web.api.espn.com (web v3)).

Endpoint URL: GET https://site.web.api.espn.com/apis/common/v3/sports/basketball/nba-development/statistics/byathlete

API paramJSrequireddescription
categorycategorynoquery parameter
seasonseasonnoquery parameter
seasontypeseason_typenoquery parameter
limitlimitnoquery parameter (default 50)
pagepagenoquery parameter (default 1)
sortsortnoquery parameter
—parsednoreturn tidy rows instead of raw JSON

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

col_nametypedescription
categorycharacterStat / leader category name
rankintegerRank within the category
athlete_idcharacterESPN athlete id
athlete_display_namecharacterAthlete display name
athlete_short_namecharacterAthlete short name
athlete_jerseycharacterJersey number
athlete_positioncharacterPosition abbreviation
team_idcharacterESPN team id
team_abbreviationcharacterTeam abbreviation
team_display_namecharacterTeam display name

Example:

await sdv.nbagl.espnNbaglLeaders({});
// snake_case alias (py/R parity): sdv.nbagl.espn_nbagl_leaders(...)