Players

Season heatmap

GET/v2/players/{id}/heatmapPro + Business

Where a player was active over one league season (football): his match heatmaps added up — every point with how many samples fell on it — and the matches it covers.

x / y are 0–100 like the match heatmap (x along the pitch in his team’s attacking direction). Weight the density by count. Football in covered leagues only.

Parameters

pathrequired

our numeric id (positive integer)

league

queryrequired

a league id from /v2/players/{id}/seasons

season

queryrequired

a season id from /v2/leagues/{id}/seasons

Response

data: SeasonHeatmap
meta: league, season, count (points)
errors: 403 history_not_in_plan — the season ended before your plan’s history404 no_data — the source has no season heatmap for this player, league and season; 404 not_found — season is not one of this league’s seasons

Every /v2 call can also answer the common errors.

Try it →

$ curl -H "Authorization: Bearer sk_live_…" \
    "https://api.sportsapi.app/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 } }