Videos

GET /tournaments/{tournament_id}/videos

Returns a collection of videos from one tournament. The collection may be filtered and sorted by optional query parameters. The tournament must be public to have access to its videos, meaning the tournament organizer has published it. The videos are returned by 20.

Resource URL

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

Path parameters

  • tournament_id
    string

    The id of the desired tournament.

Query Parameters

  • category
    string

    Category of the videos.

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

    Allowed values: created_asc, created_desc

    Default: created_asc

  • page
    integer

    Page requested of the list.

Request Body

This endpoint doesn't require a request body.

Response

[200] Success

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

    Optional

    The match's unique identifier of this video.

    Example: "5617bb3af3df95f2318b4567"