Advanced Video API · Video
Get advanced match video
GET/api/v1/advanced-videos/{match_id}
Returns match video data together with lineups, positions and event classifications.
Bearer authentication required · service: advanced_apiReference only — this page never sends API requests or exposes token controls.
Response formats
When format is listed below, use json for the response documented here, or csv and xml for downloads. JSON uses camelCase by default; set case=snake_case when supported for legacy key names. Nested response fields use dot notation; [] denotes an array item and {key} a dynamic object key.
Path parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| match_id | integer | Required | Match ID Minimum 1. |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| format | string | Required | Response format. Allowed: json, csv, xml. |
| startSec | integer | Optional | Optional clip start in seconds. Minimum 0. |
| endSec | integer | Optional | Optional clip end in seconds. Minimum 0 and greater than or equal to startSec. |
| mirrored | boolean | Optional | Mirror pitch coordinates. Default: false. |
| case | string | Optional | JSON response key style. Default: camelCase. Allowed: camelCase, snake_case. |
Response attributes
| Attribute | Type | Description |
|---|---|---|
| videos | array | Available video sources. |
| videos[].id | integer | Video ID. |
| videos[].match | integer | Match ID. |
| videos[].link | string|null | Video URL. |
| videos[].createdAt | string|null | Video creation timestamp. |
| videos[].updatedAt | string|null | Video update timestamp. |
| videos[].startSec | integer|null | Clip start offset, when requested. |
| videos[].endSec | integer|null | Clip end offset, when requested. |
| offsets | object | Calculated video offsets by period. |
| offsets.{period} | number|null | Offset in seconds for a named match period. |
| matchId | integer | Match ID. |
| matchDate | string|null | ISO 8601 match date and time. |
| matchName | string | Home team and away team display name. |
| homeTeamId | integer | Home team ID. |
| homeTeamName | string | Home team name. |
| awayTeamId | integer | Away team ID. |
| awayTeamName | string | Away team name. |
| homeTeamScore | integer|null | Home team score. |
| awayTeamScore | integer|null | Away team score. |
| matchPositions | object|null | Goal-side positions by period. |
| lineup | object | Starting players grouped by team. |
| lineup.homePlayers | array | Home-team starting players. |
| lineup.awayPlayers | array | Away-team starting players. |
| substitutions | object | Substitute players grouped by team. |
| substitutions.homePlayers | array | Home-team substitutes. |
| substitutions.awayPlayers | array | Away-team substitutes. |
| goals | array | Goal event markers. |
| goals[].id | integer | Marker ID. |
| goals[].actionId | integer|null | Action ID. |
| goals[].second | number|null | Elapsed match time in seconds. |
| goals[].creatorId | integer|null | Creator player ID. |
| goals[].creatorTeamId | integer|null | Creator team ID. |
| goals[].videoId | integer|null | Related video ID. |
| shots | array | Shot event markers. |
| shots[].id | integer | Marker ID. |
| shots[].actionId | integer|null | Action ID. |
| shots[].second | number|null | Elapsed match time in seconds. |
| shots[].creatorId | integer|null | Creator player ID. |
| shots[].creatorTeamId | integer|null | Creator team ID. |
| shots[].videoId | integer|null | Related video ID. |
| substitutionEvents | array | Substitution event markers. |
| substitutionEvents[].id | integer | Marker ID. |
| substitutionEvents[].actionId | integer|null | Action ID. |
| substitutionEvents[].second | number|null | Elapsed match time in seconds. |
| substitutionEvents[].creatorId | integer|null | Creator player ID. |
| substitutionEvents[].creatorTeamId | integer|null | Creator team ID. |
| substitutionEvents[].videoId | integer|null | Related video ID. |
| redCardEvents | array | Red-card event markers. |
| redCardEvents[].id | integer | Marker ID. |
| redCardEvents[].actionId | integer|null | Action ID. |
| redCardEvents[].second | number|null | Elapsed match time in seconds. |
| redCardEvents[].creatorId | integer|null | Creator player ID. |
| redCardEvents[].creatorTeamId | integer|null | Creator team ID. |
| redCardEvents[].videoId | integer|null | Related video ID. |
| yellowCardEvents | array | Yellow-card event markers. |
| yellowCardEvents[].id | integer | Marker ID. |
| yellowCardEvents[].actionId | integer|null | Action ID. |
| yellowCardEvents[].second | number|null | Elapsed match time in seconds. |
| yellowCardEvents[].creatorId | integer|null | Creator player ID. |
| yellowCardEvents[].creatorTeamId | integer|null | Creator team ID. |
| yellowCardEvents[].videoId | integer|null | Related video ID. |