Skip to main content

​
GET /webcast/check_alive

Check if one or more TikTok users are currently live streaming. Returns live status, room ID, stream title, and viewer count for each user. Lookup methods: Pass unique_id (username) for single-user lookups, or room_ids (comma-separated) to check multiple rooms at once. At least one parameter is required. Response data: Each entry includes room_id, alive (boolean), title, and userCount. Use this to build monitoring dashboards, trigger alerts when creators go live, or validate a stream before connecting via WebSocket. Performance: This endpoint is lightweight and cached — ideal for polling. Combine with bulk_live_check for monitoring large lists of creators.

​
Parameters

ParameterTypeRequiredDescription
room_idsstringNoComma-separated room IDs
unique_idstringNoTikTok username (without @)

​
Response

{ "status_code": 0, "data": [{ "room_id": "...", "alive": true, "title": "...", "userCount": 1234 }] }

​
Examples

const res = await fetch('https://api.tik.tools/webcast/check_alive?apiKey=YOUR_KEY&unique_id=username');
const { data } = await res.json();
console.log(data[0].alive ? 'Live!' : 'Offline');