🛍️ Taobao, Tmall & Alibaba B2B Wholesale Scraper API — Products, Seller Shops, Reviews, DSR, SKUs & Factory Tiers (淘宝 / 天猫 / 阿里巴巴)

The fastest, cheapest zero-login Taobao (淘宝), Tmall (天猫) & Alibaba.com B2B Wholesale Scraper & Synchronous REST API suite ($1.50 / 1,000 items). Extract official Mainland Taobao & Tmall products, seller shop catalogs (shopUrls), 50+ full detail fields, customer reviews (with buyer videos), 3-axis Seller DSR ratings, purchased SKU attributes, multi-currency prices (CNY, SGD, HKD, TWD), Alibaba B2B wholesale tiers, and permanent HD photos.

🚀 Try Live on Apify • 📓 Open in Google Colab • ⚡ RapidAPI Hub • ⚡ Zyla API Hub • ⚡ Official n8n Creator Hub • 🔧 41 Free n8n Templates • 📖 Documentation & Schemas • 📚 Engineering Playbooks

_{⚡ 1-Click Free Trial: Test live queries using Apify's `$5` free monthly credit • Zero login or cookies required}

📦 Included in This Repository (Python Quickstarts, Google Colab, n8n Workflows, MCP & Sample Data)

This repository contains ready-to-run Python SDK scripts, an interactive 1-Click Google Colab notebook (notebooks/quickstart.ipynb), 9-node n8n automation workflow .json templates, AI Agent MCP configuration (.cursor/mcp.json), and sample output datasets (JSON & CSV):

Extraction Engine	🐍 Python SDK Quickstart	⚡ n8n Workflow Template	📊 Sample Output	🚀 Cloud Console
Taobao & Tmall 淘宝 Product Scraper — Products, Seller Shops, Reviews, DSR & Prices _{unitbytes/taobao-tmall-scraper • Full Schema • Engineering Playbook}	`examples/run_taobao_tmall_scraper.py`	`n8n/taobao-tmall-scraper-n8n-workflow.json`	`JSON` · `CSV`	⚡ Run on Apify
Taobao & Tmall Seller Catalog & Shop Scraper (淘宝店铺) _{unitbytes/taobao-seller-shop-scraper • Full Schema • Engineering Playbook}	`examples/run_taobao_seller_shop_scraper.py`	`n8n/taobao-seller-shop-scraper-n8n-workflow.json`	`JSON` · `CSV`	⚡ Run on Apify
Alibaba Scraper: Wholesale Products & Factory Finder _{unitbytes/alibaba-scraper • Full Schema • Engineering Playbook}	`examples/run_alibaba_scraper.py`	`n8n/alibaba-scraper-n8n-workflow.json`	`JSON` · `CSV`	⚡ Run on Apify
Alibaba B2B Wholesale & Supplier Synchronous REST API (`<500ms` GET) _{RapidAPI Hub • Zyla API Hub • Full Schema}	`examples/run_alibaba_rapidapi.py`	`n8n/alibaba-scraper-n8n-workflow.json`	`JSON` · `CSV`	⚡ RapidAPI · ⚡ Zyla

📓 1-Click Interactive Google Colab Notebook: Open notebooks/quickstart.ipynb directly in your browser via Google Colab ↗ to inspect sample DataFrames and test live API queries with zero local setup.
🤖 Cursor, Windsurf & Claude Code MCP Ready: Includes .cursor/mcp.json pre-configured with https://mcp.apify.com so AI coding agents can invoke these UnitBytes scrapers natively.
💡 Using n8n? Explore our official creator profile at n8n.io/creators/unitbytes or copy all 41 pre-built 9-node scraping workflows (Ctrl+V) at unitbytes.com/n8n.
📚 Engineering Playbooks: Taobao & Tmall API Pricing Guide • B2B Sourcing & Supplier API Playbook — or browse all guides at unitbytes.com/blog.

⚡ Pre-Configured 1-Click Task Presets

Launch pre-configured extraction templates directly in the Apify Cloud Console with zero parameter setup:

Task Preset	Target Extraction Use Case	Direct Launch
Scrape Taobao & Tmall Product Prices, SKUs & 3-Axis DSR Scores	Extract Taobao and Tmall product catalogs, full SKU price matrices, monthly sales volume, and merchant DSR ratings without login cookies.	⚡ Run Task Preset
Audit Taobao & Tmall Seller Storefronts, Full Catalogs & Reviews	Extract a Taobao or Tmall merchant's full product inventory, 3-axis DSR ratings, crown credit level, and verified buyer reviews.	⚡ Run Task Preset
Find Products on Alibaba: Wholesale Sourcing Engine	Search millions of products on Alibaba.com. Extract tiered wholesale volume pricing, MOQ, lead times, and factory audit credentials.	⚡ Run Task Preset
Find Verified Suppliers on Alibaba: Factory Audits & B2B Leads	Extract TÜV Rheinland & SGS audited Verified Suppliers on Alibaba with Trade Assurance, Gold Supplier tenure, and direct contacts.	⚡ Run Task Preset
Find Low MOQ Products on Alibaba: Small Batch & Dropshipping	Discover wholesale items with low minimum order quantities (MOQ ≤ 5) for dropshipping, sample orders, and small-batch private labeling.	⚡ Run Task Preset
Scrape Alibaba Product URLs: Deep Specs & Volume Pricing	Deep scrape specific Alibaba.com product URLs to extract tiered volume pricing ladders, full packaging specs, and certified supplier details.	⚡ Run Task Preset
Find Trending Products on Alibaba: Best Match & High Reviews	Extract top-rated, trending products on Alibaba.com sorted by customer reviews, supplier credibility, and high-demand wholesale niches.	⚡ Run Task Preset

🛠️ Extraction Engines in This Suite

🚀 Taobao & Tmall 淘宝 Product Scraper — Products, Seller Shops, Reviews, DSR & Prices (`unitbytes/taobao-tmall-scraper`)

The fastest, cheapest, and most reliable cookieless Taobao (淘宝) & Tmall (天猫) product & seller scraper on Apify. Extract official Mainland Taobao & Tmall products, seller shop catalogs (shopUrls), 3-axis Seller DSR ratings, customer reviews, buyer sentiment tags, purchased SKU attributes, multi-currency prices (CNY, SGD, HKD, TWD), and permanent HD photos by Keyword, Shop URL, or Direct Product URL — Zero Login, Zero Cookies & Zero Chinese Phone Number Required.

Pricing: $0.0015 / item ($1.50 per 1,000 items in Fast Summary mode ($0.0015/item) or $4.00 per 1,000 items in Full Detail mode ($0.0040/item) — 3,330+ products free/month with Apify's $5 credit, $0.00 empty-run protection)
Cloud Console: https://apify.com/unitbytes/taobao-tmall-scraper?fpr=939u3w&fp_sid=gh_taobao_alibaba
Full Documentation & Schema: https://unitbytes.com/actors/taobao-tmall-scraper/
n8n Workflow File: n8n/taobao-tmall-scraper-n8n-workflow.json
Engineering Playbook: Taobao & Tmall API Pricing in 2026 ($1.50/1K vs. $99/mo RapidAPI & Open.Taobao Limits)

Key Capabilities

Two Cookieless Extraction Modes (scrapeDetails: true & false): Run Full Detail Mode (scrapeDetails: true, Default — $0.0040/item) for 50+ fields including 3-axis Seller DSR scores, customer reviews, sentiment tags, purchased SKU attributes, 5-image HD galleries, and category breadcrumbs, or Fast Summary Mode (scrapeDetails: false — $0.0015/item) for ultra-fast single-pass catalog extraction (~2s/run).
Seller Storefront & Shop Catalogs (shopUrls) + English/Chinese Search (queries): Paste any Taobao or Tmall shop link, numeric shopId, seller handle (e.g. inman), or product URL into shopUrls to extract that seller's catalog, or search in Chinese/English (with automatic English-to-Chinese Taobao tag resolution).
Customer Reviews, Buyer Videos & 3-Axis Seller DSR Ratings: Extract featured customer reviews (buyer comment, date, purchased SKU variant, and buyer video proofs) plus crowd-sourced buyer sentiment tags (reviewTags) and official 3-axis Seller DSR scores (dsrDescription, dsrService, dsrDelivery).
Direct Product URL / ID Scraping (itemUrls) & Purchased SKU Attributes: Paste Taobao (item.taobao.com), Tmall (detail.tmall.com), or international Taobao product links or numeric IDs directly into itemUrls, extracting purchased SKU variants (skus), structured key:value attributes, and category breadcrumbs (categoryPath).
Multi-Currency Pricing & Permanent Shopify-Ready HD Photos: Automatic cross-border retail pricing (CNY, SGD, HKD, TWD) and unblocked master-resolution image galleries (img.alicdn.com) that never expire or return 403 Forbidden in Shopify, WooCommerce, or Excel.

⚙️ Input Parameters (Schema)

Parameter	Type	Default / Prefill	Description
`queries`	`array`	`["phone case"]`	List of product keywords to search on Taobao and Tmall (e.g., ['手机壳', '蓝牙耳机', '女装', 'phone case', 'wireless earbuds']). Chinese keywords provide the deepest catalog coverage; common English product terms are also supported and automatically resolved to Chinese tags when needed.
`itemUrls`	`array`	—	Scrape specific products directly. Supports Taobao, Tmall, and World Taobao URLs (e.g. https://item.taobao.com/item.htm?id=1010692564493, https://detail.tmall.com/item.htm?id=1085260672042, https://world.taobao.com/item/1010692564493.htm) or raw numeric item IDs.
`shopUrls`	`array`	—	Scrape a seller's storefront product catalog and 3-axis DSR ratings. Accepts Taobao/Tmall shop URLs (e.g. https://world.taobao.com/dianpu/100000002.htm, https://shop100000002.taobao.com), numeric shop IDs ('100000002'), seller handles ('inman'), or any product URL to automatically.
`startUrls`	`array`	—	Paste Taobao, Tmall, or World Taobao URLs directly from your browser (search listings, shop storefronts like world.taobao.com/dianpu/... or shopXXXX.taobao.com, world.taobao.com/product/... keyword pages, or direct product item URLs).
`scrapeDetails`	`boolean`	`True`	When enabled (default), enriches every discovered product with public detail-page fields (3-axis seller DSR scores, HKD/TWD cross-border prices, featured customer review & purchased SKU attributes, buyer video proofs, sentiment tags, 5-image HD gallery, shipping location, and.
`maxItems`	`integer`	`30`	Maximum number of products to scrape (1 to 10,000).
`maxItemsPerSeller`	`integer`	—	Optional cap on how many products to extract per seller when scraping multiple shops in shopUrls.
`startPage`	`integer`	`1`	Page number to start scraping from (e.g. 1, 2, 5). Allows paginating through large catalogs without tokens.
`sortBy`	`string`	`default`	Sorting order for product search results.
`priceMin`	`integer`	—	Minimum unit price in Chinese Yuan (CNY ¥).
`priceMax`	`integer`	—	Maximum unit price in Chinese Yuan (CNY ¥).
`resumptionToken`	`string`	—	Optional encrypted resumption token copied from a previous run or dataset item. Restores session and cursor to continue scraping seamlessly with zero duplicates.
`proxyConfiguration`	`object`	`{"useApifyProxy": true}`	Proxy settings. Automatically uses Apify Residential proxies on cloud runs to prevent rate limits.

🔥 Cookieless Taobao & Tmall Extraction Modes (`scrapeDetails`), Seller Storefronts (`shopUrls`) & 50+ Field Schema

💰 Cheapest Cookieless Taobao & Tmall Scraper on Apify Store: Only $1.50 per 1,000 items ($0.0015/item in Fast Summary mode, or $4.00/1K in Full Detail mode) — 3,330+ products free every month with Apify's $5 credit.

unitbytes/taobao-tmall-scraper extracts the Mainland Taobao (item.taobao.com) and Tmall (detail.tmall.com) catalog with zero login walls, zero cookies, and zero SMS verification:

Full Detail Mode (scrapeDetails: true, Default — $0.0040/item): Enriches every discovered product with 3-axis Seller DSR Scores (dsrDescription, dsrService, dsrDelivery), Total Review Volume (reviewCount), Crowd-Sourced Buyer Sentiment Tags (reviewTags), Featured Customer Review (reviews with buyer text, date, purchased SKU variant, and video proof), Purchased SKU Attributes (skus & parsed attributes), 5-Image HD Gallery (images), Shipping Origin (location), and Category Breadcrumbs (categoryPath).
Fast Summary Mode (scrapeDetails: false — $0.0015/item): Ultra-fast single-pass search (~2s/run) returning full untruncated product titles, CNY & local currency prices (SGD/HKD/TWD), promotion labels (discountType), shopId, shopName, shopUrl, taobaoShopUrl, dsrDescription score, reviewCount, reviewTags, and permanent master HD photos.
3 Flexible Input Modes (queries, shopUrls, itemUrls): Search by Chinese or English keywords (queries with automatic English-to-Chinese tag resolution), extract any seller's storefront catalog (shopUrls via shop link, numeric shopId, seller handle like inman, or item URL), or scrape direct product links (itemUrls).

📊 Key Extracted Columns (`taobao-tmall-scraper`)

Column Name	Sample Value	What It Tells You
`itemId` & `platform`	`100000000001` (`tmall` / `taobao`)	Unique numeric product ID and marketplace indicator (`tmall` Flagship vs `taobao`).
`price` / `originalPrice`	`876.0` / `876.0` (`CNY`)	Current promotion price and original list price in Chinese Yuan (`¥ CNY`).
`priceHkd` / `priceTwd`	`1040.07` (`HKD`) / `4320.17` (`TWD`)	Automatic multi-currency cross-border retail pricing (`SGD`, `HKD`, `TWD`).
`dsrDescription` / `dsrService` / `dsrDelivery`	`4.84` / `4.8` / `4.9`	3-Axis Seller DSR Scores: Official rating across Description Match, Seller Service, and Shipping Speed.
`reviewCount` / `ratingGoodCount`	`58` / `"58"`	Total verified buyer review volume (`scrapeDetails: true`).
`reviews`	`[{"rating": 5, "content": "素皮紋理很漂亮...", "sku": "...", "videos": []}]`	Featured Customer Review: Buyer comment, date, purchased SKU variant, and buyer video proofs.
`reviewTags`	`[{"tag": "質感很強", "count": 6}, {"tag": "手感很好", "count": 5}]`	Buyer Sentiment Tags: Crowd-sourced product pros & cons with buyer vote counts.
`categoryPath`	`首頁 > 數碼商城 > 手機及配件 > 手機配件 > 保護套/矽膠套`	Full category breadcrumb hierarchy for taxonomy mapping.
`skus` & `attributes`	`[{"skuId": "sku_1", "name": "適用型號:Pro Max;顏色分類:利落白", "price": 876.0}]`	Purchased SKU variant and parsed `key:value` attributes.
`shopName` / `shopItemCount`	`數碼配件官方旗艦店` (`349` items, opened `2018-04-24`)	Verified storefront name, `shopId` (`100000001`), `sellerTypeLabel`, `shopOpenedAt`, and direct `taobaoShopUrl`.

Python SDK Quickstart (`examples/run_taobao_tmall_scraper.py`)

from apify_client import ApifyClient

APIFY_TOKEN = os.getenv("APIFY_API_TOKEN", "YOUR_APIFY_API_TOKEN")
if not APIFY_TOKEN or APIFY_TOKEN.startswith("YOUR_"):
    raise SystemExit("Please set your Apify API token: export APIFY_API_TOKEN='apify_api_...'")

client = ApifyClient(APIFY_TOKEN)

run_input = {
    "queries": ["手机壳", "wireless earbuds"],
    "shopUrls": ["https://world.taobao.com/dianpu/100000001.htm"],
    "itemUrls": ["https://detail.tmall.com/item.htm?id=100000000001"],
    "scrapeDetails": True,
    "maxItems": 50,
    "sortBy": "sales"
}

run = client.actor("unitbytes/taobao-tmall-scraper").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item.get("title"), item.get("price"), item.get("reviewCount"), item.get("dsrDescription"), item.get("shopName"))

Sample Output Schema (`samples/taobao-tmall-scraper-sample.json`)

{
  "itemId": "100000000001",
  "title": "[殼膜套裝]磁吸支點手機保護殼適用iPhone Pro防摔全包保護套",
  "platform": "tmall",
  "catalogSource": "taobao_retail",
  "url": "https://world.taobao.com/item/100000000001.htm",
  "taobaoUrl": "https://detail.tmall.com/item.htm?id=100000000001",
  "price": 876.0,
  "originalPrice": 876.0,
  "promotionPrice": 876.0,
  "currency": "CNY",
  "priceHkd": 1040.07,
  "priceTwd": 4320.17,
  "discountType": "新品促銷",
  "reviewCount": 58,
  "ratingGoodCount": "58",
  "shopId": "100000001",
  "sellerUserId": "1600000001",
  "shopName": "數碼配件官方旗艦店",
  "sellerNick": "數碼配件官方旗艦店",
  "sellerType": "B",
  "sellerTypeLabel": "Tmall Flagship Store",
  "sellerCreditLevel": 19,
  "shopOpenedAt": "2018-04-24 14:44:53",
  "shopItemCount": 349,
  "shopNewItemCount": 26,
  "shopUrl": "https://world.taobao.com/dianpu/100000001.htm",
  "taobaoShopUrl": "https://shop100000001.taobao.com",
  "shopIcon": "https://img.alicdn.com/imgextra/i2/1600000001/O1CN01exampleShopIcon_!!1600000001.jpg",
  "dsrDescription": 4.84,
  "dsrService": 4.8,
  "dsrDelivery": 4.9,
  "reviewTags": [
    {
      "tag": "質感很強",
      "count": 6
    },
    {
      "tag": "手感很好",
      "count": 5
    },
    {
      "tag": "支架很實用",
      "count": 5
    },
    {
      "tag": "圖案設計精緻",
      "count": 4
    }
  ],
  "reviews": [
    {
      "rating": 5,
      "content": "素皮紋理很漂亮，上手質感很好，磁吸支架開合順滑，邊緣包邊處理得很平整。",
      "date": "2026.10.14 18:16",
      "sku": "適用型號:Pro Max;顏色分類:利落白",
      "user": "***",
      "videos": []
    }
  ],
  "categoryId": "150704",
  "rootCategoryId": "50008090",
  "categoryPath": "首頁 > 數碼商城 > 手機及配件 > 手機配件 > 保護套/矽膠套",
  "location": "廣東深圳",
  "freeShipping": false,
  "mainImage": "https://img.alicdn.com/imgextra/i3/1600000001/O1CN01exampleMainPic_!!1600000001-2-item_pic.png",
  "images": [
    "https://img.alicdn.com/imgextra/i3/1600000001/O1CN01exampleMainPic_!!1600000001-2-item_pic.png"
  ],
  "skuCount": 1,
  "skus": [
    {
      "skuId": "sku_1",
      "name": "適用型號:Pro Max;顏色分類:利落白",
      "price": 876.0,
      "imageUrl": "https://img.alicdn.com/imgextra/i3/1600000001/O1CN01exampleMainPic_!!1600000001-2-item_pic.png"
    }
  ],
  "attributes": {
    "適用型號": "Pro Max",
    "顏色分類": "利落白"
  },
  "scrapedAt": "2026-10-25T12:53:32+00:00",
  "searchQuery": "phone case",
  "detailLevel": "full"
}

Frequently Asked Questions

Q: Do I need a Taobao account, Alipay, or a Chinese phone number? No, absolutely not. The actor operates 100% cookieless and anonymously via official cross-border catalog endpoints without requiring an account, QR code scans, or SMS verification.

Q: Can I search using English keywords, or should I use Chinese keywords? Both work! Chinese keywords (e.g. 手机壳, 蓝牙耳机, 女装) provide the deepest catalog coverage on Taobao & Tmall. Common English product keywords (e.g. phone case, wireless earbuds, smart watch, hoodie) are also supported—if an English phrase is not directly indexed as an English tag, the scraper automatically resolves it to the matching Chinese Taobao tag while preserving your original searchQuery column.

Q: What is the difference between scrapeDetails: true and scrapeDetails: false? scrapeDetails: true (Default — $0.0040/item) fetches both the search/shop listing and each item's individual detail page, combining full untruncated titles and multi-currency prices with 3-axis Seller DSR Scores, Featured Customer Reviews, Purchased SKU Attributes, 5-Image HD Galleries, Shipping Origin, and Category Breadcrumbs. scrapeDetails: false ($0.0015/item) fetches only the search/shop catalog pages (~2 seconds per run) with full untruncated titles, CNY & local currency prices, promotion labels, shop metadata, dsrDescription, reviewCount, reviewTags, and permanent HD photos.

Q: Can I scrape a seller's storefront catalog (shopUrls) or direct product links (itemUrls)? Yes! Paste any Taobao/Tmall shop URL, numeric shopId, seller handle, or product URL into shopUrls to extract that seller's catalog, or paste Taobao/Tmall product URLs/IDs into itemUrls. Unavailable or offline items return a clean status notice (UNAVAILABLE) at $0.00 charged.

Q: How many products can I scrape for free? With Apify's default $5.00 free monthly credit, you can extract 3,330+ Summary products ($0.0015/item) or 1,250 Full Detail products ($0.0040/item) completely free every month.

🚀 Taobao & Tmall Seller Catalog & Shop Scraper (淘宝店铺) (`unitbytes/taobao-seller-shop-scraper`)

Fastest cookieless Taobao (淘宝) & Tmall (天猫) Seller Catalog & Shop Inventory Scraper (from $0.0015/item — 4x cheaper). Extract any seller's listed products, 3-axis DSR scores, customer reviews, CNY/HKD/TWD prices & HD photos by shop URL, ID, handle, or product.

Pricing: $0.0015 / item (Pay-Per-Event — $0.0015 seller catalog product scraped, $0.004 full product detail & sku matrix (volume tiers from $0.00105))
Cloud Console: https://apify.com/unitbytes/taobao-seller-shop-scraper?fpr=939u3w&fp_sid=gh_taobao_alibaba
Full Documentation & Schema: https://unitbytes.com/actors/taobao-seller-shop-scraper/
n8n Workflow File: n8n/taobao-seller-shop-scraper-n8n-workflow.json
Engineering Playbook: Taobao & Tmall API Pricing in 2026 ($1.50/1K vs. $99/mo RapidAPI & Open.Taobao Limits)

Key Capabilities

4-Way Seller & Storefront Resolution: Paste any Taobao or Tmall shop link (world.taobao.com/dianpu/... or shop.taobao.com), numeric Shop ID, seller handle (inman, torras), or even any product URL from that seller to extract their storefront catalog.
3-Axis Seller DSR & Storefront Metrics: Captures official Description Match (dsrDescription), Seller Service (dsrService), and Shipping Speed (dsrDelivery) ratings alongside total active listings (shopItemCount), shopId, and sellerUserId.
Customer Reviews, Buyer Videos & Sentiment Tags: When scrapeDetails is enabled, enriches every seller product with total review volume (reviewCount), crowd-sourced buyer sentiment tags (reviewTags), featured customer reviews, and purchased SKU attributes.
Multi-Currency Pricing & Permanent HD Photos: Extracts CNY, HKD, and TWD retail prices, promotional labels (discountType), working Mainland Taobao/Tmall links, and hotlink-unblocked master CDN images ready for Shopify or Excel.

⚙️ Input Parameters (Schema)

Parameter	Type	Default / Prefill	Description
`shopUrls`	`array`	`["https://world.taobao.com/dianpu/100000002.htm"`	Enter one or more Taobao or Tmall sellers to extract their product inventory and 3-axis DSR ratings. Accepts: • Shop URLs: https://world.taobao.com/dianpu/100000002.htm or https://shop100000002.taobao.com • Numeric Shop IDs: '100000002' • Seller handles or brand subdomains.
`sellers`	`array`	—	Optional list of seller handles, brand names, or numeric shop IDs (e.g. ['inman', '優送網', '34033352']).
`startUrls`	`array`	—	Paste Taobao, Tmall, or World Taobao shop links or product URLs directly from your browser.
`scrapeDetails`	`boolean`	`True`	When enabled (default), enriches every seller product with public detail-page fields (customer reviews, purchased SKU attributes, buyer video proofs, 5-image HD gallery, shipping location, and category breadcrumbs).
`maxItems`	`integer`	`30`	Maximum total number of seller products to scrape across the run (1 to 10,000).
`maxItemsPerSeller`	`integer`	—	Optional cap on how many products to extract per seller when batch-scraping multiple shops in a single run.
`startPage`	`integer`	`1`	Page number to start scraping from (1, 2, 5).
`sortBy`	`string`	`default`	Sorting order when expanding seller product catalogs.
`priceMin`	`integer`	—	Minimum unit price in Chinese Yuan (CNY ¥).
`priceMax`	`integer`	—	Maximum unit price in Chinese Yuan (CNY ¥).
`proxyConfiguration`	`object`	`{"useApifyProxy": true}`	Proxy settings. Automatically uses Apify Residential proxies on cloud runs to prevent rate limits.

Python SDK Quickstart (`examples/run_taobao_seller_shop_scraper.py`)

from apify_client import ApifyClient

APIFY_TOKEN = os.getenv("APIFY_API_TOKEN", "YOUR_APIFY_API_TOKEN")
if not APIFY_TOKEN or APIFY_TOKEN.startswith("YOUR_"):
    raise SystemExit("Please set your Apify API token: export APIFY_API_TOKEN='apify_api_...'")

client = ApifyClient(APIFY_TOKEN)

run_input = {
    "shopUrls": ["https://world.taobao.com/dianpu/100000002.htm"],
    "maxItems": 30,
    "startPage": 1,
    "scrapeDetails": True,
    "sortBy": "default"
}

run = client.actor("unitbytes/taobao-seller-shop-scraper").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item.get("title"), item.get("shopName"), item.get("searchQuery"))

Sample Output Schema (`samples/taobao-seller-shop-scraper-sample.json`)

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

Frequently Asked Questions

Q: What seller input formats are supported in shopUrls? You can pass direct shop URLs (world.taobao.com/dianpu/100000002.htm or shop100000002.taobao.com), numeric Shop IDs (100000002), brand handles or subdomains (inman, torras, inman.tmall.com), or any product URL from that seller.

Q: Do I need a Taobao account, cookies, or a Chinese phone number? No. The scraper operates 100% cookieless and anonymously via Taobao's official cross-border storefront catalog endpoints, so you never need an account, QR login, or SMS verification.

Q: What is the difference between scrapeDetails: false and scrapeDetails: true? ScrapeDetails: false ($1.50/1,000 items) extracts the seller's catalog listings, CNY/HKD/TWD prices, DSR score, and HD cover images in seconds. scrapeDetails: true ($4.00/1,000 items) additionally fetches each item's 3-axis DSR breakdown, customer reviews, sentiment tags, and category path.

Q: Are empty shops or invalid seller URLs billed? No. Under Pay-Per-Event pricing, you only pay for valid seller catalog products pushed to your dataset—empty storefronts or invalid inputs cost $0.00 beyond the nominal $0.00005 run start.

🚀 Alibaba Scraper: Wholesale Products & Factory Finder (`unitbytes/alibaba-scraper`)

Fastest Alibaba scraper for Amazon FBA, dropshipping & B2B sourcing. Extract wholesale products, tiered volume pricing, MOQ, FBA package weight/size, SKU variants & verified factory audits. MCP & AI Agent ready.

Pricing: $0.0015 / item (Pay-Per-Event — $0.0015 search item ($1.50 / 1,000), $0.0025 product detail ($2.50 / 1,000; Gold+ tiers from $0.0009 / item))
Cloud Console: https://apify.com/unitbytes/alibaba-scraper?fpr=939u3w&fp_sid=gh_taobao_alibaba
Full Documentation & Schema: https://unitbytes.com/actors/alibaba-scraper/
n8n Workflow File: n8n/alibaba-scraper-n8n-workflow.json
Engineering Playbook: 1688 Reverse Image Search & Alibaba B2B API Guide in 2026 (Photo-to-Factory Sourcing)

Key Capabilities

FOB Tiered Price Brackets: Captures unit prices across volume tiers (e.g., 500-1000 pcs, 1000-5000 pcs, 10,000+ pcs) in USD.
Verified Factory Credentials: Audits ISO/CE/RoHS certifications, on-site inspection reports, floor space, and factory staff count.
Supplier Response & On-Time Delivery: Extracts verified historical transaction scores, buyer review percentages, and average dispatch times.
Customization & OEM Capabilities: Identifies custom logo minimums, custom packaging thresholds, and graphic design lead times.

⚙️ Input Parameters (Schema)

Parameter	Type	Default / Prefill	Description
`mode`	`string`	`products`	Choose what to scrape: 'products' (Wholesale Products, Tiered Prices, FBA Weight/Size & SKUs), 'suppliers' (1 Row = 1 Unique Verified Manufacturer & Factory Audit), or 'inventory' (Full Supplier Store Catalog & Ready-to-Ship Pagination).
`keyword`	`string`	`wireless earbuds`	Product or supplier keyword to search on Alibaba.com (e.g. 'wireless earbuds'). Use this for quick single-keyword searches or 'Search Queries' for batch searches.
`queries`	`array`	—	List of product or supplier keywords to search on Alibaba.com (e.g., 'wireless earbuds', 'phone case'). Multiple queries are scraped in a single run.
`categoryUrl`	`string`	—	Direct Alibaba.com category URL, search URL, or supplier catalog URL (e.g., 'https://www.alibaba.com/category/sports-clothes_201275271.html' or 'https://ruitetec.en.alibaba.com/productlist-1.html'). Prioritized when specified.
`productUrls`	`array`	—	List of direct Alibaba.com product URLs to scrape directly (e.g., 'https://www.alibaba.com/product-detail/Wholesale-Earbuds_1600123456789.html').
`supplierUrls`	`array`	—	List of direct Alibaba supplier URLs to audit directly (e.g., 'https://ruitetec.en.alibaba.com/company_profile.html' or 'https://ruitetec.en.alibaba.com/').
`storeUrls`	`array`	—	List of Alibaba seller store URLs or subdomains to paginate their full product catalog (e.g., 'https://ruitetec.en.alibaba.com/productlist-1.html' or 'https://ruitetec.en.alibaba.com/').
`inventoryFilter`	`string`	`all`	Filter products when scraping a seller's store catalog: 'all' (Full Catalog), 'rts' (Ready-to-Ship / In-Stock Only), 'ctz' (Customizable / OEM Only), or 'dropshipping' (Dropshipping Catalog).
`maxItems`	`integer`	`20`	Maximum wholesale products to extract. Default 20 items in Full mode costs only ~`$0.05` (100% free under Apify's `$5` monthly credit).
`detailLevel`	`string`	`full`	'full' fetches complete B2B wholesale pricing tiers, MOQ, FBA package weight & dimensions, SKU variants, supplier audits (TÜV/SGS), lead times, and specifications (`$2.50/1k`). 'summary' extracts product search cards (`$1.50/1k`).
`sortBy`	`string`	`default`	Sort order for search listings.
`verifiedOnly`	`boolean`	`False`	Filter strictly for Verified Suppliers on Alibaba.com (on-site audited by TÜV Rheinland / SGS).
`tradeAssuranceOnly`	`boolean`	`False`	Filter strictly for suppliers supporting Alibaba Trade Assurance buyer payment protection.
`minOrderQuantityMax`	`integer`	—	Filter for products with Minimum Order Quantity (MOQ) less than or equal to this number.
`country`	`string`	—	Filter suppliers by origin country code (e.g. 'CN' for China, 'VN' for Vietnam, 'IN' for India, 'TR' for Turkey, 'US' for USA). Leave empty for all countries.
`resumptionToken`	`string`	—	Encrypted session token from a previous run to resume pagination exactly where it left off.
`proxyConfiguration`	`object`	`{"useApifyProxy": true}`	Apify Residential Proxy or custom proxies. Residential proxies are recommended for Alibaba to prevent anti-bot challenges.

⚡ Real-Time Synchronous REST API (RapidAPI Hub & Zyla API Hub — Sub-Second Response)

Need instant synchronous GET responses (<500ms live / <150ms cached) for a live procurement portal, ERP, or FOB cost calculator instead of an async batch job? Use our official 7-Endpoint Alibaba B2B Wholesale & Supplier Data REST API:

👉 Test Live on RapidAPI Hub ($0 Free Tier) (x-rapidapi-host: alibaba-b2b-wholesale-and-supplier-data.p.rapidapi.com)
👉 Test Live on Zyla API Hub (Listing ID 14474)
🐍 Runnable Python Script: examples/run_alibaba_rapidapi.py

Category	Endpoint	Method	Description
1. B2B Product Search	`/v1/alibaba/search`	`GET`	Search Alibaba.com wholesale listings in USD with `verified_only` (SGS/TÜV), `trade_assurance_only`, `min_moq`, `country`, and sorting.
2. Product & SKU Intelligence	`/v1/alibaba/product`	`GET`	Complete B2B product detail: USD volume ladder prices (`tieredPrices`), MOQ, sample price, SKU variants, specs, CE/FCC/RoHS certifications, and supplier profile.
2. Product & SKU Intelligence	`/v1/alibaba/product/skus`	`GET`	Extract SKU variations and calculate active FOB tier unit price (`matchedTierUnitPriceUsd`) & total USD order cost (`estimatedOrderTotalUsd`) for `order_quantity`.
2. Product & SKU Intelligence	`/v1/alibaba/products/batch`	`GET`	Concurrent batch lookup for up to 5 Alibaba `product_ids` in a single call.
3. Supplier & Logistics Intelligence	`/v1/alibaba/product/logistics`	`GET`	Extract unit weight (`unitWeightKg`), package dimensions (`packageSizeCm`), and production lead time, and calculate total shipment weight (`kg`), volume (`CBM`), and air volumetric weight.
3. Supplier & Logistics Intelligence	`/v1/alibaba/supplier`	`GET`	Extract Verified Supplier storefront profile, SGS/TÜV audit agency, factory floor size (`m²`), employee count, annual output, and main export markets.
3. Supplier & Logistics Intelligence	`/v1/alibaba/supplier/products`	`GET`	Paginate a supplier's storefront product catalog with `all`, `rts` (Ready-to-Ship), `ctz` (Customizable OEM), or `dropshipping` filters.

Python SDK Quickstart (`examples/run_alibaba_scraper.py`)

from apify_client import ApifyClient

APIFY_TOKEN = os.getenv("APIFY_API_TOKEN", "YOUR_APIFY_API_TOKEN")
if not APIFY_TOKEN or APIFY_TOKEN.startswith("YOUR_"):
    raise SystemExit("Please set your Apify API token: export APIFY_API_TOKEN='apify_api_...'")

client = ApifyClient(APIFY_TOKEN)

run_input = {
    "keyword": "wireless earbuds",
    "mode": "products",
    "inventoryFilter": "all",
    "maxItems": 20,
    "detailLevel": "full",
    "sortBy": "default"
}

run = client.actor("unitbytes/alibaba-scraper").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item.get("title"), item.get("supplierName"), item.get("price"))

Sample Output Schema (`samples/alibaba-scraper-sample.json`)

{
  "id": "1600000000001",
  "offerId": "1600000000001",
  "productId": "1600000000001",
  "title": "Premium Crystal Clear TPU PC Case for iPhone 17 18 Pro Max Strong Magnetic Charging Shockproof Transparent Phone Cover",
  "url": "https://www.alibaba.com/product-detail/Premium-Crystal-Clear-TPU-PC-Case_1600000000001.html",
  "productUrl": "https://www.alibaba.com/product-detail/Premium-Crystal-Clear-TPU-PC-Case_1600000000001.html",
  "price": 0.68,
  "priceMin": 0.51,
  "priceMax": 0.68,
  "currency": "USD",
  "minOrderQuantity": "Min. order: 200 pieces",
  "unitWeightKg": 0.08,
  "packageSizeCm": "22X12X2 cm",
  "priceType": "ladder",
  "skuCount": 42,
  "certifications": [
    "CE",
    "RoHS"
  ],
  "supplierId": "230000001",
  "supplierName": "Shenzhen Horizon Electronics Co., Ltd.",
  "supplierCountry": "CN",
  "supplierYears": "9 yrs",
  "isVerifiedSupplier": true,
  "tradeAssurance": true,
  "supplierRating": 4.7,
  "supplierReviewCount": 99,
  "supplierResponseTime": "≤2h",
  "supplierOnTimeDeliveryRate": "100.0%",
  "supplierUrl": "https://example-supplier.en.alibaba.com/company_profile.html",
  "tieredPrices": [
    {
      "minQuantity": 200,
      "maxQuantity": 2999,
      "price": 0.68,
      "unit": "piece"
    },
    {
      "minQuantity": 3000,
      "maxQuantity": 29999,
      "price": 0.65,
      "unit": "piece"
    },
    {
      "minQuantity": 30000,
      "maxQuantity": null,
      "price": 0.51,
      "unit": "piece"
    }
  ],
  "skuVariants": [
    {
      "skuId": "10001",
      "attributes": {
        "Color": "Clear",
        "Applicable Models": "iPhone 17 Pro Max"
      },
      "price": 0.68,
      "image": "https://sc04.alicdn.com/kf/He0c23016d3854f688506c3d7090724e8a.png"
    }
  ],
  "supplier": {
    "id": "230000001",
    "name": "Shenzhen Horizon Electronics Co., Ltd.",
    "country": "CN",
    "yearsActive": "9 yrs",
    "isVerified": true,
    "tradeAssurance": true,
    "rating": 4.7,
    "reviewCount": 99,
    "responseTime": "≤2h",
    "onTimeDeliveryRate": "100.0%",
    "storeUrl": "https://example-supplier.en.alibaba.com/company_profile.html",
    "homeUrl": "https://example-supplier.en.alibaba.com/"
  },
  "leadTime": {
    "ladderPeriodList": [
      {
        "minQuantity": 1,
        "maxQuantity": 100,
        "processPeriod": 8
      },
      {
        "minQuantity": 101,
        "maxQuantity": 1000,
        "processPeriod": 12
      }
    ]
  },
  "specifications": {
    "compatible brand": "For iPhone, For Samsung",
    "material": "TPU+PC",
    "OEM/ODM": "Warmly Welcomed"
  },
  "detailLevel": "full"
}

Frequently Asked Questions

Q: What supplier verification fields are extracted from Alibaba.com? Every record includes Gold Supplier years, Verified Supplier status, Trade Assurance flags, on-time delivery rate, supplier response time, review score, and country/province location.

Q: Does it extract tiered USD FOB pricing and MOQs? Yes. The scraper extracts structured USD price brackets, minimum order quantities (MOQ), unit types, lead times, and customization options for every B2B product listing.

Q: Can I scrape specific Alibaba supplier storefronts or search keywords? Yes. Provide any list of B2B sourcing keywords, category URLs, or supplier storefront URLs and filter by Trade Assurance, Verified Supplier, or minimum rating.

Q: How much does the Alibaba B2B Scraper cost? Runs are billed on Apify Pay-Per-Event at $0.0015 per product ($1.50 per 1,000 items), with a synchronous RapidAPI REST Gateway also available starting at $0 Free / $9 Pro.

⚡ Quick Installation & Local Usage

1. Run Interactively in Google Colab (Zero Local Setup)

Click Open in Google Colab ↗ (notebooks/quickstart.ipynb) to inspect the sample output DataFrame immediately and run live extractions in your browser without installing Python locally.

2. Run Locally with Python (`apify-client`)

git clone https://github.com/unitbytes/Taobao-Tmall-Alibaba-Scraper-API.git
cd Taobao-Tmall-Alibaba-Scraper-API
pip install -r requirements.txt
export APIFY_API_TOKEN="your_apify_api_token"
python examples/run_taobao_tmall_scraper.py

3. Import into n8n (Self-Hosted or Cloud)

Open any .json file inside the n8n/ folder (or copy in 1 click from unitbytes.com/n8n / n8n.io/creators/unitbytes).
Press Ctrl+V / Cmd+V directly onto your n8n workflow canvas.
Configure your Apify API Token in the HTTP Header Auth credential on Node 2. Run UnitBytes (...) (and customize your search inputs in Node 1. Configure Search & Rules), then click Test Workflow.

4. Use with AI Coding Agents (Cursor, Windsurf & Claude Code MCP)

This repository includes a ready-to-use Model Context Protocol configuration at .cursor/mcp.json pointing to https://mcp.apify.com with this suite's UnitBytes actors pre-registered. Open this folder in Cursor or Windsurf to let your AI agent run live extractions and inspect schemas automatically.

💼 Need Done-For-You Datasets or Custom Pipelines?

Don't want to manage API tokens or scripts? UnitBytes Data Delivery provides ready-to-use CSV, Excel (.xlsx), Google Sheets, or Webhook feeds tailored to your exact target keywords, cities, or categories.

🌐 Request a Sample Dataset: https://unitbytes.com/#enterprise-intake
📧 Direct Engineering Contact: contact@unitbytes.com
⚡ Explore All 41 Scrapers: https://unitbytes.com/actors/
📚 Engineering Playbooks & Guides: https://unitbytes.com/blog/
🔗 Official n8n Creator Profile: https://n8n.io/creators/unitbytes/

Navigation Menu

Repository navigation

About

Repository files navigation

🛍️ Taobao, Tmall & Alibaba B2B Wholesale Scraper API — Products, Seller Shops, Reviews, DSR, SKUs & Factory Tiers (淘宝 / 天猫 / 阿里巴巴)

📦 Included in This Repository (Python Quickstarts, Google Colab, n8n Workflows, MCP & Sample Data)

⚡ Pre-Configured 1-Click Task Presets

🛠️ Extraction Engines in This Suite

🚀 Taobao & Tmall 淘宝 Product Scraper — Products, Seller Shops, Reviews, DSR & Prices (`unitbytes/taobao-tmall-scraper`)

Key Capabilities

⚙️ Input Parameters (Schema)

🔥 Cookieless Taobao & Tmall Extraction Modes (`scrapeDetails`), Seller Storefronts (`shopUrls`) & 50+ Field Schema

📊 Key Extracted Columns (`taobao-tmall-scraper`)

Python SDK Quickstart (`examples/run_taobao_tmall_scraper.py`)

Sample Output Schema (`samples/taobao-tmall-scraper-sample.json`)

Frequently Asked Questions

🚀 Taobao & Tmall Seller Catalog & Shop Scraper (淘宝店铺) (`unitbytes/taobao-seller-shop-scraper`)

Key Capabilities

⚙️ Input Parameters (Schema)

Python SDK Quickstart (`examples/run_taobao_seller_shop_scraper.py`)

Sample Output Schema (`samples/taobao-seller-shop-scraper-sample.json`)

Frequently Asked Questions

🚀 Alibaba Scraper: Wholesale Products & Factory Finder (`unitbytes/alibaba-scraper`)

Key Capabilities

⚙️ Input Parameters (Schema)

⚡ Real-Time Synchronous REST API (RapidAPI Hub & Zyla API Hub — Sub-Second Response)

Python SDK Quickstart (`examples/run_alibaba_scraper.py`)

Sample Output Schema (`samples/alibaba-scraper-sample.json`)

Frequently Asked Questions

⚡ Quick Installation & Local Usage

1. Run Interactively in Google Colab (Zero Local Setup)

2. Run Locally with Python (`apify-client`)

3. Import into n8n (Self-Hosted or Cloud)

4. Use with AI Coding Agents (Cursor, Windsurf & Claude Code MCP)

💼 Need Done-For-You Datasets or Custom Pipelines?

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
.cursor		.cursor
.github		.github
examples		examples
n8n		n8n
notebooks		notebooks
samples		samples
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
SECURITY.md		SECURITY.md
requirements.txt		requirements.txt

Latest commit

History

Folders and files

Repository files navigation

🛍️ Taobao, Tmall & Alibaba B2B Wholesale Scraper API — Products, Seller Shops, Reviews, DSR, SKUs & Factory Tiers (淘宝 / 天猫 / 阿里巴巴)

📦 Included in This Repository (Python Quickstarts, Google Colab, n8n Workflows, MCP & Sample Data)

⚡ Pre-Configured 1-Click Task Presets

🛠️ Extraction Engines in This Suite

🚀 Taobao & Tmall 淘宝 Product Scraper — Products, Seller Shops, Reviews, DSR & Prices (unitbytes/taobao-tmall-scraper)

Key Capabilities

⚙️ Input Parameters (Schema)

🔥 Cookieless Taobao & Tmall Extraction Modes (scrapeDetails), Seller Storefronts (shopUrls) & 50+ Field Schema

📊 Key Extracted Columns (taobao-tmall-scraper)

Python SDK Quickstart (examples/run_taobao_tmall_scraper.py)

Sample Output Schema (samples/taobao-tmall-scraper-sample.json)

Frequently Asked Questions

🚀 Taobao & Tmall Seller Catalog & Shop Scraper (淘宝店铺) (unitbytes/taobao-seller-shop-scraper)

Key Capabilities

⚙️ Input Parameters (Schema)

Python SDK Quickstart (examples/run_taobao_seller_shop_scraper.py)

Sample Output Schema (samples/taobao-seller-shop-scraper-sample.json)

Frequently Asked Questions

🚀 Alibaba Scraper: Wholesale Products & Factory Finder (unitbytes/alibaba-scraper)

Key Capabilities

⚙️ Input Parameters (Schema)

⚡ Real-Time Synchronous REST API (RapidAPI Hub & Zyla API Hub — Sub-Second Response)

Python SDK Quickstart (examples/run_alibaba_scraper.py)

Sample Output Schema (samples/alibaba-scraper-sample.json)

Frequently Asked Questions

⚡ Quick Installation & Local Usage

1. Run Interactively in Google Colab (Zero Local Setup)

2. Run Locally with Python (apify-client)

3. Import into n8n (Self-Hosted or Cloud)

4. Use with AI Coding Agents (Cursor, Windsurf & Claude Code MCP)

💼 Need Done-For-You Datasets or Custom Pipelines?

About

Topics

Resources

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

🚀 Taobao & Tmall 淘宝 Product Scraper — Products, Seller Shops, Reviews, DSR & Prices (`unitbytes/taobao-tmall-scraper`)

🔥 Cookieless Taobao & Tmall Extraction Modes (`scrapeDetails`), Seller Storefronts (`shopUrls`) & 50+ Field Schema

📊 Key Extracted Columns (`taobao-tmall-scraper`)

Python SDK Quickstart (`examples/run_taobao_tmall_scraper.py`)

Sample Output Schema (`samples/taobao-tmall-scraper-sample.json`)

🚀 Taobao & Tmall Seller Catalog & Shop Scraper (淘宝店铺) (`unitbytes/taobao-seller-shop-scraper`)

Python SDK Quickstart (`examples/run_taobao_seller_shop_scraper.py`)

Sample Output Schema (`samples/taobao-seller-shop-scraper-sample.json`)

🚀 Alibaba Scraper: Wholesale Products & Factory Finder (`unitbytes/alibaba-scraper`)

Python SDK Quickstart (`examples/run_alibaba_scraper.py`)

Sample Output Schema (`samples/alibaba-scraper-sample.json`)

2. Run Locally with Python (`apify-client`)