Skip to main content
POST
TikTok — top search results

Body

application/json
query
string
required

Search term

cursor
string
default:0

Pagination cursor

region
string | null

ISO-2 region code to search from

date_posted
string | null

Recency window: all-time, yesterday, this-week, this-month, last-3-months, last-6-months

sort_by
string | null

Ranking: relevance, most-liked, date-posted

publish_time
integer
default:0

Numeric recency code — superseded by date_posted when both are sent

sort_type
integer
default:0

Numeric sort code — superseded by sort_by when both are sent

Response

Completed lookup. 1 SideShift credit.

data
object
required

TikTok platform data payload. Field names and nesting are preserved.

request_id
string
required

SideShift request id. Include it in support requests.

upstream_calls
enum<integer>
required

Number of data-source lookups performed.

Available options:
1
meta
object
required

Per-request credit accounting (also surfaced in the X-Scraper-Credits-* response headers).