Skip to main content
GET
TikTok Search Top
Beta catalog endpoint. Provider activation and live verification are in progress. An unavailable operation returns HTTP 503 and uses no credits.

Authorizations

x-api-key
string
header
required

Headers

Cache-Control
string
Idempotency-Key
string

Query Parameters

query
string
required
publish_time
enum<string>
Available options:
yesterday,
this-week,
this-month,
last-3-months,
last-6-months,
all-time
sort_by
enum<string>
Available options:
relevance,
most-liked,
date-posted
region
string
cursor
integer
since
string
until
string
min_views
integer
Required range: x >= 0
max_age_days
integer
Required range: 1 <= x <= 3650
country
string
exclude_country
string
sort_rows
enum<string>
Available options:
views
max_pages
integer
Required range: 1 <= x <= 5
seen
string

Response

Successful response. data is specific to this operation.

success
boolean
required
platform
string
required
endpoint
string
required
credits_used
integer
required
Required range: x >= 0
credits_remaining
integer | null
required
request_id
string
required
cached
boolean
required
data
object
required

Operation-specific data. Fields depend on the endpoint and upstream response; unavailable metrics may be null.