Endpoint Playground
Returns one team's touch locations in a football match as `player_points` (outfield players) and `goalkeeper_points`, each point an `x` and `y` on SofaScore's 0-100 pitch scale. `team_id` must be the home or away team of the event; get both ids from the event endpoint. Returns 404 when SofaScore has no heatmap for that team in that match, which includes teams that did not play it, unstarted matches and sports other than football.
14 Oct 2026: 722 player_points; 0 fields had a value in every checked item and 2 varied between items.
curl 'https://api.crawlora.net/api/v1/sofascore/event-team-heatmap?id=16363867&team_id=17' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| id | string | Yes | 16363867 | Numeric SofaScore event (match) id |
| team_id | string | Yes | 17 | Numeric SofaScore team id of the home or away side |
{
"code": 200,
"msg": "OK",
"data": {
"event_id": 16363867,
"team_id": 17,
"source_url": "https://api.sofascore.com/api/v1/event/16363867/heatmap/17",
"fetched_at": "2026-07-08T00:00:00Z",
"player_points": [
{
"x": 47.6,
"y": 55.9
},
{
"x": 56.8,
"y": 77.2
},
{
"x": 52.7,
"y": 33.6
}
],
"goalkeeper_points": [
{
"x": 9,
"y": 29.7
},
{
"x": 4.4,
"y": 55.9
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.