SofaScore event shot map API

Endpoint facts

Method

GET

API path

/sofascore/event-shotmap

Auth

apiKey

Credits

2 credits/request

Charged on

Successful 2xx responses only

Platform

SofaScore

Response schema

#/definitions/sofascore.eventShotmapResponseDoc

How this endpoint behaves

Query parameters:

• id: required. Numeric SofaScore event (match) id of a football or ice hockey match, e.g. 16363867 (football) or 15950163 (ice hockey).

Notable response behavior:

• shot_type is the outcome (observed values: goal, save, miss, block, blocked-off-line); situation and body_part are SofaScore's own labels (observed: assisted, corner, set-piece, fast-break, free-kick, regular, throw-in-set-piece; left-foot, right-foot, head). They are not validated as closed sets.
• xg is expected goals and xgot expected goals on target; either is omitted when SofaScore does not provide it. goalkeeper is present on shots a goalkeeper faced.
• player_coordinates and block_coordinates use SofaScore's 0-100 pitch scale; goal_mouth_coordinates locates the shot on the goal frame (z is height).
• Ice hockey shots (live-checked on NHL matches 15950163 and 15950219) fill a different set of fields and leave the football-only ones out (minute, player_coordinates, goal_mouth_coordinates, goalkeeper, situation, body_part): team is the shooting team, outcome is one of made, saved, missed or blocked, strength is even, powerplay or shorthanded, period is 1ST, 2ND or 3RD in regulation (overtime labels were not checked), period_time_seconds is the time into the period, reversed_period_time_seconds the time left in it (football shots carry these two clock fields too), time_seconds the time into the game, and coordinates is one x/y rink position in SofaScore's rink units. xg is present on most shots and absent on blocked shots (21 of 94 in the match checked).
• In hockey shot_type is the shooting technique (seen: wrist, snap, slap, tip-in, bat, backhand, wrap-around, deflected), not the outcome as in football; use outcome for the result. xgot and goalkeeper are not provided for hockey.
• Basketball matches and lower-tier hockey fixtures (the junior MHL match checked) have no shot map and return 404.
• An empty shots array is a valid response (a live match with no shots yet), not an error.
• Returns 404 when SofaScore has no shot map for the match. This includes matches that have not started and fixtures without expected-goals coverage.

Example response, ice hockey (shortened):

{
  "code": 200,
  "msg": "OK",
  "data": {
    "event_id": 15950163,
    "source_url": "https://api.sofascore.com/api/v1/event/15950163/shotmap",
    "fetched_at": "2026-10-07T17:00:00Z",
    "count": 94,
    "shots": [
      {
        "id": 19632948,
        "player": {
          "id": 1458085,
          "name": "Jackson Blake",
          "short_name": "J. Blake",
          "slug": "jackson-blake",
          "position": "R",
          "jersey_number": "53"
        },
        "is_home": false,
        "shot_type": "wrap-around",
        "xg": 0.0704,
        "time_seconds": 105,
        "team": {
          "id": 3680,
          "name": "Carolina Hurricanes",
          "short_name": "Hurricanes",
          "slug": "carolina-hurricanes"
        },
        "outcome": "missed",
        "strength": "even",
        "period": "1ST",
        "period_time_seconds": 105,
        "reversed_period_time_seconds": 1095,
        "coordinates": {
          "x": 17,
          "y": 56
        }
      },
      {
        "id": 19632957,
        "player": {
          "id": 788026,
          "name": "Sebastian Aho",
          "short_name": "S. Aho",
          "slug": "sebastian-aho",
          "position": "C",
          "jersey_number": "20"
        },
        "is_home": false,
        "shot_type": "wrist",
        "time_seconds": 151,
        "team": {
          "id": 3680,
          "name": "Carolina Hurricanes",
          "short_name": "Hurricanes",
          "slug": "carolina-hurricanes"
        },
        "outcome": "blocked",
        "strength": "even",
        "period": "1ST",
        "period_time_seconds": 151,
        "reversed_period_time_seconds": 1049,
        "coordinates": {
          "x": 58,
          "y": 24
        }
      }
    ]
  }
}

Live monitoring

Monitored request

GET /sofascore/event-shotmap?id=16363867

Checks passed, 7 days to 14 Oct 2026

100%

Median response time

1.19 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026

GET /sofascore/event-shotmap?id=16363867

Items in shots

33

Fields filled in every checked item

16

Fields empty in some or all items

3

Shared guides

Related