# Changelog of TikTok Shop Scraper (`sian.agency/tiktok-shop-scraper`) Actor - **URL**: https://apify.com/sian.agency/tiktok-shop-scraper/changelog.md - **Full Actor documentation**: https://apify.com/sian.agency/tiktok-shop-scraper.md ## Changelog All notable changes to **TikTok Shop Scraper** will be documented in this file. ### \[2026-08-26] #### ๐ŸŒ United Kingdom and Indonesia removed from the region list - **Those two markets could not return data, so they are no longer selectable.** Checked on 2026-08-26 against three different keywords each, twice over: the United Kingdom failed on every request, and Indonesia answered every request with an empty product list. Indonesia was the more misleading of the two โ€” an empty list looks like "no results for your search" rather than "this market has no data", so a run could finish, look fine, and deliver nothing. - **A run that still asks for them now stops immediately with a clear message**, and is not charged for results. It is not silently switched to another market: US products are not an acceptable answer to a question about Indonesia. - **The other six markets are unaffected** โ€” US, Singapore, Malaysia, Philippines, Thailand and Vietnam all return search results and product detail with correct local currency. - Both markets will be restored as soon as data is available again. ### \[2026-08-24] #### ๐Ÿ“„ A Run Report Worth Opening - **Copy-ready product IDs** โ€” every search now hands back the product IDs it found in one copy-paste panel, so you can feed them straight into a Product Detail sweep without touching the dataset. - **Product preview table** โ€” titles, prices, sellers, ratings and sold counts on the report page itself, so you can see whether a keyword worked before you export anything. - **Itemized cost statement** โ€” exactly what this run charged you, line by line, so TikTok Shop scraping costs stop being a monthly surprise. - **Retry advice on failures** โ€” anything that did not come back gets a one-click retry input and a plain-English reason. Failed rows are never charged. - **Ready-made API call and AI-agent config** โ€” the report ships the exact API request that reproduces the run, plus the MCP config that lets Claude or any AI agent run it in plain language. #### ๐ŸŽฏ Clearer Free-Plan Limits - **Tier shown at run start** โ€” the run log now opens by telling you which plan you are on and exactly what it includes, so a free run that stops at 25 products is never a mystery. - **Free plan** โ€” every operation, every field and all 8 regions, capped at 25 products per run with a daily run allowance. Paid plans lift the cap and unlock API and scheduled runs. #### ๐Ÿ’Ž User Benefits - Judge a keyword's value from the report alone, before you open the dataset or export a file. - Know the cost of a TikTok Shop product research run to the cent, every time. - Hand the report's MCP snippet to an AI agent and let it run price and trend checks for you. #### ๐ŸŽฏ Use Cases - **Dropshipper** running a keyword sweep, then pasting the copy-ready IDs straight into a Product Detail run to enrich the winners. - **E-commerce Seller** tracking what competitor price monitoring actually costs per run before scheduling it daily. - **Market Intelligence Analyst** briefing an AI agent with the report's MCP config to compare TikTok Shop pricing across all 8 regions. ### \[2026-06-20] #### ๐Ÿ›ก๏ธ Reliability - **Major reliability fix.** Transient hiccups are now retried with backoff before anything reaches your dataset โ€” resolving a stretch of failed runs and returning results far more consistently. - **Graceful gateway-error handling.** Temporary errors are retried and reported in plain English instead of surfacing as confusing parsing failures. ### \[2026-05-13] #### ๐ŸŽ‰ TikTok Shop Scraper โ€” Launch! - **Two Scrapers in One Actor** โ€” extract TikTok Shop product detail and run keyword-based product search โ€” pick the operation, paste the input, one clean dataset per run. - **Product Detail Extraction** โ€” full TikTok Shop product payload by ID: title, decoded rich-text description, SKU list with variants & stock, seller profile (rating, sold count, followers, products count, region), product rating, review count, business compliance info, image gallery (up to 9 images). - **Search Products by Keyword** โ€” paginated product discovery across TikTok Shop, returning real sale + original prices, currency, discount %, rating, sold count, seller info, and slug-based product URLs โ€” up to ~55 unique products per keyword. - **8 Regions Covered** โ€” United States, United Kingdom, Singapore, Malaysia, Philippines, Thailand, Vietnam, Indonesia. Same keyword, different markets. - **Real Prices on Search** โ€” `price`, `originalPrice`, `discountRate`, `currency`, `currencySymbol` returned unmasked on the search endpoint (the detail endpoint masks raw unit prices as an anti-scraping measure). - **BigInt-Safe 19-Digit IDs** โ€” TikTok Shop product and seller IDs are preserved at full precision (most scrapers silently corrupt them and break cross-operation joins). - **HTTPS-Normalized Media URLs** โ€” every product image and seller logo is delivered ready to embed. - **Smart Pagination + Auto-Dedup** โ€” stream search results across pages with auto-stop when the catalogue is exhausted; duplicates removed and not charged. - **Automatic Retries** โ€” transient flakes are retried with backoff before anything reaches your dataset, so a slow moment does not turn into an error row. - **Curated camelCase Aliases + Raw Fields** โ€” clean `productId` ยท `productTitle` ยท `price` ยท `sellerName` ยท `rating` ยท `soldCount` aliases for everyday users, plus all raw source fields spread alongside for power users. - **HTML Run Report** โ€” every run produces an HTML summary (success rate, errors, duration, inputs) saved to the key-value store. #### ๐Ÿ’Ž User Benefits - **Find winning SKUs in minutes** โ€” search any keyword across 8 regions and rank by `soldCount` + `discountRate` to spot trending products before the niche saturates. - **No API key, no setup, no proxies** โ€” paste a product ID, keyword, or region and run. Production-ready from the first click. - **Pay-per-result pricing** โ€” only charged for successful extractions; never billed for empty pages, errors, or deduplicated rows. - **Bulletproof data shape** โ€” flat structure with both camelCase aliases and raw fields means every downstream tool (BigQuery, Notion, Airtable, Slack) just works. - **Cross-operation joins that actually work** โ€” bigint-safe IDs let you pivot from search results โ†’ product detail โ†’ seller analysis without losing a single character of precision. - **GDPR-friendly defaults** โ€” extracts only publicly listed product data; no private user info, no email or phone scraping. #### ๐ŸŽฏ Use Cases - **Dropshipper** hunting winning SKUs across US + GB + SEA before the niche saturates โ€” runs Search Products across rotating keywords daily. - **E-commerce Seller** monitoring competitor prices and stock movement โ€” schedules Product Detail across a watchlist with Slack alerts on price drops. - **Brand Manager** mapping the seller landscape in a category โ€” runs Search Products to identify rising shops and benchmark against incumbents. - **Market Intelligence Analyst** validating regional demand before launching a SKU โ€” runs the same keyword across 8 regions to compare price bands and rating distributions. - **Affiliate Agency** building a creator-affiliate pipeline โ€” filters Search Products on `rating >= 4.5` and `soldCount >= 10000` to brief vetted products to creators. - **Trend Analyst** spotting viral SKUs before they hit Western marketplaces โ€” schedules Search Products across SEA regions to surface arbitrage candidates. - **Amazon/eBay Reseller** sourcing low-competition product ideas โ€” runs Search Products in SG/MY/TH/VN/ID to find SKUs not yet present on Western marketplaces.