Taobao Tmall Product Scraper
Pricing
from $10.00 / 1,000 search results
Scrape Taobao and Tmall into clean structured datasets — product details, keyword search, shop catalogs, customer reviews and buyer Q&A. Five operations in one actor, one clean dataset per run. No account, no API key, no setup.
🎯 PICK ONE OPERATION PER RUN. Each run produces one clean dataset matching the chosen mode.
Product Detail cannot return an item: coverage differs, so a product one source cannot serve often resolves on the other. Returns a compact flat row — price, CNY price, stock, per-SKU variants, images, description, brand and tags. ⚠️ It returns a different field set from Product Detail (only itemId and title are shared) — filter on _operation. Billed at the same per-result rate as Product Detail.💡 TIP: To combine operations, run the actor multiple times with different configurations.
🛍️ Required for Product Detail, Product Detail — Alternate Source, Product Reviews, and Product Q&A operations.
The numeric Taobao/Tmall item ID. You can find it:
id= (e.g. https://item.taobao.com/item.htm?id=744983869996 → 744983869996)itemId field of any search or shop-catalog result row💡 TIP: For bulk product lookups, run the actor once per item ID, or use Keyword Search / Shop Catalog to build the list first.
⚠️ Ignored for Keyword Search and Shop Catalog operations.
🛍️ Applies to Product Detail only. Controls which detail profile is used. They differ in field set, depth and speed — pick deliberately:
detail_url, delist_time, video, location).finalPriceYuan, finalSkuPrice, original-vs-final per SKU, stock). Best when accurate checkout pricing is the priority.🔄 Automatic fallback: the profiles cover slightly different products, so if the one you pick cannot return an item the actor automatically tries the others and returns whichever answers. The profile that answers decides the raw field names — they differ a lot. Build your pipeline on the curated fields — itemId, title, pictUrls, totalStock, soldCount, originalPrice, discountPrice, recordTime — which are identical across every profile. The 💎 Premium profile is never substituted in or out: ask for it and you get it, or you get an error row.
💡 Freshness: every profile except the retired Lite one returns live, non-cached data stamped with recordTime — check that field on each row to verify capture time.
💬 Applies to Product Reviews operation only.
feedbackdate (default) — sort by review dategeneral — sort by general relevance🔍 Required for Keyword Search operation.
Any Taobao / Tmall search query. Supports Chinese, English, and mixed queries:
iphone 15无线耳机 (wireless earphones)sony camera a7running shoes men💡 TIP: More specific queries return higher-quality results. Use Tmall only + price range to filter to brand merchants.
💰 Minimum price in Chinese Yuan (integer). Leave blank for no minimum. Applies to Keyword Search only.
💰 Maximum price in Chinese Yuan (integer). Leave blank for no maximum. Applies to Keyword Search only.
🏬 When enabled, search results are restricted to Tmall (brand / official stores). Default: false (searches both Taobao and Tmall).
🏪 Required for Shop Catalog operation.
The numeric userId (aka seller ID) of the Taobao / Tmall shop. You can find it:
userId field of any search or detail result row💡 TIP: For a brand's full catalog, first run a Keyword Search for the brand name, note the top userId, then run Shop Catalog with that ID.
🏪 Required when Catalog mode is extended or latest. Ignored for standard.
The numeric shop ID (distinct from the seller user ID). You can find it in the shopId field of any detail or search result row.
💡 TIP: Run a Product Detail or Keyword Search first to discover the shopId for a given seller.
📦 Applies to Shop Catalog only.
userId, 2 sort options, ~30 items/pageshopId + userId, 5 sort options (price, hot, new arrivals), 60 items/pageshopId + userId; pulls from the newest catalog endpoint. ~10 items/page (smaller pages than Extended), returns totalResults for full pagination.💡 TIP: Use Extended for the most items per call (60/page = fewer API calls). Use Latest when you specifically want the newest-endpoint listing; note it returns fewer items per page.
📊 Sort order for search or shop catalog results.
Keyword Search options:
_sale (Sales, default)_bid (Price high→low)bid (Price low→high)_coefp (General)Shop Catalog (standard) options: _sale (default), _default
Shop Catalog (extended/latest) options: coefp (Comprehensive, default), hotsell, oldstarts (New arrivals), bid (Price low→high), _bid (Price high→low)
📄 Applies to paginated operations (Keyword Search, Shop Catalog, Product Reviews). Ignored for Product Detail.
💡 TIP: Start small (1–3 pages) to preview results before scaling up.
⚠️ Hard cap: 50 pages to prevent runaway runs.