Skip to content

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_idstringoptional
teamstringoptional
Team id or abbreviation.
opponentbooleanoptional
With team: the shots its opponents took (its defence).
game_idstringoptional
seasonnumber | stringoptional
Season by the year it ends (default: the latest).
season_typeenum: regular | postseason | play_in | preseasonoptional
include_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_chart itself. Point any MCP client at https://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

seasonnumber
zones[]array
List of objects
zones[].zonestring
zones[].attemptsnumber
zones[].madenumber
zones[].pctnumber
zones[].points_per_shotnumber
zones[].expected_points_per_shotnumber
field_goal_attemptsnumber
shareobject
share.restricted_areanumber
share.paintnumber
share.midrangenumber
share.corner_3number
share.above_break_3number

Used in

Related endpoints

Try it

500 free credits every month: 50 calls to get_shot_chart, and no card.