# 🛒 TikTok Shop Scraper - Products, Reviews, Creators (No Login) (`unseenuser/tiktok-shop-scraper`) Actor Spy on viral TikTok Shop products: search, full catalogs, reviews, creator showcases. Built for dropshippers and e-commerce arbitrage. - **URL**: https://apify.com/unseenuser/tiktok-shop-scraper.md - **Developed by:** [Unseen User](https://apify.com/unseenuser) (community) - **Categories:** E-commerce, Social media, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing $6.50 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 🛒 TikTok Shop Scraper — Products, Reviews, Creators (5-in-1, No Login) > Spy on viral TikTok Shop products: search, full catalogs, reviews, creator showcases. Built for dropshippers and e-commerce arbitrage. TikTok Shop is the fastest-growing e-commerce platform of 2025–2026 — and it is still mostly opaque. This Actor exposes it: search products by keyword, pull full catalogs from any shop, harvest reviews, and see which creators promote which products. Built for dropshippers, arbitrage operators, and brand-protection teams. --- ### ⚡ Why This Actor? - **5 modes in 1 Actor** — product search, shop catalog, product details, reviews, creator showcase - **All TikTok Shop regions** — US, UK, ID, MY, PH, SG, VN, TH (plus more limited regions) - **Review intelligence** — counts, ratings, full review text where available - **Creator-product mapping** — find which creators promote which products - **Trending product discovery** — early signal on what is going viral on TikTok Shop - **Pay-per-result pricing** --- ### 🎯 Use Cases - **Dropshipping research** — find trending TikTok Shop products before they saturate - **Brand protection** — identify unauthorized resellers of your products - **Competitor catalog audit** — track competitor catalogs and pricing over time - **Affiliate marketing** — identify high-converting products for your network - **Product validation** — analyze review sentiment before launching your own SKU - **Influencer-product matching** — see which creators are pushing which SKUs - **Brand expansion intelligence** — map a niche before entering it --- ### 🔑 Setup — Required Environment Variable Before running, set your **Scrape Creators** API key as an environment variable on the Actor: 1. Open the Actor in **Apify Console** → **Settings** → **Environment variables** 2. Add: | Key | Value | Mark as Secret | |-----|-------|---------------| | `SCRAPECREATORS_API_KEY` | your API key from [scrapecreators.com](https://scrapecreators.com) | ✅ Yes | That's the only configuration the Actor needs. It will fail-fast with a clear error if the key is missing. --- ### 🚀 Quick Start #### 1. Shop Search ```json { "mode": "shop_search", "searchQueries": ["led face mask", "magnetic eyelashes"], "region": "US", "maxResults": 50 } ```` #### 2. Shop Catalog ```json { "mode": "shop_catalog", "shopUrls": [ "https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079" ], "region": "US", "maxResults": 200 } ``` #### 3. Product Details ```json { "mode": "product_details", "productUrls": [ "https://www.tiktok.com/shop/pdp/classic-clogs-by-crocs/1730213444857467838" ], "region": "US", "getRelatedVideos": true } ``` #### 4. Product Reviews ```json { "mode": "product_reviews", "productUrls": [ "https://www.tiktok.com/shop/pdp/classic-clogs-by-crocs/1730213444857467838" ], "maxReviewsPerProduct": 100 } ``` #### 5. Creator Showcase ```json { "mode": "creator_showcase", "usernames": ["mrbeast", "alixearle"], "maxResults": 50 } ``` *** ### ⚙️ Modes | Mode | Purpose | |------|---------| | `shop_search` | Find products by keyword | | `shop_catalog` | List all products from a TikTok Shop store | | `product_details` | Get full product PDP data | | `product_reviews` | Get reviews for products | | `creator_showcase` | Products a creator promotes | *** ### 💰 Pricing (Pay Per Event) | Event | Cost | |-------|------| | Shop search result | $0.001 | | Shop catalog product | $0.0015 | | Product details fetched | $0.003 | | Product review | $0.001 | | Showcase product | $0.0015 | **Bulk cost examples:** - Trending product hunt (200 products): **$0.20** - Competitor shop audit (200 products + 100 reviews each): **$10.30** - Creator-product mapping (100 creators × 20 products): **$3.00** - Full product validation (50 products × 100 reviews each): **$5.00** *** ### 📤 Output Schemas The Actor ships with a **dataset schema** that gives the Apify Console four pre-built table views you can switch between with one click: | View | When to use it | |------|----------------| | 🛒 **Overview** | Default cross-mode view — works for any row type | | 📦 **Products** | `shop_search`, `shop_catalog`, `product_details` rows | | ⭐ **Reviews** | `product_reviews` rows | | 🎬 **Creator Showcase** | `creator_showcase` rows | Each row is enriched with derived fields so you don't have to compute them downstream. #### Product row (`shop_search`, `shop_catalog`, `product_details`) ```json { "productId": "1730213444857467838", "productUrl": "https://www.tiktok.com/shop/pdp/.../1730213444857467838", "title": "Crocs Adult Classic Clogs", "description": "Iconic comfort clog…", "brand": "Crocs", "shopId": "7495832567110863806", "shopName": "Crocs", "shopUrl": "https://www.tiktok.com/@crocs", "price": 49.99, "originalPrice": 59.99, "currency": "USD", "currencySymbol": "$", "priceDisplay": "$49.99", "discountPercent": "-17%", "discountAmount": 10.00, "rating": 4.8, "ratingStars": "★★★★★", "reviewCount": 2493, "soldCount": 24737, "primaryImage": "https://p16-oec-…/1.jpg", "images": ["https://p16-oec-…/1.jpg", "https://p16-oec-…/2.jpg"], "imageCount": 2, "variants": [ { "id": "1730213454432146366", "name": "Color: Black", "price": null, "stock": null }, { "id": "1730213454432146367", "name": "Size: 10", "price": null, "stock": null } ], "variantCount": 2, "shippingInfo": null, "category": "Shoes / Clogs", "tags": [], "isAvailable": true, "isFreeShipping": null, "relatedVideos": [ { "videoId": "7527142083258305822", "playCount": 324944, "likeCount": 1812, "uploadedAt": "1752549352", "title": "These crocs are 🔥", "coverImage": "https://…", "videoUrl": "https://…" } ], "region": "US", "sourceMode": "shop_search", "sourceQuery": "clogs", "scrapedAt": "2026-05-05T12:00:00.000Z" } ``` > `relatedVideos` is only populated in `product_details` mode when **Include related affiliate videos** is enabled. #### Review row (`product_reviews`) ```json { "reviewId": "rev_abc123", "productId": "1730213444857467838", "productUrl": "https://www.tiktok.com/shop/pdp/.../1730213444857467838", "reviewerName": "JohnD", "reviewerAvatar": "https://…/avatar.jpg", "rating": 5, "ratingStars": "★★★★★", "text": "Loved them, fits perfectly.", "images": ["https://…/review1.jpg"], "imageCount": 1, "hasVideo": false, "helpfulCount": 12, "postedAt": "2024-11-03", "variant": "Color: Black / Size: 10", "verifiedPurchase": true, "sourceMode": "product_reviews", "scrapedAt": "2026-05-05T12:00:00.000Z" } ``` #### Showcase row (`creator_showcase`) ```json { "username": "alixearle", "productId": "1729587769570529799", "productUrl": "https://www.tiktok.com/shop/pdp/.../1729587769570529799", "productTitle": "Rare Beauty Soft Pinch Liquid Blush", "productPrice": "$24.99", "productCurrency": "USD", "productImage": "https://…/blush.jpg", "shopId": "7495832567110863806", "shopName": "Rare Beauty", "commissionRate": "15%", "sourceMode": "creator_showcase", "scrapedAt": "2026-05-05T12:00:00.000Z" } ``` #### Derived fields cheat-sheet | Field | Computed how | Why useful | |-------|--------------|-----------| | `priceDisplay` | `currencySymbol + price.toFixed(2)` | Drop straight into reports / dashboards | | `ratingStars` | `★★★★☆` glyphs from `rating` | Instant visual in CSV exports | | `discountAmount` | `originalPrice − price` | Sort by absolute savings | | `imageCount` / `variantCount` | `array.length` | Filter for richer listings | | `primaryImage` | `images[0]` | One column for thumbnail in tables | *** ### 🗂️ Storage Schemas The Actor publishes three Apify storage schemas so the Console UI presents your data cleanly: - **Dataset schema** (`.actor/dataset_schema.json`) — defines the four table views above (Overview / Products / Reviews / Creator Showcase) with column labels, formats (image, link, number, date), and field ordering. - **Key-value store schema** (`.actor/key_value_store_schema.json`) — partitions the KV store into collections via key prefixes: - `INPUT` — your run's input - `RUN_SUMMARY` — written at end-of-run with totals + credits remaining - `ERROR_…` — one record per failure for post-mortems - `DEBUG_…` — raw payloads (only when `Include raw API response` is on) - **Live-view OpenAPI schema** (`.actor/web_server_openapi.json`) — describes three endpoints exposed by the Actor while it's running: - `GET /` — auto-refreshing HTML dashboard with current progress - `GET /health` — process liveness + uptime - `GET /progress` — JSON snapshot (mode, region, items pushed, errors, credits remaining) Visit the live-view URL from the Apify Console while a run is in progress to watch it work in real time. *** ### 🛠️ Technical Details - **API Provider:** [Scrape Creators](https://scrapecreators.com) - **Endpoints used:** 5 TikTok Shop endpoints - `GET /v1/tiktok/shop/search` - `GET /v1/tiktok/shop/products` - `GET /v1/tiktok/product` - `GET /v1/tiktok/shop/product/reviews` - `GET /v1/tiktok/user/showcase` - **Auth:** `x-api-key` header → environment variable `SCRAPECREATORS_API_KEY` - **Concurrency:** configurable (default 3) with `p-queue` - **Retries:** exponential backoff on 429 / 5xx - **Pagination:** cursor-based for catalog/reviews/showcase, page-based for search *** ### ❓ FAQ **Q: Which regions does this support?** A: Active TikTok Shop markets: US, UK, Indonesia, Malaysia, Philippines, Singapore, Vietnam, Thailand. Limited: Mexico, Brazil, Japan, Ireland, and several EU countries (DE, FR, IT, ES). Not available in most of the EU and India. **Q: Are reviews real or fake?** A: We return what TikTok Shop displays. Fake-review detection is your responsibility. **Q: Is this affiliated with TikTok?** A: No. This Actor is independently published and is not endorsed, sponsored, or authorized by TikTok or ByteDance. **Q: Why does TikTok Shop matter for e-commerce in 2026?** A: TikTok Shop combines content, virality, and checkout in one app. Its discovery loop (creator → video → product page → checkout) compresses the funnel that Amazon, Shopify, and Meta have to spread across multiple destinations. As of 2026 it is one of the largest social-commerce platforms outside China. **Q: What about TikTok's terms of service for scraping?** A: TikTok aggressively blocks scraping. The underlying provider (Scrape Creators) handles infrastructure, proxies, and detection avoidance. You are responsible for ensuring your downstream use of the data complies with TikTok Shop's terms in your jurisdiction. See the Master ToS below. **Q: What are the rate limits?** A: Practical concurrency is 3–10 parallel requests. The Actor will automatically back off on 429/5xx responses. **Q: Can I run multiple modes in one run?** A: No. Each Actor run uses one mode. Chain runs together via Apify integrations or schedule them separately. **Q: Why is there no login option?** A: We do not log into TikTok or any user account. All data is publicly visible content surfaced via Scrape Creators' infrastructure. No credentials are required. **Q: Do I need my own Scrape Creators API key?** A: Yes. Set `SCRAPECREATORS_API_KEY` as an environment variable on the Actor in Apify Console. The Actor will not run without it. *** ### 🔗 Cross-Links Pair this Actor with the **TikTok Creator Intelligence Suite** to find creators with high engagement, then check their showcase via this Actor's `creator_showcase` mode to see what products they're promoting. *** ## 📜 Apify Actor — Terms of Service **Version:** 4.0 **Effective Date:** May 5, 2026 *** ### 0. ACCEPTANCE BY USE — IMPORTANT **Read this section first.** These Terms of Service ("**Terms**") form a binding legal agreement between you ("**User**," "**you**," "**your**") and **UnseenUser**, the Publisher of this Apify actor ("**UnseenUser**," "**the Publisher**," "**we**," "**us**," "**our**"). #### 0.1 How You Accept These Terms You accept these Terms by any of the following actions, each of which constitutes a clear, affirmative act of acceptance: - **(a) Running the Actor** — Initiating any execution of the Actor on the Apify platform - **(b) Using any output returned by the Actor** for any purpose - **(c) Continuing to access the Actor's listing or documentation** after these Terms are visible #### 0.2 Continuing Acceptance Each time you run the Actor or use its outputs, you reaffirm your acceptance of the then-current Terms. If you do not agree to these Terms or any subsequent update, you must stop using the Actor immediately. #### 0.3 No Anonymous Acceptance You cannot disclaim acceptance by: - Failing to read these Terms before running the Actor - Running the Actor through automated systems - Sharing your Apify account with others who may not have read these Terms By the act of running the Actor on Apify, you bind yourself, your organization (if applicable), and any individuals or systems acting on your behalf or under your authority. #### 0.4 If You Do Not Accept If you do not agree to these Terms, **you must not run the Actor**. No use is authorized without acceptance. *** ### PREAMBLE — UNDERSTANDING THE ARCHITECTURE Before using the Actor, please understand the technical architecture of the service: #### The Data Flow ``` You (User) → Apify Platform → Actor (software) → Third-Party API → Source Platform ↓ You (User) ← Apify Platform ← Actor (software) ← Third-Party API ``` #### What Each Party Does - **You (the User):** Run the Actor on the Apify platform with input parameters you choose. - **Apify:** Operates the cloud infrastructure that hosts and executes Actors. Apify is a Czech-incorporated company (Apify Technologies s.r.o.) governed by its own Terms of Service. - **The Publisher (us):** Publishes software code (the Actor) on Apify's platform. The Actor is a thin wrapper that translates your input into requests to a third-party API and returns the API's responses to you. The Publisher does not operate scraping infrastructure. The Publisher does not store or retain data returned by the Actor. The Publisher does not see, log, or process the personal data of any individuals returned in the Actor's outputs beyond what is incidental to passing the data through. - **Third-Party API Provider:** HarvestAPI (https://harvest-api.com) or Scrape Creators (https://scrapecreators.com). These are independent third-party companies that operate scraping infrastructure and return data from source platforms. - **Source Platform:** LinkedIn, TikTok, YouTube, Reddit, Linktree, etc. These are the platforms whose publicly visible data is accessed by the Third-Party API Providers. #### Why This Matters Your relationship with the Publisher is that of a software user to a software vendor. The Publisher has the responsibilities of a software vendor (functional code, accurate documentation) and the limits of one (the Publisher is not responsible for how you use the data you obtain). These Terms operate alongside but do not replace: - Apify's Terms of Service and Acceptable Use Policy (governing your relationship with Apify) - HarvestAPI Terms of Service and Scrape Creators Terms of Service (governing the underlying data infrastructure) - Source Platform terms (LinkedIn, TikTok, etc.) governing the public data accessed - Applicable law in your jurisdiction and the jurisdictions of data subjects These Terms incorporate the actor-specific addendum published in each Actor's individual listing ("**Addendum**"). In the event of a conflict, the more restrictive provision applies. *** ### 1. NATURE OF THE SERVICE #### 1.1 What the Actor Is The Actor is a software program published on the Apify platform. Each Actor: - (a) Accepts structured input from you on the Apify platform - (b) Translates that input into HTTP requests to a third-party API operated by HarvestAPI or Scrape Creators - (c) Receives HTTP responses from that third-party API - (d) Returns the response data to you in a structured format on the Apify platform The Actor's source code is hosted on Apify's infrastructure. The Actor runs in Apify's cloud, not on the Publisher's servers. The Publisher operates no servers running the Actor. #### 1.2 What the Actor Is Not The Actor is **not**: - (a) A scraping tool — the Publisher does not operate scraping infrastructure, proxies, headless browsers, or fake accounts - (b) A direct connection to any source platform — connections to source platforms are made by HarvestAPI / Scrape Creators - (c) A data storage or data retention service — the Publisher does not maintain a database of any data the Actor returns - (d) A licensed access channel to LinkedIn, TikTok, YouTube, Reddit, X (Twitter), Meta, Linktree, or any other source platform - (e) Affiliated with, endorsed by, sponsored by, or authorized by any source platform #### 1.3 The Publisher's Limited Role The Publisher's role is limited to: - (a) Designing and writing the Actor's source code - (b) Publishing the Actor on the Apify Store - (c) Maintaining the Actor (updating it when API providers change schemas) - (d) Providing documentation and customer support via Apify's contact mechanism The Publisher is a software vendor, similar to a developer who publishes an app on the Apple App Store or Google Play Store. The Publisher is **not** a data provider, data broker, data processor, or data controller for purposes of GDPR, CCPA, Israel's Privacy Protection Law, or equivalent. #### 1.4 The Third-Party API Providers' Role HarvestAPI (https://harvest-api.com) and Scrape Creators (https://scrapecreators.com) are independent third-party companies. They: - (a) Operate the actual data scraping infrastructure - (b) Maintain relationships with source platforms (or accept the operational risk of accessing public data without such relationships) - (c) Are themselves Apify publishers (HarvestAPI publishes 9+ actors directly; Scrape Creators publishes 10+) - (d) Provide their own Terms of Service governing their operations - (e) Are responsible for compliance obligations relating to the data collection itself The Publisher is a customer of these providers. The Publisher is not their agent, partner, or representative. *** ### 2. WHO MAY USE THE ACTOR #### 2.1 Eligibility You may use the Actor only if: - (a) You are at least 18 years old or the age of majority in your jurisdiction - (b) You have legal capacity to enter into binding contracts - (c) You are not located in or resident of a country subject to comprehensive sanctions by the United States, European Union, United Kingdom, or Israel - (d) You are not on any prohibited persons list #### 2.2 User Representations By using any Actor, you represent and warrant that: - (a) **Truthful identity:** Information you provide about your identity and intended use is accurate - (b) **Lawful intent:** Your intended use complies with applicable law in your jurisdiction - (c) **Source platform compliance:** You will independently comply with the Terms of Service of any source platform whose data you obtain through the Actor - (d) **Data subject rights:** Where Actor outputs include personal data, you will respect data subject rights under applicable law - (e) **No prohibited use:** You will not use the Actor for any of the purposes prohibited in Section 4 These representations are continuous — they must remain true throughout your use. *** ### 3. PERMITTED USES The Actor may be used for any lawful purpose, including: - Market research and competitive analysis - Academic research - Journalism and investigative reporting - Internal business intelligence - Brand monitoring - Recruitment research where consistent with applicable employment law - Building products that further process publicly available information lawfully Specific permitted uses for each Actor are described in that Actor's individual listing and Addendum. *** ### 4. PROHIBITED USES You may not use the Actor for any of the following: #### 4.1 Illegal Activity Activity illegal under the law of your jurisdiction, the User's jurisdiction, or the jurisdiction of any data subjects. #### 4.2 Harassment, Stalking, and Personal Targeting - Compiling profiles for harassment, stalking, or doxxing - Tracking individuals' movements or activities without their knowledge - Building profiles of journalists, activists, dissidents, or vulnerable populations for retaliatory purposes #### 4.3 Discrimination - Using outputs for discriminatory employment, lending, housing, or insurance decisions based on protected characteristics - Building lists for discriminatory purposes #### 4.4 Spam and Unsolicited Commercial Communication - Sending unsolicited marketing in violation of CAN-SPAM, CASL, GDPR, PECR, Israeli Anti-Spam Law (סעיף 30א לחוק התקשורת), or equivalent laws - Building "lead lists" from scraped contacts without proper consent infrastructure - Reselling contact data for spam purposes #### 4.5 Fraud and Deception - Identity theft or impersonation - Generation of fake reviews, testimonials, or coordinated inauthentic behavior - Election interference or political disinformation - Securities fraud #### 4.6 Source Platform Abuse - Using outputs to circumvent technical protection measures of source platforms - Creating fake accounts on source platforms based on Actor outputs - Vote manipulation, engagement manipulation, or platform algorithm gaming - Building services that competitively substitute for source platforms #### 4.7 Reselling the Actor's Service - Reselling raw Actor outputs as your own data product or scraping-as-a-service - Sharing your Apify credentials to provide third parties indirect access - Building competing API services using Actor outputs #### 4.8 AI Training Without Authorization - Using Actor outputs as training data for commercial AI/ML models without separate licensing authority from the source platform #### 4.9 Sensitive Targeting - Specifically targeting or profiling based on health conditions, sexual orientation, religious beliefs, political opinions, or other sensitive characteristics - Targeting children under 16 (or local age of consent for data processing) #### 4.10 Privacy Law Violations - Processing personal data of EU/UK/California/Israeli residents without complying with applicable privacy law - Failing to honor data subject access, deletion, or objection requests - Processing data for purposes incompatible with its publication context *** ### 5. SOURCE PLATFORM TERMS — YOUR RESPONSIBILITY #### 5.1 Acknowledgment The Actor accesses publicly visible data on third-party platforms ("**Source Platforms**") through the Third-Party API Providers (HarvestAPI / Scrape Creators). Source Platforms include LinkedIn, TikTok, YouTube, Reddit, X (Twitter), Meta/Facebook, Linktree, Komi, Pillar, Linkbio, Linkme, and Amazon. #### 5.2 Your Sole Responsibility You acknowledge: - (a) You are solely responsible for ensuring your downstream use of data obtained through the Actor complies with the Source Platform's Terms of Service - (b) The Publisher makes no representation that any specific use is permitted under any Source Platform's terms - (c) The Third-Party API Providers, not the Publisher, bear responsibility for the lawfulness of the data collection itself - (d) You should review Source Platform terms before commercial use: - LinkedIn: https://www.linkedin.com/legal/user-agreement - TikTok: https://www.tiktok.com/legal/page/global/terms-of-service/en - YouTube: https://www.youtube.com/static?template=terms - X: https://twitter.com/en/tos - Reddit: https://www.redditinc.com/policies/user-agreement - Meta: https://www.facebook.com/legal/terms - Linktree: https://linktr.ee/s/terms/ #### 5.3 Cease-and-Desist Compliance If you receive a cease-and-desist letter or other legal demand from a Source Platform regarding your use of Actor outputs, you must: - (a) Cease the contested use immediately - (b) Notify UnseenUser within 48 hours via UnseenUser's Apify profile contact form (https://apify.com/UnseenUser) - (c) Cooperate with the Publisher as needed to mitigate - (d) Not assert against the Publisher any claim arising from your inability to use the Actor for that Source Platform *** ### 6. DATA PROTECTION — REFLECTING ACTUAL ARCHITECTURE #### 6.1 Roles Under Privacy Law For purposes of GDPR, UK GDPR, CCPA, Israel's Privacy Protection Law (PPL) including Amendment 13, and equivalents: - **You (the User)** are the **Data Controller** of any personal data you obtain through the Actor and subsequently process for your own purposes - **HarvestAPI and Scrape Creators** are the entities that collect data from source platforms — they bear the responsibilities of data processors or controllers (depending on context) for the collection itself - **The Publisher** acts solely as a software vendor, not as a data controller or processor, because the Publisher does not store, retain, or substantively process personal data — the Actor merely passes API responses through #### 6.2 No Data Retention by the Publisher The Publisher confirms: - (a) The Publisher does not maintain a database of personal data obtained through the Actor - (b) The Actor passes data from the Third-Party API directly to you on the Apify platform — data does not flow through the Publisher's infrastructure - (c) Apify's standard execution and operational logging may include limited information about Actor runs (input parameters, run duration, data volume) — this is governed by Apify's own privacy practices - (d) The Publisher does not access, view, or analyze your Actor outputs except as needed for technical support if you specifically share them with the Publisher #### 6.3 Your Obligations as Data Controller Where your use of the Actor involves processing personal data, you are responsible for: - (a) Establishing a lawful basis for your processing (consent, legitimate interest with documented balancing test, contract, etc.) - (b) Providing transparent notice to data subjects as required by applicable law - (c) Honoring data subject access, rectification, erasure, restriction, and portability requests - (d) Implementing appropriate security measures - (e) Conducting Data Protection Impact Assessments where required - (f) Appointing a Data Protection Officer if your operations require one - (g) Registering databases with applicable supervisory authorities - (h) Honoring opt-out requests for direct marketing - (i) Cross-border transfer safeguards where data crosses borders #### 6.4 Israel's Amendment 13 — User Compliance If your use of the Actor involves Israeli residents' personal data, you must comply with the Privacy Protection Law as amended (Amendment 13, effective August 14, 2025). These obligations are yours as the data controller, not the Publisher's as the software vendor. #### 6.5 Sensitive Data Targeting Restrictions You will not use the Actor to specifically target, profile, or build datasets focused on: - Health or medical conditions - Religious beliefs - Political opinions - Sexual orientation or gender identity - Genetic or biometric data - Criminal history - Children under 16 *** ### 7. INTELLECTUAL PROPERTY #### 7.1 Actor Code The Actor's source code, schemas, documentation, and branding are owned by the Publisher. You receive a limited, non-exclusive, non-transferable, revocable license to use the Actor for permitted purposes during your active subscription/run with Apify. #### 7.2 Output Data The Publisher claims no ownership over the public data the Actor returns. Source Platforms may have copyright, database rights, or other rights in their data; data subjects may have copyright in user-generated content. Your use of output data must respect these rights independently. #### 7.3 Restrictions You may not reverse engineer, decompile, or reuse the Actor's code in a competing actor. #### 7.4 Feedback Feedback you provide may be used by the Publisher to improve products without compensation to you. *** ### 8. PRICING AND PAYMENT #### 8.1 Apify Platform Billing Pricing is administered through Apify's pricing models. Apify processes all payments. Apify's payment terms govern refunds and disputes. #### 8.2 Pricing Changes The Publisher may change Actor pricing with at least 14 days' notice via the Actor's Apify listing. #### 8.3 No Refunds for Misuse If your access is suspended or terminated for breach of these Terms, you forfeit any unused balance and are not entitled to refunds. *** ### 9. SERVICE AVAILABILITY AND CHANGES #### 9.1 No Uptime Guarantee The Actor depends on: - (a) The Apify platform - (b) Underlying API providers (HarvestAPI, Scrape Creators) - (c) Source Platforms' continued public accessibility Any of these may change behavior, restrict access, or become unavailable without notice. The Publisher makes no uptime guarantees. #### 9.2 Service Discontinuation The Publisher may discontinue any Actor at any time. Reasonable notice will be provided when feasible. *** ### 10. DISCLAIMERS #### 10.1 "AS IS" Service THE ACTOR IS PROVIDED "AS IS" AND "AS AVAILABLE" WITHOUT WARRANTIES OF ANY KIND, INCLUDING WARRANTIES OF MERCHANTABILITY, FITNESS FOR PURPOSE, NON-INFRINGEMENT, OR ACCURACY OF DATA. #### 10.2 No Representation of Lawfulness The Publisher makes no representation that your specific use of the Actor or the data it returns is lawful in your jurisdiction or under any Source Platform's terms. The burden of determining lawfulness for your use case is yours. #### 10.3 No Endorsement of Source Content Content returned by the Actor was created by third parties. The Publisher does not endorse, verify, or take responsibility for it. *** ### 11. LIMITATION OF LIABILITY #### 11.1 Aggregate Liability Cap TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL THE AGGREGATE LIABILITY OF THE PUBLISHER FOR ALL CLAIMS RELATING TO THE ACTOR EXCEED THE GREATER OF: - (a) ONE HUNDRED U.S. DOLLARS (US $100), OR - (b) THE AMOUNTS YOU PAID THROUGH APIFY FOR USE OF THE ACTOR IN THE THREE (3) MONTHS IMMEDIATELY PRECEDING THE EVENT #### 11.2 Excluded Damages THE PUBLISHER IS NOT LIABLE FOR INDIRECT, INCIDENTAL, SPECIAL, CONSEQUENTIAL, EXEMPLARY, OR PUNITIVE DAMAGES, OR FOR LOSS OF PROFITS, REVENUE, OR DATA, EVEN IF ADVISED OF THE POSSIBILITY. #### 11.3 Time Limit Any claim must be brought within one (1) year of the event. *** ### 12. INDEMNIFICATION #### 12.1 Your Indemnification of the Publisher You agree to defend, indemnify, and hold harmless the Publisher from any: - Claims arising from your use of the Actor - Claims arising from your violation of these Terms - Claims arising from your violation of any law (including privacy law) - Claims arising from your violation of any Source Platform's Terms of Service - Claims arising from your processing of personal data obtained through the Actor - Reasonable attorneys' fees and costs of defending such claims #### 12.2 Defense The Publisher may assume defense at your expense. You will cooperate with the Publisher's defense. #### 12.3 Scope The indemnification covers reasonable, foreseeable third-party claims arising from your use. It does not extend to: - Claims arising from the Publisher's gross negligence or willful misconduct - Claims regarding the Actor's source code itself (those are the Publisher's responsibility) - Claims regarding the Third-Party API Provider's data collection (those are their responsibility) *** ### 13. SUSPENSION AND TERMINATION #### 13.1 Termination by the Publisher The Publisher may terminate your access for material breach, illegal use, breach of warranty, or upon credible legal demand. #### 13.2 Effects of Termination Your license ends, you must cease use, and applicable provisions survive. #### 13.3 Termination by You You may stop using the Actor at any time on Apify. *** ### 14. DISPUTE RESOLUTION #### 14.1 Informal Resolution First Send a detailed written description of the dispute via UnseenUser's Apify profile contact form (https://apify.com/UnseenUser) and wait 60 days for resolution attempt before any formal claim. #### 14.2 Governing Law These Terms are governed by the substantive laws of the State of Israel, without regard to conflict of law principles. #### 14.3 Exclusive Jurisdiction Any dispute shall be brought exclusively in the competent civil courts of Tel Aviv-Jaffa, Israel. #### 14.4 No Class Actions You agree to bring claims only in your individual capacity. #### 14.5 Attorneys' Fees The prevailing party recovers reasonable attorneys' fees. *** ### 15. MISCELLANEOUS #### 15.1 Entire Agreement These Terms (with Addendum and incorporated documents) are the entire agreement. #### 15.2 Severability Unenforceable provisions are reformed to the minimum extent or severed. #### 15.3 Assignment You may not assign without the Publisher's consent. The Publisher may assign to affiliates, successors, or acquirers. #### 15.4 Force Majeure Neither party is liable for failure due to events beyond reasonable control, including changes by Source Platforms or Third-Party API Providers, or actions by Apify. #### 15.5 Third-Party Beneficiaries Apify, HarvestAPI, and Scrape Creators are intended third-party beneficiaries of Sections 4 (Prohibited Uses), 5 (Source Platform Compliance), and 12 (Indemnification). #### 15.6 Survival Sections 0 (Acceptance), 4, 5, 6, 7, 10, 11, 12, 14, and 15 survive termination. #### 15.7 Language English controls. Translations are for convenience only. #### 15.8 Publisher Identification for Legal Process The Publisher operates on the Apify platform under the username **UnseenUser** (apify.com/UnseenUser). The Publisher is a registered legal entity. Upon receipt of valid legal process (subpoena, court order, or equivalent) directed through Apify's official channels, the Publisher's full legal identity may be disclosed as required by law. This Section ensures that you have a valid path to legal recourse if needed. *** ### 16. ACKNOWLEDGMENT By using any Actor, you acknowledge that: - (a) You have read these Terms - (b) You understand the architecture: you are using software (the Actor) on Apify's platform that calls third-party APIs - (c) You accept responsibility for your use, including for compliance with Source Platform terms - (d) Your indemnification obligations cover third-party claims arising from your use - (e) Disputes are resolved in Israeli courts - (f) The Publisher's identity, while not publicly disclosed in this listing, can be obtained through valid legal process via Apify For questions, use UnseenUser's Apify profile contact form (https://apify.com/UnseenUser) before running the Actor. *** *These Terms reflect best practices for anonymous Apify actor publishing as of May 2026. Not a substitute for legal advice. Consult qualified Israeli commercial counsel before deploying.* *** ## 🛡️ Actor-Specific ToS Addendum — TikTok Shop Scraper This addendum supplements the Master Terms of Service V4.0. By running this Actor, you accept both the Master ToS and this addendum. #### A. Architectural Disclosure This Actor is a software wrapper. It accepts your input parameters, calls Scrape Creators' TikTok Shop endpoints, and returns the response data to you on the Apify platform. The Publisher does not store, log, or substantively process the data returned. #### B. Nature of Data Returned Product data (listings, prices, descriptions, images, variants), shop data (seller info, ratings), reviews (with reviewer names/handles), and creator showcase data. Reviewer names/handles and creator handles constitute personal data. #### C. Permitted Use Cases E-commerce competitive intelligence, product trend identification and dropshipping research, affiliate marketing research, brand monitoring (find unauthorized resellers), market research on the TikTok Shop ecosystem. #### D. Specifically Prohibited Uses In addition to Master ToS Section 4 prohibitions, you may **NOT**: - Use product data with intent to create counterfeit listings - Generate fake reviews based on patterns observed in real reviews - Mass-clone listings for trademark or design infringement - Harvest reviewer data for marketing without compliant consent - Stalk or harass individual reviewers based on their reviews - Build dropshipping operations that violate TikTok Shop seller terms #### E. TikTok Shop Platform ToS Considerations TikTok Shop is region-locked and operates under separate seller agreements per region. This Actor accesses publicly visible data via Scrape Creators. Brand-protection enforcement is active on TikTok Shop. If TikTok issues a cease-and-desist, notify the Publisher within 48 hours. #### F. Reviews and Reviewer Data Reviews are copyrighted by their authors. You **may** aggregate review sentiment for analysis (typically fair use). You may **NOT**: - Republish full reviews with reviewer attribution outside their original context - Identify and contact reviewers for paid review schemes - Organize review-bombing #### G. Pricing and Availability Data Product prices and availability change frequently. Data is point-in-time accurate only. Do not represent scraped pricing as authoritative or current. # Actor input Schema ## `mode` (type: `string`): Pick one mode. Only the input list that matches your mode is required — others are ignored. ## `searchQueries` (type: `array`): One keyword per line. Examples: "led face mask", "magnetic eyelashes", "home gadgets". ## `shopUrls` (type: `array`): Full store URL like https://www.tiktok.com/shop/store//. Find it on the TikTok app: tap a product → tap the shop name → copy the link. ## `productUrls` (type: `array`): Full product detail page URL like https://www.tiktok.com/shop/pdp//. Right-click any TikTok Shop product and copy the link. ## `usernames` (type: `array`): TikTok handles, one per line. Either "alixearle" or "@alixearle" works. ## `region` (type: `string`): ISO country code. Active TikTok Shop markets are highlighted; others may return empty results. ## `maxResults` (type: `integer`): Hard cap per query / shop / creator. For 5 keywords × 100 results, you'd get up to 500 rows. ## `maxReviewsPerProduct` (type: `integer`): Only used in Product Reviews mode. Most products have under 1,000 reviews. ## `getRelatedVideos` (type: `boolean`): Adds the affiliate videos promoting this product to the output. Slower (~2× per product). ## `includeRaw` (type: `boolean`): Adds a `raw` field with the original Scrape Creators payload. Useful for debugging; bloats dataset size. ## `concurrency` (type: `integer`): Lower = safer (avoid 429). Higher = faster. ## Actor input object example ```json { "mode": "shop_search", "searchQueries": [ "led face mask" ], "shopUrls": [ "https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079" ], "productUrls": [ "https://www.tiktok.com/shop/pdp/classic-clogs-by-crocs/1730213444857467838" ], "usernames": [ "alixearle" ], "region": "US", "maxResults": 100, "maxReviewsPerProduct": 100, "getRelatedVideos": false, "includeRaw": false, "concurrency": 3 } ``` # 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 = { "searchQueries": [ "led face mask" ], "shopUrls": [ "https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079" ], "productUrls": [ "https://www.tiktok.com/shop/pdp/classic-clogs-by-crocs/1730213444857467838" ], "usernames": [ "alixearle" ] }; // Run the Actor and wait for it to finish const run = await client.actor("unseenuser/tiktok-shop-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 = { "searchQueries": ["led face mask"], "shopUrls": ["https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079"], "productUrls": ["https://www.tiktok.com/shop/pdp/classic-clogs-by-crocs/1730213444857467838"], "usernames": ["alixearle"], } # Run the Actor and wait for it to finish run = client.actor("unseenuser/tiktok-shop-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchQueries": [ "led face mask" ], "shopUrls": [ "https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079" ], "productUrls": [ "https://www.tiktok.com/shop/pdp/classic-clogs-by-crocs/1730213444857467838" ], "usernames": [ "alixearle" ] }' | apify call unseenuser/tiktok-shop-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=unseenuser/tiktok-shop-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "🛒 TikTok Shop Scraper - Products, Reviews, Creators (No Login)", "description": "Spy on viral TikTok Shop products: search, full catalogs, reviews, creator showcases. Built for dropshippers and e-commerce arbitrage.", "version": "0.0", "x-build-id": "5oWohgTRvy5G9fSfU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unseenuser~tiktok-shop-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unseenuser-tiktok-shop-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/unseenuser~tiktok-shop-scraper/runs": { "post": { "operationId": "runs-sync-unseenuser-tiktok-shop-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/unseenuser~tiktok-shop-scraper/run-sync": { "post": { "operationId": "run-sync-unseenuser-tiktok-shop-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "mode" ], "properties": { "mode": { "title": "1️⃣ What do you want to scrape?", "enum": [ "shop_search", "shop_catalog", "product_details", "product_reviews", "creator_showcase" ], "type": "string", "description": "Pick one mode. Only the input list that matches your mode is required — others are ignored.", "default": "shop_search" }, "searchQueries": { "title": "Search keywords", "type": "array", "description": "One keyword per line. Examples: \"led face mask\", \"magnetic eyelashes\", \"home gadgets\".", "default": [], "items": { "type": "string" } }, "shopUrls": { "title": "TikTok Shop store URLs", "type": "array", "description": "Full store URL like https://www.tiktok.com/shop/store//. Find it on the TikTok app: tap a product → tap the shop name → copy the link.", "default": [], "items": { "type": "string" } }, "productUrls": { "title": "Product PDP URLs", "type": "array", "description": "Full product detail page URL like https://www.tiktok.com/shop/pdp//. Right-click any TikTok Shop product and copy the link.", "default": [], "items": { "type": "string" } }, "usernames": { "title": "TikTok usernames", "type": "array", "description": "TikTok handles, one per line. Either \"alixearle\" or \"@alixearle\" works.", "default": [], "items": { "type": "string" } }, "region": { "title": "TikTok Shop region", "enum": [ "US", "GB", "ID", "MY", "PH", "SG", "VN", "TH", "DE", "FR", "IT", "ES", "IE", "MX", "BR", "JP" ], "type": "string", "description": "ISO country code. Active TikTok Shop markets are highlighted; others may return empty results.", "default": "US" }, "maxResults": { "title": "Max results per input", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard cap per query / shop / creator. For 5 keywords × 100 results, you'd get up to 500 rows.", "default": 100 }, "maxReviewsPerProduct": { "title": "Max reviews per product (Reviews mode only)", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Only used in Product Reviews mode. Most products have under 1,000 reviews.", "default": 100 }, "getRelatedVideos": { "title": "Include related affiliate videos (Product Details mode only)", "type": "boolean", "description": "Adds the affiliate videos promoting this product to the output. Slower (~2× per product).", "default": false }, "includeRaw": { "title": "Include raw API response", "type": "boolean", "description": "Adds a `raw` field with the original Scrape Creators payload. Useful for debugging; bloats dataset size.", "default": false }, "concurrency": { "title": "Parallel API requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "Lower = safer (avoid 429). Higher = faster.", "default": 3 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```