Data Sources — NBA Shot Chart Explorer

Team

TeamGameLogs

57 fields Used in App

Per-game box score stats for any team. Returns every game in a season with full traditional stats plus league-wide rankings for each stat. This is the primary data source for the Team Shot Analysis stats panel.

team_id season season_type last_n_games

SEASON_YEAR TEAM_ID TEAM_ABBREVIATION TEAM_NAME GAME_ID GAME_DATE MATCHUP WL MIN FGM FGA FG_PCT FG3M FG3A FG3_PCT FTM FTA FT_PCT OREB DREB REB AST TOV STL BLK BLKA PF PFD PTS PLUS_MINUS GP_RANK W_RANK L_RANK W_PCT_RANK MIN_RANK FGM_RANK FGA_RANK FG_PCT_RANK FG3M_RANK FG3A_RANK FG3_PCT_RANK FTM_RANK FTA_RANK FT_PCT_RANK OREB_RANK DREB_RANK REB_RANK AST_RANK TOV_RANK STL_RANK BLK_RANK BLKA_RANK PF_RANK PFD_RANK PTS_RANK PLUS_MINUS_RANK AVAILABLE_FLAG

Core Stats League Rankings Other

Example Data

GAME_DATE	MATCHUP	WL	PTS	FGM	FGA	FG3M	FG3A	REB	AST	STL	BLK	TOV	+/-

Player

Team

ShotChartDetail

24 fields Used in App

Every single shot attempt for a player or team in a season. Includes X/Y court coordinates, shot type, zone, distance, and result. This is the core data source powering all shot chart visualizations across the app.

player_id team_id season context_measure

GRID_TYPE GAME_ID GAME_EVENT_ID PLAYER_ID PLAYER_NAME TEAM_ID TEAM_NAME PERIOD MINUTES_REMAINING SECONDS_REMAINING EVENT_TYPE ACTION_TYPE SHOT_TYPE SHOT_ZONE_BASIC SHOT_ZONE_AREA SHOT_ZONE_RANGE SHOT_DISTANCE LOC_X LOC_Y SHOT_ATTEMPTED_FLAG SHOT_MADE_FLAG GAME_DATE HTM VTM

Example Data

PLAYER_NAME	ACTION_TYPE	SHOT_TYPE	SHOT_ZONE_BASIC	SHOT_DISTANCE	LOC_X	LOC_Y	MADE	PERIOD	GAME_DATE

Team

LeagueDashTeamStats

54 fields

Season-level aggregated stats for all 30 NBA teams. Includes totals for every traditional stat plus league-wide rankings. Great for team-vs-team comparisons and league-wide analysis.

season season_type per_mode

TEAM_ID TEAM_NAME GP W L W_PCT MIN FGM FGA FG_PCT FG3M FG3A FG3_PCT FTM FTA FT_PCT OREB DREB REB AST TOV STL BLK BLKA PF PFD PTS PLUS_MINUS GP_RANK … PLUS_MINUS_RANK

Example Data

TEAM	GP	W	L	W%	PTS	FG%	3P%	REB	AST	STL	BLK	TOV	+/-

Player

LeagueDashPlayerStats

67 fields

Season-level aggregated stats for every active player in the league. Includes traditional stats, fantasy points, double-doubles, triple-doubles, and league rankings for every stat.

season per_mode season_type

PLAYER_ID PLAYER_NAME NICKNAME TEAM_ID TEAM_ABBREVIATION AGE GP W L W_PCT MIN FGM FGA FG_PCT FG3M FG3A FG3_PCT FTM FTA FT_PCT OREB DREB REB AST TOV STL BLK BLKA PF PFD PTS PLUS_MINUS NBA_FANTASY_PTS DD2 TD3 WNBA_FANTASY_PTS GP_RANK … WNBA_FANTASY_PTS_RANK TEAM_COUNT

Example Data

PLAYER	TEAM	AGE	GP	MIN	PTS	FG%	3P%	REB	AST	STL	BLK	TOV	+/-

Player

CommonPlayerInfo

33 fields

Biographical information for a single player. Includes height, weight, position, jersey number, draft info, school, country of origin, and career year range. Useful for player profile cards.

player_id

PERSON_ID FIRST_NAME LAST_NAME DISPLAY_FIRST_LAST DISPLAY_LAST_COMMA_FIRST DISPLAY_FI_LAST PLAYER_SLUG BIRTHDATE SCHOOL COUNTRY LAST_AFFILIATION HEIGHT WEIGHT SEASON_EXP JERSEY POSITION ROSTERSTATUS GAMES_PLAYED_CURRENT_SEASON_FLAG TEAM_ID TEAM_NAME TEAM_ABBREVIATION TEAM_CODE TEAM_CITY PLAYERCODE FROM_YEAR TO_YEAR DLEAGUE_FLAG NBA_FLAG GAMES_PLAYED_FLAG DRAFT_YEAR DRAFT_ROUND DRAFT_NUMBER GREATEST_75_FLAG

Example Data (Stephen Curry)

NAME	TEAM	POS	HEIGHT	WEIGHT	SCHOOL	COUNTRY	DRAFT	JERSEY	YRS EXP

Player

PlayerCareerStats

27 fields

Season-by-season career stats for a single player. Each row is one season, with totals for every traditional stat. Great for career trajectory charts and year-over-year comparisons.

player_id per_mode

PLAYER_ID SEASON_ID LEAGUE_ID TEAM_ID TEAM_ABBREVIATION PLAYER_AGE GP GS MIN FGM FGA FG_PCT FG3M FG3A FG3_PCT FTM FTA FT_PCT OREB DREB REB AST STL BLK TOV PF PTS

Example Data (Stephen Curry — last 3 seasons)

SEASON	TEAM	AGE	GP	GS	MIN	PTS	FG%	3P%	REB	AST	STL

Team

LeagueStandingsV3

92 fields

Complete league standings with an enormous amount of detail. Conference/division records, home/road splits, streaks, monthly breakdowns, situational records (ahead at half, OT, 3-point games), and more. The most field-rich endpoint available.

season season_type

TeamID TeamCity TeamName Conference ConferenceRecord PlayoffRank ClinchIndicator Division DivisionRecord DivisionRank WINS LOSSES WinPCT LeagueRank Record HOME ROAD L10 Last10Home Last10Road OT ThreePTSOrLess TenPTSOrMore LongHomeStreak LongRoadStreak LongWinStreak LongLossStreak CurrentStreak ConferenceGamesBack DivisionGamesBack AheadAtHalf BehindAtHalf TiedAtHalf PointsPG OppPointsPG DiffPointsPG vsEast vsWest Jan … Dec PlayoffSeeding

Example Data

TEAM	CONF	W	L	W%	HOME	ROAD	L10	STREAK	PPG	OPP PPG	DIFF	GB

Player

LeagueLeaders

28 fields

League-wide player rankings by any stat category. Returns all qualifying players ranked from best to worst. Includes efficiency rating and assist-to-turnover ratio. Great for leaderboard visualizations.

season stat_category per_mode scope

PLAYER_ID RANK PLAYER TEAM_ID TEAM GP MIN FGM FGA FG_PCT FG3M FG3A FG3_PCT FTM FTA FT_PCT OREB DREB REB AST STL BLK TOV PF PTS EFF AST_TOV STL_TOV

Example Data

RANK	PLAYER	TEAM	GP	MIN	PTS	FG%	3P%	REB	AST	EFF	AST/TOV

Player

PlayerGameLogs

70 fields

Per-game box score stats for any individual player. Same structure as TeamGameLogs but at the player level. Includes every traditional stat plus league rankings per game. Powers game-by-game analysis.

player_id season season_type last_n_games

SEASON_YEAR PLAYER_ID PLAYER_NAME NICKNAME TEAM_ID TEAM_ABBREVIATION TEAM_NAME GAME_ID GAME_DATE MATCHUP WL MIN FGM … PTS PLUS_MINUS NBA_FANTASY_PTS DD2 TD3 GP_RANK … WNBA_FANTASY_PTS_RANK

Example Data (Stephen Curry — last 2 games)

DATE	MATCHUP	WL	MIN	PTS	FGM	FGA	FG3M	FG3A	REB	AST	STL	+/-

Player

PlayerIndex

26 fields

Directory of all active players in the league for a season. Includes bio data (height, weight, college, country, draft info) plus basic season averages. Great for building player search/dropdown lists.

season

PERSON_ID PLAYER_LAST_NAME PLAYER_FIRST_NAME PLAYER_SLUG TEAM_ID TEAM_SLUG IS_DEFUNCT TEAM_CITY TEAM_NAME TEAM_ABBREVIATION JERSEY_NUMBER POSITION HEIGHT WEIGHT COLLEGE COUNTRY DRAFT_YEAR DRAFT_ROUND DRAFT_NUMBER ROSTER_STATUS FROM_YEAR TO_YEAR PTS REB AST STATS_TIMEFRAME

Example Data

NAME	TEAM	#	POS	HEIGHT	WEIGHT	COLLEGE	COUNTRY	DRAFT	PTS	REB	AST

Player

LeagueDashPlayerBioStats

23 fields

Player bio data combined with advanced stats. Unique fields like NET_RATING, usage rate (USG_PCT), true shooting (TS_PCT), assist percentage, and offensive/defensive rebound rates. Combines physical profile with advanced metrics.

season per_mode

PLAYER_ID PLAYER_NAME TEAM_ID TEAM_ABBREVIATION AGE PLAYER_HEIGHT PLAYER_HEIGHT_INCHES PLAYER_WEIGHT COLLEGE COUNTRY DRAFT_YEAR DRAFT_ROUND DRAFT_NUMBER GP PTS REB AST NET_RATING OREB_PCT DREB_PCT USG_PCT TS_PCT AST_PCT

Example Data

PLAYER	TEAM	AGE	HT	WT	GP	PTS	NET RTG	USG%	TS%	AST%	OREB%	DREB%

Team

LeagueDashTeamClutch

54 fields

Team stats filtered to clutch situations only (last 5 minutes, score within 5 points by default). Same stat columns as LeagueDashTeamStats but only counting clutch possessions. Reveals which teams perform best under pressure.

season ahead_behind clutch_time point_diff

TEAM_ID TEAM_NAME GP W L W_PCT FGM … PTS PLUS_MINUS GP_RANK … PLUS_MINUS_RANK

Example Data (Clutch Stats)

TEAM	GP	W	L	W%	FG%	3P%	FT%	PTS	REB	AST	TOV	+/-

Player

Team

SynergyPlayTypes

24 fields

Breaks down scoring by play type — isolation, pick & roll, post-up, spot-up, transition, cut, off-screen, handoff. Shows points per possession, efficiency percentile, FG%, turnover rate, and frequency for each play type. Reveals a player's offensive identity.

season play_type type_grouping player_or_team per_mode

SEASON_ID PLAYER_ID PLAYER_NAME TEAM_ID TEAM_ABBREVIATION TEAM_NAME PLAY_TYPE TYPE_GROUPING PERCENTILE GP POSS_PCT PPP FG_PCT FT_POSS_PCT TOV_POSS_PCT SF_POSS_PCT PLUSONE_POSS_PCT SCORE_POSS_PCT EFG_PCT POSS PTS FGM FGA FGMX

Example Data (Isolation — Top 3 Players)

PLAYER	TEAM	PLAY TYPE	GP	POSS	PPP	FG%	EFG%	TOV%	SCORE%	%ILE	PTS

Player

PlayerDashboardByShootingSplits

30 fields × multiple tables

Splits a player's shooting by court area (restricted area, paint, mid-range, 3PT zones), distance (5ft buckets), and assisted vs unassisted. Shows what % of makes were assisted vs self-created for each zone. Multiple result tables in one call.

player_id season per_mode

GROUP_SET GROUP_VALUE FGM FGA FG_PCT FG3M FG3A FG3_PCT EFG_PCT BLKA PCT_AST_2PM PCT_UAST_2PM PCT_AST_3PM PCT_UAST_3PM PCT_AST_FGM PCT_UAST_FGM FGM_RANK … PCT_UAST_FGM_RANK

Example Data (Stephen Curry — Shot Area Splits)

ZONE	FGM	FGA	FG%	EFG%	% ASSISTED	% UNASSISTED

Player

Team

HustleStatsBoxScore

25 fields

The "effort" stats that don't show up in traditional box scores. Per-game hustle data including contested shots (2PT and 3PT separately), deflections, charges drawn, screen assists, loose balls recovered (offense + defense), and box outs. Reveals the grinders and energy players.

game_id

GAME_ID TEAM_ID TEAM_ABBREVIATION TEAM_CITY PLAYER_ID PLAYER_NAME START_POSITION COMMENT MINUTES PTS CONTESTED_SHOTS CONTESTED_SHOTS_2PT CONTESTED_SHOTS_3PT DEFLECTIONS CHARGES_DRAWN SCREEN_ASSISTS SCREEN_AST_PTS OFF_LOOSE_BALLS_RECOVERED DEF_LOOSE_BALLS_RECOVERED LOOSE_BALLS_RECOVERED OFF_BOXOUTS DEF_BOXOUTS BOX_OUT_PLAYER_TEAM_REBS BOX_OUT_PLAYER_REBS BOX_OUTS

Example Data (Single Game)

PLAYER	TEAM	MIN	PTS	CONTESTED	CONTESTED 2PT	CONTESTED 3PT	DEFLECTIONS	CHARGES	SCREENS	LOOSE BALLS	BOX OUTS

Player

LeagueSeasonMatchups

27 fields

Head-to-head defensive matchup data. Shows who guarded who, total possessions matched up, FG% when guarded by that defender, plus help defense stats (help blocks, help FGA allowed). The gold standard for "how does Player A perform against Defender B?"

season off_player_id def_player_id

SEASON_ID OFF_PLAYER_ID OFF_PLAYER_NAME DEF_PLAYER_ID DEF_PLAYER_NAME GP MATCHUP_MIN PARTIAL_POSS PLAYER_PTS TEAM_PTS MATCHUP_AST MATCHUP_TOV MATCHUP_BLK MATCHUP_FGM MATCHUP_FGA MATCHUP_FG_PCT MATCHUP_FG3M MATCHUP_FG3A MATCHUP_FG3_PCT HELP_BLK HELP_FGM HELP_FGA HELP_FG_PERC MATCHUP_FTM MATCHUP_FTA SFL MATCHUP_TIME_SEC

Example Data (Stephen Curry vs Defenders)

OFFENSE	DEFENDER	GP	MIN	POSS	PTS	FGM	FGA	FG%	3PM	3PA	3P%	AST	TOV

Team

TeamDashPtShots

18 fields × multiple tables

Player tracking shot data with next-level detail. Breaks down shooting by shot clock range (24-22, 22-18, etc.), dribbles before shot (0, 1, 2, 3-6, 7+), closest defender distance (0-2ft, 2-4ft, 4-6ft, 6+ft), and touch time. Multiple result tables per call.

team_id season per_mode

TEAM_ID TEAM_NAME SORT_ORDER G SHOT_CLOCK_RANGE FGA_FREQUENCY FGM FGA FG_PCT EFG_PCT FG2A_FREQUENCY FG2M FG2A FG2_PCT FG3A_FREQUENCY FG3M FG3A FG3_PCT

Also available as: DribbleShooting (DRIBBLE_RANGE), ClosestDefenderShooting (CLOSE_DEF_DIST_RANGE), TouchTimeShooting (TOUCH_TIME_RANGE)

Example Data (Warriors — Shot Clock Breakdown)

SHOT CLOCK	FGA FREQ	FGM	FGA	FG%	EFG%	2P FG%	3P FG%