Ball track
/
View as MarkdownTry in Playground →
Ball positions recorded live for a football or tennis match, oldest first, on Enterprise only: about 14 positions per minute of football play on the 0–100 pitch, about one per tennis shot, measured in millimetres from the net. Each call returns up to limit frames recorded after since; to read on, send meta.next as the next since.
Parameters
idpathrequired
fixture id issued by DataSportsAPI, a positive integer
sincequery
return only frames recorded after this instant (ISO-8601 with any offset; the instant itself is excluded) — meta.next from the previous page, or the at of your newest frame
limitquery
frames per page, 1–5000 (5000 if omitted, enough for a whole football match)
Response
- data
BallFrame[]- meta
- count, hasNextPage, next (the since value for the following page, or null)
- errors
- 400
bad_request— since or limit is malformed403endpoint_not_in_plan— returned on every plan except Enterprise404not_found— DataSportsAPI never issued this id
Any /v2 call can also come back with one of the common errors.
curl -H "Authorization: Bearer sk_live_…" \
"https://api.datasportsapi.com/v2/fixtures/{id}/tracking/ball"{ "data": [ { "at": "2026-11-11T20:05:31.412Z", "x": 61.5, "y": 38.2 }, { "at": "2026-11-11T20:05:35.906Z", "x": 70.1, "y": 44 }, … ],
"meta": { "count": 1384, "hasNextPage": false, "next": null } }