TikTok Shop Product Reviews
TikTok Shop product reviews are public customer feedback records with text, ratings, reviewer names, images, timestamps, SKU details, countries, and explicit purchase-status flags. These fields support product feedback analysis, variant and regional comparison, and evidence-aware review workflows.
Features
- One product with regional scopeSubmit one supported public PDP URL with a market region and collect the unique reviews exposed for that product up to the requested limit.
- Review content, rating, author, and mediaEach normalized record preserves exposed review text, numeric rating, reviewer identity, images, publication time, product URL, and collection time.
- Product, SKU, country, and purchase contextReview records retain product and SKU identifiers, variant specifications, review country, and explicit verified-purchase or incentivized-review flags when supplied.
Parameters
| Parameters | Required | Description |
|---|---|---|
url | Required | Required public TikTok Shop URL matching /shop/pdp/{numeric_id} or /shop/pdp/{slug}/{numeric_id}; one task accepts one product. |
results_limit | Optional | Maximum unique reviews to save across source pages; defaults to 100 and accepts integers from 20 through 2,000. |
region | Optional | TikTok Shop market region; defaults to US, and public product or review availability in other accepted regions can vary. |
How to Use
Submit one supported product URL, track the asynchronous task, and read normalized review records with cursor pagination.
- Prepare one supported TikTok Shop PDP url, a results_limit from 20 through 2,000, and the product market region.
- POST the request to /v1/tiktok-shop/product-reviews and save the returned task_id.
- Poll GET /v1/tasks/{task_id} until the task succeeds or returns a failure.
- Read data.results.items and request the returned next_cursor while has_more remains true.
curl -X POST "https://api.socq.ai/v1/tiktok-shop/product-reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.tiktok.com/shop/pdp/example-product/1729587769570529799","results_limit":100,"region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueBest Use Cases
- Product feedback analysis: Use review text, numeric ratings, timestamps, and product identity to examine the public feedback returned for one known product.
- SKU and regional feedback comparison: Group records by SKU specification or review country, then compare their text and ratings without inferring values for missing fields.
- Purchase-context and review-media inspection: Review customer-supplied images and segment records by explicit verified-purchase or incentivized-review flags when those values are present.
Pro Tips
- Validate that the input is a full tiktok.com PDP URL with a numeric product ID before submission, because profile, video, shop, and other TikTok URLs are rejected.
- Choose the region that matches the product market; a valid URL can still return no public reviews when the selected market does not expose the product or its review feed.
- Set results_limit between 20 and 2,000 for collection coverage, then follow next_cursor until has_more is false to read every stored result page.
- Treat absent review text, reviewer identity, SKU details, and purchase-status flags as unknown; a missing boolean is not false, and a rating-only record remains valid.
Related APIs
Use these APIs when you need a different type of public TikTok Shop data.
- TikTok Shop Search API — Search public TikTok Shop products by keyword and market region with seller, price, media, rating, review, and sold-count fields.
- TikTok Shop Products API — Collect public products from one TikTok Shop store URL with seller, price, media, category, SKU, rating, review, and sold-count fields.
- TikTok Shop Product API — Retrieve one public TikTok Shop product from a PDP URL with seller, price, media, category, SKU, rating, review, and sold-count fields.
- TikTok Shop User Showcase API — Collect public showcase products for one TikTok username with price, seller, media, rating, review, sold-count, and regional context.