Skip to main content

​
POST /webcast/bulk_live_check

Check live status for multiple TikTok users in a single request. Returns the same data as check_alive but for up to 100 users simultaneously. Batch limits: Free: 1 user, Pro: up to 50 users, Ultra: up to 100 users per request. Pass usernames as a JSON array in the request body. Response data: Returns an array with each user’s unique_id, room_id, alive status, title, and userCount. Users who are offline return alive: false with an empty room_id. Use cases: Creator monitoring dashboards that track dozens of streamers, automated alert systems, multi-stream aggregators, or periodically scanning talent rosters to detect who’s live.

​
Parameters

ParameterTypeRequiredDescription
unique_idsstring[]YesArray of TikTok usernames

​
Response

{ "status_code": 0, "data": { "user1": true, "user2": false, "user3": true } }

​
Examples

const res = await fetch('https://api.tik.tools/webcast/bulk_live_check?apiKey=YOUR_KEY', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ unique_ids: ['user1', 'user2', 'user3'] })
});
const { data } = await res.json();
Object.entries(data).forEach(([user, live]) => console.log(`${user}: ${live}`));