POST /v1/tiktok/app/v3/check_live_room_online_batch

Batch check if live rooms are online

stable · 13 credits per success

Batch check TikTok live rooms' online status, supports up to 50 room IDs；Room IDs can be retrieved from `/api/v1/tiktok/web/get_live_room_id`；room_ids: List of TikTok live room IDs；Online status per room

Request

room_idsarraybody

多个直播间ID组成的数组

curl -s -X POST 'https://api.wellbyte.net/v1/tiktok/app/v3/check_live_room_online_batch' \
  -H "Authorization: Bearer dg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"room_ids":"demo"}'

Response

Sample captured 2026-08-27

data{

code:0

data[

0{ 3 items }

1:"…共 3 项"

]

meta{

endpoint:"tiktok.app.v3_check_live_room_online_batch"

cache_hit:false

elapsed_ms:0

request_id:"req_sample"

credits_charged:0

}

message:"ok"

}

History

Open full logs

No calls yet. Get one green run first, then switch to your own data.

POST /v1/tiktok/app/v3/check_live_room_online_batch

Batch check if live rooms are online

stable · 13 credits per success

Request parameters

Name	Type	In	Required	Description	Example
room_ids	array	body	no	多个直播间ID组成的数组	demo

Response fields

Field dictionary coming soon — the executable panel shows the live shape.

Errors

code	HTTP	Meaning	Billed
40001	400	Invalid parameters	no
40102	401	Invalid or revoked API Key	no
40201	402	Insufficient credits	no
40402	404	Resource not found	no
42201	422	Quality gate failed	no
42901	429	Rate limit exceeded	no
50401	504	Upstream timeout	no
50201	502	Upstream error	no

Billing

Success costs 13 credits. Any failure — including a 200 from upstream that fails the quality gate — costs 0.

Request parameters

Response fields

Errors

Billing

Search