Season heatmap
GET
/
View as MarkdownTry in Playground →
Football: a player’s match heatmaps summed over one league season to show where they were active — each point with the number of samples recorded on it — plus the matches included.
x / y range from 0 to 100 as in the match heatmap, with x running along the pitch in the direction the player’s team attacks. Use count to weight the density. Limited to football in covered leagues.
Parameters
idpathrequired
DataSportsAPI player id, a positive integer
leaguequeryrequired
league id, as listed by /v2/players/{id}/seasons
seasonqueryrequired
season id, as listed by /v2/leagues/{id}/seasons
Response
- data
SeasonHeatmap- meta
- league, season, count (number of points)
- errors
- 403
history_not_in_plan— the season finished before your plan’s history window begins404no_data— for this player, league and season the source has no season heatmap; 404 not_found — the season id belongs to a different league
Any /v2 call can also come back with one of the common errors.
curl -H "Authorization: Bearer sk_live_…" \
"https://api.datasportsapi.com/v2/players/{id}/heatmap?league=…&season=…"Example
{ "data": { "points": [ { "x": 69, "y": 9, "count": 1 }, { "x": 69, "y": 11, "count": 2 }, … ], "fixtureCount": 7, "fixtureIds": [701120, 701061, …] },
"meta": { "league": 195828, "season": 200386, "count": 397 } }