Video API · Video

Get match video

GET/api/v1/videos/{match_id}

Returns video sources, calculated offsets and match metadata.

Bearer authentication required · service: video_api

Reference 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.
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.