Draft combine¶

class nbapy.draft_combine.DrillResults(league_id='00', season='2020-21')¶

_endpoint = 'draftcombinedrillresults'¶

stats()¶

class nbapy.draft_combine.SpotShooting(league_id='00', season='2020-21')¶

_endpoint = 'draftcombinespotshooting'¶

stats()¶

class nbapy.draft_combine.Summary(league_id='00', season='2020-21')¶

_endpoint = 'draftcombinestats'¶

stats()¶

Game¶

class nbapy.game.BoxScore(game_id: str, season='2020-21', season_type='Regular Season', range_type='0', start_period='0', end_period='0', start_range='0', end_range='0')¶

_endpoint = 'boxscoretraditionalv2'¶

players_stats()¶

team_starter_bench_stats()¶

team_stats()¶

class nbapy.game.BoxScoreScoring(game_id: str, season='2020-21', season_type='Regular Season', range_type='0', start_period='0', end_period='0', start_range='0', end_range='0')¶

_endpoint = 'boxscorescoringv2'¶

players_stats()¶

team_stats()¶

class nbapy.game.BoxScoreUsage(game_id: str, season='2020-21', season_type='Regular Season', range_type='0', start_period='0', end_period='0', start_range='0', end_range='0')¶

_endpoint = 'boxscoreusagev2'¶

players_stats()¶

team_stats()¶

class nbapy.game.BoxScoreMisc(game_id: str, season='2020-21', season_type='Regular Season', range_type='0', start_period='0', end_period='0', start_range='0', end_range='0')¶

_endpoint = 'boxscoremiscv2'¶

players_stats()¶

team_stats()¶

class nbapy.game.BoxScoreAdvanced(game_id: str, season='2020-21', season_type='Regular Season', range_type='0', start_period='0', end_period='0', start_range='0', end_range='0')¶

_endpoint = 'boxscoreadvancedv2'¶

players_stats()¶

team_stats()¶

class nbapy.game.BoxScoreFourFactors(game_id: str, season='2020-21', season_type='Regular Season', range_type='0', start_period='0', end_period='0', start_range='0', end_range='0')¶

_endpoint = 'boxscorefourfactorsv2'¶

players_stats()¶

team_stats()¶

class nbapy.game.BoxScorePlayerTracking(game_id)¶

_endpoint = 'boxscoreplayertrackv2'¶

stats()¶

class nbapy.game.BoxScoreHustle(game_id)¶

_endpoint = 'hustlestatsboxscore'¶

players_stats()¶

team_stats()¶

class nbapy.game.Info(game_id: str, season='2020-21', season_type='Regular Season', range_type='0', start_period='0', end_period='0', start_range='0', end_range='0')¶

_endpoint = 'boxscoresummaryv2'¶

available_video()¶

game_info()¶

game_summary()¶

inactive_players()¶

last_meeting()¶

line_score()¶

officials()¶

other_stats()¶

season_series()¶

class nbapy.game.PlayByPlay(game_id, start_period='0', end_period='0')¶

_endpoint = 'playbyplay'¶

available_video()¶

stats()¶

League¶

League-wide stats.

class nbapy.league.LeagueLeaders(league_id='00', per_mode='PerGame', stat_category='PTS', season='2020-21', season_type='Regular Season', scope='S')¶

Season league leaders in various stats.

_endpoint = 'leagueleaders'¶

players()¶

class nbapy.league.Lineups(group_quantity=5, season_type='Regular Season', measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', season='2020-21', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', last_n_games='0')¶

Stats for various lineups throughout the league.

_endpoint = 'leaguedashlineups'¶

lineups()¶

class nbapy.league.PlayerStats(season_type='Regular Season', measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', season='2020-21', playoff_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', team_id='0', conference='', division='', game_segment='', period='0', shot_clock_range='', last_n_games='0', game_scope='', player_experience='', player_position='', starter_bench='', draft_year='', draft_pick='', college='', country='', height='', weight='')¶

League-wide (all) player stats.

_endpoint = 'leaguedashplayerstats'¶

stats()¶

class nbapy.league.PlayerTrackingStats(league_id='00', season_type='Regular Season', player_or_team='Player', per_mode='PerGame', season='2020-21', playoff_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', team_id='0', conference='', division='', last_n_games='0', game_scope='', player_experience='', player_position='', pt_measure_type='CatchShoot', starter_bench='', draft_year='', draft_pick='', college='', country='', height='', weight='')¶

Various player tracking stats.

Includes catch and shoot tracking, speed and distance, post-ups, touches, etc.

_endpoint = 'leaguedashptstats'¶

stats()¶

class nbapy.league.TeamStats(conference='', date_from='', date_to='', division='', game_scope='', game_segment='', last_n_games='0', league_id='00', location='', measure_type='Base', month='0', opponent_team_id='0', outcome='', playoff_round='0', pace_adjust='N', per_mode='PerGame', period='0', player_experience='', player_position='', plus_minus='N', rank='N', season='2020-21', season_segment='', season_type='Regular Season', shot_clock_range='', starter_bench='', team_id='0', vs_conference='', vs_division='')¶

League-wide team stats.

_endpoint = 'leaguedashteamstats'¶

stats()¶

Player¶

class nbapy.player.Career(player_id: str, per_mode='PerGame', league_id='00')¶

Career stats.

Based on several parameters such as career regular season totals, post season career totals, all star season careers totals, college season career totals, season/career highs and next game info.

Parameters

player_id – Player ID to look up
per_mode – Mode to measure statistics (Totals, PerGame, Per36, etc.)
league_id – ID for the league to look in (Default is 00)

_endpoint = 'playerprofilev2'¶

all_star_season_splits(career=False)¶

Splits for all seasons the player was an all-star.

Parameters: career – switch for career stats True: Career totals False: Per-season (per_mode) stats

career_highs()¶: Career highs in basic stats.

college_season_splits(career=False)¶

College splits.

Parameters: career – switch for career stats True: Career totals False: Per-season (per_mode) stats

next_game()¶: Info on the player’s next game.

post_season_rankings()¶: Post season split rankings.

post_season_splits(career=False)¶

Post-season splits.

Parameters: career – switch for career stats True: Career totals False: Per-season (per_mode) stats

reg_season_rankings()¶: Regular season split rankings.

reg_season_splits(career=False)¶

Regular-season splits.

Parameters: career – switch for career stats True: Career totals False: Per-season (per_mode) stats

season_highs()¶: Season highs in basic stats.

class nbapy.player.ClutchSplits(player_id: str, team_id: str = '0', measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Contains a lot of methods for last n minutes with a deficit of x points.

_endpoint = 'playerdashboardbyclutch'¶

last_10s_lte_3pts()¶: Splits in last 10 seconds <= 3 points.

last_1m_lte_5pts()¶: Splits in last minute <= 5 points.

last_1m_pm_5pts()¶: Splits in last minute +/- 5 points.

last_30s_lte_3pts()¶: Splits in last 30 seconds <= 3 points.

last_3m_lte_5pts()¶: Splits in last 3 minutes <= 5 points.

last_3m_pm_5pts()¶: Splits in last 3 minutes +/- 5 points.

last_5m_lte_5pts()¶: Splits in last 5 minutes <= 5 points.

last_5m_pm_5pts()¶: Splits in last 5 minutes +/- 5 points.

class nbapy.player.GameLogs(player_id: str, league_id='00', season='2020-21', season_type='Regular Season')¶

Contains a full log of all the games for a player for a given season.

Parameters

player_id – ID of the player to look up
league_id – ID for the league to look in
season – Season given to look up
season_type – Season type to consider (Regular / Playoffs)

_endpoint = 'playergamelog'¶

logs()¶

class nbapy.player.GeneralSplits(player_id: str, team_id: str = '0', measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Random general splits.

Contains stats pertaining to location, wins and losses, pre/post all star break, starting position, and numbers of days rest.

Parameters: Splits (see) –

_endpoint = 'playerdashboardbygeneralsplits'¶

days_rest()¶

location()¶

month()¶

pre_post_all_star()¶

starting_position()¶

wins_losses()¶

class nbapy.player.InGameSplits(player_id: str, team_id: str = '0', measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Game splits by half, by quarter, by score margin, and by actual margins.

_endpoint = 'playerdashboardbygamesplits'¶

by_actual_margin()¶

by_half()¶

by_period()¶

by_score_margin()¶

class nbapy.player.LastNGamesSplits(player_id: str, team_id: str = '0', measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Contains players stats for n games.

Per last 5, 10, 15, and 20 games, or specified number of games.

_endpoint = 'playerdashboardbylastngames'¶

game_num()¶: Stats for sets of 10 games.

last_10()¶

last_15()¶

last_20()¶

last_5()¶

class nbapy.player.OpponentSplits(player_id: str, team_id: str = '0', measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Contains stats pertaining to player stats vs certain opponents.

Grouped by division, conference, and by specific team opponent.

Parameters: Splits (see) –

_endpoint = 'playerdashboardbyopponent'¶

by_conference()¶

by_division()¶

by_team()¶

class nbapy.player.PassTracking(player_id: str, team_id: str = '0', measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Tracking data for passing for a given team.

Parameters: Splits (see) –

_endpoint = 'playerdashptpass'¶

made()¶

received()¶

class nbapy.player.PlayerList(league_id='00', season='2020-21', active_only=1)¶

Contains a list of players and their teams.

Parameters

league_id – ID for the league to look in
season – Season given to look up. This affects whether or not the player is active and on what team.
active_only – (1 or 0 for true or false respectively). Only return active players for the given season. If season is set prior to the current season, and active_only is 1, then only players who’s career ended in the specified season will be listed.

_endpoint = 'commonallplayers'¶

players()¶

exception nbapy.player.PlayerNotFoundException¶

class nbapy.player.ReboundTracking(player_id: str, team_id: str = '0', measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Tracking data for rebounding for a given team.

Parameters: Splits (see) –

_endpoint = 'playerdashptreb'¶

num_contested()¶

overall()¶

rebound_distance()¶

shot_distance()¶

shot_type()¶

class nbapy.player.ShootingSplits(player_id: str, team_id: str = '0', measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Shooting stats.

Based on shot distance, area, assisted to, shot types, and assisted by.

_endpoint = 'playerdashboardbyshootingsplits'¶

assisted_by()¶

assisted_shots()¶

shot_5ft()¶

shot_8ft()¶

shot_areas()¶

shot_types_detail()¶

shot_types_summary()¶

class nbapy.player.ShotTracking(player_id: str, team_id: str = '0', measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Tracking data for shooting for a given player.

Parameters: Splits (see) –

_endpoint = 'playerdashptshots'¶

closest_defender()¶

closest_defender_long()¶

dribbles()¶

general()¶

overall()¶

shot_clock()¶

touch_time()¶

class nbapy.player.Splits(player_id: str, team_id: str = '0', measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Player stats splits.

Also a base class containing common arguments for different split type child classes.

Parameters

player_id – ID of the player to look up
team_id – ID of the team to look up
measure_type – Specifies type of measure to use (Base, Advanced, etc.)
per_mode – Mode to measure statistics (Totals, PerGame, Per36, etc.)
plus_minus – Whether or not to consider plus minus (Y or N)
pace_adjust – Whether or not to pace adjust stats (Y or N)
rank – Whether or not to consider rank (Y or N)
league_id – ID for the league to look in (Default is 00)
season – Season given to look up
season_type – Season type to consider (Regular / Playoffs)
po_round – Playoff round
outcome – Filter out by wins or losses
location – Filter out by home or away
month – Specify month to filter by
season_segment – Filter by pre/post all star break
date_from – Filter out games before a specific date
date_to – Filter out games after a specific date
opponent_team_id – Opponent team ID to look up
vs_conference – Filter by conference
vs_division – Filter by division
game_segment – Filter by half / overtime
period – Filter by quarter / specific overtime
shot_clock_range – Filter statistics by range in shot clock
last_n_games – Filter by number of games specified in N

_endpoint = 'playerdashboardbygeneralsplits'¶

overall()¶

class nbapy.player.Summary(player_id: str)¶

Contains common player information like headline stats, weight, etc.

Parameters: player_id – ID of the player to look up

_endpoint = 'commonplayerinfo'¶

headline_stats()¶

info()¶

class nbapy.player.TeamPerformanceSplits(player_id: str, team_id: str = '0', measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Player stats by different team performance metrics.

Metrics include score differential, points scored, and points scored against.

_endpoint = 'playerdashboardbyteamperformance'¶

points_against()¶

points_scored()¶

score_differential()¶

class nbapy.player.VsPlayer(player_id: str, vs_player_id: str, team_id: str = '0', measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Contains general stats that pertain to players against other players.

:param : player_id: ID of the player to look up :param : vs_player_id: ID of the vs player to look up :param : team_id: ID of the team to look up :param : measure_type: Specifies type of measure to use (Base, Advanced, etc.) :param : per_mode: Mode to measure statistics (Totals, PerGame, Per36, etc.) :param : plus_minus: Whether or not to consider plus minus (Y or N) :param : pace_adjust: Whether or not to pace adjust stats (Y or N) :param : rank: Whether or not to consider rank (Y or N) :param : league_id: ID for the league to look in (Default is 00) :param : season: Season given to look up :param : season_type: Season type to consider (Regular / Playoffs) :param : po_round: Playoff round :param : outcome: Filter out by wins or losses :param : location: Filter out by home or away :param : month: Specify month to filter by :param : season_segment: Filter by pre/post all star break :param : date_from: Filter out games before a specific date :param : date_to: Filter out games after a specific date :param : opponent_team_id: Opponent team ID to look up :param : vs_conference: Filter by conference :param : vs_division: Filter by division :param : game_segment: Filter by half / overtime :param : period: Filter by quarter / specific overtime :param : shot_clock_range: Filter statistics by range in shot clock :param : last_n_games: Filter by number of games specified in N

json¶: Contains the full json dump to play around with

_endpoint = 'playervsplayer'¶

on_off_court()¶: Player1’s splits with Player2 on and off the court.

overall()¶: Splits comparison.

player_info()¶

shot_area_off_court()¶: Player1’s shooting by area splits with Player2 off the court.

shot_area_on_court()¶: Player1’s shooting by area splits with Player2 on the court.

shot_area_overall()¶: Player1’s shooting by area splits regardless of Player2.

shot_dist_off_court()¶: Player1’s shooting distance splits with Player2 off the court.

shot_dist_on_court()¶: Player1’s shooting distance splits with Player2 on the court.

shot_dist_overall()¶: Player1’s shooting distance splits regardless of Player2.

vs_player_info()¶

class nbapy.player.YearOverYearSplits(player_id: str, team_id: str = '0', measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Stats over the given season and over all seasons in the given league.

_endpoint = 'playerdashboardbyyearoveryear'¶

by_year()¶

nbapy.player.get_id(name, season='2020-21', active_only=1)¶

Get a player_id for any specified player.

Calls PlayerList, then matches name to return the id. Player id is needed for most of our player functions.

Parameters

name – name of the player to lookup. This must match the name as presented on nba.com (case insensitive)
season – season to lookup
active_only – only match active players

Returns

Nba.com player_id

Raises

PlayerNotFoundException –

Scoreboard¶

Displays game info for all games in a given day.

class nbapy.scoreboard.Scoreboard(month=5, day=24, year=2021, league_id='00', offset=0)¶

A scoreboard for all games for a given day.

Displays current games plus info for a given day

Parameters

month – Specified month (1-12)
day – Specified day (1-31)
year – Specified year (YYYY)
league_id – ID for the league to look in (Default is 00)
offset – Day offset from which to operate

TODAY = datetime.datetime(2021, 5, 24, 18, 17, 1, 905906)¶

_endpoint = 'scoreboard'¶

available()¶

east_conf_standings_by_day()¶

game_header()¶

last_meeting()¶

line_score()¶

series_standings()¶

west_conf_standings_by_day()¶

Shot Chart¶

class nbapy.shot_chart.ShotChart(player_id: str, team_id='0', game_id='', league_id='00', season='2020-21', season_type='Regular Season', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conf='', vs_div='', position='', game_segment='', period='0', last_n_games='0', ahead_behind='', context_measure='FGM', clutch_time='', rookie_year='')¶

_endpoint = 'shotchartdetail'¶

league_average()¶

shot_chart()¶

Team¶

class nbapy.team.ClutchSplits(team_id, measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Contains a lot of methods for last n minutes with a deficit of x points.

_endpoint = 'teamdashboardbyclutch'¶

last_10s_lte_3pts()¶: Splits in last 10 seconds <= 3 points.

last_1m_lte_5pts()¶: Splits in last minute <= 5 points.

last_1m_pm_5pts()¶: Splits in last minute +/- 5 points.

last_30s_lte_3pts()¶: Splits in last 30 seconds <= 3 points.

last_3m_lte_5pts()¶: Splits in last 3 minutes <= 5 points.

last_3m_pm_5pts()¶: Splits in last 3 minutes +/- 5 points.

last_5m_lte_5pts()¶: Splits in last 5 minutes <= 5 points.

last_5m_pm_5pts()¶: Splits in last 5 minutes +/- 5 points.

class nbapy.team.CommonRoster(team_id, season='2020-21')¶

_endpoint = 'commonteamroster'¶

coaches()¶

roster()¶

class nbapy.team.Details(team_id)¶

Various team details.

_endpoint = 'teamdetails'¶

awards_championships()¶: Champtionship title victories and opponents.

awards_conf()¶: Conference title victories and opponents.

awards_div()¶: Division title victories and opponents.

background()¶: Background info such as coach, city, arena, owner, etc.

history()¶: History info such as nickname, year founded, etc.

hof_players()¶: All team hall of fame players.

retired_players()¶: Retired numbers and associated info.

social_sites()¶: Team social media sites.

class nbapy.team.GameLogs(team_id, date_from='', date_to='', game_segment='', last_n_games='0', league_id='00', location='', measure_type='Base', month='0', opponent_team_id='0', outcome='', po_round='0', pace_adjust='N', per_mode='PerGame', period='0', plus_minus='N', rank='N', season='2020-21', season_segment='', season_type='Regular Season', shot_clock_range='', vs_conference='', vs_division='')¶

_endpoint = 'teamgamelogs'¶

logs()¶

class nbapy.team.GeneralSplits(team_id, measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Random general stats.

Contains stats pertaining to location, wins and losses, pre/post all star break and numbers of days rest.

_endpoint = 'teamdashboardbygeneralsplits'¶

days_rest()¶

location()¶

month()¶

pre_post_all_star()¶

wins_losses()¶

class nbapy.team.InGameSplits(team_id, measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Team stats by half, by quarter, by score margin, and by actual margins.

_endpoint = 'teamdashboardbygamesplits'¶

by_actual_margin()¶

by_half()¶

by_period()¶

by_score_margin()¶

class nbapy.team.LastNGamesSplits(team_id, measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Contains team stats per n games.

Per last 5, 10, 15, and 20 games, or specified number of games.

_endpoint = 'teamdashboardbylastngames'¶

game_num()¶: Stats for sets of 10 games.

last_10()¶

last_15()¶

last_20()¶

last_5()¶

class nbapy.team.LineupSplits(team_id, game_id='', group_quantity=5, season='2020-21', season_type='Regular Season', measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', last_n_games='0')¶

Splits for all team lineup combinations.

_endpoint = 'teamdashlineups'¶

lineups()¶

class nbapy.team.OpponentSplits(team_id, measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Contains stats pertaining to a team vs certain opponents.

By division, conference, and by specific team opponent

_endpoint = 'teamdashboardbyopponent'¶

by_conference()¶

by_division()¶

by_team()¶

class nbapy.team.PassTracking(team_id, measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Tracking data for passing for a given team.

_endpoint = 'teamdashptpass'¶

made()¶

received()¶

class nbapy.team.PerformanceSplits(team_id, measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Team stats by different performance metrics.

Includes score differential, points scored, and points scored against.

_endpoint = 'teamdashboardbyteamperformance'¶

points_against()¶

points_scored()¶

score_differential()¶

class nbapy.team.PlayerOnOffSplits(team_id, measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Team splits when a specific player is on or off the court.

_endpoint = 'teamplayeronoffdetails'¶

off_court()¶

on_court()¶

class nbapy.team.PlayerOnOffSummary(team_id, measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Team stats on offensive/defensive/net rating with players on or off the court.

_endpoint = 'teamplayeronoffsummary'¶

off_court()¶

on_court()¶

class nbapy.team.PlayerSplits(team_id, measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Splits for all the players on a team.

_endpoint = 'teamplayerdashboard'¶

players()¶

class nbapy.team.ReboundTracking(team_id, measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Tracking data for rebounding for a given team.

Parameters: Splits (see) –

_endpoint = 'teamdashptreb'¶

num_contested()¶

overall()¶

rebound_distance()¶

shot_distance()¶

shot_type()¶

class nbapy.team.SeasonResults(team_id, league_id='00', season_type='Regular Season', per_mode='PerGame')¶

Team results per season.

Includes W/L, points, division/conference rank, playoff record, finals results, etc.

_endpoint = 'teamyearbyyearstats'¶

results()¶

class nbapy.team.ShootingSplits(team_id, measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Shooting stats.

Based on shot distance, area, assisted to, shot types, and assisted by.

_endpoint = 'teamdashboardbyshootingsplits'¶

assisted_by()¶

assisted_shots()¶

shot_5ft()¶

shot_8ft()¶

shot_areas()¶

shot_types()¶

class nbapy.team.ShotTracking(team_id, measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Shooting tracking data for a given team.

_endpoint = 'teamdashptshots'¶

closest_defender()¶

closest_defender_long()¶

dribbles()¶

general()¶

shot_clock()¶

touch_time()¶

class nbapy.team.Splits(team_id, measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Team stats splits.

Also a base class containing common arguments for different split type child classes.

Parameters

team_id – ID of the team to look up
measure_type – Specifies type of measure to use (Base, Advanced, etc.)
per_mode – Mode to measure statistics (Totals, PerGame, Per36, etc.)
plus_minus – Whether or not to consider plus minus (Y or N)
pace_adjust – Whether or not to pace adjust stats (Y or N)
rank – Whether or not to consider rank (Y or N)
league_id – ID for the league to look in (Default is 00)
season – Season given to look up
season_type – Season type to consider (Regular / Playoffs)
po_round – Playoff round
outcome – Filter out by wins or losses
location – Filter out by home or away
month – Specify month to filter by
season_segment – Filter by pre/post all star break
date_from – Filter out games before a specific date
date_to – Filter out games after a specific date
opponent_team_id – Opponent team ID to look up
vs_conference – Filter by conference
vs_division – Filter by division
game_segment – Filter by half / overtime
period – Filter by quarter / specific overtime
shot_clock_range – Filter statistics by range in shot clock
last_n_games – Filter by number of games specified in N

_endpoint = 'teamdashboardbygeneralsplits'¶

overall()¶

class nbapy.team.TeamList(league_id='00')¶

_endpoint = 'commonteamyears'¶

teams()¶

class nbapy.team.TeamSummary(team_id, season='2020-21', league_id='00', season_type='Regular Season')¶

_endpoint = 'teaminfocommon'¶

info()¶

season_ranks()¶

class nbapy.team.VsPlayer(team_id, vs_player_id, measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

_endpoint = 'teamvsplayer'¶

on_off_court()¶

overall()¶

shot_area_off_court()¶

shot_area_on_court()¶

shot_area_overall()¶

shot_dist_off_court()¶

shot_dist_on_court()¶

shot_dist_overall()¶

vs_player_overall()¶

class nbapy.team.YearOverYearSplits(team_id, measure_type='Base', per_mode='PerGame', plus_minus='N', pace_adjust='N', rank='N', league_id='00', season='2020-21', season_type='Regular Season', po_round='0', outcome='', location='', month='0', season_segment='', date_from='', date_to='', opponent_team_id='0', vs_conference='', vs_division='', game_segment='', period='0', shot_clock_range='', last_n_games='0')¶

Team stats over the given season and over all seasons in the given league.

_endpoint = 'teamdashboardbyyearoveryear'¶

by_year()¶

Constants¶

class nbapy.constants.AheadBehind¶

AheadOrBehind = 'Ahead or Behind'¶

AheadOrTied = 'Ahead or Tied'¶

BehindOrTied = 'Behind or Tied'¶

class nbapy.constants.ClutchTime¶

Last10Sec = 'Last 10 Seconds'¶

Last1Min = 'Last 1 Minutes'¶

Last2Min = 'Last 2 Minutes'¶

Last30Sec = 'Last 30 Seconds'¶

Last3Min = 'Last 3 Minutes'¶

Last4Min = 'Last 4 Minutes'¶

Last5Min = 'Last 5 Minutes'¶

class nbapy.constants.College¶

class nbapy.constants.Conference¶

class nbapy.constants.ContextMeasure¶

Default = 'FGM'¶

EFG_PCT = 'EFG_PCT'¶

FG3A = 'FG3A'¶

FG3M = 'FG3m'¶

FG3_PCT = 'FG3_PCT'¶

FGA = 'FGA'¶

FGM = 'FGM'¶

FG_PCT = 'FG_PCT'¶

PF = 'PF'¶

PTS_2ND_CHANCE = 'PTS_2ND_CHANCE'¶

PTS_FB = 'PTS_FB'¶

PTS_OFF_TOV = 'PTS_OFF_TOV'¶

TS_PCT = 'TS_PCT'¶

class nbapy.constants.Counter¶

Default = '1000'¶

class nbapy.constants.Country¶

class nbapy.constants.DateFrom¶

class nbapy.constants.DateTo¶

class nbapy.constants.Direction¶

ASC = 'ASC'¶

DESC = 'DESC'¶

Default = 'DESC'¶

class nbapy.constants.Division¶

class nbapy.constants.DraftPick¶

FirstPick = '1st+Pick'¶

FirstRound = '1st+Round'¶

Lottery = 'Lottery+Pick'¶

Picks11Thru20 = 'Picks+11+Thru+20'¶

Picks21Thru30 = 'Picks+21+Thru+30'¶

SecondRound = '2nd+Round'¶

Top10 = 'Top+10+Pick'¶

Top15 = 'Top+15+Pick'¶

Top20 = 'Top+20+Pick'¶

Top25 = 'Top+25+Pick'¶

Top5 = 'Top+5+Pick'¶

Undrafted = 'Undrafted'¶

class nbapy.constants.DraftYear¶

class nbapy.constants.EndPeriod¶

class nbapy.constants.EndRange¶

class nbapy.constants.GameID¶

class nbapy.constants.GameScope¶

Default = 'Season'¶

Finals = 'Finals'¶

Last10 = 'Last 10'¶

Season = 'Season'¶

Yesterday = 'Yesterday'¶

class nbapy.constants.GameSegment¶

EntireGame = ''¶

FirstHalf = 'First Half'¶

Overtime = 'Overtime'¶

SecondHalf = 'Second Half'¶

class nbapy.constants.Game_Scope¶

Last10 = 'Last 10'¶

Yesterday = 'Yesterday'¶

class nbapy.constants.GroupQuantity¶

Default = 5¶

class nbapy.constants.Height¶

Player height.

Example

For greater than 6ft8 api call should be GT+6-8 For lower than 7ft3 api call should be LT+7-3

class nbapy.constants.LastNGames¶

class nbapy.constants.League¶

Default = '00'¶

GLeague = '20'¶

NBA = '00'¶

class nbapy.constants.Location¶

Away = 'Away'¶

Home = 'Home'¶

class nbapy.constants.MeasureType¶

Advanced = 'Advanced'¶

Base = 'Base'¶

Default = 'Base'¶

FourFactors = 'Four Factors'¶

Misc = 'Misc'¶

Opponent = 'Opponent'¶

Scoring = 'Scoring'¶

Usage = 'Usage'¶

class nbapy.constants.Month¶

All = '0'¶

April = '7'¶

August = '11'¶

December = '3'¶

February = '5'¶

January = '4'¶

July = '10'¶

June = '9'¶

March = '6'¶

May = '8'¶

November = '2'¶

October = '1'¶

September = '12'¶

class nbapy.constants.OpponentTeamID¶

class nbapy.constants.Outcome¶

Loss = 'L'¶

Win = 'W'¶

class nbapy.constants.PaceAdjust¶

class nbapy.constants.PerMode¶

Default = 'PerGame'¶

MinutesPer = 'MinutesPer'¶

Per100Plays = 'Per100Plays'¶

Per100Possessions = 'Per100Possessions'¶

Per36 = 'Per36'¶

Per40 = 'Per40'¶

Per48 = 'Per48'¶

PerGame = 'PerGame'¶

PerMinute = 'PerMinute'¶

PerPlay = 'PerPlay'¶

PerPossession = 'PerPossession'¶

Totals = 'Totals'¶

class nbapy.constants.Period¶

AllQuarters = '0'¶

FirstQuarter = '1'¶

FourthQuarter = '4'¶

Overtime(n)¶

SecondQuarter = '2'¶

ThirdQuarter = '3'¶

class nbapy.constants.PlayerExperience¶

Rookie = 'Rookie'¶

Sophomore = 'Sophomore'¶

Veteran = 'Veteran'¶

class nbapy.constants.PlayerOrTeam¶

Default = 'Player'¶

Player = 'Player'¶

Team = 'Team'¶

class nbapy.constants.PlayerPosition¶

Center = 'C'¶

Forward = 'F'¶

Guard = 'G'¶

class nbapy.constants.PlayerScope¶

AllPlayers = 'All Players'¶

Default = 'All Players'¶

Rookies = 'Rookie'¶

class nbapy.constants.Player_or_Team¶

Default = 'P'¶

Player = 'P'¶

Team = 'T'¶

class nbapy.constants.PlayoffRound¶

All = '0'¶

ConferenceFinals = '3'¶

Finals = '4'¶

QuarterFinals = '1'¶

SemiFinals = '2'¶

class nbapy.constants.PlusMinus¶

class nbapy.constants.PtMeasureType¶

CatchAndShoot = 'CatchShoot'¶

Default = 'CatchShoot'¶

Defense = 'Defense'¶

Drives = 'Drives'¶

Efficiency = 'Efficiency'¶

ElbowTouches = 'ElbowTouch'¶

PaintTouches = 'PaintTouch'¶

Passing = 'Passing'¶

PostUps = 'PostTouch'¶

PullUpShooting = 'PullUpShot'¶

Rebounding = 'Rebounding'¶

SpeedDistance = 'SpeedDistance'¶

Touches = 'Possessions'¶

class nbapy.constants.RangeType¶

class nbapy.constants.Rank¶

class nbapy.constants.RookieYear¶

class nbapy.constants.Scope¶

AllPlayers = 'S'¶

Default = 'S'¶

Rookies = 'Rookies'¶

class nbapy.constants.SeasonSegment¶

EntireSeason = ''¶

PostAllStar = 'Post All-Star'¶

PreAllStar = 'Pre All-Star'¶

class nbapy.constants.SeasonType¶

Default = 'Regular Season'¶

Playoffs = 'Playoffs'¶

Regular = 'Regular Season'¶

class nbapy.constants.ShotClockRange¶

AllRanges = ''¶

ShotClockOff = 'ShotClock Off'¶

get(n)¶

class nbapy.constants.Sorter¶

AST = 'AST'¶

BLK = 'BLK'¶

DREB = 'DREB'¶

Default = 'PTS'¶

FG3A = 'FG3A'¶

FG3M = 'FG3M'¶

FG3_PCT = 'FG3_PCT'¶

FGA = 'FGA'¶

FGM = 'FGM'¶

FG_PCT = 'FG_PCT'¶

FTA = 'FTA'¶

FTM = 'FTM'¶

FT_PCT = 'FT_PCT'¶

OREB = 'OREB'¶

PTS = 'PTS'¶

REB = 'REB'¶

STL = 'STL'¶

TOV = 'TOV'¶

class nbapy.constants.StartPeriod¶

class nbapy.constants.StartRange¶

class nbapy.constants.StarterBench¶

Bench = 'Bench'¶

Starters = 'Starters'¶

class nbapy.constants.StatCategory¶

AST = 'AST'¶

AST_TOV = 'AST/TO'¶

BLK = 'BLK'¶

DREB = 'DREB'¶

Default = 'PTS'¶

EFF = 'EFF'¶

FG3A = '3PA'¶

FG3M = '3PM'¶

FG3_PCT = '3P%'¶

FGA = 'FGA'¶

FGM = 'FGM'¶

FG_PCT = 'FG%'¶

FTA = 'FTA'¶

FTM = 'FTM'¶

FT_PCT = 'FT%'¶

OREB = 'OREB'¶

PF = 'PF'¶

PTS = 'PTS'¶

REB = 'REB'¶

STL = 'STL'¶

STL_TOV = 'STL/TOV'¶

TOV = 'TOV'¶

class nbapy.constants.TeamID¶

class nbapy.constants.VsConference¶

All = ''¶

East = 'East'¶

West = 'West'¶

class nbapy.constants.VsDivision¶

All = ''¶

Atlantic = 'Atlantic'¶

Central = 'Central'¶

Northwest = 'Northwest'¶

Pacific = 'Pacific'¶

Southeast = 'Southeast'¶

Southwest = 'Southwest'¶

class nbapy.constants.Weight¶

Player weight.

Example

For greater than 225lbs api call should be GT+225lbs