get_shot_chart
10 creditsMulti-tablePOST /v1/get_shot_chart
Data refreshed · changelog
Shot profile by zone for a player, team or defence, with every shot's x/y
Use it when you want where a player or team shoots from and how well, by zone, with expected points per shot, or every shot's x/y to draw a chart.
Parameters
player_idstringoptionalteamstringoptional- Team id or abbreviation.
opponentbooleanoptional- With team: the shots its opponents took (its defence).
game_idstringoptionalseasonnumber | stringoptional- Season by the year it ends (default: the latest).
season_typeenum: regular | postseason | play_in | preseasonoptionalinclude_shotsbooleanoptional- Add each shot's x, y and result (up to 3,000).
leagueenum: nba | wnba | nbloptional- League. Defaults to nba. One of: nba, wnba, nbl.
Notes
- Over MCP, ask for it in plain English and the client calls
get_shot_chartitself. Point any MCP client athttps://mcp.dunkapi.com/mcp?key=YOUR_API_KEY. - Each call costs 10 credits, taken before it runs and refunded if the server errors.
- Not the call you need? Find the right call by what you are trying to answer.
Request
curl -X POST https://mcp.dunkapi.com/v1/get_shot_chart \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"player_id": "4065648",
"season": 2026
}'Response
json
{
"season": 2026,
"zones": [
{
"zone": "restricted_area",
"attempts": 57,
"made": 37,
"pct": 0.649,
"points_per_shot": 1.298,
"expected_points_per_shot": 1.171
},
{
"zone": "paint",
"attempts": 54,
"made": 22,
"pct": 0.407,
"points_per_shot": 0.815,
"expected_points_per_shot": 0.782
},
{
"zone": "midrange",
"attempts": 33,
"made": 12,
"pct": 0.364,
"points_per_shot": 0.727,
"expected_points_per_shot": 0.798
}
],
"field_goal_attempts": 287,
"share": {
"restricted_area": 0.199,
"paint": 0.188,
"midrange": 0.115,
"corner_3": 0.038,
"above_break_3": 0.46
}
}Response fields
seasonnumberzones[]array- List of objects
zones[].zonestringzones[].attemptsnumberzones[].madenumberzones[].pctnumberzones[].points_per_shotnumberzones[].expected_points_per_shotnumberfield_goal_attemptsnumbershareobjectshare.restricted_areanumbershare.paintnumbershare.midrangenumbershare.corner_3numbershare.above_break_3number
Used in
- NBA shot chart data: The x/y location of every NBA field goal attempt in the play-by-play since 2003-04, with distance, zone, result and expected points. REST or MCP.
- NBA play-by-play data: Play-by-play for every NBA season since 2003-04: clock, score, players, shot type and location, and win probability from 2018. REST or MCP.
- Guide: How do I build an NBA shot chart by zone in Python?
Related endpoints
list_teams1 cr
Returns the team this one takes.
Team ids, abbreviations and colours for a season
search_players1 cr
Returns the player_id this one takes.
Find players by name
list_games2 cr
Returns the game_id this one takes.
Games with scores by season, date, range or team
get_schedule2 cr
Returns the game_id this one takes.
Upcoming games with the median line across sportsbooks
Try it
500 free credits every month: 50 calls to get_shot_chart, and no card.