Keywords to search on the TikTok Shop storefront. Each term is read straight from TikTok Shop's own search API as structured data (price, rating, sold count, seller, variants) — no browser, no scrolling, no CAPTCHA — and yields every matching product up to Max Results.
Examples: wireless earbuds, silk pillowcase, kbeauty serum
Region support: every supported storefront. The storefront follows your proxy's exit country, so set Region to match it. TikTok's search feed typically ends after 50–200 products per keyword.
", "items": { "type": "string" } }, "product_urls": { "title": "Product URLs", "type": "array", "description": "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" } }, "category_urls": { "title": "Category URLs", "type": "array", "description": "Category browse-page URLs. Each yields every product in that category — pulled straight from TikTok Shop's own product API as structured data (price, rating, sold count, seller, variants), so no scrolling and no page-scraping.
URL pattern: https://shop.tiktok.com/{region}/c/{slug}/{id} — e.g. https://shop.tiktok.com/us/c/beauty-personal-care/601450. Copy one from the storefront's category menu. The Max Results cap applies per category URL.
Works in every supported region. Set Region to match the storefront and your proxy's exit country.
", "items": { "type": "string" } }, "region": { "title": "Region", "enum": [ "US", "GB", "VN", "TH", "PH", "MY", "SG", "JP", "MX", "BR" ], "type": "string", "description": "TikTok Shop storefront — United States, United Kingdom, Vietnam, Thailand, Philippines, Malaysia, Singapore, Japan, Mexico or Brazil — 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 category URL (or per Product URL, where it always equals 1). Search and category results are paged from TikTok Shop's product API.
Default 100. Hard cap 1000 — TikTok's search feed typically ends after 50–200 products per keyword 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 }, "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
http://user:pass@host:port — works with any provider that issues URLs (BrightData, Oxylabs, SmartProxy, your own). Leave empty for any other Proxy provider.",
"items": {
"type": "string"
}
},
"proxy": {
"title": "Proxy Configuration",
"type": "object",
"description": "Managed by the actor. Proxy is bundled — the scraper runs on its own residential proxy (DataImpulse, with Apify residential fallback), aligned to the selected Region. No proxy configuration is needed. Advanced users may override via the API with a raw_urls / provider proxy object.