Skip to main content
GET
Get Game Tracking
The Game Data API is in preview. Endpoints, fields and limits may change before release, and it is not yet available to call.
The response is a redirect to a temporary download link for the period’s file. The link expires 30 minutes after the request; call the endpoint again for a new one.

File contents

One row per player, or the ball, per frame.
integer
Video frame number.
number
Seconds from the start of the period.
string
player_id, or ball.
string
The player’s team; empty for the ball.
number
Pitch metres along the length, from the centre spot. Tracking uses the fixed pitch: coordinates are not turned to each team’s attacking direction.
number
Pitch metres across the width, from the centre spot.
number
Ball height in metres; empty for players.
number
Speed in metres per second.
boolean
false when the position is estimated while the player was off screen.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

game_id
string<uuid>
required

Game identifier. The game must belong to your organization.

Query Parameters

period
integer
required

The period to return.

Required range: 1 <= x <= 5

Response

Redirect to a temporary download link for the period's Parquet file. The link expires 30 minutes after the request; call the endpoint again for a new one. One row per player or ball per frame with columns frame, time_s, object_id, team_id, x, y, z, speed_mps and in_frame.