Taobao & Tmall Seller Catalog & Shop Scraper (淘宝店铺)

🏪 Taobao & Tmall Seller Catalog & Shop Inventory Scraper — Storefront Products, 3-Axis DSR Ratings & Multi-Currency Prices (淘宝店铺商品采集)

---

[!TIP] 💰 4x Cheaper Than Competitors on Apify Store: Only $1.50 per 1,000 seller products ($0.0015/item) with a $0.00005 startup fee — compared to competitors charging $5.99 per 1,000 items plus a $0.05 start fee. If a domestic-only shop is not indexed on Taobao Global, you are charged $0.00.

---

⚠️ Honest Breakdown: What Works vs. What Does NOT Work (Read Before Running)

[!IMPORTANT] Why Domestic Taobao (shopXXXX.taobao.com / *.tmall.com) Does Not Work Cookieless:
Domestic Mainland Taobao and Tmall storefronts strictly block unauthenticated access behind mandatory account login walls and slider CAPTCHAs. Because this actor is 100% cookieless (you do not need to supply your own Chinese Taobao login cookies), it cannot scrape login-gated domestic Mainland storefronts directly.
Instead, this actor extracts seller catalogs from Taobao Global (world.taobao.com/dianpu/{shopId}.htm) — Alibaba's official public cross-border portal. Please read the exact differences below so your expectations match how this actor works:

✅ What IS Working (Cookieless via world.taobao.com/dianpu)

• Overseas-Indexed Seller Storefronts (shopUrls): Extracting storefront product listings, shopId, shopName, sellerUserId, shopLogo, shopItemCount, selling points (sellPoints), and 3-axis DSR scores (dsrDescription, dsrService, dsrDelivery) for Taobao & Tmall sellers participating in Taobao Global cross-border shipping.
• Resolving Sellers from Taobao Global Product Links: Passing a world.taobao.com/item/{itemIdStr}.htm product link (e.g. https://world.taobao.com/item/Y1QrcEVrd3JLNWVjWno4SDJBVHByZz09.htm) automatically resolves its shopId and extracts that seller's overseas catalog.
• Fast Storefront Catalog Mode (scrapeDetails: false, default — $0.0015/item): Every storefront product is returned in fast catalog mode (~1–2s per shop) with full untruncated titles, CNY/HKD/TWD prices, 3-axis DSR scores, selling points, and permanent HD cover photo.
• Full Product Detail Mode (scrapeDetails: true — $0.003/item): Enriches every storefront product with its detail page (reviewCount, ratingGoodCount, reviewTags, reviews, skus & attributes, shipping location, categoryPath, sellerCreditLevel, shopOpenedAt, and up to 15 HD gallery + description images).
• Zero-Charge Protection: Any domestic-only or unindexed shop finishes cleanly and charges $0.00.

❌ What Does NOT Work (Where Domestic Taobao Expectations Differ)

1. Domestic-Only Shops & Raw Numeric item.taobao.com Links Do NOT Work:
   • Many Mainland China sellers only ship domestically and are not indexed on world.taobao.com/dianpu/{shopId}.htm.
   • If you pass a shopXXXX.taobao.com URL or shopId for a domestic-only shop, or a raw numeric item.taobao.com/item.htm?id=... link (which world.taobao.com redirects to taglist-404 without a logged-in domestic session), the actor returns 0 products ($0.00 charged) with a diagnostic explanation in the dataset.
2. Custom Tmall Brand Subdomains (https://<brand>.tmall.com) Have Limited Coverage:
   • Custom Tmall subdomains (brand.tmall.com) do not contain the numeric shopId in the URL. Because domestic brand.tmall.com requires login to resolve, the actor attempts to match the brand handle via keyword search on world.taobao.com. This works for major indexed brands (inman, xiaomi, torras), but will NOT resolve niche, unindexed, or domestic-only Tmall subdomains. Always prefer passing a numeric shopId, shop{id}.taobao.com, world.taobao.com/dianpu/{id}.htm, or a world.taobao.com/item/{itemIdStr}.htm product URL from that seller.
3. Multi-View Catalog Expansion (Not Sequential Domestic Pagination):
   • world.taobao.com/dianpu/{shopId}.htm serves 1 page (~60 items) per view. To collect more than 60 items from a seller, the actor automatically scans across sort orders (sales-des, price-asc, price-des, credit-des, default), CNY price bands, property filters (pvids), and seller keyword views with strict deduplication.
4. Login-Gated Domestic Detail Fields Are NOT Exposed:
   • No Full Interactive SKU / Stock Matrix: Public world.taobao.com storefront pages do not expose the login-gated multi-color/size inventory selector or stock counts.
   • No Exact Monthly Unit Sales (salesCount): Domestic 已售 X+ monthly unit sales require a logged-in domestic account (salesCount is empty; use reviewCount and sortBy: "sales" instead).

---

🎯 4 Ways to Target an Overseas-Indexed Taobao or Tmall Seller

Paste any of the following formats into shopUrls or sellers:

1. Direct Shop URLs (Most Reliable): https://world.taobao.com/dianpu/63978904.htm or https://shop63978904.taobao.com (for shops indexed on world.taobao.com)
2. Numeric Shop IDs (Most Reliable): 63978904 or 103710607
3. Taobao Global Product URL from That Seller: https://world.taobao.com/item/Y1QrcEVrd3JLNWVjWno4SDJBVHByZz09.htm (resolves its seller shopId and extracts their storefront catalog)
4. Indexed Brand / Seller Handles: inman, torras, or 優送網 (resolved via world.taobao.com keyword search; use numeric shopId whenever possible)

---

🚀 How to Use in 3 Simple Steps (No Coding Required!)

1. Step 1: Enter Seller URLs, Shop IDs, Handles, or Product Links
   In Seller / Shop URLs (shopUrls), paste one or more Taobao/Tmall shop links, numeric shop IDs, seller handles, or product links.
2. Step 2: Click "Save & Start"
   Hit the green button at the bottom of the screen. The actor resolves each storefront and extracts its product catalog, 3-axis DSR ratings, and multi-currency prices.
3. Step 3: Download Your Seller Inventory Spreadsheet
   Click Export to download your complete seller catalog as an Excel (XLSX), CSV, or JSON file with permanent, hotlink-unblocked HD product images.

---

📊 What Data You Get (Spreadsheet Columns Preview)

Column Name	Sample Value	What It Tells You
shopId / sellerUserId	63978904 / 393647717	Unique numeric Taobao/Tmall Shop ID and Seller User ID.
shopName / shopLogo	示例優選店 / https://img.alicdn.com/imgextra/i1/O1CN01example_item_01.jpg	Official storefront name and permanent shop logo URL.
shopItemCount	406	Total number of active products listed in the seller's world.taobao.com storefront.
dsrDescription / dsrService / dsrDelivery	4.9 / 4.9 / 4.9	3-Axis Seller DSR Scores: Official rating across Description Match, Seller Service, and Shipping Speed.
shopUrl & taobaoShopUrl	https://world.taobao.com/dianpu/63978904.htm / https://shop63978904.taobao.com	Direct links to the seller's storefront on Taobao Global (shopUrl) and Mainland Taobao (taobaoShopUrl).
itemId & platform	8803330176 (taobao / tmall)	Unique product ID and marketplace indicator (tmall for brand flagships, taobao for merchants).
title	農夫山泉天然水4L*4桶整箱特批價家庭大瓶桶裝飲用水	Full 60-character product listing title.
price / originalPrice	199.00 / 220.00	Current promotion price and original list price in Chinese Yuan (¥ CNY).
priceHkd / priceTwd	81.92 (HKD) / 340.29 (TWD)	Multi-currency cross-border retail pricing (HKD, TWD).
reviewCount & reviewTags	85 / [{"tag": "品質很好", "count": 40}]	Buyer review volume and crowd-sourced sentiment tags when exposed on the storefront card.
mainImage & images	https://img.alicdn.com/imgextra/i1/O1CN01example_item_01.jpg	Permanent HD Photo Gallery: Master resolution links that never expire.

---

📤 Sample Output Preview

{
  "itemId": "1001543398120",
  "title": "樂百氏天然泉水19L*2桶特批價15L家庭大瓶桶裝泡茶水非礦泉純淨水",
  "platform": "taobao",
  "catalogSource": "taobao_retail",
  "url": "https://world.taobao.com/item/1001543398120.htm",
  "taobaoUrl": "https://item.taobao.com/item.htm?id=1001543398120",
  "price": 69.0,
  "originalPrice": 69.0,
  "promotionPrice": 69.0,
  "currency": "CNY",
  "priceHkd": 81.92,
  "priceTwd": 340.29,
  "discountType": "節日促銷",
  "shopId": "63978904",
  "shopName": "示例優選店",
  "sellerNick": "示例優選店",
  "sellerUserId": "393647717",
  "shopLogo": "https://img.alicdn.com/imgextra/i1/O1CN01example_item_01.jpg",
  "shopUrl": "https://world.taobao.com/dianpu/63978904.htm",
  "taobaoShopUrl": "https://shop63978904.taobao.com",
  "shopItemCount": 416,
  "dsrDescription": 4.9,
  "dsrService": 4.9,
  "dsrDelivery": 4.9,
  "categoryId": "50008916",
  "rootCategoryId": "50026316",
  "mainImage": "https://img.alicdn.com/imgextra/i1/O1CN01example_item_01.jpg",
  "images": [
    "https://img.alicdn.com/imgextra/i1/O1CN01example_item_01.jpg"
  ],
  "scrapedAt": "2026-10-25T12:50:40+00:00",
  "searchQuery": "shop:63978904",
  "detailLevel": "summary"
}

---

🥊 Market Comparison: Why UnitBytes Outperforms Alternatives

Capability / Metric	🏪 UnitBytes Seller Scraper	⚠️ Other Seller Scrapers
Storefront Catalog Price (per 1,000 items)	🟢 $1.05 – $1.50	🔴 $4.00 – $5.99
Actor Startup Fee	🟢 $0.00005	🔴 $0.05 (1,000x higher)
Resolve Seller from Cross-Border Product Link	✅ Yes (world.taobao.com indexed items)	⚠️ Often requires numeric shopId only
Resolve Seller from Indexed Brand Handle	✅ Major global-indexed brands	⚠️ Limited
3-Axis Seller DSR Scores & Total Item Count	✅ Yes (Included on every row)	❌ Often missing
Buyer Sentiment Tags (reviewTags)	✅ Included when present	❌ Missing on shop scrapers

---

💡 Cost-Effective Pay-Per-Event (PPE) Pricing

Event	Free Plan Price	What It Includes
Actor Start (apify-actor-start)	$0.00005	Nominal startup event — charged only when valid products are returned ($0.00 on empty runs).
Seller Catalog Product (search-item)	$0.0015 / item ($1.50 / 1k)	Storefront product row with full 60-character title, CNY/HKD/TWD prices, 3-axis DSR ratings, shop profile, and HD photos.

---

⚡ UnitBytes · Chinese E-Commerce & Global Sourcing Ecosystem

⚡ UnitBytes · B2B Sourcing, E-Commerce Demand & Global Lead Intelligence Ecosystem
🏪 Taobao & Tmall Seller Shops 📍 You are here Full shop inventories, new arrivals & seller DSR audits	🛍️ Taobao & Tmall Products Retail, Reviews & 3-Axis DSR Consumer trends, buyer sentiment tags & flagship stores	🌍 1688 Global & Arbitrage ✨ English Search & Margins English search, CE/FCC/RoHS filters, Amazon/TikTok margins & 15 currencies
🇨🇳 1688 Factory Direct Wholesale B2B & MOQ Direct factory prices, SKU matrices & Amazon FBA specs	📸 1688 Reverse Image Search Photo-to-Factory (以图搜款) Upload any product photo or URL to find the exact 1688 factory	🌐 Alibaba Wholesale Global B2B & MOQ Verified suppliers, inspection audits & tiered pricing
🐟 Goofish Search & Deals C2C Resale & Arbitrage Zero-login 闲鱼 search, price drops & liquidation	⭐ Goofish Sellers & Reviews Zhima Credit & Store Audits Active/sold seller catalogs & buyer unboxing photos	📈 Google Shopping Trends 🔥 Breakout Product Demand Rising e-commerce products, seasonal buying curves & regions
📊 Google Trends All-in-One 5-Surface Search Intelligence Web, YouTube, Shopping & News search breakouts from $0.30/1K	📍 Google Maps Email & Leads B2B Contacts & Tech Stack Verified business emails, phone numbers, social links & pixels	💬 Google Maps Reviews (10K) Customer Sentiment & ORM Up to 10,000 reviews per place by newest, rating or keyword
🖼️ Google Maps Photos & Menus 4K Place, Menu & Video Feeds Original =s0 photos, restaurant menus, MP4 videos & Local Guides	🇰🇷 Naver Place & Naver Map Korean B2B Leads & Menus South Korean local businesses, KRW menus, hours & reviews	⭐ Naver Place Reviews (네이버) Korean Receipt & Blog Reviews Receipt-verified visitor reviews, photo filters & Naver Blog links

Actor	Purpose & Superpowers	Pricing
Taobao & Tmall Seller Catalog & Shop Scraper (📍 You are here)	Competitor storefront monitoring, seller catalog exports & 3-axis DSR audits	From $0.0015 / item
Taobao & Tmall Product Scraper	Keyword product search, seller catalogs, reviews, sentiment tags & direct item details	From $0.0015 / item
1688 Global Scraper & Arbitrage API (AliTrading)	English search, CE/FCC/RoHS/UL/CPC certification filters, 24h/48h dropshipping, 15 currencies & 9-market Amazon/TikTok Shop arbitrage leaderboards	From $0.0015 / item
1688 Factory Direct Scraper & Price Monitor	Factory-direct B2B wholesale pricing, MOQ, SKU matrices & Amazon FBA packaging specs	From $0.0015 / item
1688 Reverse Image Search (Photo-to-Factory)	Find direct Chinese factories by product photo, URL, or Base64	From $0.0015 / item
Alibaba Wholesale Scraper	Global B2B suppliers, verified export audits, MOQ tiers & OEM/ODM	From $0.0015 / item
Alibaba Supplier Scraper	1 Row = 1 unique audited manufacturer with factory floor size, annual output & TÜV/SGS verification	From $0.0015 / item
Alibaba Seller Inventory & Store Catalog Scraper	Full store catalog pagination, Ready-to-Ship (rts) inventory filter, 30d buyer views & 180d sales	From $0.0015 / item
Goofish / Xianyu Fast Search & Deals Scraper	Secondhand C2C deals, price-drop sniping, liquidation & sample sourcing	From $0.0015 / item
Goofish / Xianyu Sellers, Inventory & Reviews Scraper	Merchant due diligence, Zhima Credit (芝麻信用) ratings, active/sold store catalogs & buyer unboxing photos	From $0.001 / item
Google Shopping Trends Scraper	Breakout physical merchandise demand (froogle), seasonal buying curves & top shopper regions	From $0.30 / 1K
Google Trends Scraper & Data API (All-in-One)	All 5 endpoints (interest_over_time, trending_now, interest_by_region, related_queries, related_topics) across 5 Google properties	From $0.30 / 1K
Google Maps Email & Leads Scraper (B2B Contacts)	Extract B2B business leads with verified website emails, phone numbers, social links, tech stack & ad pixels	From $0.50 / 1K
Google Maps Reviews Scraper (All 10K Reviews)	Extract up to 10,000 reviews per place sorted by newest/lowest rating, server-side keyword filter & policy report links	From $0.25 / 1K
Google Maps Photos Scraper (Places, Menus & Local Guides)	Original =s0 full-resolution place & menu photos, playable MP4 videos, 360° & Local Guide photo feeds	Pay-Per-Event
Naver Place & Map Scraper (네이버 플레이스·지도)	South Korean local business leads, KRW menus, 7-day hours, 0507 SmartCall phones, GPS & visitor/blog reviews	From $1.00 / 1K
Naver Place Reviews Scraper (네이버 플레이스 리뷰)	Receipt-verified Korean visitor reviews, server-side photo review filter, sentiment keywords & linked Naver Blog reviews	From $0.50 / 1K
Naver Map Scraper: Korean Leads & Menus (네이버 지도)	Korean B2B business discovery, road addresses, subway directions, amenities & full menu pricing	From $1.00 / 1K

---

💻 Python & Node.js API Usage

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run = client.actor("unitbytes/taobao-seller-shop-scraper").call(
    run_input={
        "shopUrls": [
            "https://world.taobao.com/dianpu/63978904.htm",
            "https://detail.tmall.com/item.htm?id=1085260672042",
        ],
        "maxItems": 50,
    }
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"[{item.get('shopName')}] {item['title']} — ¥{item['price']} (DSR: {item.get('dsrDescription')})")

---

🛠️ Support, Feedback & Legal Compliance

• Issues & Feature Requests: Please open an issue on the Actor Issues tab.
• Compliance: This Actor extracts strictly publicly available e-commerce storefront catalog data without logging in or bypassing private authentication walls. See Apify's guide on the legality of web scraping.