Player tracking
/
View as MarkdownTry in Playground →
Player tracking for NBA games, since 2026-11-13 (Enterprise only): all ten players on court plus the ball, at five frames per second, ordered by frame — who holds the ball, the game clock and the shot clock, and for every player the name, shirt number, side and position. With no cursor you get the newest frames (the last 30 seconds unless you set limit); with a cursor, the page that follows it.
Parameters
idpathrequired
fixture id issued by DataSportsAPI, a positive integer
afterquery
frames that come after this frame counter (PlayerFrame.frame; that counter excluded) — meta.next from the previous page
sincequery
frames received after this instant (ISO-8601 with any offset; that instant excluded); ignored when after is sent
limitquery
frames per page, 1–3000 (150 if omitted, which is 30 seconds)
fpsquery
5 for every frame (the default) or 1 for one frame per second
Response
- data
PlayerFrame[]- meta
- count, hasNextPage, next (the after value for the following page, or null)
- errors
- 400
bad_request— after, since, limit or fps 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/players"{ "data": [
{ "frame": 731569, "at": "2026-11-13T03:00:06.453Z", "period": 4, "clock": 541, "shotClock": 20, "running": true,
"possession": { "side": "home", "player": { "name": "John Doe", "shirtNumber": 9, "side": "home" } },
"ball": { "x": 44.45, "y": 86.75, "height": 0.9 },
"players": [ { "side": "home", "name": "John Doe", "shirtNumber": 9, "x": 43.86, "y": 90.03 }, … ] }, … ],
"meta": { "count": 150, "hasNextPage": false, "next": null } }