Viewer API › Videos Legacy

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
[
    {
        "id": "863174896574643814",
        "name": "Game 1: TSM vs. EnVyUs",
        "url": "https:\/\/www.youtube.com\/watch?v=SI5QgDJkaSU",
        "language": "en",
        "category": "replay",
        "match_id": "378426939508809728"
    }
]
Structure (collection)
  • 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

  • match_id
    string|null

    The match's identifier of this video.

    Example: "378426939508809728"

LegacyGET /tournaments/{tournament_id}/matches/{match_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 match.

Resource URL

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

HTTP headers

Path parameters

  • tournament_id
    string

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

  • match_id
    string

    The id of the match to retrieve.

Query Parameters

  • 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

[200] Videos retrieved.

Example
[
    {
        "id": "863174896574643814",
        "name": "Game 1: TSM vs. EnVyUs",
        "url": "https:\/\/www.youtube.com\/watch?v=SI5QgDJkaSU",
        "language": "en",
        "category": "replay"
    }
]
Structure (collection)
  • 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