API v1 Overview
API version 1 provides comprehensive access to football match analysis data.
Base URL
https://aiontheball.nl/api/v1/
Available Endpoints
Video Management
| Endpoint | Method | Description |
|---|---|---|
/videos |
GET | List all videos |
/videos |
POST | Upload a new video |
/videos/{id} |
GET | Get video details and status |
/videos/{id} |
PUT | Update video metadata |
/videos/{id}/analysis |
POST | Create analysis for a video |
Analysis Data
| Endpoint | Method | Description |
|---|---|---|
/analyses/{id} |
GET | Get analysis details and status |
/analyses/{id}/events |
GET | Get all detected events |
/analyses/{id}/summary |
GET | Get comprehensive game summary with player identities |
/analyses/{id}/query-intervals |
POST | Query time intervals with filters |
/analyses/{id}/tracking/download |
GET | Download raw tracking data |
Response Format
All endpoints return JSON. Successful responses have HTTP status 200.
{
"data": { ... }
}
Error responses include a message:
{
"message": "Analysis not found"
}
Rate Limits
- 100 requests per minute per API token
- Tracking downloads: 10 per hour
Capabilities
Event Detection
- Team possession changes
- Player possession
- Match timeline (halves)
- Scene classification (play vs replay)
Player Tracking
- Position data at 25 FPS
- Player identification by jersey number
- Distance and speed calculations
Filtering
- Combine multiple conditions with AND/OR
- Filter by location, possession, time, and more
- Generate highlight clips