SofaScore
SofaScore player season heatmap
Returns a football player's aggregated touch locations over one competition season: points with an x, y and touch count on SofaScore's 0-100 pitch scale, the number of matches behind it and the matched events. Get tournament_id and season from player-statistics-seasons. The response is large for a full league season. Returns 404 when SofaScore has no heatmap for that player, competition and season, which includes sports other than football and seasons the player did not play.
get/sofascore/player-season-heatmap
Request
- Base URL: https://api.crawlora.net/api/v1
- URL: https://api.crawlora.net/api/v1/sofascore/player-season-heatmap
- Auth: API key in header x-api-key
Query parameters
idstring required
Numeric SofaScore player id
tournament_idstring required
Numeric SofaScore unique-tournament (competition) id
seasonstring required
Numeric SofaScore season id
Headers
x-api-keystring required
API key required
Response
OK
Example response
{
"code": 200,
"data": {
"events": [
{
"away_team": {
"country": "Spain",
"id": 2817,
"name": "FC Barcelona",
"short_name": "Barcelona",
"slug": "barcelona"
},
"home_team": {
"country": "Spain",
"id": 2817,
"name": "FC Barcelona",
"short_name": "Barcelona",
"slug": "barcelona"
},
"id": 14025013,
"start_time": "2025-08-15T19:00:00Z",
"status": {
"description": "Ended",
"type": "finished"
},
"tournament": {
"category": "England",
"name": "Premier League",
"slug": "premier-league",
"unique_tournament_id": 17,
"unique_tournament_name": "Premier League"
}
}
],
"matches": 35,
"player_id": 839956,
"points": [
{
"count": 1,
"x": 71,
"y": 42
}
],
"season": 76986,
"tournament_id": 17
},
"msg": "OK"
}Changes
No recorded changes to this operation across all 2 revisions of this API.