AI on the Ball API
Turn a recording of a football match into structured match data. Upload one video and the API detects players, ball and teams, and returns every pass, carry, shot and goal as timed events. It also returns player and ball tracking for the whole match, a match summary, and a report per player and per team. On top of that, query the match for moments, such as every progressive carry by one team in the final third, and get back the time intervals to cut clips from.
Get started
- Request an API token from support@smart11.ai.
-
Send it as a bearer token on every request to the base URL:
https://aiontheball.nl/api/v1/ Authorization: Bearer YOUR_API_TOKEN -
Follow the Analysis Workflow from upload to results. An analysis takes 2 to 6 hours, depending on video length and queue size.
The API Overview lists every endpoint, the response format and the rate limits.
What an analysis returns
| Result | Endpoint |
|---|---|
| Every detected event, from passes and shots to possession phases and pitch zones | Events, event types |
| Match summary with possession, player identities and player statistics | Summary |
| Per-player report: coverage, physical output, position, on-ball actions, interactions | Player Report |
| Per-team report: average positions, possession, territory, kits | Team Report |
| Time intervals matching a combination of filters, for clips and highlights | Query Intervals, filters |
| Player, referee and ball positions per frame, as Parquet or JSON | Download Tracking |
| Appearance crops per player and per team | Exemplar Crops |
| A notification when the analysis is done | Webhooks |
What's new
See the Changelog for every release, newest first.
Support
Questions, tokens and access: support@smart11.ai.