Skip to main content

nba_shotchartdetail

Endpoint URL#

https://stats.nba.com/stats/shotchartdetail

Valid URL#

https://stats.nba.com/stats/shotchartdetail?AheadBehind=&ClutchTime=&ContextFilter=&ContextMeasure=PTS&DateFrom=&DateTo=&EndPeriod=&EndRange=&GameID=&GameSegment=&LastNGames=0&LeagueID=00&Location=&Month=0&OpponentTeamID=0&Outcome=&Period=0&PlayerID=2544&PlayerPosition=&PointDiff=&Position=&RangeType=&RookieYear=&Season=&SeasonSegment=&SeasonType=Regular+Season&StartPeriod=&StartRange=&TeamID=1610612739&VsConference=&VsDivision=

Parameters#

API Parameter NameParameterPatternRequiredNullable
ContextMeasurecontext_measure_simple^((PTS)\|(FGM)\|(FGA)\|(FG_PCT)\|(FG3M)\|(FG3A)\|(FG3_PCT)\|(PF)\|(EFG_PCT)\|(TS_PCT)\|(PTS_FB)\|(PTS_OFF_TOV)\|(PTS_2ND_CHANCE)\|(PF))?$Y
LastNGameslast_n_gamesY
LeagueIDleague_idY
MonthmonthY
OpponentTeamIDopponent_team_idY
PeriodperiodY
PlayerIDplayer_idY
SeasonTypeseason_type_all_star^(Regular Season)\|(Pre Season)\|(Playoffs)\|(All Star)$Y
TeamIDteam_idY
VsDivisionvs_division_nullable^((Atlantic)\|(Central)\|(Northwest)\|(Pacific)\|(Southeast)\|(Southwest)\|(East)\|(West))?$YY
VsConferencevs_conference_nullable^((East)\|(West))?$YY
StartRangestart_range_nullableY
StartPeriodstart_period_nullableY
SeasonSegmentseason_segment_nullable^((Post All-Star)\|(Pre All-Star))?$YY
Seasonseason_nullableY
RookieYearrookie_year_nullableYY
RangeTyperange_type_nullableY
Positionposition_nullableY
PointDiffpoint_diff_nullableY
PlayerPositionplayer_position_nullable^((Guard)\|(Center)\|(Forward))?$YY
Outcomeoutcome_nullable^((W)\|(L))?$YY
Locationlocation_nullable^((Home)\|(Road))?$YY
GameSegmentgame_segment_nullable^((First Half)\|(Overtime)\|(Second Half))?$YY
GameIDgame_id_nullable^(\d{10})?$YY
EndRangeend_range_nullableY
EndPeriodend_period_nullableY
DateTodate_to_nullableYY
DateFromdate_from_nullableYY
ContextFiltercontext_filter_nullableY
ClutchTimeclutch_time_nullable^((Last 5 Minutes)\|(Last 4 Minutes)\|(Last 3 Minutes)\|(Last 2 Minutes)\|(Last 1 Minute)\|(Last 30 Seconds)\|(Last 10 Seconds))?$Y
AheadBehindahead_behind_nullable^((Ahead or Behind)\|(Ahead or Tied)\|(Behind or Tied))?$Y

Data Sets#

LeagueAverages league_averages#

['GRID_TYPE', 'SHOT_ZONE_BASIC', 'SHOT_ZONE_AREA', 'SHOT_ZONE_RANGE', 'FGA', 'FGM', 'FG_PCT']

Shot_Chart_Detail shot_chart_detail#

['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']

JSON#

{    "data_sets": {        "LeagueAverages": [            "GRID_TYPE",            "SHOT_ZONE_BASIC",            "SHOT_ZONE_AREA",            "SHOT_ZONE_RANGE",            "FGA",            "FGM",            "FG_PCT"        ],        "Shot_Chart_Detail": [            "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"        ]    },    "endpoint": "ShotChartDetail",    "last_validated_date": "2020-08-15",    "nullable_parameters": [        "AheadBehind",        "ClutchTime",        "ContextFilter",        "DateFrom",        "DateTo",        "EndPeriod",        "EndRange",        "GameID",        "GameSegment",        "Location",        "Outcome",        "PlayerPosition",        "PointDiff",        "Position",        "RangeType",        "RookieYear",        "Season",        "SeasonSegment",        "StartPeriod",        "StartRange",        "VsConference",        "VsDivision"    ],    "parameter_patterns": {        "AheadBehind": "^((Ahead or Behind)|(Ahead or Tied)|(Behind or Tied))?$",        "ClutchTime": "^((Last 5 Minutes)|(Last 4 Minutes)|(Last 3 Minutes)|(Last 2 Minutes)|(Last 1 Minute)|(Last 30 Seconds)|(Last 10 Seconds))?$",        "ContextFilter": null,        "ContextMeasure": "^((PTS)|(FGM)|(FGA)|(FG_PCT)|(FG3M)|(FG3A)|(FG3_PCT)|(PF)|(EFG_PCT)|(TS_PCT)|(PTS_FB)|(PTS_OFF_TOV)|(PTS_2ND_CHANCE)|(PF))?$",        "DateFrom": null,        "DateTo": null,        "EndPeriod": null,        "EndRange": null,        "GameID": "^(\\d{10})?$",        "GameSegment": "^((First Half)|(Overtime)|(Second Half))?$",        "LastNGames": null,        "LeagueID": null,        "Location": "^((Home)|(Road))?$",        "Month": null,        "OpponentTeamID": null,        "Outcome": "^((W)|(L))?$",        "Period": null,        "PlayerID": null,        "PlayerPosition": "^((Guard)|(Center)|(Forward))?$",        "PointDiff": null,        "Position": null,        "RangeType": null,        "RookieYear": null,        "Season": null,        "SeasonSegment": "^((Post All-Star)|(Pre All-Star))?$",        "SeasonType": "^(Regular Season)|(Pre Season)|(Playoffs)|(All Star)$",        "StartPeriod": null,        "StartRange": null,        "TeamID": null,        "VsConference": "^((East)|(West))?$",        "VsDivision": "^((Atlantic)|(Central)|(Northwest)|(Pacific)|(Southeast)|(Southwest)|(East)|(West))?$"    },    "parameters": [        "AheadBehind",        "ClutchTime",        "ContextFilter",        "ContextMeasure",        "DateFrom",        "DateTo",        "EndPeriod",        "EndRange",        "GameID",        "GameSegment",        "LastNGames",        "LeagueID",        "Location",        "Month",        "OpponentTeamID",        "Outcome",        "Period",        "PlayerID",        "PlayerPosition",        "PointDiff",        "Position",        "RangeType",        "RookieYear",        "Season",        "SeasonSegment",        "SeasonType",        "StartPeriod",        "StartRange",        "TeamID",        "VsConference",        "VsDivision"    ],    "required_parameters": [        "ContextMeasure",        "DateFrom",        "DateTo",        "GameID",        "GameSegment",        "LastNGames",        "LeagueID",        "Location",        "Month",        "OpponentTeamID",        "Outcome",        "Period",        "PlayerID",        "PlayerPosition",        "RookieYear",        "SeasonSegment",        "SeasonType",        "TeamID",        "VsConference",        "VsDivision"    ],    "status": "success"}

Last validated 2020-08-16