Skip to main content
POST /v1/data/tiktok/live-rooms/run Pricing: $0.001 per live room ($1.00 per 1,000).

Ways to call it

  • Search by keyword: set keywords (optional: region, maxResults)
  • Check by handle: set handles

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
Search terms to find currently live rooms that best match the topic.
string
default:"US"
Two-letter region code to localize the live search, for example US or JP.
string[]
Usernames to check whether that creator is currently live.
integer
default:"50"
How many live rooms to return in total. Defaults to 50; use 0 for all. Applies to Keyword search.

Example

Response fields

Each row in data is one live room, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For a creator’s profile use tiktok/profiles.