Users

Learn how to search for users on VtubersTV.

We provide a search API that allows you to search for users on VtubersTV. You can search for users by their username.

GET /users/<username>

With this endpoint, you can search for users by their username with exact match. An exact match means that the username you provide must match the username of the user you are searching for exactly. So if someone has the username johnDoe, you must provide johnDoe as the username and not johndoe or JohnDoe.

Here is an example of a search for a user using our mascot's username nora:

GET /users/nora
user.json
{
  "id": "3537110236",
  "username": "nora",
  "avatar": "https://user-content.vtubers.tv/avatars/14xy9wo674707ui79se3c78v9hg654g7907nk5ii2ud79loqeuwr94597frwln7foipx91.gif",
  "banner": "https://user-content.vtubers.tv/banners/t50w02m86r9o4y4nck571gk0o0i905073vtkq028k50g778p21372h21uw7wp3rfy083p1.jpg",
  "followers": [(...)],
  "following": [],
  "total_views": "0",
  "display_name": "Nora 🤖",
  "pronouns": "She, Her, Hers",
  "bio": "The official mascot for VtubersTV!\n\nSource Code: https://github.com/VtubersTV/Nora",
  "is_banned": false,
  "warnings": [],
  "role": "admin",
  "videos": [(...)],
  "socials": [(...)],
  "latest_videos": [(...)],
  "popular_videos": [ (...)],
  "created_at": "2024-07-15T21:43:18.330Z",
  "_id": "669597f6c4972c56166ace23",
  "__v": {
    "raw": 1,
    "result": "1"
  },
  "premium": {
    "isPremium": true,
    "premiumSince": "2024-07-15T21:56:13.847Z",
    "premiumUntil": "2099-08-14T21:56:13.847Z",
  }
}