tiktok/app-v3/live-ranking-list

Name: Get live room ranking list
Author: TikTok

Get ranking list of audience in live room. This capability focuses on tiktok (tiktok app v3) workflows centered on get live room ranking list.

Input

Anchor Id(string)

Anchor id

Room Id(string)

Live room id

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/live-ranking-list

Input Schema

2 parameters · 2 required · 0 optional

Parameter	Type	Required	Description
`room_id`	string	Required	Live room id
`anchor_id`	string	Required	Anchor id

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/live-ranking-list",
  "prompt": "a beautiful sunset over mountains"
}'

← Back to Get live room ranking list

API README

Get live room ranking list

Get ranking list of audience in live room. This capability focuses on tiktok (tiktok app v3) workflows centered on get live room ranking list. It is suitable for tiktok workflows.

Capability

Get ranking list of audience in live room. This capability focuses on tiktok (tiktok app v3) workflows centered on get live room ranking list. 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/check-live-room-online-batchBatch 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`.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.