Skip to main content

NBA G League — G League Stats API (stats.nba.com, LeagueID=20) — Box scores: boxscoreadvancedv2–boxscoresummaryv3

nbagl_stats_boxscoreadvancedv2​

Box score advanced v2.

Endpoint URL: GET https://stats.nba.com/stats/boxscoreadvancedv2

Valid URL: https://stats.nba.com/stats/boxscoreadvancedv2?EndPeriod=14&EndRange=0&GameID=2022500137&RangeType=0&StartPeriod=0&StartRange=0

API ParameterPythonPatternRequiredNullableDescription
EndPeriodend_periodY
EndRangeend_rangeY
GameIDgame_idY
RangeTyperange_typeY
StartPeriodstart_periodY
StartRangestart_rangeY

Returns​

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (PlayerStats, TeamStats) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

PlayerStats

col_nametypedescription
game_idString
team_idInt64
team_abbreviationString
team_cityString
player_idInt64
player_nameString
nicknameString
start_positionStringPosition the player started the game at ('F', 'C', or 'G'); empty for bench players.
commentString
minString
e_off_ratingFloat64Estimated offensive rating: points produced per 100 possessions using the stats API's estimated-possession formula.
off_ratingFloat64Points scored per 100 possessions while on the floor.
e_def_ratingFloat64Estimated defensive rating: points allowed per 100 possessions using the estimated-possession formula.
def_ratingFloat64Points allowed per 100 possessions while on the floor.
e_net_ratingFloat64Estimated net rating: estimated offensive rating minus estimated defensive rating.
net_ratingFloat64
ast_pctFloat64
ast_tovFloat64Ratio of assists to turnovers.
ast_ratioFloat64Assists per 100 possessions used.
oreb_pctFloat64Percentage of available offensive rebounds grabbed while on the floor.
dreb_pctFloat64Percentage of available defensive rebounds grabbed while on the floor.
reb_pctFloat64Percentage of all available rebounds grabbed while on the floor.
tm_tov_pctFloat64Turnovers committed per 100 possessions.
efg_pctFloat64Effective field goal percentage: (FGM + 0.5 * FG3M) / FGA.
ts_pctFloat64
usg_pctFloat64Percentage of team plays used while on the floor.
e_usg_pctFloat64Estimated usage percentage using the stats API's estimated-possession formula.
e_paceFloat64Estimated pace: team possessions per regulation game, from the estimated-possession formula.
paceFloat64
pace_per40Float64
possInt64
pieFloat64

TeamStats

col_nametypedescription
game_idString
team_idInt64
team_nameString
team_abbreviationString
team_cityString
minString
e_off_ratingFloat64Estimated offensive rating: points produced per 100 possessions using the stats API's estimated-possession formula.
off_ratingFloat64Points scored per 100 possessions while on the floor.
e_def_ratingFloat64Estimated defensive rating: points allowed per 100 possessions using the estimated-possession formula.
def_ratingFloat64Points allowed per 100 possessions while on the floor.
e_net_ratingFloat64Estimated net rating: estimated offensive rating minus estimated defensive rating.
net_ratingFloat64
ast_pctFloat64
ast_tovFloat64Ratio of assists to turnovers.
ast_ratioFloat64Assists per 100 possessions used.
oreb_pctFloat64Percentage of available offensive rebounds grabbed while on the floor.
dreb_pctFloat64Percentage of available defensive rebounds grabbed while on the floor.
reb_pctFloat64Percentage of all available rebounds grabbed while on the floor.
e_tm_tov_pctFloat64
tm_tov_pctFloat64Turnovers committed per 100 possessions.
efg_pctFloat64Effective field goal percentage: (FGM + 0.5 * FG3M) / FGA.
ts_pctFloat64
usg_pctFloat64Percentage of team plays used while on the floor.
e_usg_pctFloat64Estimated usage percentage using the stats API's estimated-possession formula.
e_paceFloat64Estimated pace: team possessions per regulation game, from the estimated-possession formula.
paceFloat64
pace_per40Float64
possInt64
pieFloat64

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_boxscoreadvancedv2()

nbagl_stats_boxscoreadvancedv3​

Box score advanced v3.

Endpoint URL: GET https://stats.nba.com/stats/boxscoreadvancedv3

Valid URL: https://stats.nba.com/stats/boxscoreadvancedv3?EndPeriod=14&EndRange=0&GameID=2022500137&RangeType=0&StartPeriod=0&StartRange=0

API ParameterPythonPatternRequiredNullableDescription
EndPeriodend_periodY
EndRangeend_rangeY
GameIDgame_idY
RangeTyperange_typeY
StartPeriodstart_periodY
StartRangestart_rangeY

Returns​

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (PlayerStats, TeamStats) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

PlayerStats

col_nametypedescription
game_idStringUnique 10-character game identifier from the league's stats API.
away_team_idInt64
home_team_idInt64
team_idInt64
team_cityString
team_nameString
team_tricodeStringThree-letter team abbreviation.
team_slugStringURL-friendly slug for the team name.
person_idInt64Player identifier from the league's stats API.
first_nameString
family_nameStringPlayer's family (last) name.
name_iStringAbbreviated player name (first initial and last name).
player_slugStringURL-friendly slug for the player's name.
positionString
commentString
jersey_numStringPlayer's jersey number.
minutesString
estimated_offensive_ratingFloat64Estimated offensive rating from the stats API's estimated-metrics family.
offensive_ratingFloat64Points scored per 100 possessions while on the floor (offensive rating).
estimated_defensive_ratingFloat64Estimated defensive rating from the stats API's estimated-metrics family.
defensive_ratingFloat64Points allowed per 100 possessions while on the floor (defensive rating).
estimated_net_ratingFloat64Estimated net rating (estimated offensive minus defensive rating) from the stats API's estimated-metrics family.
net_ratingFloat64Offensive rating minus defensive rating while on the floor (net rating).
assist_percentageFloat64Percentage of teammate field goals assisted while on the floor, as a decimal.
assist_to_turnoverFloat64Ratio of assists to turnovers.
assist_ratioFloat64Assists per 100 possessions used (assist ratio).
offensive_rebound_percentageFloat64Percentage of available offensive rebounds secured while on the floor, as a decimal.
defensive_rebound_percentageFloat64Percentage of available defensive rebounds secured while on the floor, as a decimal.
rebound_percentageFloat64Percentage of all available rebounds secured while on the floor, as a decimal.
turnover_ratioFloat64Turnovers per 100 possessions used (turnover ratio).
effective_field_goal_percentageFloat64Effective field goal percentage (weights made threes at 1.5), as a decimal.
true_shooting_percentageFloat64True shooting percentage (accounts for threes and free throws), as a decimal.
usage_percentageFloat64Percentage of team plays used by the player while on the floor, as a decimal.
estimated_usage_percentageFloat64Estimated percentage of team plays used by the player while on the floor, as a decimal.
estimated_paceFloat64Estimated pace (possessions per 48 minutes) from the stats API's estimated-metrics family.
paceFloat64
pace_per40Float64Pace normalized to possessions per 40 minutes.
possessionsFloat64
pieFloat64

TeamStats

col_nametypedescription
game_idStringUnique 10-character game identifier from the league's stats API.
away_team_idInt64
home_team_idInt64
team_idInt64
team_cityString
team_nameString
team_tricodeStringThree-letter team abbreviation.
team_slugStringURL-friendly slug for the team name.
minutesString
estimated_offensive_ratingFloat64Estimated offensive rating from the stats API's estimated-metrics family.
offensive_ratingFloat64Points scored per 100 possessions while on the floor (offensive rating).
estimated_defensive_ratingFloat64Estimated defensive rating from the stats API's estimated-metrics family.
defensive_ratingFloat64Points allowed per 100 possessions while on the floor (defensive rating).
estimated_net_ratingFloat64Estimated net rating (estimated offensive minus defensive rating) from the stats API's estimated-metrics family.
net_ratingFloat64Offensive rating minus defensive rating while on the floor (net rating).
assist_percentageFloat64Percentage of teammate field goals assisted while on the floor, as a decimal.
assist_to_turnoverFloat64Ratio of assists to turnovers.
assist_ratioFloat64Assists per 100 possessions used (assist ratio).
offensive_rebound_percentageFloat64Percentage of available offensive rebounds secured while on the floor, as a decimal.
defensive_rebound_percentageFloat64Percentage of available defensive rebounds secured while on the floor, as a decimal.
rebound_percentageFloat64Percentage of all available rebounds secured while on the floor, as a decimal.
estimated_team_turnover_percentageFloat64
turnover_ratioFloat64Turnovers per 100 possessions used (turnover ratio).
effective_field_goal_percentageFloat64Effective field goal percentage (weights made threes at 1.5), as a decimal.
true_shooting_percentageFloat64True shooting percentage (accounts for threes and free throws), as a decimal.
usage_percentageFloat64Percentage of team plays used by the player while on the floor, as a decimal.
estimated_usage_percentageFloat64Estimated percentage of team plays used by the player while on the floor, as a decimal.
estimated_paceFloat64Estimated pace (possessions per 48 minutes) from the stats API's estimated-metrics family.
paceFloat64
pace_per40Float64Pace normalized to possessions per 40 minutes.
possessionsFloat64
pieFloat64

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_boxscoreadvancedv3()

nbagl_stats_boxscorefourfactorsv2​

Box score four factors v2.

Endpoint URL: GET https://stats.nba.com/stats/boxscorefourfactorsv2

Valid URL: https://stats.nba.com/stats/boxscorefourfactorsv2?EndPeriod=14&EndRange=0&GameID=2022500137&RangeType=0&StartPeriod=0&StartRange=0

API ParameterPythonPatternRequiredNullableDescription
EndPeriodend_periodY
EndRangeend_rangeY
GameIDgame_idY
RangeTyperange_typeY
StartPeriodstart_periodY
StartRangestart_rangeY

Returns​

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (sqlPlayersFourFactors, sqlTeamsFourFactors) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

sqlPlayersFourFactors

col_nametypedescription
game_idString
team_idInt64
team_abbreviationString
team_cityString
player_idInt64
player_nameString
nicknameString
start_positionStringPosition the player started the game at ('F', 'C', or 'G'); empty for bench players.
commentString
minString
efg_pctFloat64Effective field goal percentage: (FGM + 0.5 * FG3M) / FGA.
fta_rateFloat64Free throw attempt rate: free throw attempts per field goal attempt.
tm_tov_pctFloat64Turnovers committed per 100 possessions.
oreb_pctFloat64Percentage of available offensive rebounds grabbed while on the floor.
opp_efg_pctFloat64Opponent effective field goal percentage while on the floor.
opp_fta_rateFloat64Opponent free throw attempts per field goal attempt while on the floor.
opp_tov_pctFloat64Opponent turnovers per 100 possessions while on the floor.
opp_oreb_pctFloat64Percentage of available offensive rebounds grabbed by the opponent while on the floor.

sqlTeamsFourFactors

col_nametypedescription
game_idString
team_idInt64
team_nameString
team_abbreviationString
team_cityString
minString
efg_pctFloat64Effective field goal percentage: (FGM + 0.5 * FG3M) / FGA.
fta_rateFloat64Free throw attempt rate: free throw attempts per field goal attempt.
tm_tov_pctFloat64Turnovers committed per 100 possessions.
oreb_pctFloat64Percentage of available offensive rebounds grabbed while on the floor.
opp_efg_pctFloat64Opponent effective field goal percentage while on the floor.
opp_fta_rateFloat64Opponent free throw attempts per field goal attempt while on the floor.
opp_tov_pctFloat64Opponent turnovers per 100 possessions while on the floor.
opp_oreb_pctFloat64Percentage of available offensive rebounds grabbed by the opponent while on the floor.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_boxscorefourfactorsv2()

nbagl_stats_boxscorefourfactorsv3​

Box score four factors v3.

Endpoint URL: GET https://stats.nba.com/stats/boxscorefourfactorsv3

Valid URL: https://stats.nba.com/stats/boxscorefourfactorsv3?EndPeriod=14&EndRange=0&GameID=2022500137&RangeType=0&StartPeriod=0&StartRange=0

API ParameterPythonPatternRequiredNullableDescription
EndPeriodend_periodY
EndRangeend_rangeY
GameIDgame_idY
RangeTyperange_typeY
StartPeriodstart_periodY
StartRangestart_rangeY

Returns​

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (PlayerStats, TeamStats) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

PlayerStats

col_nametypedescription
game_idStringUnique 10-character game identifier from the league's stats API.
away_team_idInt64
home_team_idInt64
team_idInt64
team_cityString
team_nameString
team_tricodeStringThree-letter team abbreviation.
team_slugStringURL-friendly slug for the team name.
person_idInt64Player identifier from the league's stats API.
first_nameString
family_nameStringPlayer's family (last) name.
name_iStringAbbreviated player name (first initial and last name).
player_slugStringURL-friendly slug for the player's name.
positionString
commentString
jersey_numStringPlayer's jersey number.
minutesString
effective_field_goal_percentageFloat64Effective field goal percentage four-factor, as a decimal.
free_throw_attempt_rateFloat64Free throw attempts per field goal attempt (free throw rate four-factor).
team_turnover_percentageFloat64Turnovers committed per 100 possessions (turnover four-factor).
offensive_rebound_percentageFloat64Offensive rebound percentage four-factor, as a decimal.
opp_effective_field_goal_percentageFloat64Opponent's effective field goal percentage while on the floor, as a decimal.
opp_free_throw_attempt_rateFloat64Opponent's free throw attempt rate while on the floor.
opp_team_turnover_percentageFloat64Opponent turnovers forced per 100 possessions while on the floor.
opp_offensive_rebound_percentageFloat64Opponent's offensive rebound percentage while on the floor, as a decimal.

TeamStats

col_nametypedescription
game_idStringUnique 10-character game identifier from the league's stats API.
away_team_idInt64
home_team_idInt64
team_idInt64
team_cityString
team_nameString
team_tricodeStringThree-letter team abbreviation.
team_slugStringURL-friendly slug for the team name.
minutesString
effective_field_goal_percentageFloat64Effective field goal percentage four-factor, as a decimal.
free_throw_attempt_rateFloat64Free throw attempts per field goal attempt (free throw rate four-factor).
team_turnover_percentageFloat64Turnovers committed per 100 possessions (turnover four-factor).
offensive_rebound_percentageFloat64Offensive rebound percentage four-factor, as a decimal.
opp_effective_field_goal_percentageFloat64Opponent's effective field goal percentage while on the floor, as a decimal.
opp_free_throw_attempt_rateFloat64Opponent's free throw attempt rate while on the floor.
opp_team_turnover_percentageFloat64Opponent turnovers forced per 100 possessions while on the floor.
opp_offensive_rebound_percentageFloat64Opponent's offensive rebound percentage while on the floor, as a decimal.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_boxscorefourfactorsv3()

nbagl_stats_boxscorehustlev2​

Box score hustle v2.

Endpoint URL: GET https://stats.nba.com/stats/boxscorehustlev2

Valid URL: https://stats.nba.com/stats/boxscorehustlev2?GameID=2022500137

API ParameterPythonPatternRequiredNullableDescription
GameIDgame_idY

Returns​

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (PlayerStats, TeamStats) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

PlayerStats

col_nametypedescription
game_idStringUnique 10-character game identifier from the league's stats API.
away_team_idInt64
home_team_idInt64
team_idInt64
team_cityString
team_nameString
team_tricodeStringThree-letter team abbreviation.
team_slugStringURL-friendly slug for the team name.
person_idInt64Player identifier from the league's stats API.
first_nameString
family_nameStringPlayer's family (last) name.
name_iStringAbbreviated player name (first initial and last name).
player_slugStringURL-friendly slug for the player's name.
positionString
commentString
jersey_numStringPlayer's jersey number.
minutesString
pointsInt64
contested_shotsInt64Opponent shot attempts contested in the game.
contested_shots2ptInt64Opponent two-point attempts contested.
contested_shots3ptInt64Opponent three-point attempts contested.
deflectionsInt64
charges_drawnInt64Offensive charges drawn.
screen_assistsInt64Screens that led directly to a teammate's made field goal (screen assists).
screen_assist_pointsInt64Points teammates scored directly off the player's screen assists.
loose_balls_recovered_offensiveInt64Loose balls recovered while on offense.
loose_balls_recovered_defensiveInt64Loose balls recovered while on defense.
loose_balls_recovered_totalInt64Total loose balls recovered in the game.
offensive_box_outsInt64Box-outs recorded on the offensive glass.
defensive_box_outsInt64Box-outs recorded on the defensive glass.
box_out_player_team_reboundsInt64Team rebounds secured following the player's box-outs.
box_out_player_reboundsInt64Rebounds the player secured directly off their own box-outs.
box_outsInt64Total box-outs recorded in the game (hustle stats tracking).

TeamStats

col_nametypedescription
game_idStringUnique 10-character game identifier from the league's stats API.
away_team_idInt64
home_team_idInt64
team_idInt64
team_cityString
team_nameString
team_tricodeStringThree-letter team abbreviation.
team_slugStringURL-friendly slug for the team name.
minutesString
pointsInt64
contested_shotsInt64Opponent shot attempts contested in the game.
contested_shots2ptInt64Opponent two-point attempts contested.
contested_shots3ptInt64Opponent three-point attempts contested.
deflectionsInt64
charges_drawnInt64Offensive charges drawn.
screen_assistsInt64Screens that led directly to a teammate's made field goal (screen assists).
screen_assist_pointsInt64Points teammates scored directly off the player's screen assists.
loose_balls_recovered_offensiveInt64Loose balls recovered while on offense.
loose_balls_recovered_defensiveInt64Loose balls recovered while on defense.
loose_balls_recovered_totalInt64Total loose balls recovered in the game.
offensive_box_outsInt64Box-outs recorded on the offensive glass.
defensive_box_outsInt64Box-outs recorded on the defensive glass.
box_out_player_team_reboundsInt64Team rebounds secured following the player's box-outs.
box_out_player_reboundsInt64Rebounds the player secured directly off their own box-outs.
box_outsInt64Total box-outs recorded in the game (hustle stats tracking).

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_boxscorehustlev2()

nbagl_stats_boxscorematchupsv3​

Box score matchups v3.

Endpoint URL: GET https://stats.nba.com/stats/boxscorematchupsv3

Valid URL: https://stats.nba.com/stats/boxscorematchupsv3?GameID=2022500137

API ParameterPythonPatternRequiredNullableDescription
GameIDgame_idY

Returns​

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (PlayerStats, TeamStats) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

TeamStats

col_nametypedescription
game_idStringUnique stats.nba.com game identifier in endpoints that use compact schedule field names.
away_team_idInt64
home_team_idInt64
team_idInt64
team_cityString
team_nameString
team_tricodeStringThree-letter team code used by NBA or WNBA Stats schedule and scoreboard feeds.
team_slugStringURL slug for teamslug used by NBA or WNBA Stats pages.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_boxscorematchupsv3()

nbagl_stats_boxscoremiscv2​

Box score misc v2.

Endpoint URL: GET https://stats.nba.com/stats/boxscoremiscv2

Valid URL: https://stats.nba.com/stats/boxscoremiscv2?EndPeriod=14&EndRange=0&GameID=2022500137&RangeType=0&StartPeriod=0&StartRange=0

API ParameterPythonPatternRequiredNullableDescription
EndPeriodend_periodY
EndRangeend_rangeY
GameIDgame_idY
RangeTyperange_typeY
StartPeriodstart_periodY
StartRangestart_rangeY

Returns​

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (sqlPlayersMisc, sqlTeamsMisc) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

sqlPlayersMisc

col_nametypedescription
game_idString
team_idInt64
team_abbreviationString
team_cityString
player_idInt64
player_nameString
nicknameString
start_positionStringPosition the player started the game at ('F', 'C', or 'G'); empty for bench players.
commentString
minString
pts_off_tovInt64Points scored following opponent turnovers.
pts_2_nd_chanceInt64Second-chance points scored after offensive rebounds.
pts_fbInt64Fast-break points scored.
pts_paintInt64Points scored in the paint.
opp_pts_off_tovFloat64Opponent points scored off turnovers while on the floor.
opp_pts_2_nd_chanceFloat64Opponent second-chance points scored while on the floor.
opp_pts_fbFloat64Opponent fast-break points scored while on the floor.
opp_pts_paintFloat64Opponent points in the paint scored while on the floor.
blkInt64
blkaInt64Number of own field goal attempts that were blocked by opponents.
pfInt64
pfdInt64Personal fouls drawn.

sqlTeamsMisc

col_nametypedescription
game_idString
team_idInt64
team_nameString
team_abbreviationString
team_cityString
minString
pts_off_tovFloat64Points scored following opponent turnovers.
pts_2_nd_chanceFloat64Second-chance points scored after offensive rebounds.
pts_fbFloat64Fast-break points scored.
pts_paintFloat64Points scored in the paint.
opp_pts_off_tovFloat64Opponent points scored off turnovers while on the floor.
opp_pts_2_nd_chanceFloat64Opponent second-chance points scored while on the floor.
opp_pts_fbFloat64Opponent fast-break points scored while on the floor.
opp_pts_paintFloat64Opponent points in the paint scored while on the floor.
blkInt64
blkaInt64Number of own field goal attempts that were blocked by opponents.
pfInt64
pfdInt64Personal fouls drawn.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_boxscoremiscv2()

nbagl_stats_boxscoremiscv3​

Box score misc v3.

Endpoint URL: GET https://stats.nba.com/stats/boxscoremiscv3

Valid URL: https://stats.nba.com/stats/boxscoremiscv3?EndPeriod=14&EndRange=0&GameID=2022500137&RangeType=0&StartPeriod=0&StartRange=0

API ParameterPythonPatternRequiredNullableDescription
EndPeriodend_periodY
EndRangeend_rangeY
GameIDgame_idY
RangeTyperange_typeY
StartPeriodstart_periodY
StartRangestart_rangeY

Returns​

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (PlayerStats, TeamStats) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

PlayerStats

col_nametypedescription
game_idStringUnique 10-character game identifier from the league's stats API.
away_team_idInt64
home_team_idInt64
team_idInt64
team_cityString
team_nameString
team_tricodeStringThree-letter team abbreviation.
team_slugStringURL-friendly slug for the team name.
person_idInt64Player identifier from the league's stats API.
first_nameString
family_nameStringPlayer's family (last) name.
name_iStringAbbreviated player name (first initial and last name).
player_slugStringURL-friendly slug for the player's name.
positionString
commentString
jersey_numStringPlayer's jersey number.
minutesString
points_off_turnoversInt64Points scored off opponent turnovers.
points_second_chanceInt64Second-chance points scored after offensive rebounds.
points_fast_breakInt64Fast-break points scored.
points_paintInt64Points scored in the paint.
opp_points_off_turnoversInt64Opponent points off turnovers scored while on the floor.
opp_points_second_chanceInt64Opponent second-chance points scored while on the floor.
opp_points_fast_breakInt64Opponent fast-break points scored while on the floor.
opp_points_paintInt64Opponent points in the paint scored while on the floor.
blocksInt64
blocks_againstInt64Player's shot attempts that were blocked by opponents.
fouls_personalInt64Personal fouls committed.
fouls_drawnInt64Personal fouls drawn.

TeamStats

col_nametypedescription
game_idStringUnique 10-character game identifier from the league's stats API.
away_team_idInt64
home_team_idInt64
team_idInt64
team_cityString
team_nameString
team_tricodeStringThree-letter team abbreviation.
team_slugStringURL-friendly slug for the team name.
minutesString
points_off_turnoversInt64Points scored off opponent turnovers.
points_second_chanceInt64Second-chance points scored after offensive rebounds.
points_fast_breakInt64Fast-break points scored.
points_paintInt64Points scored in the paint.
opp_points_off_turnoversInt64Opponent points off turnovers scored while on the floor.
opp_points_second_chanceInt64Opponent second-chance points scored while on the floor.
opp_points_fast_breakInt64Opponent fast-break points scored while on the floor.
opp_points_paintInt64Opponent points in the paint scored while on the floor.
blocksInt64
blocks_againstInt64Player's shot attempts that were blocked by opponents.
fouls_personalInt64Personal fouls committed.
fouls_drawnInt64Personal fouls drawn.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_boxscoremiscv3()

nbagl_stats_boxscoreplayertrackv3​

Box score player track v3.

Endpoint URL: GET https://stats.nba.com/stats/boxscoreplayertrackv3

Valid URL: https://stats.nba.com/stats/boxscoreplayertrackv3?GameID=2022500137

API ParameterPythonPatternRequiredNullableDescription
GameIDgame_idY

Returns​

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (PlayerStats, TeamStats) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

PlayerStats

col_nametypedescription
game_idStringUnique stats.nba.com game identifier in endpoints that use compact schedule field names.
away_team_idInt64
home_team_idInt64
team_idInt64
team_cityString
team_nameString
team_tricodeStringThree-letter team code used by NBA or WNBA Stats schedule and scoreboard feeds.
team_slugStringURL slug for teamslug used by NBA or WNBA Stats pages.
person_idInt64Stats API identifier for personid associated with this NBA or WNBA Stats row.
first_nameString
family_nameStringDisplay name for familyname associated with this NBA or WNBA Stats row.
name_iStringNBA or WNBA Stats value for namei in the boxscoreplayertrackv3 result set.
player_slugStringURL slug for playerslug used by NBA or WNBA Stats pages.
positionString
commentString
jersey_numStringNBA or WNBA Stats value for jerseynum in the boxscoreplayertrackv3 result set.
minutesString
speedFloat64
distanceFloat64
rebound_chances_offensiveInt64Rebounding metric for reboundchancesoffensive in the requested NBA or WNBA Stats split.
rebound_chances_defensiveInt64Rebounding metric for reboundchancesdefensive in the requested NBA or WNBA Stats split.
rebound_chances_totalInt64Rebounding metric for reboundchancestotal in the requested NBA or WNBA Stats split.
touchesInt64
secondary_assistsInt64Passing or assist metric for secondaryassists in the requested NBA or WNBA Stats split.
free_throw_assistsInt64Shooting metric for freethrowassists in the requested NBA or WNBA Stats split.
passesInt64
assistsInt64
contested_field_goals_madeInt64Shooting metric for contestedfieldgoalsmade in the requested NBA or WNBA Stats split.
contested_field_goals_attemptedInt64Shooting metric for contestedfieldgoalsattempted in the requested NBA or WNBA Stats split.
contested_field_goal_percentageFloat64Percentage or rate for contestedfieldgoalpercentage in the requested NBA or WNBA Stats split.
uncontested_field_goals_madeInt64Shooting metric for uncontestedfieldgoalsmade in the requested NBA or WNBA Stats split.
uncontested_field_goals_attemptedInt64Shooting metric for uncontestedfieldgoalsattempted in the requested NBA or WNBA Stats split.
uncontested_field_goals_percentageFloat64Percentage or rate for uncontestedfieldgoalspercentage in the requested NBA or WNBA Stats split.
field_goal_percentageFloat64Percentage or rate for fieldgoalpercentage in the requested NBA or WNBA Stats split.
defended_at_rim_field_goals_madeInt64Shooting metric for defendedatrimfieldgoalsmade in the requested NBA or WNBA Stats split.
defended_at_rim_field_goals_attemptedInt64Shooting metric for defendedatrimfieldgoalsattempted in the requested NBA or WNBA Stats split.
defended_at_rim_field_goal_percentageFloat64Percentage or rate for defendedatrimfieldgoalpercentage in the requested NBA or WNBA Stats split.

TeamStats

col_nametypedescription
game_idStringUnique stats.nba.com game identifier in endpoints that use compact schedule field names.
away_team_idInt64
home_team_idInt64
team_idInt64
team_cityString
team_nameString
team_tricodeStringThree-letter team code used by NBA or WNBA Stats schedule and scoreboard feeds.
team_slugStringURL slug for teamslug used by NBA or WNBA Stats pages.
minutesString
distanceFloat64
rebound_chances_offensiveInt64Rebounding metric for reboundchancesoffensive in the requested NBA or WNBA Stats split.
rebound_chances_defensiveInt64Rebounding metric for reboundchancesdefensive in the requested NBA or WNBA Stats split.
rebound_chances_totalInt64Rebounding metric for reboundchancestotal in the requested NBA or WNBA Stats split.
touchesInt64
secondary_assistsInt64Passing or assist metric for secondaryassists in the requested NBA or WNBA Stats split.
free_throw_assistsInt64Shooting metric for freethrowassists in the requested NBA or WNBA Stats split.
passesInt64
assistsInt64
contested_field_goals_madeInt64Shooting metric for contestedfieldgoalsmade in the requested NBA or WNBA Stats split.
contested_field_goals_attemptedInt64Shooting metric for contestedfieldgoalsattempted in the requested NBA or WNBA Stats split.
contested_field_goal_percentageFloat64Percentage or rate for contestedfieldgoalpercentage in the requested NBA or WNBA Stats split.
uncontested_field_goals_madeInt64Shooting metric for uncontestedfieldgoalsmade in the requested NBA or WNBA Stats split.
uncontested_field_goals_attemptedInt64Shooting metric for uncontestedfieldgoalsattempted in the requested NBA or WNBA Stats split.
uncontested_field_goals_percentageFloat64Percentage or rate for uncontestedfieldgoalspercentage in the requested NBA or WNBA Stats split.
field_goal_percentageFloat64Percentage or rate for fieldgoalpercentage in the requested NBA or WNBA Stats split.
defended_at_rim_field_goals_madeInt64Shooting metric for defendedatrimfieldgoalsmade in the requested NBA or WNBA Stats split.
defended_at_rim_field_goals_attemptedInt64Shooting metric for defendedatrimfieldgoalsattempted in the requested NBA or WNBA Stats split.
defended_at_rim_field_goal_percentageFloat64Percentage or rate for defendedatrimfieldgoalpercentage in the requested NBA or WNBA Stats split.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_boxscoreplayertrackv3()

nbagl_stats_boxscorescoringv2​

Box score scoring v2.

Endpoint URL: GET https://stats.nba.com/stats/boxscorescoringv2

Valid URL: https://stats.nba.com/stats/boxscorescoringv2?EndPeriod=14&EndRange=0&GameID=2022500137&RangeType=0&StartPeriod=0&StartRange=0

API ParameterPythonPatternRequiredNullableDescription
EndPeriodend_periodY
EndRangeend_rangeY
GameIDgame_idY
RangeTyperange_typeY
StartPeriodstart_periodY
StartRangestart_rangeY

Returns​

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (sqlPlayersScoring, sqlTeamsScoring) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

sqlPlayersScoring

col_nametypedescription
game_idString
team_idInt64
team_abbreviationString
team_cityString
player_idInt64
player_nameString
nicknameString
start_positionStringPosition the player started the game at ('F', 'C', or 'G'); empty for bench players.
commentString
minString
pct_fga_2_ptFloat64Share of field goal attempts taken as two-pointers.
pct_fga_3_ptFloat64Share of field goal attempts taken as three-pointers.
pct_pts_2_ptFloat64Share of points scored on two-point field goals.
pct_pts_2_pt_mrFloat64Share of points scored on mid-range two-point field goals.
pct_pts_3_ptFloat64Share of points scored on three-point field goals.
pct_pts_fbFloat64Share of points scored on the fast break.
pct_pts_ftFloat64Share of points scored on free throws.
pct_pts_off_tovFloat64Share of points scored off opponent turnovers.
pct_pts_paintFloat64Share of points scored in the paint.
pct_ast_2_pmFloat64Share of made two-point field goals that were assisted.
pct_uast_2_pmFloat64Share of made two-point field goals that were unassisted.
pct_ast_3_pmFloat64Share of made three-point field goals that were assisted.
pct_uast_3_pmFloat64Share of made three-point field goals that were unassisted.
pct_ast_fgmFloat64Share of all made field goals that were assisted.
pct_uast_fgmFloat64Share of all made field goals that were unassisted.

sqlTeamsScoring

col_nametypedescription
game_idString
team_idInt64
team_nameString
team_abbreviationString
team_cityString
minString
pct_fga_2_ptFloat64Share of field goal attempts taken as two-pointers.
pct_fga_3_ptFloat64Share of field goal attempts taken as three-pointers.
pct_pts_2_ptFloat64Share of points scored on two-point field goals.
pct_pts_2_pt_mrFloat64Share of points scored on mid-range two-point field goals.
pct_pts_3_ptFloat64Share of points scored on three-point field goals.
pct_pts_fbFloat64Share of points scored on the fast break.
pct_pts_ftFloat64Share of points scored on free throws.
pct_pts_off_tovFloat64Share of points scored off opponent turnovers.
pct_pts_paintFloat64Share of points scored in the paint.
pct_ast_2_pmFloat64Share of made two-point field goals that were assisted.
pct_uast_2_pmFloat64Share of made two-point field goals that were unassisted.
pct_ast_3_pmFloat64Share of made three-point field goals that were assisted.
pct_uast_3_pmFloat64Share of made three-point field goals that were unassisted.
pct_ast_fgmFloat64Share of all made field goals that were assisted.
pct_uast_fgmFloat64Share of all made field goals that were unassisted.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_boxscorescoringv2()

nbagl_stats_boxscorescoringv3​

Box score scoring v3.

Endpoint URL: GET https://stats.nba.com/stats/boxscorescoringv3

Valid URL: https://stats.nba.com/stats/boxscorescoringv3?EndPeriod=14&EndRange=0&GameID=2022500137&RangeType=0&StartPeriod=0&StartRange=0

API ParameterPythonPatternRequiredNullableDescription
EndPeriodend_periodY
EndRangeend_rangeY
GameIDgame_idY
RangeTyperange_typeY
StartPeriodstart_periodY
StartRangestart_rangeY

Returns​

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (PlayerStats, TeamStats) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

PlayerStats

col_nametypedescription
game_idStringUnique 10-character game identifier from the league's stats API.
away_team_idInt64
home_team_idInt64
team_idInt64
team_cityString
team_nameString
team_tricodeStringThree-letter team abbreviation.
team_slugStringURL-friendly slug for the team name.
person_idInt64Player identifier from the league's stats API.
first_nameString
family_nameStringPlayer's family (last) name.
name_iStringAbbreviated player name (first initial and last name).
player_slugStringURL-friendly slug for the player's name.
positionString
commentString
jersey_numStringPlayer's jersey number.
minutesString
percentage_field_goals_attempted2ptFloat64Share of field goal attempts taken as two-pointers, as a decimal.
percentage_field_goals_attempted3ptFloat64Share of field goal attempts taken as three-pointers, as a decimal.
percentage_points2ptFloat64Share of points scored on two-pointers, as a decimal.
percentage_points_midrange2ptFloat64Share of points scored on mid-range two-pointers, as a decimal.
percentage_points3ptFloat64Share of points scored on three-pointers, as a decimal.
percentage_points_fast_breakFloat64Share of points scored on fast breaks, as a decimal.
percentage_points_free_throwFloat64Share of points scored at the free throw line, as a decimal.
percentage_points_off_turnoversFloat64Share of points scored off opponent turnovers, as a decimal.
percentage_points_paintFloat64Share of points scored in the paint, as a decimal.
percentage_assisted2ptFloat64Percentage of made two-pointers that were assisted, as a decimal.
percentage_unassisted2ptFloat64Percentage of made two-pointers that were unassisted, as a decimal.
percentage_assisted3ptFloat64Percentage of made three-pointers that were assisted, as a decimal.
percentage_unassisted3ptFloat64Percentage of made three-pointers that were unassisted, as a decimal.
percentage_assisted_fgmFloat64Percentage of made field goals that were assisted, as a decimal.
percentage_unassisted_fgmFloat64Percentage of made field goals that were unassisted, as a decimal.

TeamStats

col_nametypedescription
game_idStringUnique 10-character game identifier from the league's stats API.
away_team_idInt64
home_team_idInt64
team_idInt64
team_cityString
team_nameString
team_tricodeStringThree-letter team abbreviation.
team_slugStringURL-friendly slug for the team name.
minutesString
percentage_field_goals_attempted2ptFloat64Share of field goal attempts taken as two-pointers, as a decimal.
percentage_field_goals_attempted3ptFloat64Share of field goal attempts taken as three-pointers, as a decimal.
percentage_points2ptFloat64Share of points scored on two-pointers, as a decimal.
percentage_points_midrange2ptFloat64Share of points scored on mid-range two-pointers, as a decimal.
percentage_points3ptFloat64Share of points scored on three-pointers, as a decimal.
percentage_points_fast_breakFloat64Share of points scored on fast breaks, as a decimal.
percentage_points_free_throwFloat64Share of points scored at the free throw line, as a decimal.
percentage_points_off_turnoversFloat64Share of points scored off opponent turnovers, as a decimal.
percentage_points_paintFloat64Share of points scored in the paint, as a decimal.
percentage_assisted2ptFloat64Percentage of made two-pointers that were assisted, as a decimal.
percentage_unassisted2ptFloat64Percentage of made two-pointers that were unassisted, as a decimal.
percentage_assisted3ptFloat64Percentage of made three-pointers that were assisted, as a decimal.
percentage_unassisted3ptFloat64Percentage of made three-pointers that were unassisted, as a decimal.
percentage_assisted_fgmFloat64Percentage of made field goals that were assisted, as a decimal.
percentage_unassisted_fgmFloat64Percentage of made field goals that were unassisted, as a decimal.

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_boxscorescoringv3()

nbagl_stats_boxscoresummaryv2​

Box score summary v2.

Endpoint URL: GET https://stats.nba.com/stats/boxscoresummaryv2

Valid URL: https://stats.nba.com/stats/boxscoresummaryv2?GameID=2022500137

API ParameterPythonPatternRequiredNullableDescription
GameIDgame_idY

Returns​

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (GameSummary, OtherStats, Officials, InactivePlayers, GameInfo, LineScore, LastMeeting, SeasonSeries, AvailableVideo) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

GameSummary

col_nametypedescription
game_date_estString
game_sequenceInt64
game_idString
game_status_idInt64
game_status_textString
gamecodeString
home_team_idInt64
visitor_team_idInt64
seasonString
live_periodInt64
live_pc_timeString
natl_tv_broadcaster_abbreviationString
live_period_time_bcastString
wh_statusInt64

OtherStats

col_nametypedescription
league_idString
team_idInt64
team_abbreviationString
team_cityString
pts_paintInt64Points scored in the paint.
pts_2_nd_chanceInt64
pts_fbInt64
largest_leadInt64
lead_changesInt64
times_tiedInt64
team_turnoversInt64
total_turnoversInt64
team_reboundsInt64Team rebounds (rebounds credited to the team rather than a player).
pts_off_toInt64

Officials

col_nametypedescription
official_idInt64
first_nameString
last_nameString
jersey_numString

InactivePlayers

col_nametypedescription
player_idInt64
first_nameString
last_nameString
jersey_numString
team_idInt64
team_cityString
team_nameString
team_abbreviationString

GameInfo

col_nametypedescription
game_dateString
attendanceInt64
game_timeString

LineScore

col_nametypedescription
game_date_estString
game_sequenceInt64
game_idString
team_idInt64
team_abbreviationString
team_city_nameString
team_nicknameString
team_wins_lossesString
pts_qtr1Int64
pts_qtr2Int64
pts_qtr3Int64
pts_qtr4Int64
pts_ot1Int64
pts_ot2Int64Scoring or score-margin metric for points ot2 in the requested NBA or WNBA Stats split.
pts_ot3Int64Scoring or score-margin metric for points ot3 in the requested NBA or WNBA Stats split.
pts_ot4Int64Scoring or score-margin metric for points ot4 in the requested NBA or WNBA Stats split.
pts_ot5Int64Scoring or score-margin metric for points ot5 in the requested NBA or WNBA Stats split.
pts_ot6Int64Scoring or score-margin metric for points ot6 in the requested NBA or WNBA Stats split.
pts_ot7Int64Scoring or score-margin metric for points ot7 in the requested NBA or WNBA Stats split.
pts_ot8Int64Scoring or score-margin metric for points ot8 in the requested NBA or WNBA Stats split.
pts_ot9Int64Scoring or score-margin metric for points ot9 in the requested NBA or WNBA Stats split.
pts_ot10Int64Scoring or score-margin metric for points ot10 in the requested NBA or WNBA Stats split.
ptsInt64

LastMeeting

col_nametypedescription
game_idString
last_game_idString
last_game_date_estString
last_game_home_team_idInt64
last_game_home_team_cityString
last_game_home_team_nameString
last_game_home_team_abbreviationString
last_game_home_team_pointsInt64
last_game_visitor_team_idInt64
last_game_visitor_team_cityString
last_game_visitor_team_nameString
last_game_visitor_team_city1String
last_game_visitor_team_pointsInt64

SeasonSeries

col_nametypedescription
game_idString
home_team_idInt64
visitor_team_idInt64
game_date_estString
home_team_winsInt64
home_team_lossesInt64
series_leaderString

AvailableVideo

col_nametypedescription
game_idString
video_available_flagInt64
pt_availableInt64
pt_xyz_availableInt64
wh_statusInt64
hustle_statusInt64
historical_statusInt64

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_boxscoresummaryv2()

nbagl_stats_boxscoresummaryv3​

Box score summary v3.

Endpoint URL: GET https://stats.nba.com/stats/boxscoresummaryv3

Valid URL: https://stats.nba.com/stats/boxscoresummaryv3?GameID=2022500137

API ParameterPythonPatternRequiredNullableDescription
GameIDgame_idY

Returns​

return_parsed=True (default) — A dict of DataFrames keyed by result-set name (PlayerStats, TeamStats, Officials) (one table per documented key below); pass return_as_pandas=True for a dict of pandas.DataFrames (same keys).

PlayerStats

col_nametypedescription
game_idStringUnique 10-character game identifier from the league's stats API.
game_codeString
game_statusInt64
game_status_textString
periodInt64
game_clockString
game_time_utcString
game_etString
away_team_idInt64
home_team_idInt64
durationString
attendanceInt64
selloutInt64
series_game_numberString
game_labelString
game_sub_labelString
series_textString
if_necessaryBoolean
is_neutralBoolean
video_available_flagInt64
pt_availableInt64
pt_xyz_availableInt64
wh_statusInt64
hustle_statusInt64
historical_statusInt64
game_subtypeString
team_idInt64
team_nameString
team_cityString
team_tricodeStringThree-letter team abbreviation.
team_slugStringURL-friendly slug for the team name.
team_winsInt64Team's win total entering the game.
team_lossesInt64Team's loss total entering the game.
scoreInt64
in_bonusStringWhether the team is currently in the bonus (penalty) foul situation, as reported by the stats API.
timeouts_remainingInt64Timeouts the team has remaining.
seedInt64Team's playoff seed, populated for postseason games.
person_idInt64
nameString
name_iString
first_nameString
family_nameString
jersey_numString

TeamStats

col_nametypedescription
game_idStringUnique 10-character game identifier from the league's stats API.
game_codeString
game_statusInt64
game_status_textString
periodInt64
game_clockString
game_time_utcString
game_etString
away_team_idInt64
home_team_idInt64
durationString
attendanceInt64
selloutInt64
series_game_numberString
game_labelString
game_sub_labelString
series_textString
if_necessaryBoolean
is_neutralBoolean
video_available_flagInt64
pt_availableInt64
pt_xyz_availableInt64
wh_statusInt64
hustle_statusInt64
historical_statusInt64
game_subtypeString
team_idInt64
team_nameString
team_cityString
team_tricodeStringThree-letter team abbreviation.
team_slugStringURL-friendly slug for the team name.
team_winsInt64Team's win total entering the game.
team_lossesInt64Team's loss total entering the game.
scoreInt64
in_bonusStringWhether the team is currently in the bonus (penalty) foul situation, as reported by the stats API.
timeouts_remainingInt64Timeouts the team has remaining.
seedInt64Team's playoff seed, populated for postseason games.
dummy_keyStringPlaceholder key emitted by the stats API's box score summary payload; carries no data.

Officials

col_nametypedescription
person_idInt64
nameString
name_iString
first_nameString
family_nameString
jersey_numString
assignmentString

return_parsed=False — the raw JSON Dict payload, unparsed.

Raises​

ExceptionDescription
NoDataErrorThe host answered 404 -- the requested resource does not exist.
ValueErrorThe host answered 400 / 422 -- the request is wrong; retrying cannot help.
AssetFetchErrorThe fetch failed (a non-2xx answer or a connection failure after retries, e.g. 401/403/429/5xx, or an empty or unreadable 200 body) -- the answer is unknown, not empty.
ImportErrorcurl_cffi is not installed -- stats.nba.com / stats.wnba.com block plain requests, so the transport needs it (pip install curl_cffi or sportsdataverse[all]).

Example​

nbagl_stats_boxscoresummaryv3()