Skip to contents

[Deprecated]

NBA Stats no longer returns stable data for this V2 endpoint. This function is deprecated and now errors when called. Use nba_hustlestatsboxscore() instead.

Usage

nba_boxscoretraditionalv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscoreadvancedv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscoremiscv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscorescoringv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscoreusagev3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscorefourfactorsv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscoreplayertrackv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscorematchupsv3(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_boxscorehustlev2(game_id = "0022200021", ...)

nba_boxscoredefensivev2(
  game_id = "0022200021",
  start_period = 0,
  end_period = 14,
  start_range = 0,
  end_range = 0,
  range_type = 0,
  ...
)

nba_gamerotation(game_id, league_id = "00", rotation_stat = "PLAYER_PTS", ...)

nba_boxscoresummaryv3(game_id = "0022200021", ...)

Arguments

game_id

Game ID - 10-digit zero-padded ID (e.g., '0022200021')

start_period

Start period filter - default: 0

end_period

End period filter - default: 0

start_range

Start range filter (in tenths of a second) - default: 0

end_range

End range filter (in tenths of a second) - default: 0

range_type

Range type - 0: by half, 1: by period, 2: custom range

...

Additional arguments passed to an underlying function like httr.

league_id

League ID

rotation_stat

Rotation stat to provide details on: PLAYER_PTS, PT_DIFF, USG_PCT

Value

Returns a named list of data frames: home_team_player_traditional, away_team_player_traditional, home_team_totals_traditional, away_team_totals_traditional, home_team_starters_totals, away_team_starters_totals, home_team_bench_totals, away_team_bench_totals

home_team_player_traditional

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_idintegerUnique player identifier (V3 endpoints).
first_namecharacterPlayer's first name.
family_namecharacterPlayer's family / last name.
name_icharacterInitialed name (e.g. 'A. Wilson').
player_slugcharacterURL-safe player identifier.
positioncharacterListed roster position (G, F, C, etc.).
commentcharacterPlayer status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_numcharacterJersey number worn by the player.
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_madeintegerField goals made (2-pt + 3-pt).
field_goals_attemptedintegerField goal attempts (2-pt + 3-pt).
field_goals_percentagenumericField goal percentage (0-1 decimal).
three_pointers_madeintegerThree-point field goals made.
three_pointers_attemptedintegerThree-point field goal attempts.
three_pointers_percentagenumericThree-point field goal percentage (0-1 decimal).
free_throws_madeintegerFree throws made.
free_throws_attemptedintegerFree throw attempts.
free_throws_percentagenumericFree throw percentage (0-1 decimal).
rebounds_offensiveintegerOffensive rebounds.
rebounds_defensiveintegerDefensive rebounds.
rebounds_totalintegerTotal rebounds.
assistsintegerTotal assists.
stealsintegerTotal steals.
blocksintegerTotal blocks.
turnoversintegerTotal turnovers.
fouls_personalintegerPersonal fouls.
pointsintegerPoints scored.
plus_minus_pointsnumericPlus/minus point differential while on court.

away_team_player_traditional

Same columns as the home_team_player_traditional table above.

home_team_totals_traditional

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_madeintegerField goals made (2-pt + 3-pt).
field_goals_attemptedintegerField goal attempts (2-pt + 3-pt).
field_goals_percentagenumericField goal percentage (0-1 decimal).
three_pointers_madeintegerThree-point field goals made.
three_pointers_attemptedintegerThree-point field goal attempts.
three_pointers_percentagenumericThree-point field goal percentage (0-1 decimal).
free_throws_madeintegerFree throws made.
free_throws_attemptedintegerFree throw attempts.
free_throws_percentagenumericFree throw percentage (0-1 decimal).
rebounds_offensiveintegerOffensive rebounds.
rebounds_defensiveintegerDefensive rebounds.
rebounds_totalintegerTotal rebounds.
assistsintegerTotal assists.
stealsintegerTotal steals.
blocksintegerTotal blocks.
turnoversintegerTotal turnovers.
fouls_personalintegerPersonal fouls.
pointsintegerPoints scored.
plus_minus_pointsnumericPlus/minus point differential while on court.

away_team_totals_traditional

Same columns as the home_team_totals_traditional table above.

home_team_starters_totals

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
field_goals_madeintegerField goals made (2-pt + 3-pt).
field_goals_attemptedintegerField goal attempts (2-pt + 3-pt).
field_goals_percentagenumericField goal percentage (0-1 decimal).
three_pointers_madeintegerThree-point field goals made.
three_pointers_attemptedintegerThree-point field goal attempts.
three_pointers_percentagenumericThree-point field goal percentage (0-1 decimal).
free_throws_madeintegerFree throws made.
free_throws_attemptedintegerFree throw attempts.
free_throws_percentagenumericFree throw percentage (0-1 decimal).
rebounds_offensiveintegerOffensive rebounds.
rebounds_defensiveintegerDefensive rebounds.
rebounds_totalintegerTotal rebounds.
assistsintegerTotal assists.
stealsintegerTotal steals.
blocksintegerTotal blocks.
turnoversintegerTotal turnovers.
fouls_personalintegerPersonal fouls.
pointsintegerPoints scored.

away_team_starters_totals

Same columns as the home_team_starters_totals table above.

home_team_bench_totals

Same columns as the home_team_starters_totals table above.

away_team_bench_totals

Same columns as the home_team_starters_totals table above.

Returns a named list of data frames: home_team_player_advanced, away_team_player_advanced, home_team_totals_advanced, away_team_totals_advanced

home_team_player_advanced

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_idintegerUnique player identifier (V3 endpoints).
first_namecharacterPlayer's first name.
family_namecharacterPlayer's family / last name.
name_icharacterInitialed name (e.g. 'A. Wilson').
player_slugcharacterURL-safe player identifier.
positioncharacterListed roster position (G, F, C, etc.).
commentcharacterPlayer status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_numcharacterJersey number worn by the player.
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
estimated_offensive_ratingnumericEstimated offensive rating (points per 100 possessions estimate).
offensive_ratingnumericOffensive rating (points per 100 possessions).
estimated_defensive_ratingnumericEstimated defensive rating (points allowed per 100 possessions estimate).
defensive_ratingnumericDefensive rating (points allowed per 100 possessions).
estimated_net_ratingnumericEstimated net rating (off rating - def rating).
net_ratingnumericNet rating (off rating - def rating).
assist_percentagenumericAssist percentage (0-1).
assist_to_turnovernumericAssist-to-turnover ratio.
assist_rationumericAssist ratio (assists per 100 possessions used).
offensive_rebound_percentagenumericOffensive rebound percentage (0-1).
defensive_rebound_percentagenumericDefensive rebound percentage (0-1).
rebound_percentagenumericTotal rebound percentage (0-1).
turnover_rationumericTurnover ratio (turnovers per 100 possessions used).
effective_field_goal_percentagenumericEffective field goal percentage (0-1).
true_shooting_percentagenumericTrue shooting percentage (0-1).
usage_percentagenumericUsage percentage (0-1).
estimated_usage_percentagenumericEstimated usage percentage (0-1).
estimated_pacenumericEstimated possessions per 48 minutes.
pacenumericPossessions per 48 minutes.
pace_per40numericPace per40.
possessionsnumericPossessions used.
pienumericPlayer Impact Estimate (0-1).

away_team_player_advanced

Same columns as the home_team_player_advanced table above.

home_team_totals_advanced

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
estimated_offensive_ratingnumericEstimated offensive rating (points per 100 possessions estimate).
offensive_ratingnumericOffensive rating (points per 100 possessions).
estimated_defensive_ratingnumericEstimated defensive rating (points allowed per 100 possessions estimate).
defensive_ratingnumericDefensive rating (points allowed per 100 possessions).
estimated_net_ratingnumericEstimated net rating (off rating - def rating).
net_ratingnumericNet rating (off rating - def rating).
assist_percentagenumericAssist percentage (0-1).
assist_to_turnovernumericAssist-to-turnover ratio.
assist_rationumericAssist ratio (assists per 100 possessions used).
offensive_rebound_percentagenumericOffensive rebound percentage (0-1).
defensive_rebound_percentagenumericDefensive rebound percentage (0-1).
rebound_percentagenumericTotal rebound percentage (0-1).
estimated_team_turnover_percentagenumericEstimated team turnover percentage (0-1).
turnover_rationumericTurnover ratio (turnovers per 100 possessions used).
effective_field_goal_percentagenumericEffective field goal percentage (0-1).
true_shooting_percentagenumericTrue shooting percentage (0-1).
usage_percentagenumericUsage percentage (0-1).
estimated_usage_percentagenumericEstimated usage percentage (0-1).
estimated_pacenumericEstimated possessions per 48 minutes.
pacenumericPossessions per 48 minutes.
pace_per40numericPace per40.
possessionsnumericPossessions used.
pienumericPlayer Impact Estimate (0-1).

away_team_totals_advanced

Same columns as the home_team_totals_advanced table above.

Returns a named list of data frames: home_team_player_misc, away_team_player_misc, home_team_totals_misc, away_team_totals_misc

home_team_player_misc

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_idintegerUnique player identifier (V3 endpoints).
first_namecharacterPlayer's first name.
family_namecharacterPlayer's family / last name.
name_icharacterInitialed name (e.g. 'A. Wilson').
player_slugcharacterURL-safe player identifier.
positioncharacterListed roster position (G, F, C, etc.).
commentcharacterPlayer status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_numcharacterJersey number worn by the player.
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
points_off_turnoversintegerPoints scored off opponent turnovers.
points_second_chanceintegerSecond-chance points scored.
points_fast_breakintegerFast-break points scored.
points_paintintegerPoints scored in the paint.
opp_points_off_turnoversintegerOpponent points off turnovers.
opp_points_second_chanceintegerOpponent points second chance.
opp_points_fast_breakintegerOpponent points fast break.
opp_points_paintintegerOpponent points paint.
blocksintegerTotal blocks.
blocks_againstintegerShots blocked by opponents while attempting.
fouls_personalintegerPersonal fouls.
fouls_drawnintegerPersonal fouls drawn (by opponent's actions).

away_team_player_misc

Same columns as the home_team_player_misc table above.

home_team_totals_misc

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
points_off_turnoversintegerPoints scored off opponent turnovers.
points_second_chanceintegerSecond-chance points scored.
points_fast_breakintegerFast-break points scored.
points_paintintegerPoints scored in the paint.
opp_points_off_turnoversintegerOpponent points off turnovers.
opp_points_second_chanceintegerOpponent points second chance.
opp_points_fast_breakintegerOpponent points fast break.
opp_points_paintintegerOpponent points paint.
blocksintegerTotal blocks.
blocks_againstintegerShots blocked by opponents while attempting.
fouls_personalintegerPersonal fouls.
fouls_drawnintegerPersonal fouls drawn (by opponent's actions).

away_team_totals_misc

Same columns as the home_team_totals_misc table above.

Returns a named list of data frames: home_team_player_scoring, away_team_player_scoring, home_team_totals_scoring, away_team_totals_scoring

home_team_player_scoring

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_idintegerUnique player identifier (V3 endpoints).
first_namecharacterPlayer's first name.
family_namecharacterPlayer's family / last name.
name_icharacterInitialed name (e.g. 'A. Wilson').
player_slugcharacterURL-safe player identifier.
positioncharacterListed roster position (G, F, C, etc.).
commentcharacterPlayer status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_numcharacterJersey number worn by the player.
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
percentage_field_goals_attempted2ptnumericPercentage field goals attempted2pt.
percentage_field_goals_attempted3ptnumericPercentage field goals attempted3pt.
percentage_points2ptnumericPercentage points2pt.
percentage_points_midrange2ptnumericPercentage points midrange2pt.
percentage_points3ptnumericPercentage points3pt.
percentage_points_fast_breaknumericPercentage points fast break.
percentage_points_free_thrownumericPercentage points free throw.
percentage_points_off_turnoversnumericPercentage points off turnovers.
percentage_points_paintnumericPercentage points paint.
percentage_assisted2ptnumericPercentage assisted2pt.
percentage_unassisted2ptnumericPercentage unassisted2pt.
percentage_assisted3ptnumericPercentage assisted3pt.
percentage_unassisted3ptnumericPercentage unassisted3pt.
percentage_assisted_fgmnumericPercentage assisted fgm.
percentage_unassisted_fgmnumericPercentage unassisted fgm.

away_team_player_scoring

Same columns as the home_team_player_scoring table above.

home_team_totals_scoring

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
percentage_field_goals_attempted2ptnumericPercentage field goals attempted2pt.
percentage_field_goals_attempted3ptnumericPercentage field goals attempted3pt.
percentage_points2ptnumericPercentage points2pt.
percentage_points_midrange2ptnumericPercentage points midrange2pt.
percentage_points3ptnumericPercentage points3pt.
percentage_points_fast_breaknumericPercentage points fast break.
percentage_points_free_thrownumericPercentage points free throw.
percentage_points_off_turnoversnumericPercentage points off turnovers.
percentage_points_paintnumericPercentage points paint.
percentage_assisted2ptnumericPercentage assisted2pt.
percentage_unassisted2ptnumericPercentage unassisted2pt.
percentage_assisted3ptnumericPercentage assisted3pt.
percentage_unassisted3ptnumericPercentage unassisted3pt.
percentage_assisted_fgmnumericPercentage assisted fgm.
percentage_unassisted_fgmnumericPercentage unassisted fgm.

away_team_totals_scoring

Same columns as the home_team_totals_scoring table above.

Returns a named list of data frames: home_team_player_usage, away_team_player_usage, home_team_totals_usage, away_team_totals_usage

home_team_player_usage

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_idintegerUnique player identifier (V3 endpoints).
first_namecharacterPlayer's first name.
family_namecharacterPlayer's family / last name.
name_icharacterInitialed name (e.g. 'A. Wilson').
player_slugcharacterURL-safe player identifier.
positioncharacterListed roster position (G, F, C, etc.).
commentcharacterPlayer status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_numcharacterJersey number worn by the player.
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
usage_percentagenumericUsage percentage (0-1).
percentage_field_goals_madenumericNumber of percentage field goals made.
percentage_field_goals_attemptednumericNumber of percentage field goals attempted.
percentage_three_pointers_madenumericNumber of percentage three pointers made.
percentage_three_pointers_attemptednumericNumber of percentage three pointers attempted.
percentage_free_throws_madenumericNumber of percentage free throws made.
percentage_free_throws_attemptednumericNumber of percentage free throws attempted.
percentage_rebounds_offensivenumericPercentage rebounds offensive.
percentage_rebounds_defensivenumericPercentage rebounds defensive.
percentage_rebounds_totalnumericPercentage rebounds total.
percentage_assistsnumericPercentage assists.
percentage_turnoversnumericPercentage turnovers.
percentage_stealsnumericPercentage steals.
percentage_blocksnumericPercentage blocks.
percentage_blocks_allowednumericPercentage blocks allowed.
percentage_personal_foulsnumericPercentage personal fouls.
percentage_personal_fouls_drawnnumericPercentage personal fouls drawn.
percentage_pointsnumericPercentage points.

away_team_player_usage

Same columns as the home_team_player_usage table above.

home_team_totals_usage

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
usage_percentagenumericUsage percentage (0-1).
percentage_field_goals_madenumericNumber of percentage field goals made.
percentage_field_goals_attemptednumericNumber of percentage field goals attempted.
percentage_three_pointers_madenumericNumber of percentage three pointers made.
percentage_three_pointers_attemptednumericNumber of percentage three pointers attempted.
percentage_free_throws_madenumericNumber of percentage free throws made.
percentage_free_throws_attemptednumericNumber of percentage free throws attempted.
percentage_rebounds_offensivenumericPercentage rebounds offensive.
percentage_rebounds_defensivenumericPercentage rebounds defensive.
percentage_rebounds_totalnumericPercentage rebounds total.
percentage_assistsnumericPercentage assists.
percentage_turnoversnumericPercentage turnovers.
percentage_stealsnumericPercentage steals.
percentage_blocksnumericPercentage blocks.
percentage_blocks_allowednumericPercentage blocks allowed.
percentage_personal_foulsnumericPercentage personal fouls.
percentage_personal_fouls_drawnnumericPercentage personal fouls drawn.
percentage_pointsnumericPercentage points.

away_team_totals_usage

Same columns as the home_team_totals_usage table above.

Returns a named list of data frames: home_team_player_four_factors, away_team_player_four_factors, home_team_totals_four_factors, away_team_totals_four_factors

home_team_player_four_factors

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_idintegerUnique player identifier (V3 endpoints).
first_namecharacterPlayer's first name.
family_namecharacterPlayer's family / last name.
name_icharacterInitialed name (e.g. 'A. Wilson').
player_slugcharacterURL-safe player identifier.
positioncharacterListed roster position (G, F, C, etc.).
commentcharacterPlayer status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_numcharacterJersey number worn by the player.
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
effective_field_goal_percentagenumericEffective field goal percentage (0-1).
free_throw_attempt_ratenumericFree throw attempt rate (FTA / FGA).
team_turnover_percentagenumericTeam turnover percentage (0-1).
offensive_rebound_percentagenumericOffensive rebound percentage (0-1).
opp_effective_field_goal_percentagenumericOpponent effective field goal percentage (0-1 decimal).
opp_free_throw_attempt_ratenumericOpponent free throw attempt rate.
opp_team_turnover_percentagenumericOpponent team turnover percentage (0-1 decimal).
opp_offensive_rebound_percentagenumericOpponent offensive rebound percentage (0-1 decimal).

away_team_player_four_factors

Same columns as the home_team_player_four_factors table above.

home_team_totals_four_factors

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
effective_field_goal_percentagenumericEffective field goal percentage (0-1).
free_throw_attempt_ratenumericFree throw attempt rate (FTA / FGA).
team_turnover_percentagenumericTeam turnover percentage (0-1).
offensive_rebound_percentagenumericOffensive rebound percentage (0-1).
opp_effective_field_goal_percentagenumericOpponent effective field goal percentage (0-1 decimal).
opp_free_throw_attempt_ratenumericOpponent free throw attempt rate.
opp_team_turnover_percentagenumericOpponent team turnover percentage (0-1 decimal).
opp_offensive_rebound_percentagenumericOpponent offensive rebound percentage (0-1 decimal).

away_team_totals_four_factors

Same columns as the home_team_totals_four_factors table above.

Returns a named list of data frames: home_team_player_player_track, away_team_player_player_track, home_team_totals_player_track, away_team_totals_player_track

home_team_player_player_track

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_idintegerUnique player identifier (V3 endpoints).
first_namecharacterPlayer's first name.
family_namecharacterPlayer's family / last name.
name_icharacterInitialed name (e.g. 'A. Wilson').
player_slugcharacterURL-safe player identifier.
positioncharacterListed roster position (G, F, C, etc.).
commentcharacterPlayer status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_numcharacterJersey number worn by the player.
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
speednumericSpeed.
distancenumericDistance value (in feet for shot data; otherwise context-dependent).
rebound_chances_offensiveintegerRebound chances offensive.
rebound_chances_defensiveintegerRebound chances defensive.
rebound_chances_totalintegerRebound chances total.
touchesintegerTouches.
secondary_assistsintegerSecondary assists.
free_throw_assistsintegerFree throw assists (passes that led to a fouled shot attempt).
passesintegerPasses.
assistsintegerTotal assists.
contested_field_goals_madeintegerContested field goals made.
contested_field_goals_attemptedintegerContested field goal attempts.
contested_field_goal_percentagenumericContested field goal percentage (0-1).
uncontested_field_goals_madeintegerNumber of uncontested field goals made.
uncontested_field_goals_attemptedintegerNumber of uncontested field goals attempted.
uncontested_field_goals_percentagenumericUncontested field goals percentage (0-1 decimal).
field_goal_percentagenumericField Goal Percentage.
defended_at_rim_field_goals_madeintegerField goals made allowed when defending at the rim.
defended_at_rim_field_goals_attemptedintegerField goal attempts allowed when defending at the rim.
defended_at_rim_field_goal_percentagenumericField goal percentage allowed at the rim (0-1).

away_team_player_player_track

Same columns as the home_team_player_player_track table above.

home_team_totals_player_track

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
distancenumericDistance value (in feet for shot data; otherwise context-dependent).
rebound_chances_offensiveintegerRebound chances offensive.
rebound_chances_defensiveintegerRebound chances defensive.
rebound_chances_totalintegerRebound chances total.
touchesintegerTouches.
secondary_assistsintegerSecondary assists.
free_throw_assistsintegerFree throw assists (passes that led to a fouled shot attempt).
passesintegerPasses.
assistsintegerTotal assists.
contested_field_goals_madeintegerContested field goals made.
contested_field_goals_attemptedintegerContested field goal attempts.
contested_field_goal_percentagenumericContested field goal percentage (0-1).
uncontested_field_goals_madeintegerNumber of uncontested field goals made.
uncontested_field_goals_attemptedintegerNumber of uncontested field goals attempted.
uncontested_field_goals_percentagenumericUncontested field goals percentage (0-1 decimal).
field_goal_percentagenumericField Goal Percentage.
defended_at_rim_field_goals_madeintegerField goals made allowed when defending at the rim.
defended_at_rim_field_goals_attemptedintegerField goal attempts allowed when defending at the rim.
defended_at_rim_field_goal_percentagenumericField goal percentage allowed at the rim (0-1).

away_team_totals_player_track

Same columns as the home_team_totals_player_track table above.

Returns a named list of data frames: home_team_player_matchups, away_team_player_matchups

home_team_player_matchups

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_idintegerUnique player identifier (V3 endpoints).
first_namecharacterPlayer's first name.
family_namecharacterPlayer's family / last name.
name_icharacterInitialed name (e.g. 'A. Wilson').
player_slugcharacterURL-safe player identifier.
positioncharacterListed roster position (G, F, C, etc.).
commentcharacterPlayer status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_numcharacterJersey number worn by the player.
matchups_person_idintegerUnique identifier for matchups person.
matchups_first_namecharacterMatchups first name.
matchups_family_namecharacterMatchups family name.
matchups_name_icharacterMatchups name i.
matchups_player_slugcharacterMatchups player slug.
matchups_jersey_numcharacterMatchups jersey num.
matchup_minutescharacterMatchup minutes.
matchup_minutes_sortnumericMatchup minutes sort.
partial_possessionsnumericPartial possessions.
percentage_defender_total_timenumericTime / clock value.
percentage_offensive_total_timenumericTime / clock value.
percentage_total_time_both_onnumericPercentage total time both on.
switches_onintegerSwitches on.
player_pointsintegerPlayer points.
team_pointsintegerTeam points.
matchup_assistsintegerMatchup assists.
matchup_potential_assistsintegerMatchup potential assists.
matchup_turnoversintegerMatchup turnovers.
matchup_blocksintegerMatchup blocks.
matchup_field_goals_madeintegerNumber of matchup field goals made.
matchup_field_goals_attemptedintegerNumber of matchup field goals attempted.
matchup_field_goals_percentagenumericMatchup field goals percentage (0-1 decimal).
matchup_three_pointers_madeintegerNumber of matchup three pointers made.
matchup_three_pointers_attemptedintegerNumber of matchup three pointers attempted.
matchup_three_pointers_percentagenumericMatchup three pointers percentage (0-1 decimal).
help_blocksintegerHelp blocks.
help_field_goals_madeintegerNumber of help field goals made.
help_field_goals_attemptedintegerNumber of help field goals attempted.
help_field_goals_percentagenumericHelp field goals percentage (0-1 decimal).
matchup_free_throws_madeintegerNumber of matchup free throws made.
matchup_free_throws_attemptedintegerNumber of matchup free throws attempted.
shooting_foulsintegerShooting fouls.

away_team_player_matchups

Same columns as the home_team_player_matchups table above.

Returns a named list of data frames: home_team_player_hustle, away_team_player_hustle, home_team_hustle_totals, away_team_hustle_totals

home_team_player_hustle

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_idintegerUnique player identifier (V3 endpoints).
first_namecharacterPlayer's first name.
family_namecharacterPlayer's family / last name.
name_icharacterInitialed name (e.g. 'A. Wilson').
player_slugcharacterURL-safe player identifier.
positioncharacterListed roster position (G, F, C, etc.).
commentcharacterPlayer status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_numcharacterJersey number worn by the player.
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
pointsintegerPoints scored.
contested_shotsintegerDefensively contested shots.
contested_shots2ptintegerContested shots2pt.
contested_shots3ptintegerContested shots3pt.
deflectionsintegerDefensive deflections.
charges_drawnintegerCharges drawn.
screen_assistsintegerScreen assists (resulting in a basket).
screen_assist_pointsintegerPoints generated from screen assists.
loose_balls_recovered_offensiveintegerLoose balls recovered on offense.
loose_balls_recovered_defensiveintegerLoose balls recovered on defense.
loose_balls_recovered_totalintegerLoose balls recovered total.
offensive_box_outsintegerOffensive box outs.
defensive_box_outsintegerDefensive box outs.
box_out_player_team_reboundsintegerBox-outs that led to either a player or team rebound.
box_out_player_reboundsintegerBox-outs that led to a player rebound.
box_outsintegerBox-outs executed.

away_team_player_hustle

Same columns as the home_team_player_hustle table above.

home_team_totals_hustle

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
minutescharacterMinutes played, formatted MM:SS (V3 PT-duration parsed) or decimal minutes (V2).
pointsintegerPoints scored.
contested_shotsintegerDefensively contested shots.
contested_shots2ptintegerContested shots2pt.
contested_shots3ptintegerContested shots3pt.
deflectionsintegerDefensive deflections.
charges_drawnintegerCharges drawn.
screen_assistsintegerScreen assists (resulting in a basket).
screen_assist_pointsintegerPoints generated from screen assists.
loose_balls_recovered_offensiveintegerLoose balls recovered on offense.
loose_balls_recovered_defensiveintegerLoose balls recovered on defense.
loose_balls_recovered_totalintegerLoose balls recovered total.
offensive_box_outsintegerOffensive box outs.
defensive_box_outsintegerDefensive box outs.
box_out_player_team_reboundsintegerBox-outs that led to either a player or team rebound.
box_out_player_reboundsintegerBox-outs that led to a player rebound.
box_outsintegerBox-outs executed.

away_team_totals_hustle

Same columns as the home_team_totals_hustle table above.

Returns a named list of data frames: home_team_player_defensive, away_team_player_defensive, home_team_totals_defensive, away_team_totals_defensive

home_team_player_defensive

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
person_idintegerUnique player identifier (V3 endpoints).
first_namecharacterPlayer's first name.
family_namecharacterPlayer's family / last name.
name_icharacterInitialed name (e.g. 'A. Wilson').
player_slugcharacterURL-safe player identifier.
positioncharacterListed roster position (G, F, C, etc.).
commentcharacterPlayer status / inactive reason (e.g. 'DNP - Coach's Decision', 'Inactive').
jersey_numcharacterJersey number worn by the player.
matchup_minutescharacterMatchup minutes.
partial_possessionsnumericPartial possessions.
switches_onintegerSwitches on.
player_pointsintegerPlayer points.
defensive_reboundsintegerDefensive rebounds.
matchup_assistsintegerMatchup assists.
matchup_turnoversintegerMatchup turnovers.
stealsintegerTotal steals.
blocksintegerTotal blocks.
matchup_field_goals_madeintegerNumber of matchup field goals made.
matchup_field_goals_attemptedintegerNumber of matchup field goals attempted.
matchup_field_goal_percentagenumericMatchup field goal percentage (0-1 decimal).
matchup_three_pointers_madeintegerNumber of matchup three pointers made.
matchup_three_pointers_attemptedintegerNumber of matchup three pointers attempted.
matchup_three_pointer_percentagenumericMatchup three pointer percentage (0-1 decimal).

away_team_player_defensive

Same columns as the home_team_player_defensive table above.

home_team_totals_defensive

col_nametypesdescription
game_idcharacterUnique game identifier.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
team_idintegerUnique team identifier.
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').

away_team_totals_defensive

Same columns as the home_team_totals_defensive table above.

Returns a named list of data frames: AwayTeam, HomeTeam

AwayTeam

col_nametypesdescription
GAME_IDcharacterUnique game identifier.
TEAM_IDcharacterUnique team identifier.
TEAM_CITYcharacterTeam city or region (e.g. 'Las Vegas').
TEAM_NAMEcharacterFull team display name (e.g. 'Las Vegas Aces').
PERSON_IDcharacterUnique player identifier (V3 endpoints).
PLAYER_FIRSTcharacter
PLAYER_LASTcharacter
IN_TIME_REALcharacter
OUT_TIME_REALcharacter
PLAYER_PTScharacter
PT_DIFFcharacter
USG_PCTcharacterUsage percentage (0-1).

HomeTeam

Same columns as the AwayTeam table above.

Returns a named list of data frames: GameSummary, GameInfo, ArenaInfo, Officials, LineScore, InactivePlayers, LastFiveMeetings, OtherStats, AvailableVideo

GameSummary

col_nametypesdescription
game_idcharacterUnique game identifier.
game_codecharacterESPN game code (numeric identifier).
game_statusintegerGame status label.
game_status_textcharacterGame status display text (e.g. 'Final', '4:32 - 4th').
periodintegerPeriod of the game (1-4 quarters; 5+ for OT).
game_clockcharacterGame clock.
game_time_utccharacterGame start time in UTC (ISO 8601 timestamp).
game_etcharacterGame et.
away_team_idintegerUnique identifier for the away team.
home_team_idintegerUnique identifier for the home team.
durationintegerDuration.
attendanceintegerReported attendance.
selloutcharacterSellout.

GameInfo

col_nametypesdescription
game_idcharacterUnique game identifier.
game_datecharacterGame date (YYYY-MM-DD).
attendanceintegerReported attendance.
game_durationintegerGame duration.

ArenaInfo

col_nametypesdescription
game_idcharacterUnique game identifier.
arena_idintegerUnique identifier for arena.
arena_namecharacterArena name.
arena_citycharacterArena city.
arena_statecharacterArena state.
arena_countrycharacterArena country.
arena_timezonecharacterArena timezone.

Officials

col_nametypesdescription
game_idcharacterUnique game identifier.
person_idintegerUnique player identifier (V3 endpoints).
namecharacterDisplay name.
name_icharacterInitialed name (e.g. 'A. Wilson').
first_namecharacterPlayer's first name.
family_namecharacterPlayer's family / last name.
jersey_numcharacterJersey number worn by the player.

LineScore

col_nametypesdescription
game_idcharacterUnique game identifier.
team_idintegerUnique team identifier.
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
team_slugcharacterURL-safe team identifier (e.g. 'lasvegas-aces' / 'aces').
team_winsintegerTeam wins.
team_lossesintegerTeam losses.
period1_scoreintegerPeriod1 score.
period2_scoreintegerPeriod2 score.
period3_scoreintegerPeriod3 score.
period4_scoreintegerPeriod4 score.
scoreintegerFinal score.

InactivePlayers

col_nametypesdescription
game_idcharacterUnique game identifier.
team_idintegerUnique team identifier.
person_idintegerUnique player identifier (V3 endpoints).
first_namecharacterPlayer's first name.
family_namecharacterPlayer's family / last name.
jersey_numcharacterJersey number worn by the player.

LastFiveMeetings

col_nametypesdescription
recency_orderintegerRecency order.
game_idcharacterUnique game identifier.
game_time_utccharacterGame start time in UTC (ISO 8601 timestamp).
game_etcharacterGame et.
game_statusintegerGame status label.
game_status_textcharacterGame status display text (e.g. 'Final', '4:32 - 4th').
away_team_idintegerUnique identifier for the away team.
away_team_citycharacterAway team city / location.
away_team_namecharacterAway team name.
away_team_tricodecharacterAway team three-letter code.
away_team_scoreintegerAway team's score.
away_team_winsintegerAway team's team wins.
away_team_lossesintegerAway team's team losses.
home_team_idintegerUnique identifier for the home team.
home_team_citycharacterHome team city / location.
home_team_namecharacterHome team name.
home_team_tricodecharacterHome team three-letter code.
home_team_scoreintegerHome team's score.
home_team_winsintegerHome team's team wins.
home_team_lossesintegerHome team's team losses.

OtherStats

col_nametypesdescription
game_idcharacterUnique game identifier.
team_idintegerUnique team identifier.
team_citycharacterTeam city or region (e.g. 'Las Vegas').
team_namecharacterFull team display name (e.g. 'Las Vegas Aces').
team_tricodecharacterThree-letter team code (e.g. 'LAS' / 'NYL').
pointsintegerPoints scored.
rebounds_totalintegerTotal rebounds.
assistsintegerTotal assists.
stealsintegerTotal steals.
blocksintegerTotal blocks.
turnoversintegerTotal turnovers.
field_goals_percentagenumericField goal percentage (0-1 decimal).
three_pointers_percentagenumericThree-point field goal percentage (0-1 decimal).
free_throws_percentagenumericFree throw percentage (0-1 decimal).
points_in_the_paintintegerPoints in the paint.
points_second_chanceintegerSecond-chance points scored.
points_fast_breakintegerFast-break points scored.
biggest_leadintegerBiggest lead.
lead_changesintegerLead changes.
times_tiedintegerTimes tied.
biggest_scoring_runintegerBiggest scoring run.
turnovers_teamintegerTurnovers team.
turnovers_totalintegerTurnovers total.
rebounds_teamintegerRebounds team.
points_from_turnoversintegerPoints from turnovers.
bench_pointsintegerPoints scored by the bench.

AvailableVideo

col_nametypesdescription
game_idcharacterUnique game identifier.
video_available_flagintegerVideo available flag.
pt_availableintegerPt available.
pt_xyz_availableintegerPt xyz available.
wh_statusintegerWh status.
hustle_statusintegerHustle status.
historical_statusintegerHistorical status.

Details

 nba_boxscoretraditionalv3(game_id = "0022200021")

 nba_boxscoreadvancedv3(game_id = "0022200021")

 nba_boxscoremiscv3(game_id = "0022200021")

 nba_boxscorescoringv3(game_id = "0022200021")

 nba_boxscoreusagev3(game_id = "0022200021")

 nba_boxscorefourfactorsv3(game_id = "0022200021")

 nba_boxscoreplayertrackv3(game_id = "0022200021")

 nba_boxscorematchupsv3(game_id = "0022200021")

 nba_boxscorehustlev2(game_id = "0022200021")

 nba_boxscoredefensivev2(game_id = "0022200021")

 nba_gamerotation(game_id = "0022200021")

 nba_boxscoresummaryv3(game_id = "0022200021")

Author

Saiem Gilani