Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab
Docs v2

Players

Season heatmap

GET

/v2/players/{id}/heatmap

Pro and up

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

id

pathrequired

DataSportsAPI player id, a positive integer

league

queryrequired

league id, as listed by /v2/players/{id}/seasons

season

queryrequired

season id, as listed by /v2/leagues/{id}/seasons

Response

meta
league, season, count (number of points)
errors
403 history_not_in_plan — the season finished before your plan’s history window begins404 no_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 } }