TikTok hub

TikTok Shop Product Reviews API

Pull customer reviews for one TikTok Shop product into structured JSON — ratings, text, media, and summary stats in the same envelope as the rest of the TikTok tag.

GET /v1/tiktok/products/reviews

1 credit per successful request.

About this endpoint

Quality monitors and affiliate pickers often need more than a price and sold count. They need what buyers wrote: star ratings, review text, photos, and whether a purchase was verified, without opening every PDP in a browser.

`GET /v1/tiktok/products/reviews` takes either a public Shop product page `url` or a `productId` (or both). Optional `region` selects a catalog country from the documented ISO set. Optional `page` is 1-based; omit it for the first page. On success the body uses the shared Social Fetch envelope: `data.lookupStatus` (`found` / `not_found`), review objects under `data.reviews`, aggregate stats under `data.summary` (total count, average rating, per-star distribution when available), and page state under `data.page` (`currentPage`, `nextPage`, `hasMore`). Each review can include id, productId, skuId, rating (1–5), text, createdAt, verifiedPurchase, incentivized, reviewer, media, variant, and country. `found` with an empty `reviews` array means the product resolved but this page has no reviews in the selected catalog. Bill from `meta.creditsCharged`; the flat amount for this operation is on this page and in the OpenAPI note.

This route lists reviews for one product. Product detail by PDP URL is `GET /v1/tiktok/products`. Keyword discovery is `GET /v1/tiktok/shop/products/search`. A full shop catalog is `GET /v1/tiktok/shop/products`. Creator showcase shelves are `GET /v1/tiktok/profiles/{handle}/showcase-products`. Same API key for all of them.

TikTok Shop Product Reviews API FAQ

What does the TikTok Shop Product Reviews API return?

lookupStatus (found or not_found), review objects under data.reviews, summary stats under data.summary (totalReviews, averageRating, ratingDistribution), and page state under data.page (currentPage, nextPage, hasMore). Each review can include id, productId, skuId, rating, text, createdAt, verifiedPurchase, incentivized, reviewer (id, name, avatarUrl), media (displayImageUrl, imageUrls), variant, and country. Responses use the shared Social Fetch envelope with meta.requestId and meta.creditsCharged.

How do I list TikTok Shop product reviews via API?

Send GET /v1/tiktok/products/reviews with x-api-key and either url (a public Shop PDP) or productId, or both. Optionally add region (documented country codes such as US, GB, DE, ID, JP) and page (1-based; omit for the first page). Full parameter lists and examples are in the API docs.

How much does GET /v1/tiktok/products/reviews cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged — that field is the billing source of truth. Each paginated page is a separate billed request.

Is product reviews the same as product detail or shop catalog list?

No. GET /v1/tiktok/products/reviews returns customer reviews for one product. GET /v1/tiktok/products resolves catalog detail for one PDP URL. GET /v1/tiktok/shop/products lists products for one storefront when you already have that shop's public URL.

How does pagination work on TikTok Shop product reviews?

Pagination is page-number based, not cursor-based. When data.page.hasMore is true, request the next page with page set to data.page.nextPage. Keep the same url or productId and region across pages. Omit page (or use 1) for the first page.

What does lookupStatus found with an empty reviews array mean?

The product resolved for the request, but this page has no reviews in the selected catalog or region. Branch on lookupStatus first; only treat not_found as a missing product.

Can I pick a country or region for product reviews?

Yes. Pass an optional region query parameter using one of the documented codes (US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE). Omit region when you want the default catalog behavior documented for the route.

Do I need a TikTok Shop seller account to read product reviews?

No. You authenticate to Social Fetch with an API key. The route reads public Shop review data; it does not act on behalf of a seller account you manage.