List TikTok Shop product reviews (v2) | TikTok Shop API

Returns customer reviews for product_id: ratings, text, media, and seller replies where present. count (default 30, max 500) sets how many; sort and filter narrow them. has_more says whether more reviews exist.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

product_id*string

Numeric TikTok Shop product ID, from the product_id of a search, category, or seller result.

Match^\d{10,30}$

region?string

TikTok Shop storefront to read from, such as US or GB. Results, pricing, and availability are region-specific.

Default"US"

Value in

"US"
"GB"
"SG"
"MY"
"PH"
"TH"
"VN"
"JP"
"MX"

count?integer

How many reviews to return (1-500). Reviews are collected in pages of up to 100, so larger values take longer to answer.

Range1 <= value <= 500

Default30

sort?string

Review order: recommended (default) or most_recent.

Default"recommended"

Value in

"recommended"
"most_recent"

filter?string

Restrict to a star rating, to reviews carrying photos/video, or to verified purchases. total_reviews in the response reflects the filter, so it doubles as a count per rating.

Default"all"

Value in

"all"
"5_star"
"4_star"
"3_star"
"2_star"
"1_star"
"with_media"
"verified_purchase"

curl -X GET "https://example.com/v1/tiktok-shop/product/reviews?product_id=1730927783781307026" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "product_reviews": [      {        "review_id": "string",        "property1": null,        "property2": null      }    ],    "total_reviews": "string",    "has_more": true,    "property1": null,    "property2": null  }}