TikTok Shop Reviews Scraper

The Actor collects customer reviews for one or many TikTok Shop products, with star-rating, media, and verified-purchase filters, and the matching review total carried on every row.

{
  "product_ids": [
    "https://shop.tiktok.com/us/pdp/1730927783781307026",
    "1729447567685489298"
  ],
  "region": "US",
  "reviewFilter": "all"
}

Accepted input

product_ids is required and takes page links or bare product IDs, mixed freely in the same list. Each product is fetched separately; one that cannot be read is logged as a warning and skipped rather than ending the run, so a bad ID in a ten-product list costs that product only. region is required and selects the storefront read — US, GB, SG, MY, PH, TH, or VN — which changes the products, prices, and currency returned, not only the display language. reviewSort defaults to recommended and also accepts most_recent, which walks the newest reviews first and suits tracking sentiment over time. reviewFilter defaults to all and also accepts 5_star, 4_star, 3_star, 2_star, 1_star, with_media, or verified_purchase; only one value applies at a time, so narrowing to five-star reviews with media in a single run is not possible. maxItems defaults to 100 and bounds the number of reviews saved across the whole run; a value of 0 disables the bound.

How the review count is requested

Reviews are fetched from TikTok in one request per product, up to a ceiling of 500 reviews per product; asking for more than that per product is not possible. maxItems is a run-wide bound, not a per-product one: it is divided across the products in product_ids rather than spent entirely on the first, so a three-product run with maxItems set to 300 asks each product for 100. Setting maxItems to 0 requests the full 500-review ceiling from every product in the list.

Result fields

{
  "review_id": "7567443161237194551",
  "product_id": "1731756086010286738",
  "review_rating": 5,
  "review_text": "This product feels super hydrating. The shade is great and it goes on smooth. Also, it smells really good and the packaging is neat.",
  "reviewer_name": "C**e",
  "review_time": "1761932674796",
  "total_reviews": "9916"
}

This is a trimmed, live-captured result. Numeric fields arrive exactly as the source returns them, so review_time and total_reviews are numeric strings rather than a date and an integer; new Date(Number(review_time)) converts the timestamp without a timezone guess. The full row also carries sku_id (the variant the review is attached to), sku_specification (the size, colour, or similar the reviewer bought), reviewer_id, reviewer_avatar_url, review_images (any photos or video attached, empty when there are none), review_country, is_verified_purchase, and is_incentivized_review (whether the reviewer was rewarded for reviewing, with a free sample, a discount, or similar). review_text is empty when the reviewer left a star rating without writing anything. reviewer_name arrives partially masked by TikTok, as shown above. product_id on each row is taken from the upstream review record when present and falls back to the ID supplied in product_ids otherwise.

Filtering and the review total

total_reviews reflects the filter active on that run, not the product's lifetime review count: a run with reviewFilter set to 1_star reports the one-star count on every row, not the count across all ratings. A run with the default all filter reports the product's full review total. This makes the field a way to size the remaining pool from a single row, but only against the filter that produced it.

Products with no reviews

A product with zero reviews, or zero reviews matching the active reviewFilter, yields no rows for that product and is not treated as an error; the run continues to the next product in product_ids.

Related Actors

For a product's full page — description, variants, seller profile, and a page of reviews alongside everything else — use the TikTok Shop Product Scraper. For the creators and affiliates promoting a product instead of the people buying it, use the TikTok Shop Creator Videos Scraper. For the seller behind the product, use the TikTok Shop Seller Info Scraper.