Viewer API › Videos Legacy

Endpoints

LegacyGET /tournaments/{tournament_id}/videos
Retrieve videos of a tournament.
LegacyGET /tournaments/{tournament_id}/matches/{match_id}/videos
Retrieve videos of a match.

LegacyGET /tournaments/{tournament_id}/videos

This endpoint is in legacy mode. Access will soon be deprecated. It is therefore advised to use another endpoint when possible.

Returns the videos of the given tournament.

Resource URL

https://api.toornament.com/viewer/v2/tournaments/{tournament_id}/videos

HTTP headers

X-Api-Key
string
API key of your application (see Authentication)
Range
string
A range of requested items using the videos unit. The size of the range can not exceed 50. (see Pagination)
Example: videos=0-49

Path parameters

tournament_id
string
The id of the tournament you want to retrieve data about.

Query Parameters

participant_ids
array
One or several participant ids to filter.
Example: 618965765764577354,618931468547654563
category
string
The category of the videos.
Possible values: replay, highlight, bonus
sort
string
Sorts the collection in a particular order. "created_asc" sorts the videos from the oldest to the most recent one; "created_desc" sorts the videos from the most recent to the oldest one.
Possible values: created_asc, created_desc
Default: created_asc

Request Body

This endpoint does not require a request body.

Response

[206] Videos retrieved.

Example

[
    {
        "match_id": "378426939508809728",
        "id": "863174896574643814",
        "name": "Game 1: TSM vs. EnVyUs",
        "url": "https:\/\/www.youtube.com\/watch?v=SI5QgDJkaSU",
        "language": "en",
        "category": "replay"
    }
]

Structure (collection)

match_id
string|null
The match's identifier of this video.
Example: "378426939508809728"
id
string
An identifier for a video.
Example: "863174896574643814"
name
string
The title of the video.
Max. length: 40 characters
Example: "Game 1: TSM vs. EnVyUs"
url
string
The URL of the video.
Max. length: 2,000 characters
Example: "https://www.youtube.com/watch?v=SI5QgDJkaSU"
language
string
Language code of the video content in ISO 639-1 code
Max. length: 2 characters
Example: "en"
category
string
The category of the video.
Possible values: replay, highlight, bonus

LegacyGET /tournaments/{tournament_id}/matches/{match_id}/videos