🛍️ TikTok Shop Search Scraper

Turn any TikTok Shop keyword into a clean, spreadsheet-ready table of products — price, seller, rating, sold count, images, free‑shipping signals and direct links. No browser, no login, just fast HTTP.

🟢 HTTP-only ⚡ · 🔑 Multi-keyword · 📄 Real pagination · 🌍 15 regions · 🧾 Flat CSV/Excel output

---

✨ Why this scraper

Most "search" scrapers stop at the first page — about 30 products — because TikTok Shop's HTML only ships the first batch. This actor talks to TikTok's own load‑more API to keep pulling page after page, so maxPages and maxItems actually mean something.

	🐢 First‑page‑only scrapers	🚀 This actor
Products per keyword	~30 (hard cap)	Hundreds (real pagination)
Sold count / rating	Often blank	✅ Parsed
Free‑shipping flag	Rarely detected	✅ From TikTok labels
Output shape	Nested JSON blobs	✅ Flat rows for CSV/Sheets
Browser needed	Often	❌ Never (pure HTTP)

---

🔥 What it does

• 🔎 Search one keyword or many in a single run
• 📄 Paginate for real — walks TikTok's load‑more feed, not just page 1
• 🌍 Pick a region — US, GB, ES, MX, DE, FR, JP and more
• 🧾 Extract clean product cards — title, ID, URL, image, seller, price, sold count, rating, reviews, badges
• 📈 Sort locally by relevance, best sellers, price or rating
• 🎚️ Filter by price, rating, sold count and free shipping
• 🧹 Deduplicate globally so the same product never floods your dataset
• 🧪 Log issues separately — failed pages go to an Errors dataset, never billed as products

---

🗺️ How it works

┌────────────┐     ┌─────────────────────┐     ┌──────────────────────┐
   │  keyword   │ ──▶ │  Page 1  (SSR HTML)  │ ──▶ │  Parse product cards │
   │  + region  │     │  ~30 products        │     │  price · rating ·    │
   └────────────┘     └──────────┬──────────┘     │  seller · shipping   │
                                 │                 └──────────┬───────────┘
                       has_more? │ load_more_params           │
                                 ▼                            ▼
                      ┌─────────────────────┐        ┌─────────────────┐
                      │  load-more API      │ ─loop▶ │  filter · sort  │
                      │  next 30 products   │        │  dedupe · save  │
                      └─────────────────────┘        └─────────────────┘
                        (same session, no signing)

1. Fetch page 1 via server‑side HTML with a Chrome‑like TLS fingerprint.
2. Follow load_more_params into TikTok's product_list API inside the same session — page after page — until maxPages or maxItems is reached.
3. Shape → filter → sort → dedupe → save each product as a flat row.

---

🚀 Quick start

The actor accepts the simple competitor‑style input:

{
  "country_code": "US",
  "keyword": "water bottle",
  "maxItems": 50,
  "maxPages": 3
}

…and a richer product‑research workflow:

{
  "country_code": "US",
  "keywords": ["neck fan", "phone case", "makeup organizer"],
  "maxItems": 100,
  "maxPages": 5,
  "sortBy": "best_sellers",
  "dedupe": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

💡 Pro tip: run broad keywords first (water bottle, phone case, hair dryer brush), sort by best_sellers, then re‑run the winners with price/rating filters.

---

🌍 Supported regions

US · VN · TH · PH · MY · ID · GB · SG · ES · MX · DE · IT · FR · BR · JP

For best results, match the proxy country to country_code.

---

📥 Input reference

Field	Type	Default	What it does
keywords	array	["water bottle"]	One or many search keywords.
keyword	string	—	Single keyword (simple‑input compatibility). Merged with keywords.
country_code	enum	US	TikTok Shop region.
maxItems	int	10	Max products per keyword. 0 = no per‑keyword cap.
maxPages	int	1	Max search pages to walk per keyword. Raise this to go past ~30 products.
sortBy	enum	relevance	relevance, best_sellers, price_asc, price_desc, rating_desc.
minPrice / maxPrice	number	—	Filter on normalized currentPrice.
minRating	number	0	Keep products at or above this rating.
minSoldCount	int	0	Keep products at or above this sold count.
freeShippingOnly	bool	false	Keep only products TikTok tags with free shipping.
dedupe	bool	true	Drop duplicate products across keywords and pages.
compactOutput	bool	true	Remove empty values while keeping stable columns.
includeRawProduct	bool	false	Attach the original TikTok card as rawProductJson (debugging).
maxConcurrency	int	1	Keywords processed in parallel.
requestDelayMs	int	0	Optional pause between pages of one keyword.
requestTimeoutSec	int	20	HTTP request timeout.
maxRetries	int	2	Retries on 429/5xx, captcha and parse failures.
maxProxyRetries	int	2	Dedicated retry budget for proxy/transport errors.
proxyConfiguration	object	Residential US	Apify proxy settings. Residential strongly recommended.

---

📤 Output

Every product is a flat row with type: "product_card" and status: "ok":

{
  "type": "product_card",
  "status": "ok",
  "countryCode": "US",
  "query": "water bottle",
  "page": 1,
  "searchRank": 1,
  "sortedRank": 1,
  "productId": "1731726912824578262",
  "title": "HydroPal 32oz Motivational Sports Water Bottle",
  "productUrl": "https://shop.tiktok.com/us/pdp/hydropal-32oz-water-bottle/1731726912824578262",
  "currentPrice": 8.99,
  "originalPrice": 19.98,
  "currency": "USD",
  "currencySymbol": "$",
  "soldCount": 1397,
  "soldText": "1.4K sold",
  "rating": 4.7,
  "reviewCount": 224,
  "sellerId": "7494113938193482966",
  "sellerName": "HydroPal",
  "sellerUrl": "https://www.tiktok.com/shop/s/7494113938193482966?region=US",
  "imageUrl": "https://p16-oec-general-useast5.ttcdn-us.com/...webp",
  "tags": "Free shipping",
  "freeShipping": true,
  "scrapedAt": "2026-07-11T10:36:31Z"
}

🧾 Field guide

Column	Meaning
productId · title · productUrl	Product identity and direct link
currentPrice · originalPrice · currency	Normalized pricing
soldCount · soldText	Units sold (number + human label)
rating · reviewCount	Star rating and review volume
sellerId · sellerName · sellerUrl	Seller identity and storefront
imageUrl · imageUrls	Primary image + full list
tags · freeShipping	TikTok badges and shipping signal
searchRank · sortedRank	Position in TikTok's feed vs. after your sort

📊 Ready‑made table views

The main dataset ships three table views in the Output tab:

• 🛍️ Products — identity, image, rating, seller, direct URL
• 💵 Prices & sales — current/original price, sold count, rating, reviews, shipping
• 🏪 Sellers — seller identity and the products returned for each seller

Two more outputs live outside the main dataset:

• 🧪 Errors — a separate dataset of warning/error rows (never billed as products)
• 📋 Run summary — a run_summary record in the key‑value store OUTPUT (input scope, saved count, issues, runtime)

---

🧪 Example recipes

🏆 Find best‑selling product ideas

{
  "country_code": "US",
  "keywords": ["makeup organizer", "hair dryer brush", "press on nails"],
  "maxItems": 100,
  "maxPages": 5,
  "sortBy": "best_sellers"
}

🎯 Filter by price and rating

{
  "country_code": "US",
  "keyword": "portable blender",
  "minPrice": 10,
  "maxPrice": 50,
  "minRating": 4.5,
  "maxItems": 100,
  "maxPages": 5
}

🌐 Compare regions

{
  "country_code": "GB",
  "keywords": ["neck fan", "mini printer"],
  "maxItems": 100,
  "maxPages": 5,
  "sortBy": "rating_desc"
}

---

🛡️ Reliability notes

• 🧠 HTTP‑only. No headless browser — fast and cheap.
• 🌐 Use a residential proxy. TikTok Shop can return empty data or a Security Check on datacenter traffic. Match the proxy country to country_code.
• 🐢 Start small, then scale. Begin with maxConcurrency: 1 and a few pages; increase once results look stable.
• 🐞 Raw output is for debugging only. includeRawProduct: true makes rows much larger.
• 🧾 Flat output is intentional. It keeps Apify "All fields", CSV and Google Sheets exports predictable.

---

💼 Use cases

🔬 Product research · 📈 Trend discovery · 🕵️ Competitor monitoring · 💲 Price & rating checks · 🔥 High‑volume best‑sellers · 📊 Dashboard feeds · 🌍 Marketplace analysis by country · 🛒 Dropshipping & brand scouting

---

❓ FAQ

Does it use a browser? No. HTTP requests only.

How do I get more than ~30 products? Raise maxPages (and maxItems). The actor follows TikTok's real load‑more feed, so more pages = more unique products.

Why did I get warning rows? TikTok returned an empty or limited public response for that keyword/page. Try a residential proxy, lower concurrency, or re‑run the keyword.

Why are some rating or seller fields empty? TikTok doesn't expose every value for every card. Empty fields are normal for some products and regions.

Can I scrape multiple keywords? Yes — use keywords. If keyword is also set, both are merged and deduplicated.

How do I keep exports clean? Leave compactOutput: true and includeRawProduct: false unless debugging.

---

🐛 Feature requests & issues

Need a new field, a different format, or a workflow this actor doesn't cover yet? Found a TikTok Shop response that doesn't parse? Open an issue on the actor page and include the run ID, your input, what you expected, and a short example of the data you need. Clear reports get fixed faster.

---

🏷️ Tags: tiktok shop scraper · tiktok shop search · product research · marketplace scraper · dropshipping research · best sellers · price monitoring

🔗 Built for Apify · HTTP‑only · Multi‑keyword · Real pagination · Flat product‑card output