TikTok Shop Product Reviews API

TikTok Shop Product Reviews

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

How to Use

Submit one supported product URL, track the asynchronous task, and read normalized review records with cursor pagination.

1. Prepare one supported TikTok Shop PDP url, a results_limit from 20 through 2,000, and the product market region.
2. POST the request to /v1/tiktok-shop/product-reviews and save the returned task_id.
3. Poll GET /v1/tasks/{task_id} until the task succeeds or returns a failure.
4. 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 true

Best 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