Skip to main content
POST /v1/data/tiktok-shop/reviews/run Pricing: $0.002 per review ($2.00 per 1,000).

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
required
One or more product urls. One request reads them all.
string
default:"US"
Region to use. United States by default.Allowed values: US (United States), GB (United Kingdom), DE (Germany), FR (France), IT (Italy), ES (Spain), IE (Ireland), BR (Brazil), MX (Mexico), JP (Japan), ID (Indonesia), MY (Malaysia), PH (Philippines), SG (Singapore), TH (Thailand), VN (Vietnam).
integer
default:"50"
How many reviews to return in total. Defaults to 50; use 0 for all.
string
Sort to use.Allowed values: recommended (Recommended), most_recent (Most recent first), highest_rating (Highest rating first), lowest_rating (Lowest rating first).

Example

Response fields

Each row in data is one review, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For product listings use tiktok/shop.