Videos

GET /tournaments/{tournament_id}/videos

Simple Access

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.

    Example: "https://www.youtube.com/watch?v=SI5QgDJkaSU"

  • language
    string

    Language code of the video content in ISO 639-1 code

    Max. length: 2,000 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"

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

Simple Access

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.

    Example: "https://www.youtube.com/watch?v=SI5QgDJkaSU"

  • language
    string

    Language code of the video content in ISO 639-1 code

    Max. length: 2,000 characters

    Example: "en"

  • category
    string

    The category of the video.

    Possible values: replay, highlight, bonus