# TikTok Shop Reviews Scraper (`parsebird/tiktok-shop-reviews-scraper`) Actor Scrape TikTok Shop product reviews by link or product ID: rating, text, date, photos and videos, reviewer, verified purchase, variant, plus product rating breakdown. 10 storefronts, filters, JSON/CSV/Excel. - **URL**: https://apify.com/parsebird/tiktok-shop-reviews-scraper.md - **Developed by:** [ParseBird](https://apify.com/parsebird) (community) - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.39 / 1,000 reviews This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ### TikTok Shop Reviews Scraper TikTok Shop Reviews Scraper extracts public product reviews from [TikTok Shop](https://shop.tiktok.com/us) product pages: star rating, review text, publish date, review photos, reviewer, verified-purchase flag, and the purchased variant, together with the product's overall rating and star breakdown.
Paste up to 500 TikTok Shop product links or IDs, filter by exact or minimum stars, photo reviews, or verified buyers, and get one clean row per review with product rating context attached.

ParseBird TikTok Suite   •  Video, story, LIVE & shop data
TikTok Slideshow Downloader
Photo-mode posts as image files 		TikTok Story Viewer
Active stories, no-watermark video 		TikTok Live Search Scraper
LIVE rooms by keyword 		TikTok Shop Reviews Scraper
You are here
##### Copy to your AI assistant Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor. ```text Use Apify Actor parsebird/tiktok-shop-reviews-scraper to scrape public TikTok Shop product reviews. Example with ApifyClient (Python): client.actor("parsebird/tiktok-shop-reviews-scraper").call(run_input={"productTargets":["https://shop.tiktok.com/us/pdp/riffmaster-wireless-guitar-controller-by-pdp-lightweight-design-easy-connectivity/1731043373753405773"],"storefront":"US","starRatingFilter":"any","reviewLimit":100,"reviewOrder":"recommended"}). Inputs: productTargets array of strings required, 1-500 TikTok Shop product links or numeric product IDs; storefront string default "US" (US, GB, SG, MY, PH, TH, VN, ID, JP, MX; public pages are currently available for US); starRatingFilter string default "any" (any, exact-1..exact-5, minimum-1..minimum-5); mediaOnly boolean default false; verifiedPurchaseOnly boolean default false; reviewLimit integer optional per product, empty = all public reviews; reviewOrder "recommended" or "newest". TikTok Shop shows up to 20 reviews per product without login. Output: one row per review with product{id,name,url,overallRating,ratingDistribution{oneStar..fiveStar},matchingReviewCount}, rating, text, publishedAt (ISO 8601), media[{url,type}], reviewer{name,accountId,avatarUrl,country}, purchase{isVerifiedPurchase,isIncentivized}, variant{sku,name,attributes}. API docs: https://docs.apify.com/api/client/python/ and https://docs.apify.com/api/client/js/. Token: https://console.apify.com/account/integrations. ``` ### What is TikTok Shop Reviews Scraper? **TikTok Shop Reviews Scraper** is a TikTok Shop review scraper and **TikTok Shop reviews API** alternative. Give it product links such as `https://shop.tiktok.com/us/pdp/riffmaster-wireless-guitar-controller-by-pdp-lightweight-design-easy-connectivity/1731043373753405773` or plain product IDs, and it returns the **public buyer reviews** TikTok Shop shows on each product page, plus the **product's overall rating and full 1–5 star breakdown**. No TikTok account, login, or API key is needed. The easiest way to try it is to open the actor, keep the prefilled product, and click **Start**. > **Important limit:** TikTok Shop shows **up to 20 reviews per product** to visitors who are not logged in, and its review-paging API rejects anonymous requests. This actor returns those public reviews. For every product it also returns the **complete star distribution and total review count**, even when the product has thousands of reviews. ### What can TikTok Shop Reviews Scraper do? - ⭐ **Collect public reviews** with rating, text, date, photos, reviewer, verified-purchase and incentivized flags, and the purchased SKU and variant options. - 📊 **Attach product context** to every row: product name, link, overall rating, star breakdown, and the number of product reviews that match your star filter. - 🔗 **Accept any product reference**: `shop.tiktok.com/us/pdp/...` links (with or without query parameters), `tiktok.com/view/product/{id}` links, and numeric product IDs. Repeated products are processed once. - 🎯 **Filter reviews** by exact stars (`exact-1` … `exact-5`), minimum stars (`minimum-1` … `minimum-5`), photo reviews only, or verified purchases only. - ↕️ **Sort** in TikTok Shop's recommended order or newest first, and cap reviews per product with `reviewLimit`. - ⏱️ **Monitor products** on a schedule with [Apify schedules](https://docs.apify.com/platform/schedules) to track rating changes and new reviews at the top of the page. - 🔌 **Integrate** through the [Apify API](https://docs.apify.com/api/v2), webhooks, and [integrations](https://apify.com/integrations) such as Make, Zapier, Google Sheets, and Slack. - 📁 **Export** as JSON, CSV, Excel, HTML, or XML. ### What data can you extract from TikTok Shop reviews? | Field | Description | |-------|-------------| | `rating` | Review star rating, 1 to 5 | | `text` | Review text (omitted for rating-only reviews) | | `publishedAt` | Publish time in ISO 8601 (UTC) | | `media[].url`, `media[].type` | Photos attached to the review (`image`) | | `reviewer.name`, `reviewer.accountId`, `reviewer.avatarUrl`, `reviewer.country` | Public reviewer details as shown by TikTok Shop (names are masked by TikTok, for example `U**J`) | | `purchase.isVerifiedPurchase`, `purchase.isIncentivized` | Purchase signals shown with the review | | `variant.sku`, `variant.name`, `variant.attributes` | Purchased SKU, variant label, and option values such as `{"Platform": "PlayStation"}` | | `product.id`, `product.name`, `product.url` | Reviewed product | | `product.overallRating` | Product rating on a 0–5 scale | | `product.ratingDistribution` | Product-wide count of 1–5 star reviews | | `product.matchingReviewCount` | Product-wide number of reviews matching your star filter (omitted when photo or verified filters are on, because TikTok Shop does not publish those counts) | Some reviews, often older ones, have no reviewer, variant, or purchase details on TikTok Shop; those objects are then omitted from the row. ### How to scrape TikTok Shop reviews 1. Open [TikTok Shop Reviews Scraper](https://apify.com/parsebird/tiktok-shop-reviews-scraper) and click **Try for free** or **Start**. 2. In **Products**, paste TikTok Shop product links or numeric product IDs, one per line. 3. Pick the **Storefront** (US by default). 4. Optionally set **Max reviews per product**, **Sort reviews by**, and the **Filters**. 5. Click **Start**. Each product takes a few seconds. 6. Open the **Output** tab, or export the dataset as JSON, CSV, or Excel. ### Input parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `productTargets` | array of strings | **Yes** | — | 1–500 TikTok Shop product links or numeric product IDs | | `storefront` | string | No | `US` | Storefront for bare product IDs: `US`, `GB`, `SG`, `MY`, `PH`, `TH`, `VN`, `ID`, `JP`, `MX`. Links use the country in the link. | | `starRatingFilter` | string | No | `any` | `any`, `exact-1` … `exact-5`, or `minimum-1` … `minimum-5` | | `mediaOnly` | boolean | No | `false` | Only reviews with attached photos | | `verifiedPurchaseOnly` | boolean | No | `false` | Only reviews marked as verified purchases | | `reviewLimit` | integer | No | empty (all public reviews) | Maximum reviews per product, at least 1. The form pre-fills `100`. | | `reviewOrder` | string | No | `recommended` | `recommended` keeps TikTok Shop's order; `newest` sorts the collected reviews newest first | | `proxyConfiguration` | object | No | Apify Proxy, US | Network settings. TikTok Shop serves US pages to US visitors. | ### Input / Output Example input: ```json { "productTargets": [ "https://shop.tiktok.com/us/pdp/riffmaster-wireless-guitar-controller-by-pdp-lightweight-design-easy-connectivity/1731043373753405773" ], "storefront": "US", "starRatingFilter": "any", "reviewLimit": 100, "reviewOrder": "recommended" } ``` Example output row: ```json { "product": { "id": "1731043373753405773", "name": "PDP Riffmaster Wireless Guitar Controller - Collapsible, Low Latency, 30-Foot Low Latency Wireless Connection, Audio Controls, 3.5mm Audio Jack, Guitar Strap, Rechargeable Battery, Analog Stick, Home Storage Compatible for Fortnite Festival, Rock Band 4", "url": "https://shop.tiktok.com/us/pdp/riffmaster-wireless-guitar-controller-by-pdp-lightweight-design-easy-connectivity/1731043373753405773", "overallRating": 4.7, "ratingDistribution": { "oneStar": 1, "twoStar": 0, "threeStar": 0, "fourStar": 34, "fiveStar": 96 }, "matchingReviewCount": 131 }, "rating": 1, "publishedAt": "2026-06-01T03:21:56.027Z", "media": [ { "url": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/fac5bbca79bd4a7fb29bea64938f597d~tplv-fhlh96nyum-crop-webp:300:300.webp?...", "type": "image" } ], "text": "Literally not what I ordered. Now I gotta return it back, get a refund, and try and purchase the guitar again HOPING they get it right this time smh.", "reviewer": { "name": "U**J", "accountId": "6873921462563701766", "avatarUrl": "https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/107674e902517e3894d08ea3b5007fd3~tplv-tiktokx-cropcenter:100:100.jpg?...", "country": "US" }, "purchase": { "isVerifiedPurchase": true, "isIncentivized": false }, "variant": { "sku": "1731043397250683213", "name": "PlayStation", "attributes": { "Platform": "PlayStation" } } } ``` Download the dataset as JSON, CSV, Excel, HTML, or XML. ### Python API example ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("parsebird/tiktok-shop-reviews-scraper").call(run_input={ "productTargets": ["1731043373753405773"], "starRatingFilter": "minimum-4", "reviewOrder": "newest", }) for review in client.dataset(run["defaultDatasetId"]).iterate_items(): print(review["rating"], review["publishedAt"], review.get("text", "")[:80]) ``` ### JavaScript API example ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' }); const run = await client.actor('parsebird/tiktok-shop-reviews-scraper').call({ productTargets: ['https://shop.tiktok.com/us/pdp/riffmaster-wireless-guitar-controller-by-pdp-lightweight-design-easy-connectivity/1731043373753405773'], mediaOnly: true, }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((r) => console.log(r.rating, r.media.length, r.product.ratingDistribution)); ``` See the [Python client](https://docs.apify.com/api/client/python/) and [JavaScript client](https://docs.apify.com/api/client/js/) docs for more options. ### Use cases - **Product research**: compare rating breakdowns and top reviews across competing TikTok Shop products. - **Brand monitoring**: track your products' overall rating and the reviews TikTok Shop shows first. - **Voice of customer**: pull low-star reviews (`exact-1`, `exact-2`) to find recurring complaints. - **Creative sourcing**: collect photo reviews (`mediaOnly`) as social proof and UGC ideas. - **Variant insights**: see which SKU or option buyers reviewed via `variant.attributes`. - **Dashboards**: send ratings to Google Sheets, BI tools, or Slack with integrations. ### How it works 1. The actor reads each link or ID and works out the product ID and storefront. 2. It loads the public TikTok Shop product page through Apify Proxy and reads the product details, rating summary, and public reviews. 3. It applies your star, photo, and verified-purchase filters, sorts, and applies `reviewLimit`. 4. It pushes one dataset row per review and logs any product it could not load, with the reason. ### How much does it cost to scrape TikTok Shop reviews? **What is the price per TikTok Shop review?** The actor uses pay-per-event pricing: you pay per review saved, and platform usage is included. | Event | Free plan | Bronze | Silver | Gold | |-------|-----------|--------|--------|------| | `review-scraped` | $0.00199 (**$1.99 / 1,000**) | $0.00179 (**$1.79 / 1,000**) | $0.00159 (**$1.59 / 1,000**) | $0.00139 (**$1.39 / 1,000**) | One `review-scraped` event is one review row in the dataset. A product with 20 public reviews costs about $0.04 on the Free plan; 50 products at 20 reviews each (1,000 reviews) cost $1.99. Products that fail to load are not charged. Apify's free plan includes monthly platform credits you can use to try the actor. ### Is it legal to scrape TikTok Shop reviews? **Is scraping TikTok Shop reviews legal?** This actor only reads reviews that TikTok Shop shows publicly without login. Scraping public data is generally legal in many jurisdictions, but reviews can contain personal data (reviewer names, avatars) protected by laws such as GDPR and CCPA. Collect only what you need, respect [TikTok's Terms of Service](https://www.tiktok.com/legal/page/us/terms-of-service/en), and consult your lawyer if unsure. Read more in Apify's guide: [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/) ### Other TikTok scrapers and related Actors | Actor | Best for | |-------|----------| | [TikTok Slideshow Downloader](https://apify.com/parsebird/tiktok-slideshow-downloader) | Downloading every photo from TikTok photo-mode posts | | [Coupang Review Scraper](https://apify.com/parsebird/coupang-review-scraper) | Product reviews from Coupang Korea | | [AliExpress Scraper](https://apify.com/parsebird/aliexpress-scraper) | AliExpress products and prices | | [Trustpilot Reviews Scraper](https://apify.com/parsebird/trustpilot-reviews-scraper) | Company reviews from Trustpilot | ### FAQ **Why do I get at most 20 reviews per product?** TikTok Shop shows up to 20 reviews per product to visitors who are not logged in, and its review-paging API rejects anonymous requests. The actor returns every review TikTok Shop makes public, and it always includes the full star breakdown and total review count so you still see the whole product's rating profile. **Which storefronts work?** TikTok Shop currently publishes public product pages for the **US** storefront. Other storefront values are accepted; if TikTok Shop serves no public page, the product is skipped, logged with the reason, and not charged. **How does "newest" ordering work?** It sorts the collected public reviews by publish date, newest first. "Recommended" keeps TikTok Shop's own order. **What does `matchingReviewCount` mean?** It is TikTok Shop's product-wide count of reviews matching your star filter: the total review count for `any`, the count of that star for `exact-N`, or the sum from N to 5 stars for `minimum-N`. It is omitted when photo or verified filters are on, because TikTok Shop does not publish those counts. **Do reviews include videos?** The public review data contains photos only, so `media[].type` is `image`. **Do I need a TikTok account or API key?** No. The actor reads public product pages only. **Can I schedule runs or use the results in other tools?** Yes. Use [schedules](https://docs.apify.com/platform/schedules), the [API](https://docs.apify.com/api/v2), webhooks, or [integrations](https://apify.com/integrations). **Where can I report issues?** Open the **Issues** tab on the actor page with your input and run ID. # Changelog This Actor's version history is a separate document: https://apify.com/parsebird/tiktok-shop-reviews-scraper/changelog.md # Actor input Schema ## `productTargets` (type: `array`): Add 1 to 500 TikTok Shop product page links (for example https://shop.tiktok.com/us/pdp/.../1731043373753405773) or numeric product IDs. ## `storefront` (type: `string`): Choose the TikTok Shop country storefront for bare product IDs. Product links use the country in the link. Currently TikTok Shop publishes public product pages for the US storefront; other storefronts are attempted and reported in the log if TikTok serves no public page. ## `reviewLimit` (type: `integer`): Stop after this many reviews for each product. Leave empty to collect every publicly available review (TikTok Shop shows up to 20 per product without login). ## `reviewOrder` (type: `string`): Keep TikTok Shop's recommended order, or sort the collected reviews newest first. ## `starRatingFilter` (type: `string`): Keep all reviews, one exact star rating, or a minimum star rating. ## `mediaOnly` (type: `boolean`): Return only reviews that include attached photos or videos. ## `verifiedPurchaseOnly` (type: `boolean`): Return only reviews that TikTok Shop marks as verified purchases. ## `proxyConfiguration` (type: `object`): TikTok Shop only serves its US storefront to US visitors, so the default is Apify Proxy with a US location. Change it only if you know you need different proxies. ## Actor input object example ```json { "productTargets": [ "https://shop.tiktok.com/us/pdp/riffmaster-wireless-guitar-controller-by-pdp-lightweight-design-easy-connectivity/1731043373753405773" ], "storefront": "US", "reviewLimit": 100, "reviewOrder": "recommended", "starRatingFilter": "any", "mediaOnly": false, "verifiedPurchaseOnly": false, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyCountry": "US" } } ``` # Actor output Schema ## `dataset` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "productTargets": [ "https://shop.tiktok.com/us/pdp/riffmaster-wireless-guitar-controller-by-pdp-lightweight-design-easy-connectivity/1731043373753405773" ], "storefront": "US", "reviewLimit": 100, "reviewOrder": "recommended", "starRatingFilter": "any", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("parsebird/tiktok-shop-reviews-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "productTargets": ["https://shop.tiktok.com/us/pdp/riffmaster-wireless-guitar-controller-by-pdp-lightweight-design-easy-connectivity/1731043373753405773"], "storefront": "US", "reviewLimit": 100, "reviewOrder": "recommended", "starRatingFilter": "any", "proxyConfiguration": { "useApifyProxy": True, "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("parsebird/tiktok-shop-reviews-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "productTargets": [ "https://shop.tiktok.com/us/pdp/riffmaster-wireless-guitar-controller-by-pdp-lightweight-design-easy-connectivity/1731043373753405773" ], "storefront": "US", "reviewLimit": 100, "reviewOrder": "recommended", "starRatingFilter": "any", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyCountry": "US" } }' | apify call parsebird/tiktok-shop-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,parsebird/tiktok-shop-reviews-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/RjfRFONe95a4mJMxA/builds/1HpusQeGl8v4pajpT/openapi.json