List TikTok Shop product reviews
Returns customer reviews for a TikTok Shop product. Pass a public product page `url`, a `productId`, or both. Results are page-based; use `data.page.nextPage` as the `page` query parameter on the next request when `data.page.hasMore` is true. `data.lookupStatus` is `not_found` when the product cannot be resolved.
Operation
/v1/tiktok/products/reviewsHeaders
API key (`sfk_...`)
Parameters
Public TikTok Shop product detail page URL for the product whose reviews should be listed.
min 1 chars · max 4096 chars
TikTok Shop product identifier. Provide this instead of `url` when you already know the product id.
min 1 chars
Optional country or region code for the product review catalog. When omitted, the default catalog region applies.
one of: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE
1-based review page number. Omit to request the first page.
≥ 1
Response fields
Endpoint-specific response payload.
Whether the product could be resolved for this request.
one of: found, not_found
Customer reviews for the product on this page.
Stable id for the review when available.
min 1 chars
TikTok Shop product id for this review.
min 1 chars
Sku id for the purchased variant, when available.
min 1 chars
Star rating for the review (1-5).
≥ 1 · ≤ 5
Review body text, when available.
ISO-8601 timestamp for when the review was posted, when available.
min 1 chars
Whether the review is from a verified purchase, when available.
Whether the review is marked as incentivized, when available.
Reviewer display information.
Reviewer id when available.
min 1 chars
Display name when available.
min 1 chars
Profile image URL when available.
min 1 chars
Media attached to a review.
Primary image attached to the review, when available.
min 1 chars
Additional image URLs for the review when available.
min 1 chars
Human-readable label for the purchased variant, when available.
min 1 chars
Country code associated with the review, when available.
min 1 chars
Summary statistics for the product review set.
Total number of reviews reported for the product, when available.
≥ 0
Average star rating, when available.
≥ 0
Breakdown of reviews by star rating, when available.
Count of 1-star ratings, when available.
≥ 0
Count of 2-star ratings, when available.
≥ 0
Count of 3-star ratings, when available.
≥ 0
Count of 4-star ratings, when available.
≥ 0
Count of 5-star ratings, when available.
≥ 0
Pagination information for the current response.
1-based page number for this response.
≥ 1
Next page number to request when more pages are available; otherwise null.
≥ 1
Whether another page of reviews is available.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Code example
Responses
Product reviews for the requested page. `lookupStatus` is `not_found` when the product cannot be resolved.
Error codes
Product
Returns detailed catalog data for a TikTok Shop product page URL, including offer and media fields when the page resolves. Response shape may change as the catalog updates.
Showcase products
Lists TikTok Shop products featured on a creator profile showcase with cursor-based pagination. This route does not expose `lookupStatus`; an empty `data.products` array can occur when there are no showcased products, the profile is private, or other cases—call `GET /v1/tiktok/profiles/{handle}` first when you need explicit account status.