/vt/list (1.6.0)

Download OpenAPI specification:Download

E-mail: [email protected] URL: https://vt.rita.moe License: Apache 2.0

A live tracker of VTubers, based on generals from /vt/.

Main list

Get list of current and recently offline streamers.

Responses

Response Schema: application/json

last_update

number

Timestamp in miliseconds when the data was exported

last_update_twitch

number

Timestamp in miliseconds when the Twitch refresh was completed

last_update_youtube

number

Timestamp in miliseconds when the YouTube refresh was completed

last_update_others

number

Timestamp in miliseconds when the other platform's refresh was completed

object (GetListTags)

Tags used in the list, the keys here are the name of the group

	Array of objects (TagObject)
	Array of objects (TagObject)
	Array of objects (TagObject)
	Array of objects (TagObject)
	Array of objects (TagObject)
	Array of objects (TagObject)
	Array of objects (TagObject)

Array of objects (GetListStreamers)

List of streamers

Array

id	number Unique ID for this streamer
name	string Given name, might include alternative names or romanized names
last_live	string Timestamp in miliseconds when the last stream started (or was found live), as a string
is_live	number Boolean `0`/`1` if the streamer is live
twitch	null or string Can be `null` if no active Twitch channel
youtube	null or string Can be `null` if no active YouTube channel with a "live" tab, uses the new username system
soopkr	null or string Can be `null` if no active SOOP channel
avatar	string An avatar from either 7TV, SOOP, Twitch or YouTube - in that order
avatar_proxied	null or string Might be `null`, not used for 7TV and SOOP. Key and size for the proxied version in 64x64, `https://t.rita.moe/${avatar_proxied}/${avatar.replace('?', '%3F')}`
avatar_proxied2x	null or string Might be `null`, not used for 7TV and SOOP. Key and size for the proxied version in 128x128, `https://t.rita.moe/${avatar_proxied2x}/${avatar.replace('?', '%3F')}`
	Array of objects (TagObject) The list of tags given to this streamer
	Array of objects (LinkObject) List of links to their website or social media
	object Data related to a stream

object (GetListStats)

Some statistics

	object
	object
	object

Response samples

Content type

application/json

{"last_update": 1726660547585,
"last_update_twitch": 1726660159117,
"last_update_youtube": 1726660547565,
"last_update_others": 1726660558445,
"tags": {"country": [{"id": 1,
"group": "country",
"title": "Australia",
"color": "#AEE2FF"
},
{"id": 19,
"group": "country",
"title": "France",
"color": "#AEE2FF"
},
{"id": 21,
"group": "country",
"title": "Russia",
"color": "#AEE2FF"
},
{"id": 16,
"group": "country",
"title": "United Kingdom",
"color": "#AEE2FF"
}
],
"genre": [{"id": 71,
"group": "genre",
"title": "+18",
"color": "#E1AFD1"
},
{"id": 56,
"group": "genre",
"title": "art",
"color": "#E1AFD1"
},
{"id": 136,
"group": "genre",
"title": "ASMR",
"color": "#E1AFD1"
},
{"id": 49,
"group": "genre",
"title": "horror",
"color": "#E1AFD1"
},
{"id": 57,
"group": "genre",
"title": "music",
"color": "#E1AFD1"
}
],
"group": [{"id": 30,
"group": "group",
"title": "V-Dere",
"color": "#D37676"
},
{"id": 44,
"group": "group",
"title": "VShojo",
"color": "#D37676"
}
],
"lang": [{"id": 50,
"group": "lang",
"title": "English",
"color": "#B9F3FC"
},
{"id": 58,
"group": "lang",
"title": "French",
"color": "#B9F3FC"
},
{"id": 69,
"group": "lang",
"title": "German",
"color": "#B9F3FC"
},
{"id": 60,
"group": "lang",
"title": "Japanese",
"color": "#B9F3FC"
},
{"id": 82,
"group": "lang",
"title": "Russian",
"color": "#B9F3FC"
}
],
"model": [{"id": 51,
"group": "model",
"title": "2D",
"color": "#7BD3EA"
},
{"id": 52,
"group": "model",
"title": "3D",
"color": "#7BD3EA"
},
{"id": 73,
"group": "model",
"title": "IRL",
"color": "#7BD3EA"
},
{"id": 53,
"group": "model",
"title": "PNG",
"color": "#7BD3EA"
}
],
"other": [{"id": 77,
"group": "other",
"title": "TTS",
"color": "#F5F5F5"
},
{"id": 27,
"group": "other",
"title": "duo",
"color": "#F5F5F5"
}
],
"thread": [{"id": 40,
"group": "thread",
"title": "/asp/",
"color": "#B0C5A4"
},
{"id": 1,
"group": "thread",
"title": "/euro/",
"color": "#B0C5A4"
},
{"id": 38,
"group": "thread",
"title": "/lig/",
"color": "#B0C5A4"
},
{"id": 78,
"group": "thread",
"title": "/pcg/",
"color": "#B0C5A4"
},
{"id": 37,
"group": "thread",
"title": "/pink/",
"color": "#B0C5A4"
},
{"id": 47,
"group": "thread",
"title": "/vsj+/",
"color": "#B0C5A4"
},
{"id": 80,
"group": "thread",
"title": "/wvt/",
"color": "#B0C5A4"
}
]
},
"list": [{"id": 1063,
"name": "고세구 (Gosegu)",
"last_live": "1734601719000",
"is_live": 1,
"twitch": "gosegugosegu",
"youtube": "gosegu",
"soopkr": "gosegu2",
"avatar": "https://static-cdn.jtvnw.net/jtv_user_pictures/1e4cac72-a1cd-4f72-8ada-b2d10ac990d7-profile_image-300x300.png",
"avatar_proxied": "IPbaZgH4J03BHwEoEtVDeLa0Ys8=/64x64",
"avatar_proxied2x": "qy55ntEtbLADY89UAKNr_FkLaqo=/128x128",
"tags": [{"id": 1,
"group": "country",
"title": "South Korea",
"color": "#AEE2FF"
}
],
"links": [{"title": "Twitter",
"url": "https://twitter.com/gosegu486385"
}
],
"live": {"platform": "twitch",
"title": "트위치 바이빵가루",
"category": "Just Chatting",
"thumbnail": "https://static-cdn.jtvnw.net/previews-ttv/live_user_gosegugosegu-320x180.jpg",
"thumbnail_proxied": "eQIxaX5pA-idWGx_HBdZoGKVWGA=/160x90",
"thumbnail_proxied2x": "Qu5oDGhXKwUmFYrrAdFFK9jIZgM=/320x180",
"url": "https://twitch.tv/gosegugosegu",
"on_twitch": 1,
"on_youtube": 1,
"on_soopkr": 1,
"viewers_twitch": 24,
"viewers_youtube": 178,
"viewers_soopkr": 5,
"viewers": 207
}
}
],
"stats": {"status": {"total": "937",
"live": "85",
"offline30d": "764",
"gonefishing": "40",
"unknown": "36",
"disabled": "12"
},
"platforms": {"twitch": "64",
"youtube": "31",
"soopkr": "0"
},
"viewers": {"total": "69578",
"twitch": "36505",
"youtube": "33073",
"soopkr": "0"
}
}
}

Streamers list

All streamers, but no details about live streams.

Responses

Response Schema: application/json

Array

id	number Unique ID for this streamer
name	string Given name, might include alternative names or romanized names
last_live	string Timestamp in miliseconds when the last stream started (or was found live), as a string
is_live	number Boolean `0`/`1` if the streamer is live
twitch	null or string Can be `null` if no active Twitch channel
youtube	null or string Can be `null` if no active YouTube channel with a "live" tab, uses the new username system
soopkr	null or string Can be `null` if no active SOOP channel
avatar	string An avatar from either 7TV, SOOP, Twitch or YouTube - in that order
avatar_proxied	null or string Might be `null`, not used for 7TV and SOOP. Key and size for the proxied version in 64x64, `https://t.rita.moe/${avatar_proxied}/${avatar.replace('?', '%3F')}`
avatar_proxied2x	null or string Might be `null`, not used for 7TV and SOOP. Key and size for the proxied version in 128x128, `https://t.rita.moe/${avatar_proxied2x}/${avatar.replace('?', '%3F')}`
	Array of objects (TagObject) The list of tags given to this streamer
	Array of objects (LinkObject) List of links to their website or social media
twitch_id	null or string The streamer's Twitch ID, can be `null`
youtube_id	null or string The streamer's YouTube ID, can be `null`
last_refresh	string Timestamp in miliseconds when the streamer data was last refreshed, as a string
disabled	number Boolean `0`/`1` if the streamer is disabled (probably graduated)

Response samples

Content type

application/json

[{"id": 1063,
"name": "고세구 (Gosegu)",
"last_live": "1734601719000",
"is_live": 1,
"twitch": "gosegugosegu",
"youtube": "gosegu",
"soopkr": "gosegu2",
"avatar": "https://static-cdn.jtvnw.net/jtv_user_pictures/1e4cac72-a1cd-4f72-8ada-b2d10ac990d7-profile_image-300x300.png",
"avatar_proxied": "IPbaZgH4J03BHwEoEtVDeLa0Ys8=/64x64",
"avatar_proxied2x": "qy55ntEtbLADY89UAKNr_FkLaqo=/128x128",
"tags": [{"id": 1,
"group": "country",
"title": "South Korea",
"color": "#AEE2FF"
}
],
"links": [{"title": "Twitter",
"url": "https://twitter.com/gosegu486385"
}
],
"twitch_id": "707328484",
"youtube_id": "UCV9WL7sW6_KjanYkUUaIDfQ",
"last_refresh": "1725734707",
"disabled": 0
}
]

Hidden streamers list

This is a filtred version of /api/streamers with only the hidden streamers who don't appear in /api/list.

A streamer is hidden when it hasn't been live for more than 30 days, has not been seen live yet, or has been disabled.

Responses

Response Schema: application/json

Array

id	number Unique ID for this streamer
name	string Given name, might include alternative names or romanized names
last_live	string Timestamp in miliseconds when the last stream started (or was found live), as a string
is_live	number Boolean `0`/`1` if the streamer is live
twitch	null or string Can be `null` if no active Twitch channel
youtube	null or string Can be `null` if no active YouTube channel with a "live" tab, uses the new username system
soopkr	null or string Can be `null` if no active SOOP channel
avatar	string An avatar from either 7TV, SOOP, Twitch or YouTube - in that order
avatar_proxied	null or string Might be `null`, not used for 7TV and SOOP. Key and size for the proxied version in 64x64, `https://t.rita.moe/${avatar_proxied}/${avatar.replace('?', '%3F')}`
avatar_proxied2x	null or string Might be `null`, not used for 7TV and SOOP. Key and size for the proxied version in 128x128, `https://t.rita.moe/${avatar_proxied2x}/${avatar.replace('?', '%3F')}`
	Array of objects (TagObject) The list of tags given to this streamer
	Array of objects (LinkObject) List of links to their website or social media
twitch_id	null or string The streamer's Twitch ID, can be `null`
youtube_id	null or string The streamer's YouTube ID, can be `null`
last_refresh	string Timestamp in miliseconds when the streamer data was last refreshed, as a string
disabled	number Boolean `0`/`1` if the streamer is disabled (probably graduated)

Response samples

Content type

application/json

[{"id": 1063,
"name": "고세구 (Gosegu)",
"last_live": "1734601719000",
"is_live": 1,
"twitch": "gosegugosegu",
"youtube": "gosegu",
"soopkr": "gosegu2",
"avatar": "https://static-cdn.jtvnw.net/jtv_user_pictures/1e4cac72-a1cd-4f72-8ada-b2d10ac990d7-profile_image-300x300.png",
"avatar_proxied": "IPbaZgH4J03BHwEoEtVDeLa0Ys8=/64x64",
"avatar_proxied2x": "qy55ntEtbLADY89UAKNr_FkLaqo=/128x128",
"tags": [{"id": 1,
"group": "country",
"title": "South Korea",
"color": "#AEE2FF"
}
],
"links": [{"title": "Twitter",
"url": "https://twitter.com/gosegu486385"
}
],
"twitch_id": "707328484",
"youtube_id": "UCV9WL7sW6_KjanYkUUaIDfQ",
"last_refresh": "1725734707",
"disabled": 0
}
]

Tags list

All tags available, even those not used by any streamer.

Responses

Response Schema: application/json

object (TagGroupObject)

title	string
color	string
	Array of objects (TagSimpleObject)

object (TagGroupObject)

title	string
color	string
	Array of objects (TagSimpleObject)

object (TagGroupObject)

title	string
color	string
	Array of objects (TagSimpleObject)

object (TagGroupObject)

title	string
color	string
	Array of objects (TagSimpleObject)

object (TagGroupObject)

title	string
color	string
	Array of objects (TagSimpleObject)

object (TagGroupObject)

title	string
color	string
	Array of objects (TagSimpleObject)

object (TagGroupObject)

title	string
color	string
	Array of objects (TagSimpleObject)

object (TagGroupObject)

title	string
color	string
	Array of objects (TagSimpleObject)

Response samples

Content type

application/json

{"country": {"title": "country",
"color": "#AEE2FF",
"tags": [{"id": 1,
"title": "Australia"
},
{"id": 19,
"title": "France"
},
{"id": 21,
"title": "Russia"
},
{"id": 16,
"title": "United Kingdom"
}
]
}
}

Upcoming list

Upcoming YouTube live streams scheduled for the next 48 hours.

Responses

Response Schema: application/json

last_update

number

Timestamp in miliseconds when the data was exported

Array of objects

List of upcoming streams

Array

stream_id	number Unique ID for this stream
upcoming_time	string Timestamp in miliseconds of the scheduled time, as a string
id	number Unique ID for this streamer
name	string Given name, might include alternative names or romanized names
last_live	string Timestamp in miliseconds when the last stream started (or was found live), as a string
is_live	number Boolean `0`/`1` if the streamer is live
twitch	null or string Can be `null` if no active Twitch channel
youtube	null or string Can be `null` if no active YouTube channel with a "live" tab, uses the new username system
soopkr	null or string Can be `null` if no active SOOP channel
avatar	string An avatar from either 7TV, SOOP, Twitch or YouTube - in that order
avatar_proxied	null or string Might be `null`, not used for 7TV and SOOP. Key and size for the proxied version in 64x64, `https://t.rita.moe/${avatar_proxied}/${avatar.replace('?', '%3F')}`
avatar_proxied2x	null or string Might be `null`, not used for 7TV and SOOP. Key and size for the proxied version in 128x128, `https://t.rita.moe/${avatar_proxied2x}/${avatar.replace('?', '%3F')}`
	Array of objects (TagObject) The list of tags given to this streamer
	Array of objects (LinkObject) List of links to their website or social media
	object (LiveObject) Data related to a stream

Response samples

Content type

application/json

{"last_update": 1718118747580,
"list": [{"stream_id": 558238,
"upcoming_time": "1718119800000",
"id": 1063,
"name": "고세구 (Gosegu)",
"last_live": "1734601719000",
"is_live": 1,
"twitch": "gosegugosegu",
"youtube": "gosegu",
"soopkr": "gosegu2",
"avatar": "https://static-cdn.jtvnw.net/jtv_user_pictures/1e4cac72-a1cd-4f72-8ada-b2d10ac990d7-profile_image-300x300.png",
"avatar_proxied": "IPbaZgH4J03BHwEoEtVDeLa0Ys8=/64x64",
"avatar_proxied2x": "qy55ntEtbLADY89UAKNr_FkLaqo=/128x128",
"tags": [{"id": 1,
"group": "country",
"title": "South Korea",
"color": "#AEE2FF"
}
],
"links": [{"title": "Twitter",
"url": "https://twitter.com/gosegu486385"
}
],
"live": {"platform": "twitch",
"title": "트위치 바이빵가루",
"category": "Just Chatting",
"thumbnail": "https://static-cdn.jtvnw.net/previews-ttv/live_user_gosegugosegu-320x180.jpg",
"thumbnail_proxied": "eQIxaX5pA-idWGx_HBdZoGKVWGA=/160x90",
"thumbnail_proxied2x": "Qu5oDGhXKwUmFYrrAdFFK9jIZgM=/320x180",
"url": "https://twitch.tv/gosegugosegu"
}
}
]
}

/news/ list

We're manually archiving the news from /news/, with sources if possible.

query Parameters

page	integer Page number

Responses

Response Schema: application/json

object

Pagination information

current	number The current page
total	number The last page
has_next	boolean If there's a next page

Array of objects

List of news

Array

timestamp	number Timestamp in seconds of when the post was created
	object Additional details about this group of news
	object The keys in this object are the names of the category

Response samples

Content type

application/json

{"pagination": {"current": 1,
"total": 3,
"has_next": true
},
"list": [{"timestamp": 1718001875,
"details": {"post_is_op": 0,
"post_link": "https://warosu.org/vt/thread/77541222#p77800028"
},
"categories": {"Hololive": [{"title": "Shiori Novella shows off her silver play button.",
"links": ["https://x.com/shiorinovella/status/1791279440636596460"
]
},
{"title": "Takanashi Kiara unveils a new outfit, themed after 80s jazzercise videos.",
"links": ["https://x.com/takanashikiara/status/1799917374017007688"
]
}
],
"Other Corpos": [{"title": "Miria Rubellite of CosmonoahV, a JP agency, graduates on 6/9.",
"links": [ ]
},
{"title": "Varium announces 3 new talents.",
"links": ["https://x.com/mishiomolf/status/1799743243829313712",
"https://x.com/sidenlime/status/1799743244848562254",
"https://x.com/toonooto/status/1799743247993962708"
]
}
]
}
}
]
}

/news/eco list

Manual archive of Stock Watch anon's posts.

query Parameters

page	integer Page number

Responses

Response Schema: application/json

object

Pagination information

current	number The current page
total	number The last page
has_next	boolean If there's a next page

Array of objects

List of news

Array

timestamp	number Timestamp in seconds of when the post was created
post_link	null or string Might be `null`, the link back to the post where this news is from
content	string The plain-text version of the post
images	Array of strings Can be empty, list of images URLs attached to the post

Response samples

Content type

application/json

{"pagination": {"current": 1,
"total": 2,
"has_next": true
},
"list": [{"timestamp": 1726044004,
"post_link": "https://warosu.org/vt/thread/84597347#p84972104",
"content": "Stock Watch anon here. It's time to get to work. [...]",
"images": ["https://safe.rita.moe/r3emHaMJq60k.png"
]
}
]
}

Site updates

Changelog and notices about the site.

Responses

Response Schema: application/json

last_update

number

Timestamp in seconds when the data was exported

Array of objects

List of updates

Array

id	number Unique ID for this update
timestamp	number Timestamp in seconds of when the update was created
content	string HTML-formated content of the update

Response samples

Content type

application/json

{"last_update": 1736329921,
"list": [{"id": 1,
"timestamp": 1736328235,
"content": "This is a test!<br/>\nBeeh"
}
]
}