🏪 Taobao & Tmall Seller Catalog & Shop Inventory Scraper — Storefront Products, 3-Axis DSR Ratings, Reviews & 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, and 3-axis DSR scores (dsrDescription, dsrService, dsrDelivery) for Taobao & Tmall sellers participating in Taobao Global cross-border shipping.
• Resolving Sellers from Cross-Border Product Links: Passing a product link (item.taobao.com / detail.tmall.com / world.taobao.com) for an item listed on world.taobao.com automatically resolves its shopId and extracts that seller's overseas catalog.
• Detail Page Enrichment (scrapeDetails: true): Enriches each seller product with reviewCount, crowd-sourced reviewTags, 1–2 featured customer reviews (reviews), purchased SKU attributes from reviews, location, and categoryPath.
• 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 (shopUrls) 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, world.taobao.com redirects to taglist-404 and the actor returns 0 products ($0.00 charged) — even if that shop opens when you are logged into domestic Taobao in your browser.
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 cross-border 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: skus and attributes only reflect the SKU variant(s) mentioned inside the featured customer reviews on the public page, not 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).
   • Featured Review Snippets Only: scrapeDetails: true extracts the 1–2 featured customer reviews embedded in the public page, not full multi-page review histories.

---

🎯 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. Cross-Border Product URL from That Seller: https://detail.tmall.com/item.htm?id=1085260672042 (if the item is listed on world.taobao.com, 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, SKUs, and customer reviews.
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 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}]	Total buyer review volume and crowd-sourced sentiment tags (scrapeDetails: true).
reviews	[{"rating": 5, "content": "...", "sku": "..."}]	Featured Customer Review Excerpt (scrapeDetails: true): The 1–2 featured buyer reviews embedded in the public page.
skus / attributes	[{"skuId": "sku_1", "name": "規格:4L*4桶整箱", "price": 199.0}]	Purchased SKU variant(s) and key:value attributes extracted from featured customer reviews (scrapeDetails: true). Does not include the login-gated interactive SKU/stock matrix.
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
Full Detail Price (per 1,000 items)	🟢 $2.10 – $3.00	🔴 $5.99+ or summary-only
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
Customer Reviews & Buyer Sentiment Tags	✅ Featured Review Excerpts + Tags (scrapeDetails: true)	❌ 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 (scrapeDetails: false) with CNY/HKD/TWD prices, 3-axis DSR ratings, shop profile, and HD photo.
Full Product Detail (full-detail)	$0.0030 / item ($3.00 / 1k)	Enriched product (scrapeDetails: true) with customer reviews, buyer videos, purchased SKU attributes, sentiment tags, and category breadcrumbs.

---

⚡ UnitBytes · Chinese E-Commerce & Sourcing Ecosystem

Actor	Best For
🏪 Taobao & Tmall Seller Scraper (You are here)	Competitor storefront monitoring, seller catalog exports & DSR audits
🛍️ Taobao & Tmall Product Scraper	Keyword product search, seller catalogs, reviews & direct item details
🇨🇳 1688 Wholesale Factory Scraper	Factory-direct B2B wholesale pricing, MOQ, and Amazon FBA packaging specs
📸 1688 Reverse Image Search Scraper	Find direct Chinese factories by product photo
🌐 Alibaba B2B Supplier Scraper	Global B2B suppliers, verified export audits & OEM/ODM
🐟 Goofish (Xianyu) Search Scraper	Secondhand C2C deals, liquidation & sample sourcing
📕 Xiaohongshu (RedNote) Trend Scraper	Viral Chinese product trends, social commerce & KOL discovery

---

💻 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",
        ],
        "scrapeDetails": True,
        "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.