Skip to main content
POST
TikTok — top search results

Body

application/json
query
string
required

Search term.

cursor
string
default:0

Opaque pagination token.

Maximum string length: 32768
region
string | null

Two-letter region code.

date_posted
enum<string> | null

Named recency window.

Available options:
all-time,
yesterday,
this-week,
this-month,
last-3-months,
last-6-months
sort_by
enum<string> | null

Named ranking.

Available options:
relevance,
most-liked,
date-posted
publish_time
enum<integer>
default:0

Numeric recency code.

Available options:
0,
1,
7,
30,
90,
180
sort_type
enum<integer>
default:0

Numeric ranking code.

Available options:
0,
1,
3

Response

Completed lookup. Standard cost: 1 SideShift credit; account-specific pricing, when present, is shown in the Scraper dashboard and returned in the billing headers.

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).