Multi-table10 credits

get_shot_map

Every shot attempt with rink coordinates, shot type, shooter and goalie.

When to use it

You want to plot or model shot locations rather than read a list of events -- a shooter's season heat map, a team's attempts by zone, or the input to an expected-goals model. Filter by game, by player, or by season plus team.

Parameters

Name	Type	Required	Description
game_id	string	no	NHL game ID
season	string	no	Season ID, 8-digit; use with team
team	string	no	Team abbreviation; use with season
player_id	number	no	NHL player ID of the shooter
strength	string	no	Strength filter, e.g. 5v5

Request

bash

curl -X POST https://mcp.puckapi.com/v1/get_shot_map \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "game_id": "2024020601"
}'

Over MCP, ask for it in plain English and the client calls get_shot_map itself. Point any MCP client at https://mcp.puckapi.com/mcp?key=YOUR_API_KEY.

Response

json

{
  "shots": [
    {
      "type": "shot-on-goal",
      "x_coord": 62,
      "y_coord": -9,
      "shot_type": "wrist",
      "strength": "5v5",
      "team": "PIT",
      "shooter": 8471675,
      "goalie": 8480045,
      "game_id": "2024020601",
      "period": 1,
      "seconds_elapsed": 143
    }
  ],
  "summary": {
    "returned": 114,
    "capped_at": 2000,
    "by_type": {
      "shot-on-goal": 55,
      "missed-shot": 29,
      "blocked-shot": 20,
      "goal": 10
    }
  },
  "count": 114
}

Response fields

Field	Type	Description
shots[].x_coord	number	Rink x, -100..100
shots[].y_coord	number	Rink y, -42..42
shots[].type	string	goal, shot-on-goal, missed-shot or blocked-shot
shots[].shot_type	string	wrist, snap, slap, tip-in, backhand, deflected, wrap-around
shots[].shooter	number	Shooter's NHL player ID
shots[].goalie	number	Goalie in net at the time
summary.capped_at	number	Hard cap of 2,000 shots per call