Videos

Learn how to get a video on VtubersTV.

We provide an API that allows you to get a video on VtubersTV. You can get a video by its ID. Here is the endpoint for getting a video by its ID:

GET /videos/<videoId>

We are going to use the following video ID for this example: 6l43HBXI582GUqsINLPY which is a real video ID on VtubersTV. The video is a video of the developer of VtubersTV, so you can use it for testing purposes.

GET /videos/6l43HBXI582GUqsINLPY

You should get a response like this:

video.json 
{
  "data": {
    "id": "6l43HBXI582GUqsINLPY",
    "title": "Test Video with new Dashboard",
    "description": "This is a test video",
    "author": {
      "id": "3537110236",
      "username": "nora",
      "display_name": "Nora 🤖",
      "avatar": "https://user-content.vtubers.tv/avatars/14xy9wo674707ui79se3c78v9hg654g7907nk5ii2ud79loqeuwr94597frwln7foipx91.gif",
      "followers": "1"
    },
    "thumbnail": "https://user-content.vtubers.tv/videos/thumbnail/6l43HBXI582GUqsINLPY",
    "views": "1",
    "likes": "1",
    "dislikes": "0",
    "meta": {
      "width": "1920",
      "height": "948",
      "duration": "00:01:03",
      "file_size": "2478037",
      "tags": [
        "genshin"
      ],
      "is_made_for_adults": false,
      "isDeleted": false
    },
    "createdAt": "2024-07-28T03:38:16.505Z",
    "comments": [
      {
        "parent": "NULL",
        "id": "66946a65931c9030375a39ed",
        "content": "This is a test comment",
        "author": {
          "id": "9362380075",
          "username": "YaMi",
          "display_name": "Steller",
          "avatar": "https://user-content.vtubers.tv/avatars/197l3m1911e9f0kun8yk72ycut7ukt0lk1zujqj0l31wc0aljx2wkflhh30u98k44x01j9.jpg"
        },
        "createdAt": "2024-07-15T00:16:37.889Z",
        "upvotes": "0",
        "downvotes": "0",
        "isFlagged": false,
        "isDeleted": false
      },
    ]
  }
}

You can use this response to display the video on your website or app. You can also use the video ID to get the video URL and embed it in your website or app.

Users
Learn how to search for users on VtubersTV.
Users
Learn the structure of a user object on VtubersTV.