{ "data": { "id": "CLJ5fUchJI7BMW34n", "actId": "PsVmeHsn8748GeSDv", "userId": "NWYsOG96fMDy8ycdf", "startedAt": "2026-10-29T06:54:18.627Z", "finishedAt": "2026-10-29T06:54:22.889Z", "status": "SUCCEEDED", "meta": { "origin": "API" }, "stats": { "durationMillis": 4188, "runTimeSecs": 4.188, "computeUnits": 0.004653333333333333, "imageSizeBytes": 339430912 }, "options": { "useCache": true, "betaPackages": false, "tag": "latest", "memoryMbytes": 4096, "diskMbytes": 8192 }, "exitCode": 0, "inputSchema": "{\n \"title\": \"TikTok Shop Review Scraper\",\n \"type\": \"object\",\n \"schemaVersion\": 1,\n \"properties\": {\n \"productUrls\": {\n \"title\": \"Product URLs\",\n \"type\": \"array\",\n \"description\": \"TikTok Shop product pages to collect reviews from. Takes precedence over Product IDs and Search keyword.\",\n \"editor\": \"stringList\",\n \"prefill\": [\n \"https://shop.tiktok.com/view/product/1731849567724278088\"\n ],\n \"maxItems\": 500,\n \"sectionCaption\": \"Products\",\n \"sectionDescription\": \"Give product URLs, product IDs, or a search keyword. If you give more than one, URLs are used first, then IDs, then the keyword.\"\n },\n \"productIds\": {\n \"title\": \"Product IDs\",\n \"type\": \"array\",\n \"description\": \"Numeric product IDs, if you already have them. Used when no Product URLs are given.\",\n \"editor\": \"stringList\",\n \"maxItems\": 500\n },\n \"searchKeyword\": {\n \"title\": \"Search keyword\",\n \"type\": \"string\",\n \"description\": \"Find products by keyword and collect reviews for the matches. Used only when no Product URLs or Product IDs are given.\",\n \"editor\": \"textfield\"\n },\n \"maxProductsFromSearch\": {\n \"title\": \"Max products from search\",\n \"type\": \"integer\",\n \"description\": \"How many matching products to collect reviews for. Only used when you scrape by search keyword.\",\n \"prefill\": 5,\n \"minimum\": 1,\n \"maximum\": 100\n },\n \"region\": {\n \"title\": \"Marketplace\",\n \"type\": \"string\",\n \"description\": \"Which TikTok Shop marketplace the products belong to. Reviews are written in that market's language.\",\n \"editor\": \"select\",\n \"enum\": [\n \"US\",\n \"GB\",\n \"DE\",\n \"FR\",\n \"IT\",\n \"ES\",\n \"IE\",\n \"BR\",\n \"MX\",\n \"JP\",\n \"ID\",\n \"MY\",\n \"PH\",\n \"SG\",\n \"TH\",\n \"VN\"\n ],\n \"enumTitles\": [\n \"United States\",\n \"United Kingdom\",\n \"Germany\",\n \"France\",\n \"Italy\",\n \"Spain\",\n \"Ireland\",\n \"Brazil\",\n \"Mexico\",\n \"Japan\",\n \"Indonesia\",\n \"Malaysia\",\n \"Philippines\",\n \"Singapore\",\n \"Thailand\",\n \"Vietnam\"\n ],\n \"prefill\": \"US\",\n \"sectionCaption\": \"Marketplace and limits\"\n },\n \"maxReviewsPerProduct\": {\n \"title\": \"Max reviews per product\",\n \"type\": \"integer\",\n \"description\": \"Upper limit of reviews collected per product. Leave empty to collect every review available. You are charged per review returned, so this is also your cost control.\",\n \"prefill\": 100,\n \"minimum\": 1\n },\n \"reviewsFilter\": {\n \"title\": \"Only include\",\n \"type\": \"string\",\n \"description\": \"Keep only reviews matching this condition. Filtered runs scan more pages to find matches and may return fewer reviews than the maximum.\",\n \"editor\": \"select\",\n \"enum\": [\n \"all\",\n \"5_star\",\n \"4_star\",\n \"3_star\",\n \"2_star\",\n \"1_star\",\n \"with_images\",\n \"verified\"\n ],\n \"enumTitles\": [\n \"All reviews\",\n \"5 stars only\",\n \"4 stars only\",\n \"3 stars only\",\n \"2 stars only\",\n \"1 star only\",\n \"With photos or video\",\n \"Verified purchases only\"\n ],\n \"prefill\": \"all\",\n \"sectionCaption\": \"Filter and order\"\n },\n \"reviewsSort\": {\n \"title\": \"Sort reviews by\",\n \"type\": \"string\",\n \"description\": \"Order of the collected reviews. Sorting is applied to the reviews this run collects, not to the product's entire review history.\",\n \"editor\": \"select\",\n \"enum\": [\n \"recommended\",\n \"most_recent\",\n \"highest_rating\",\n \"lowest_rating\"\n ],\n \"enumTitles\": [\n \"Recommended\",\n \"Most recent first\",\n \"Highest rating first\",\n \"Lowest rating first\"\n ],\n \"prefill\": \"recommended\"\n },\n \"includeProductSummary\": {\n \"title\": \"Include product summary row\",\n \"type\": \"boolean\",\n \"description\": \"Adds one free row per product with its title, price, average rating, total review count and shop details, and fills the product title in on every review row. Product and shop details are available for the United States marketplace.\",\n \"default\": true,\n \"sectionCaption\": \"Extras\"\n },\n \"includeRatingBreakdown\": {\n \"title\": \"Include star breakdown\",\n \"type\": \"boolean\",\n \"description\": \"Adds the full 1-5 star distribution to the product summary row. Adds a few seconds per product and is skipped silently if unavailable.\",\n \"default\": false\n },\n \"feedback\": {\n \"title\": \"Feedback to the maintainers\",\n \"type\": \"string\",\n \"editor\": \"hidden\",\n \"description\": \"For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns.\"\n }\n },\n \"required\": []\n}", "readme": "[![TikTok Shop reviews. 16 markets. Buyer photos. Exact variants. Verified purchases.](https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/tiktok-shop-review-scraper-hero-5cb6adc6fedc.png)](https://console.apify.com/actors/PsVmeHsn8748GeSDv/input)\n\nFrom **Zen Studio**, creators of [1688 Wholesale](https://apify.com/zen-studio/1688-wholesale-scraper), ranked #1 for “1688” in Apify Store search, alongside dedicated [Shopee](https://apify.com/zen-studio/shopee-product-scraper) and [Alibaba](https://apify.com/zen-studio/alibaba-scraper) actors.\n\n## Why choose this actor?\n\n**Buyer feedback across 16 markets.** Collect TikTok Shop reviews from the US, UK, Europe, Latin America and Asia using the same output format. Select the product’s marketplace and export its reviews in their original language, with duplicates removed before billing.\n\n**Know exactly what the buyer reviewed.** Keep the purchased variant, buyer photos and verified-purchase flag alongside full review text, star rating and date. Compare feedback by color or model and inspect customer photos alongside written reviews. Photos and variant details are included when available.\n\n**Start with a product or a keyword.** Paste product links or IDs, or enter a keyword to discover products and collect their reviews. For US products, optionally add product and shop details plus the 1–5-star rating breakdown when available, in a separate summary row.\n\n\"Collect\n\n## Try a product\n\nCollect 20 reviews from a US product, with its product summary and optional star breakdown:\n\n```json\n{\n \"productUrls\": [\n \"https://shop.tiktok.com/view/product/1731849567724278088\"\n ],\n \"region\": \"US\",\n \"maxReviewsPerProduct\": 20,\n \"includeProductSummary\": true,\n \"includeRatingBreakdown\": true\n}\n```\n\n[Open actor input](https://console.apify.com/actors/PsVmeHsn8748GeSDv/input), replace the product link and choose the matching marketplace. Export JSON, CSV or Excel; JSON preserves photo arrays and the rating breakdown. Reviews are billed per unique review delivered. The summary has no review charge; normal dataset-item charges apply.\n\nCollection currently stops after 500 review pages per product, roughly 5,000 reviews before duplicates are removed. A lower review limit controls the size of your trial. Product/shop details and the optional star breakdown are US-only; the breakdown may be unavailable. See [pricing](https://apify.com/zen-studio/tiktok-shop-review-scraper/pricing).\n\n
Zen Studio · Marketplace Data
\"\"  TikTok Shop
You are here		\"\"  1688
Wholesale products		\"\"  Shopee
Products & stock		\"\"  Alibaba
Products & suppliers		\"\"  RedNote
Product reviews
\n\n### Copy to your AI assistant\n\n```text\nHelp me use zen-studio/tiktok-shop-review-scraper on Apify. Read https://apify.com/zen-studio/tiktok-shop-review-scraper.md for documentation, input schema, pricing and limits. Choose settings for my requested outcome. If you cannot retrieve the page, ask me to paste the relevant sections. To reach the maintainers, add feedback=\"\" to any run, including one that worked: feature requests, a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note.\n```\n\n## How to scrape TikTok Shop reviews\n\nzen-studio/tiktok-shop-review-scraper on Apify returns one row per TikTok Shop buyer review (rating, text, posted_at ISO 8601, images, variant, verified_purchase, incentivized, country) across 16 marketplaces. Input precedence is productUrls > productIds > searchKeyword; set region to the product's marketplace (default US) or the run finds nothing. Omit maxReviewsPerProduct to collect accessible reviews up to the 500-page ceiling (roughly 5000 before deduplication). For product title, price, sold_count, shop data and the 1-5 rating_breakdown, set includeProductSummary=true and includeRatingBreakdown=true; those enrichments are United States only and the summary row carries no review charge, only the dataset-item fee. reviewsFilter and reviewsSort apply only to the reviews a run collects, not the product's whole history, so rare filters can return fewer rows than requested. Charges: $0.005 per run start plus each unique review delivered, duplicates removed before billing. Full spec: https://api.apify.com/v2/actors/zen-studio~tiktok-shop-review-scraper/builds/default and current pricing: https://apify.com/zen-studio/tiktok-shop-review-scraper\n\nGive the actor a product URL. Everything else is optional.\n\n```json\n{\n \"productUrls\": [\"https://shop.tiktok.com/view/product/1731849567724278088\"],\n \"maxReviewsPerProduct\": 20,\n \"includeRatingBreakdown\": true\n}\n```\n\nYou can also scrape by product ID, or let the actor find products for you:\n\n```json\n{\n \"searchKeyword\": \"wireless earbuds\",\n \"maxProductsFromSearch\": 5,\n \"maxReviewsPerProduct\": 50,\n \"region\": \"MY\"\n}\n```\n\n### Input options\n\n| Parameter | Type | Default | Meaning |\n|---|---|---|---|\n| `productUrls` | array | none | Product pages to collect reviews from. Wins over the other two inputs. |\n| `productIds` | array | none | Numeric product IDs. Used when no URLs are given. |\n| `searchKeyword` | string | none | Finds products by keyword. Used when no URLs or IDs are given. |\n| `maxProductsFromSearch` | integer | 5 | How many matching products to collect reviews for. |\n| `region` | string | `US` | Which of the 16 marketplaces the products belong to. |\n| `maxReviewsPerProduct` | integer | no user-set limit | Leave empty to collect accessible reviews up to the 500-page collection ceiling. |\n| `reviewsFilter` | string | `all` | Keep only 5/4/3/2/1-star reviews, reviews with photos, or verified purchases. |\n| `reviewsSort` | string | `recommended` | Recommended, most recent, highest or lowest rating. |\n| `includeProductSummary` | boolean | `true` | Adds the per-product row and fills product titles into review rows. |\n| `includeRatingBreakdown` | boolean | `false` | Adds the 1-5 star distribution to that summary row. |\n\nProduct URLs work in any of their shapes: `shop.tiktok.com/view/product/`, `tiktok.com/shop/pdp//` or a bare product ID.\n\n## What data can you extract from TikTok Shop?\n\nOne row per review, plus one optional summary row per product.\n\n**Review rows** carry the rating, the full review text, an ISO 8601 date, the reviewer's display name and avatar, whether it was a verified purchase, whether it was incentivized, every review photo, the exact variant bought, and the reviewer's country.\n\n```json\n{\n \"type\": \"review\",\n \"review_id\": \"7574564812835915575\",\n \"product_id\": \"1731849567724278088\",\n \"product_name\": \"JBL Vibe Beam 2, True Wireless Noise Cancelling Earbuds\",\n \"region\": \"US\",\n \"rating\": 5,\n \"text\": \"Probably one of the best types of wireless earbuds, long battery life, very high sound quality, noise cancellation works perfectly, 10/10\",\n \"posted_at\": \"2025-11-19T22:20:43.013000+00:00\",\n \"reviewer_name\": \"i**a\",\n \"reviewer_id\": null,\n \"reviewer_avatar_url\": null,\n \"verified_purchase\": true,\n \"incentivized\": false,\n \"images\": [\"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/8ad45cd1...\"],\n \"image_count\": 1,\n \"variant\": \"Item: Black\",\n \"country\": \"US\",\n \"product_url\": \"https://shop.tiktok.com/view/product/1731849567724278088\"\n}\n```\n\n**Product summary row** (one per product, no review charge):\n\n```json\n{\n \"type\": \"product\",\n \"product_id\": \"1731849567724278088\",\n \"product_name\": \"JBL Vibe Beam 2, True Wireless Noise Cancelling Earbuds\",\n \"region\": \"US\",\n \"rating_average\": 4.5,\n \"review_count\": 1673,\n \"reviews_collected\": 20,\n \"price\": \"$77.94\",\n \"price_amount\": 77.94,\n \"price_currency\": \"USD\",\n \"sold_count\": 13667,\n \"shop_name\": \"JBL\",\n \"shop_rating\": \"4.7\",\n \"shop_followers\": 487311,\n \"rating_breakdown\": { \"1\": 100, \"2\": 28, \"3\": 69, \"4\": 138, \"5\": 1338 },\n \"product_url\": \"https://shop.tiktok.com/view/product/1731849567724278088\"\n}\n```\n\nTikTok anonymises reviewer names (`i**a`), and some reviews carry no reviewer ID or avatar, so those fields can be `null`. Export to JSON to keep `images` and `rating_breakdown` nested; CSV and Excel flatten them.\n\nProduct details, price, shop data and the star breakdown are available for the **United States** marketplace. In other marketplaces, collected reviews still include rating, text, date and available photos, variant and flags.\n\n## Integrations and scheduling\n\nConnect results to n8n or other Apify integrations. Schedule daily runs to keep reviews up to date.\n\n## Pricing\n\n| Event | When charged | Price |\n|---|---|---|\n| Actor start | Once per run | $0.005 |\n| Review | Each unique review written to the dataset | from $0.79 per 1,000 |\n| Dataset item | Each row written, including the product summary row | $0.01 per 1,000 |\n\nReviews are $1.99 per 1,000 on the free plan and drop by plan, down to $0.79 per 1,000. **Duplicate reviews are removed before you are charged**, so you never pay twice for the same review. The product summary row carries no review charge, only the $0.01-per-1,000 dataset-item fee.\n\nFree pays $1.99 per 1,000 reviews, Bronze $1.49, Silver $0.99, and Gold and above $0.79.\n\nA run collecting 1,000 reviews costs about $0.80 to $2.00 depending on your plan, plus $0.01 in dataset items and the $0.005 start.\n\n## FAQ\n\n**Can I get every review for a product?**\nLeave `maxReviewsPerProduct` empty to collect accessible reviews until the source ends or the 500-page collection ceiling is reached. That is roughly 5,000 reviews before duplicates are removed, so larger review histories may be incomplete.\n\n**Which marketplaces are supported?**\nSixteen: US, GB, DE, FR, IT, ES, IE, BR, MX, JP, ID, MY, PH, SG, TH and VN. Reviews come back in the language buyers wrote them in.\n\n**Why did a filtered run return fewer reviews than I asked for?**\nFiltering happens across the reviews the run reads, and rare filters (1-star, for example, is often under 10% of a product's reviews) can exhaust the page budget before finding enough matches. You are only charged for the reviews you actually receive.\n\n**Does \"most recent\" sort the product's whole history?**\nNo. Sorting applies to the reviews the run collects, not to every review the product has ever received.\n\n**Is the star breakdown always returned?**\nIt is an optional extra for US products. When it cannot be read the summary row simply omits it, and the review rows are unaffected.\n\n**Do I need a TikTok account or cookies?**\nNo. No login, no cookies, no browser setup.\n\n**What happens if one product ID is wrong?**\nThat product is skipped with a warning and the rest of the run continues. You are not charged for it.\n\n**Is there a free tier?**\nFree-plan users get 5 runs and up to 50 reviews to try the actor before upgrading.\n\n## Related\n\n- [TikTok Shop Product Scraper](https://apify.com/zen-studio/tiktok-shop-product-scraper)\n finds the products, prices and sellers whose reviews you read here.\n- [TikTok Lookalike Search](https://apify.com/zen-studio/tiktok-lookalike-search)\n finds creators similar to the ones you name, with bio emails and TikTok Shop signals, for affiliate outreach.\n\n## Support\n\nReport issues or request features on the **Issues** tab of this actor. Use the collected data responsibly and in line with applicable law and TikTok's terms.\n", "gitCommitId": "0f8dc40dfbacd3dce7482193f0e79ec5a1300933", "gitBranchName": "main", "actorDefinition": { "actorSpecification": 1, "name": "tiktok-shop-review-scraper", "title": "TikTok Shop Review Scraper - All 16 Marketplaces", "description": "Extract every buyer review from any TikTok Shop product: star rating, full text, date, photos, the variant bought and verified-purchase flags. Works across all 16 marketplaces, not just the US, and adds a free product summary with price, shop data and the 1-5 star breakdown.", "version": "0.1", "meta": { "templateId": "python-empty" }, "input": { "title": "TikTok Shop Review Scraper", "type": "object", "schemaVersion": 1, "properties": { "productUrls": { "title": "Product URLs", "type": "array", "description": "TikTok Shop product pages to collect reviews from. Takes precedence over Product IDs and Search keyword.", "editor": "stringList", "prefill": [ "https://shop.tiktok.com/view/product/1731849567724278088" ], "maxItems": 500, "sectionCaption": "Products", "sectionDescription": "Give product URLs, product IDs, or a search keyword. If you give more than one, URLs are used first, then IDs, then the keyword." }, "productIds": { "title": "Product IDs", "type": "array", "description": "Numeric product IDs, if you already have them. Used when no Product URLs are given.", "editor": "stringList", "maxItems": 500 }, "searchKeyword": { "title": "Search keyword", "type": "string", "description": "Find products by keyword and collect reviews for the matches. Used only when no Product URLs or Product IDs are given.", "editor": "textfield" }, "maxProductsFromSearch": { "title": "Max products from search", "type": "integer", "description": "How many matching products to collect reviews for. Only used when you scrape by search keyword.", "prefill": 5, "minimum": 1, "maximum": 100 }, "region": { "title": "Marketplace", "type": "string", "description": "Which TikTok Shop marketplace the products belong to. Reviews are written in that market's language.", "editor": "select", "enum": [ "US", "GB", "DE", "FR", "IT", "ES", "IE", "BR", "MX", "JP", "ID", "MY", "PH", "SG", "TH", "VN" ], "enumTitles": [ "United States", "United Kingdom", "Germany", "France", "Italy", "Spain", "Ireland", "Brazil", "Mexico", "Japan", "Indonesia", "Malaysia", "Philippines", "Singapore", "Thailand", "Vietnam" ], "prefill": "US", "sectionCaption": "Marketplace and limits" }, "maxReviewsPerProduct": { "title": "Max reviews per product", "type": "integer", "description": "Upper limit of reviews collected per product. Leave empty to collect every review available. You are charged per review returned, so this is also your cost control.", "prefill": 100, "minimum": 1 }, "reviewsFilter": { "title": "Only include", "type": "string", "description": "Keep only reviews matching this condition. Filtered runs scan more pages to find matches and may return fewer reviews than the maximum.", "editor": "select", "enum": [ "all", "5_star", "4_star", "3_star", "2_star", "1_star", "with_images", "verified" ], "enumTitles": [ "All reviews", "5 stars only", "4 stars only", "3 stars only", "2 stars only", "1 star only", "With photos or video", "Verified purchases only" ], "prefill": "all", "sectionCaption": "Filter and order" }, "reviewsSort": { "title": "Sort reviews by", "type": "string", "description": "Order of the collected reviews. Sorting is applied to the reviews this run collects, not to the product's entire review history.", "editor": "select", "enum": [ "recommended", "most_recent", "highest_rating", "lowest_rating" ], "enumTitles": [ "Recommended", "Most recent first", "Highest rating first", "Lowest rating first" ], "prefill": "recommended" }, "includeProductSummary": { "title": "Include product summary row", "type": "boolean", "description": "Adds one free row per product with its title, price, average rating, total review count and shop details, and fills the product title in on every review row. Product and shop details are available for the United States marketplace.", "default": true, "sectionCaption": "Extras" }, "includeRatingBreakdown": { "title": "Include star breakdown", "type": "boolean", "description": "Adds the full 1-5 star distribution to the product summary row. Adds a few seconds per product and is skipped silently if unavailable.", "default": false }, "feedback": { "title": "Feedback to the maintainers", "type": "string", "editor": "hidden", "description": "For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns." } }, "required": [] }, "output": { "actorOutputSchemaVersion": 1, "title": "TikTok Shop reviews", "description": "One dataset row per buyer review: star rating, review text, date, reviewer, verified-purchase and incentivized flags, photos and the variant bought, plus an optional summary row per product with its average rating and review count.", "properties": { "results": { "type": "string", "title": "Reviews", "description": "Dataset of collected product reviews.", "template": "{{links.apiDefaultDatasetUrl}}/items" } } }, "storages": { "dataset": { "actorSpecification": 1, "fields": {}, "views": { "overview": { "title": "Reviews", "transformation": { "fields": [ "rating", "text", "posted_at", "reviewer_name", "verified_purchase", "incentivized", "images", "image_count", "variant", "country", "product_name", "product_id", "region", "review_id", "reviewer_id", "reviewer_avatar_url", "product_url", "type" ] }, "display": { "component": "table", "properties": { "rating": { "label": "Rating", "format": "number" }, "text": { "label": "Review", "format": "text" }, "posted_at": { "label": "Date", "format": "text" }, "reviewer_name": { "label": "Reviewer", "format": "text" }, "verified_purchase": { "label": "Verified purchase", "format": "boolean" }, "incentivized": { "label": "Incentivized", "format": "boolean" }, "images": { "label": "Photos", "format": "array" }, "variant": { "label": "Variant", "format": "text" }, "country": { "label": "Country", "format": "text" }, "product_name": { "label": "Product", "format": "text" }, "product_id": { "label": "Product ID", "format": "text" }, "review_id": { "label": "Review ID", "format": "text" }, "product_url": { "label": "Product URL", "format": "link" }, "image_count": { "label": "Photo count", "format": "number" }, "region": { "label": "Marketplace", "format": "text" }, "reviewer_id": { "label": "Reviewer ID", "format": "text" }, "reviewer_avatar_url": { "label": "Reviewer avatar", "format": "link" }, "type": { "label": "Row type", "format": "text" } } } }, "products": { "title": "Product summary", "transformation": { "fields": [ "product_name", "rating_average", "review_count", "reviews_collected", "rating_breakdown", "price", "price_amount", "price_currency", "sold_count", "shop_name", "shop_rating", "shop_followers", "region", "product_id", "product_url", "type" ] }, "display": { "component": "table", "properties": { "product_name": { "label": "Product", "format": "text" }, "rating_average": { "label": "Average rating", "format": "number" }, "review_count": { "label": "Total reviews", "format": "number" }, "reviews_collected": { "label": "Collected", "format": "number" }, "rating_breakdown": { "label": "Star breakdown", "format": "object" }, "region": { "label": "Marketplace", "format": "text" }, "product_id": { "label": "Product ID", "format": "text" }, "product_url": { "label": "Product URL", "format": "link" }, "price": { "label": "Price", "format": "text" }, "sold_count": { "label": "Units sold", "format": "number" }, "shop_name": { "label": "Shop", "format": "text" }, "shop_rating": { "label": "Shop rating", "format": "text" }, "shop_followers": { "label": "Shop followers", "format": "number" }, "type": { "label": "Row type", "format": "text" }, "price_amount": { "label": "Price (number)", "format": "number" }, "price_currency": { "label": "Currency", "format": "text" } } } } } } }, "dockerfile": "../Dockerfile", "dockerContextDir": "..", "maxMemoryMbytes": 1024, "pricingModel": { "pricingType": "PAY_PER_EVENT", "events": [ { "name": "apify-actor-start", "pricePerEvent": 0.005 }, { "name": "review-scraped", "pricePerEvent": 0.00199 }, { "name": "apify-default-dataset-item", "pricePerEvent": 0.00001 } ] }, "readme": "[![TikTok Shop reviews. 16 markets. Buyer photos. Exact variants. Verified purchases.](https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/tiktok-shop-review-scraper-hero-5cb6adc6fedc.png)](https://console.apify.com/actors/PsVmeHsn8748GeSDv/input)\n\nFrom **Zen Studio**, creators of [1688 Wholesale](https://apify.com/zen-studio/1688-wholesale-scraper), ranked #1 for “1688” in Apify Store search, alongside dedicated [Shopee](https://apify.com/zen-studio/shopee-product-scraper) and [Alibaba](https://apify.com/zen-studio/alibaba-scraper) actors.\n\n## Why choose this actor?\n\n**Buyer feedback across 16 markets.** Collect TikTok Shop reviews from the US, UK, Europe, Latin America and Asia using the same output format. Select the product’s marketplace and export its reviews in their original language, with duplicates removed before billing.\n\n**Know exactly what the buyer reviewed.** Keep the purchased variant, buyer photos and verified-purchase flag alongside full review text, star rating and date. Compare feedback by color or model and inspect customer photos alongside written reviews. Photos and variant details are included when available.\n\n**Start with a product or a keyword.** Paste product links or IDs, or enter a keyword to discover products and collect their reviews. For US products, optionally add product and shop details plus the 1–5-star rating breakdown when available, in a separate summary row.\n\n\"Collect\n\n## Try a product\n\nCollect 20 reviews from a US product, with its product summary and optional star breakdown:\n\n```json\n{\n \"productUrls\": [\n \"https://shop.tiktok.com/view/product/1731849567724278088\"\n ],\n \"region\": \"US\",\n \"maxReviewsPerProduct\": 20,\n \"includeProductSummary\": true,\n \"includeRatingBreakdown\": true\n}\n```\n\n[Open actor input](https://console.apify.com/actors/PsVmeHsn8748GeSDv/input), replace the product link and choose the matching marketplace. Export JSON, CSV or Excel; JSON preserves photo arrays and the rating breakdown. Reviews are billed per unique review delivered. The summary has no review charge; normal dataset-item charges apply.\n\nCollection currently stops after 500 review pages per product, roughly 5,000 reviews before duplicates are removed. A lower review limit controls the size of your trial. Product/shop details and the optional star breakdown are US-only; the breakdown may be unavailable. See [pricing](https://apify.com/zen-studio/tiktok-shop-review-scraper/pricing).\n\n
Zen Studio · Marketplace Data
\"\"  TikTok Shop
You are here		\"\"  1688
Wholesale products		\"\"  Shopee
Products & stock		\"\"  Alibaba
Products & suppliers		\"\"  RedNote
Product reviews
\n\n### Copy to your AI assistant\n\n```text\nHelp me use zen-studio/tiktok-shop-review-scraper on Apify. Read https://apify.com/zen-studio/tiktok-shop-review-scraper.md for documentation, input schema, pricing and limits. Choose settings for my requested outcome. If you cannot retrieve the page, ask me to paste the relevant sections. To reach the maintainers, add feedback=\"\" to any run, including one that worked: feature requests, a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note.\n```\n\n## How to scrape TikTok Shop reviews\n\nzen-studio/tiktok-shop-review-scraper on Apify returns one row per TikTok Shop buyer review (rating, text, posted_at ISO 8601, images, variant, verified_purchase, incentivized, country) across 16 marketplaces. Input precedence is productUrls > productIds > searchKeyword; set region to the product's marketplace (default US) or the run finds nothing. Omit maxReviewsPerProduct to collect accessible reviews up to the 500-page ceiling (roughly 5000 before deduplication). For product title, price, sold_count, shop data and the 1-5 rating_breakdown, set includeProductSummary=true and includeRatingBreakdown=true; those enrichments are United States only and the summary row carries no review charge, only the dataset-item fee. reviewsFilter and reviewsSort apply only to the reviews a run collects, not the product's whole history, so rare filters can return fewer rows than requested. Charges: $0.005 per run start plus each unique review delivered, duplicates removed before billing. Full spec: https://api.apify.com/v2/actors/zen-studio~tiktok-shop-review-scraper/builds/default and current pricing: https://apify.com/zen-studio/tiktok-shop-review-scraper\n\nGive the actor a product URL. Everything else is optional.\n\n```json\n{\n \"productUrls\": [\"https://shop.tiktok.com/view/product/1731849567724278088\"],\n \"maxReviewsPerProduct\": 20,\n \"includeRatingBreakdown\": true\n}\n```\n\nYou can also scrape by product ID, or let the actor find products for you:\n\n```json\n{\n \"searchKeyword\": \"wireless earbuds\",\n \"maxProductsFromSearch\": 5,\n \"maxReviewsPerProduct\": 50,\n \"region\": \"MY\"\n}\n```\n\n### Input options\n\n| Parameter | Type | Default | Meaning |\n|---|---|---|---|\n| `productUrls` | array | none | Product pages to collect reviews from. Wins over the other two inputs. |\n| `productIds` | array | none | Numeric product IDs. Used when no URLs are given. |\n| `searchKeyword` | string | none | Finds products by keyword. Used when no URLs or IDs are given. |\n| `maxProductsFromSearch` | integer | 5 | How many matching products to collect reviews for. |\n| `region` | string | `US` | Which of the 16 marketplaces the products belong to. |\n| `maxReviewsPerProduct` | integer | no user-set limit | Leave empty to collect accessible reviews up to the 500-page collection ceiling. |\n| `reviewsFilter` | string | `all` | Keep only 5/4/3/2/1-star reviews, reviews with photos, or verified purchases. |\n| `reviewsSort` | string | `recommended` | Recommended, most recent, highest or lowest rating. |\n| `includeProductSummary` | boolean | `true` | Adds the per-product row and fills product titles into review rows. |\n| `includeRatingBreakdown` | boolean | `false` | Adds the 1-5 star distribution to that summary row. |\n\nProduct URLs work in any of their shapes: `shop.tiktok.com/view/product/`, `tiktok.com/shop/pdp//` or a bare product ID.\n\n## What data can you extract from TikTok Shop?\n\nOne row per review, plus one optional summary row per product.\n\n**Review rows** carry the rating, the full review text, an ISO 8601 date, the reviewer's display name and avatar, whether it was a verified purchase, whether it was incentivized, every review photo, the exact variant bought, and the reviewer's country.\n\n```json\n{\n \"type\": \"review\",\n \"review_id\": \"7574564812835915575\",\n \"product_id\": \"1731849567724278088\",\n \"product_name\": \"JBL Vibe Beam 2, True Wireless Noise Cancelling Earbuds\",\n \"region\": \"US\",\n \"rating\": 5,\n \"text\": \"Probably one of the best types of wireless earbuds, long battery life, very high sound quality, noise cancellation works perfectly, 10/10\",\n \"posted_at\": \"2025-11-19T22:20:43.013000+00:00\",\n \"reviewer_name\": \"i**a\",\n \"reviewer_id\": null,\n \"reviewer_avatar_url\": null,\n \"verified_purchase\": true,\n \"incentivized\": false,\n \"images\": [\"https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/8ad45cd1...\"],\n \"image_count\": 1,\n \"variant\": \"Item: Black\",\n \"country\": \"US\",\n \"product_url\": \"https://shop.tiktok.com/view/product/1731849567724278088\"\n}\n```\n\n**Product summary row** (one per product, no review charge):\n\n```json\n{\n \"type\": \"product\",\n \"product_id\": \"1731849567724278088\",\n \"product_name\": \"JBL Vibe Beam 2, True Wireless Noise Cancelling Earbuds\",\n \"region\": \"US\",\n \"rating_average\": 4.5,\n \"review_count\": 1673,\n \"reviews_collected\": 20,\n \"price\": \"$77.94\",\n \"price_amount\": 77.94,\n \"price_currency\": \"USD\",\n \"sold_count\": 13667,\n \"shop_name\": \"JBL\",\n \"shop_rating\": \"4.7\",\n \"shop_followers\": 487311,\n \"rating_breakdown\": { \"1\": 100, \"2\": 28, \"3\": 69, \"4\": 138, \"5\": 1338 },\n \"product_url\": \"https://shop.tiktok.com/view/product/1731849567724278088\"\n}\n```\n\nTikTok anonymises reviewer names (`i**a`), and some reviews carry no reviewer ID or avatar, so those fields can be `null`. Export to JSON to keep `images` and `rating_breakdown` nested; CSV and Excel flatten them.\n\nProduct details, price, shop data and the star breakdown are available for the **United States** marketplace. In other marketplaces, collected reviews still include rating, text, date and available photos, variant and flags.\n\n## Integrations and scheduling\n\nConnect results to n8n or other Apify integrations. Schedule daily runs to keep reviews up to date.\n\n## Pricing\n\n| Event | When charged | Price |\n|---|---|---|\n| Actor start | Once per run | $0.005 |\n| Review | Each unique review written to the dataset | from $0.79 per 1,000 |\n| Dataset item | Each row written, including the product summary row | $0.01 per 1,000 |\n\nReviews are $1.99 per 1,000 on the free plan and drop by plan, down to $0.79 per 1,000. **Duplicate reviews are removed before you are charged**, so you never pay twice for the same review. The product summary row carries no review charge, only the $0.01-per-1,000 dataset-item fee.\n\nFree pays $1.99 per 1,000 reviews, Bronze $1.49, Silver $0.99, and Gold and above $0.79.\n\nA run collecting 1,000 reviews costs about $0.80 to $2.00 depending on your plan, plus $0.01 in dataset items and the $0.005 start.\n\n## FAQ\n\n**Can I get every review for a product?**\nLeave `maxReviewsPerProduct` empty to collect accessible reviews until the source ends or the 500-page collection ceiling is reached. That is roughly 5,000 reviews before duplicates are removed, so larger review histories may be incomplete.\n\n**Which marketplaces are supported?**\nSixteen: US, GB, DE, FR, IT, ES, IE, BR, MX, JP, ID, MY, PH, SG, TH and VN. Reviews come back in the language buyers wrote them in.\n\n**Why did a filtered run return fewer reviews than I asked for?**\nFiltering happens across the reviews the run reads, and rare filters (1-star, for example, is often under 10% of a product's reviews) can exhaust the page budget before finding enough matches. You are only charged for the reviews you actually receive.\n\n**Does \"most recent\" sort the product's whole history?**\nNo. Sorting applies to the reviews the run collects, not to every review the product has ever received.\n\n**Is the star breakdown always returned?**\nIt is an optional extra for US products. When it cannot be read the summary row simply omits it, and the review rows are unaffected.\n\n**Do I need a TikTok account or cookies?**\nNo. No login, no cookies, no browser setup.\n\n**What happens if one product ID is wrong?**\nThat product is skipped with a warning and the rest of the run continues. You are not charged for it.\n\n**Is there a free tier?**\nFree-plan users get 5 runs and up to 50 reviews to try the actor before upgrading.\n\n## Related\n\n- [TikTok Shop Product Scraper](https://apify.com/zen-studio/tiktok-shop-product-scraper)\n finds the products, prices and sellers whose reviews you read here.\n- [TikTok Lookalike Search](https://apify.com/zen-studio/tiktok-lookalike-search)\n finds creators similar to the ones you name, with bio emails and TikTok Shop signals, for affiliate outreach.\n\n## Support\n\nReport issues or request features on the **Issues** tab of this actor. Use the collected data responsibly and in line with applicable law and TikTok's terms.\n" }, "buildNumber": "0.0.19", "imageDigest": "9dfccda14eb3ae2f21e5da138f351d8ae97675e64bace5ee91acee5865f71402", "actVersion": { "sourceType": "GIT_REPO", "buildTag": "latest", "versionNumber": "0.0" }, "usage": { "ACTOR_COMPUTE_UNITS": 0.004653333333333333 } } }