Skip to main content
POST
TikTok Top Search API

TikTok Top Search

Submit an asynchronous task, then read its standard results.
query is required. results_limit defaults to 100. Results can contain videos and photo carousels; region changes content availability and does not guarantee geographic filtering.

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. results_limit defaults to 100. Results can contain videos and photo carousels; region changes content availability and does not guarantee geographic filtering.

query
string
required

Search query.

Minimum string length: 1
callback_url
string<uri>
published_within
enum<string>
Available options:
day,
month,
six_months,
three_months,
week
Minimum string length: 1
region
string
Minimum string length: 1
Pattern: ^[A-Za-z]{2}$
results_limit
integer
default:100
Required range: 1 <= x <= 2000
sort_by
enum<string>
Available options:
date,
likes,
relevance
Minimum string length: 1

Response

Task accepted

code
integer
data
object