Player heatmap

GET

https://api.datasportsapi.com/v2/fixtures/{id}/heatmap/{playerId}

Plan: Pro + Business
Auth: Bearer dsa_live_…
Parameters: 2 required · 0 optional
Returns: Heatmap

Try in Playground

A single player’s activity map for the fixture — each recorded position sample, expressed as percentages of the pitch.

Plan access

Requires a Pro or Business plan; every other plan receives 403 endpoint_not_in_plan.

Worth knowing

Football only, in covered leagues. x measures distance along the pitch in the direction the player attacks (100 = the goal being attacked) and y measures across it. points is empty when no heatmap exists, and other sports likewise get 200 with empty points; an unknown fixture or player id gets 404.

01Parameters

Name	In	Required	Description
`id`	path	Required	fixture id issued by DataSportsAPI, a positive integer
`playerId`	path	Required	player id issued by DataSportsAPI, for example taken from /lineups

idpathRequired
fixture id issued by DataSportsAPI, a positive integer
playerIdpathRequired
player id issued by DataSportsAPI, for example taken from /lineups

02Request

The same call from the command line and each SDK. The SDK lines assume a client created with your key; left out, it is read from DATASPORTSAPI_API_KEY. Installing a client: SDKs & CLI.

curl -H "Authorization: Bearer dsa_live_…" \
    "https://api.datasportsapi.com/v2/fixtures/{id}/heatmap/{playerId}"

03Response

The top-level keys of the JSON body. Each object links to its full shape in the data reference.

data: Heatmap
meta: playerId, count

ObjectsHeatmap

Example response

2 lines

{ "data": { "points": [ { "x": 61.2, "y": 23.4 }, { "x": 58, "y": 31.5 }, … ] },
  "meta": { "playerId": 3759, "count": 214 } }

04Errors

Nothing specific to this endpoint: only the account-wide errors below apply.

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code