tiktok/app-v3/check-live-room-online-batch

Name: Batch check if live rooms are online
Author: TikTok

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`.

Input

Room Ids(array)

List of TikTok live room IDs

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDtiktok/app-v3/check-live-room-online-batch

Input Schema

1 parameters · 0 required · 1 optional

Parameter	Type	Required	Description
`room_ids`	string[]	Optional	List of TikTok live room IDs · Default: ["7494491933781003054","7494514925034113835","7494520590523517739"]

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Code Examples

Ready-to-run snippets

curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "tiktok/app-v3/check-live-room-online-batch",
  "room_ids": [
    "7494491933781003054",
    "7494514925034113835",
    "7494520590523517739"
  ],
  "prompt": "a beautiful sunset over mountains"
}'

← Back to Batch check if live rooms are online

API README

Batch check if live rooms are online

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. It is suitable for tiktok workflows.

Capability

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. It helps applications, agents, and automated workflows turn that capability into repeatable tasks and useful downstream experiences.

Common use cases

Connect structured data to dashboards, agents, internal tools, and automated workflows.
Create repeatable integrations that pass structured results to downstream business systems.
Support scheduled jobs, internal tools, and agent workflows with structured results.

Related Models

tiktok/app-v3/check-live-room-onlineCheck if live room is online The Room ID of the live room can be obtained from the `/api/v1/tiktok/web/get_live_room_id` interface through the live room link.tiktok/app-v3/content-translateGet content translation data. This capability focuses on tiktok (tiktok app v3) workflows centered on get content translation data.tiktok/app-v3/creator-search-insightsGet creator search insights data, used to understand trending search topics and creative inspiration.tiktok/app-v3/creator-search-insights-detailGet creator search insights detail data, used to query search statistics for specific query.tiktok/app-v3/creator-search-insights-trendGet creator search insights trend data, including search popularity by region and time.tiktok/app-v3/creator-search-insights-videosGet creator search insights related videos, query popular related videos for the search term.tiktok/app-v3/general-search-resultGet comprehensive search results of specified keywords.tiktok/app-v3/hashtag-detailGet details of specified hashtag. This capability focuses on tiktok (tiktok app v3) workflows centered on get details of specified hashtag.