Skip to main content
POST
Best-selling / trending product listings on TikTok Shop, optionally within a category. Returns a normalized Product page.

Authorizations

Authorization
string
header
required

AgentKey API key (ak_…).

Body

application/json
category
string

Numeric TikTok Shop category id (required on TikTok Shop: the upstream lists products per category only; e.g. 601152 Beauty & Personal Care, 601739 Phones & Electronics).

cursor
string

Opaque pagination cursor from the previous response's next_cursor. Send the same parameters with it.

fields
string[]

Projection: keep only these dotted paths of data, e.g. ["items.id", "items.text"].

include_raw
boolean
default:false

Attach the raw upstream payload as raw (not a stable contract; truncated above 256 KB).

limit
integer
default:20

Maximum number of products to return.

Required range: 1 <= x <= 20
provider
string

Shorthand for routing.only = [provider].

region
enum<string>
default:US

TikTok Shop market (ISO 3166-1 alpha-2).

Available options:
US,
GB,
SG,
MY,
PH,
TH,
VN,
ID
routing
object

Provider routing override. order: try these providers first; only: restrict to these (equivalent to pinning); allow_fallbacks: false tries only the first eligible provider.

Response

Success envelope

Success envelope whose data is a ProductPage.

attempts
object[]
required
credits_charged
number
required

Credits charged for this call (the method's fixed price).

data
object
required

One page of products.

op
string
required

Method name.

op_version
integer
required

Method version that served the call.

provider
string
required

Provider that actually served the call.

request_id
string
required

Correlation id; quote it in support requests.

took_ms
integer
required
unsupported_fields
string[]
required

Output paths this provider structurally does not supply; such fields are null for a different reason than 'missing on this record'.

raw
any

Upstream payload, only with include_raw=true. Not a stable contract.

raw_truncated
boolean