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 cannot exceed 50. (see Pagination)

    Example: videos=0-49

Path parameters

  • tournament_id
    string

    The id of the tournament for which videos must be retrieved

Query Parameters

  • participant_ids
    array

    One or several participant ids to filter

    Example: 618965765764577354,618931468547654563

  • category
    string

    Category of the videos.

    Possible values: replay, highlight, bonus

  • sort
    string

    Sorts the collection in a particular order. "created_asc" sorts the videos from older to newer; "created_desc" sorts the videos from newer to older.

    Possible values: created_asc, created_desc

    Default: created_asc

Request Body

This endpoint doesn't 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",
        "match_id": "378426939508809728"
    }
]
Structure (collection)
  • id
    string

    A unique identifier for this video.

    Example: "863174896574643814"

  • name
    string

    Title of the video.

    Example: "Game 1: TSM vs. EnVyUs"

  • url
    string

    Url of the video.

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

  • language
    string

    Language code of the video content. This value is represented as an ISO 639-1 code.

    Example: "en"

  • category
    string

    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 for which videos must be retrieved

  • match_id
    string

    The id of the match to retrieve

Query Parameters

  • category
    string

    Category of the videos.

    Possible values: replay, highlight, bonus

  • sort
    string

    Sorts the collection in a particular order. "created_asc" sorts the videos from older to newer; "created_desc" sorts the videos from newer to older.

    Possible values: created_asc, created_desc

    Default: created_asc

Request Body

This endpoint doesn't 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

    A unique identifier for this video.

    Example: "863174896574643814"

  • name
    string

    Title of the video.

    Example: "Game 1: TSM vs. EnVyUs"

  • url
    string

    Url of the video.

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

  • language
    string

    Language code of the video content. This value is represented as an ISO 639-1 code.

    Example: "en"

  • category
    string

    Category of the video.

    Possible values: replay, highlight, bonus