GET /football/matches/{match_id}/players/{player_id}/heatmap - The Stats API

Return heatmap points for one player’s touches in one match.

Endpoint

GET https://api.thestatsapi.com/api/football/matches/{match_id}/players/{player_id}/heatmap

Each point uses x and y integer pitch coordinates from 0 to 100. Points are returned in capture order.

Path parameters

Name	Type	Required	Description
`match_id`	string	Yes	Match ID. Example: `mt_404012971`
`player_id`	string	Yes	Player ID. Example: `pl_84027040`

Response

{
  "data": {
    "match_id": "mt_404012971",
    "player": {
      "id": "pl_84027040",
      "name": "Dusan Vlahovic"
    },
    "team": {
      "id": "tm_5025",
      "name": "Juventus",
      "side": "home"
    },
    "points": [
      { "x": 41, "y": 9 },
      { "x": 44, "y": 12 }
    ]
  }
}

The endpoint returns 404 when no heatmap is available, for example for an unused substitute or a fixture without movement coverage.