TikTok Shop V2 API: List TikTok Shop product reviews

Returns customer reviews and the rating summary for product_id. When has_more is true, request page_start + 1 for the next page. filter_type and filter_value narrow by media, verified purchase, or star rating.

2 credits / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

product_id*string

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

Length1 <= length

page_start?integer

Page number. When the response's has_more is true, request page_start + 1 for the next page.

Range1 <= value

Default1

sort_rule?|

Review sort order as an integer: 2 (default) is most recent, 1 is recommended.

Default2

filter_type?string

Review filter. no_filter = all reviews, with_media = reviews containing images/video, verified_purchase = verified purchase reviews only.

Default"no_filter"

Value in

"no_filter"
"with_media"
"verified_purchase"

filter_value?string

Star rating filter. all = every rating, 5_star..1_star = only reviews with that star rating.

Default"all"

Value in

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

region?string

TikTok Shop storefront region code. Results, prices, and availability are region-specific.

Default"US"

Value in

"US"
"GB"
"SG"
"MY"
"PH"
"TH"
"VN"
"ID"

clean?string

Defaults to true. Set false to get the unshaped source payload; its shape is not guaranteed to match the documented response schema.

Defaulttrue

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

{  "data": {    "product_reviews": [      {        "property1": null,        "property2": null      }    ],    "has_more": true,    "total_reviews": 0,    "review_ratings": {      "review_count": 0,      "overall_score": 0,      "rating_result": {        "property1": 0,        "property2": 0      },      "property1": null,      "property2": null    },    "property1": null,    "property2": null  }}