Average positions

GET

https://api.datasportsapi.com/v2/fixtures/{id}/average-positions

Plan: Pro + Business
Auth: Bearer dsa_live_…
Parameters: 1 required · 0 optional
Returns: AveragePositions

Try in Playground

Average position of every player during the fixture, grouped by side.

Plan access

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

Worth knowing

Football only, in covered leagues; otherwise the lists are empty. Coordinates use the heatmap frame, oriented in the team’s attacking direction.

01Parameters

Name	In	Required	Description
`id`	path	Required	fixture id issued by DataSportsAPI, a positive integer

idpathRequired
fixture id issued by DataSportsAPI, a positive integer

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}/average-positions"

03Response

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

data: AveragePositions

ObjectsAveragePositions

Example response

3 lines

{ "data": { "home": [ { "player": { "id": 3772, "name": "David Raya", … }, "jerseyNumber": "1", "positionCode": "G",
                         "position": "goalkeeper", "x": 8.2, "y": 49.9, "pointsCount": 40 }, … ],
    "away": [ … ] } }

04Errors

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

Any key can also meet401unauthorized429rate_limited429quota_exceeded500internal_errorEvery error code