Keywords to search on the TikTok Shop storefront. Each term opens https://shop.tiktok.com/us/s?q={keyword} in an anti-detect browser, scrolls to load matches, and yields every visible product card.
Examples: wireless earbuds, silk pillowcase, kbeauty serum
Region support: web keyword search currently works only on US. Other regions either 404 the search URL or redirect to non-shop surfaces — for those, use Product URLs directly. (Browse-by-category is handled by a separate actor.)
Direct product detail-page (PDP) URLs. Always returns the full detail enrichment (description, image gallery, full breadcrumb).
URL pattern: https://shop.tiktok.com/{region}/pdp/{product_id}
Use this when you already have product IDs (from a previous run, an affiliate feed, or competitor research).
", "items": { "type": "string" } }, "region": { "title": "Region", "enum": [ "US", "GB", "VN", "TH", "PH", "MY", "SG", "JP", "MX", "BR" ], "type": "string", "description": "TikTok Shop storefront for the proxy/exit IP. Must match your residential proxy's exit country — the actor probes the proxy IP and aligns the browser's locale, timezone, and geolocation automatically, but the proxy still has to land in a supported country. TikTok returns {\"code\":10000} on a mismatch.
Note: FR has no web Shop (mobile-app only); ID redirects to Tokopedia and is not supported.
Cap on products yielded per search term (or per Product URL, where it always equals 1). The scraper scrolls the SERP in batches; raising this triggers more scrolls.
Default 100. Hard cap 1000 — TikTok's SERP typically exhausts at 200–500 cards regardless of how high you set this.
", "default": 100 }, "scrape_product_details": { "title": "Scrape Product Details", "type": "boolean", "description": "For each product yielded by a search term, fetch its full detail page (description, full image gallery, complete category breadcrumb). Adds one browser fetch per product and is billed at the higher PPE rate. Already implied for Product URLs.
", "default": false }, "max_concurrency": { "title": "Max Concurrent Requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many product detail fetches run in parallel. Higher is faster but more likely to trigger rate-limiting.", "default": 3 }, "browser_endpoint": { "title": "Remote Browser Endpoint (CDP)", "type": "string", "description": "Optional WebSocket URL of a remote CDP-compatible browser (Bright Data Scraping Browser, BrowserBase, etc.). Use as a fallback if the bundled Camoufox + captcha solver still gets blocked from the Apify proxy.
Example (Bright Data): wss://brd-customer-XXX-zone-scraping_browser:PWD@brd.superproxy.io:9222
Required. TikTok Shop blocks unauthenticated traffic from many countries with a login wall. Use Apify residential proxy with US or GB (well-covered) or your own residential proxy (BrightData, Oxylabs, SmartProxy via raw_urls). Apify's VN / SEA pools are best-effort and often route via EU — which fails.