Endpoint Playground
Returns one player's touch locations in a football match as `points`, each an `x` and `y` on SofaScore's 0-100 pitch scale. Get `player_id` from event-lineups. Returns 404 when SofaScore has no heatmap for that player in that match, which includes players who did not play, unstarted matches and sports other than football.
14 Oct 2026: 35 points; 2 fields had a value in every checked item.
curl 'https://api.crawlora.net/api/v1/sofascore/event-player-heatmap?id=16363867&player_id=839956' \
-H "x-api-key: $CRAWLORA_API_KEY"| Parameter | Type | Required | Prefilled value | Description |
|---|---|---|---|---|
| id | string | Yes | 16363867 | Numeric SofaScore event (match) id |
| player_id | string | Yes | 839956 | Numeric SofaScore player id that played in the match |
{
"code": 200,
"msg": "OK",
"data": {
"event_id": 16363867,
"player_id": 839956,
"source_url": "https://api.sofascore.com/api/v1/event/16363867/player/839956/heatmap",
"fetched_at": "2026-07-08T00:00:00Z",
"count": 8,
"points": [
{
"x": 47,
"y": 55
},
{
"x": 56,
"y": 77
},
{
"x": 52,
"y": 33
},
{
"x": 48,
"y": 47
}
]
}
}The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.