Skip to main content
POST
TikTok Live Search API

TikTok Live Search

Find LIVE streams that are on air right now for a keyword. Results include the stream title, host, current viewers, likes and start time. Each result’s id and author.id are exactly the room_id and user_id that TikTok Live Shopping takes, so a shopping stream you find here leads straight to the products it is selling.
query is required. Results cover streams broadcasting at the time of the request. results_limit defaults to 20 and accepts 1 to 200.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

query is required. Returns LIVE streams that are broadcasting now and match it, with their current viewers. results_limit defaults to 20 and accepts 1 to 200.

query
string
required

Keyword to find LIVE streams for.

Minimum string length: 1
callback_url
string<uri>
results_limit
integer
default:20
Required range: 1 <= x <= 200

Response

Task accepted

code
integer
data
object