# Taobao & Tmall Seller Catalog & Shop Scraper (淘宝店铺) (`unitbytes/taobao-seller-shop-scraper`) Actor ⚡ 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 link. MCP & AI Agent ready. - **URL**: https://apify.com/unitbytes/taobao-seller-shop-scraper.md - **Developed by:** [UnitBytes | Enterprise Web Data](https://apify.com/unitbytes) (community) - **Categories:** E-commerce, Lead generation, Agents - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.05 / 1,000 seller catalog product scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## 🏪 Taobao & Tmall Seller Catalog & Shop Inventory Scraper — Storefront Products, 3-Axis DSR Ratings, Reviews & Prices (淘宝店铺商品采集)

Try it for Free
⚡ 1-Click Free Trial: Test live queries using Apify's free monthly credit • No credit card required

[![Available on Apify](https://img.shields.io/badge/Available_on-Apify-28B52A?style=for-the-badge\&logo=apify\&logoColor=white)](https://console.apify.com/actors/VnFNV2i0Km7Y68UJP?addFromActorId=VnFNV2i0Km7Y68UJP) [![Price](https://img.shields.io/badge/Price-From_$0.0015%2Fitem-orange?style=for-the-badge)](#-cost-effective-pay-per-event-ppe-pricing) [![Free Trial](https://img.shields.io/badge/Free_Monthly_Trial-Up_to_3%2C330_Products-brightgreen?style=for-the-badge)](#-cost-effective-pay-per-event-ppe-pricing) [![Details](https://img.shields.io/badge/Details-Reviews_%26_3--Axis_DSR-blue?style=for-the-badge)](#-what-data-you-get-spreadsheet-columns-preview) [![Export](https://img.shields.io/badge/Export-Excel%2C_CSV%2C_Sheets-green?style=for-the-badge)](#-how-to-use-in-3-simple-steps-no-coding-required) [![Auth](https://img.shields.io/badge/Auth-100%25_Cookieless-teal?style=for-the-badge)](#-how-to-use-in-3-simple-steps-no-coding-required) **The fastest, cheapest, and most reliable cookieless Taobao (淘宝) & Tmall (天猫) Seller Catalog & Shop Inventory Scraper on Apify. Extract any seller's listed products, 3-axis DSR reputation scores, total item counts, customer reviews, buyer sentiment tags, multi-currency prices (`CNY`, `HKD`, `TWD`), and permanent HD photos by Shop URL, Shop ID, Seller Handle, or Product Link — Zero Login, Zero Cookies & Zero Chinese Phone Number Required.** [**🚀 Try it Free on Apify**](https://console.apify.com/actors/VnFNV2i0Km7Y68UJP?addFromActorId=VnFNV2i0Km7Y68UJP) • [**📊 View Sample Data**](#-sample-output-preview) • [**💡 Quickstart Guide**](#-how-to-use-in-3-simple-steps-no-coding-required) • [**❓ FAQ**](#-frequently-asked-questions-faq)
*** > \[!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**. Extracts clean flat columns per product directly into Excel, CSV, or JSON with **zero duplicate items**. *** > \[!NOTE] > > ### 🔍 How This Cookieless Seller Scraper Works & Data Transparency > > Domestic `taobao.com` and `tmall.com` storefronts block unauthenticated visitors with mandatory SMS/QR login walls. To extract real Mainland Taobao & Tmall seller catalogs **100% cookieless**, this Actor queries Alibaba's official Server-Side Rendered (SSR) portal (**`world.taobao.com/dianpu/{shopId}.htm`** & **`world.taobao.com/product/{shopName}.htm`**): > > - **What You Get**: Every seller's `shopId`, `shopName`, `sellerUserId`, `shopLogo`, `shopItemCount`, 3-axis DSR scores (`dsrDescription`, `dsrService`, `dsrDelivery`), plus each product's full untruncated `title`, `price` (`CNY`, `HKD`, `TWD`), `discountType`, `taobaoUrl`, and permanent HD photo. When `scrapeDetails: true` is enabled, each item is further enriched with `reviewCount`, `reviewTags`, featured `reviews`, purchased SKU `attributes`, `location`, and `categoryPath`. > - **What Requires Domestic Account Login (Not Exposed on Public SSR Pages)**: Interactive multi-color/size SKU inventory tables and exact monthly unit sales (`salesCount`) are gated behind domestic login and are not exposed on public pages. *** ### 🎯 4 Ways to Target Any Taobao or Tmall Seller Paste any of the following formats into **`shopUrls`** or **`sellers`**—the scraper resolves the seller automatically: 1. **Direct Shop URLs:** `https://world.taobao.com/dianpu/63978904.htm` or `https://shop63978904.taobao.com` 2. **Numeric Shop IDs:** `63978904` or `103710607` 3. **Brand / Seller Handles & Subdomains:** `inman`, `torras`, `https://inman.tmall.com`, or `優送網` 4. **Any Product URL from That Seller:** `https://detail.tmall.com/item.htm?id=1085260672042` (automatically resolves the product's seller and extracts their storefront catalog!) *** ### 🚀 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/...` | Official storefront name and permanent shop logo URL. | | **`shopItemCount`** | `406` | Total number of active products listed in the seller's 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` | Direct links to the seller's storefront on Taobao Global and domestic Taobao. | | **`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** (when `scrapeDetails: true`): Buyer comment, date, purchased SKU, and buyer videos. | | **`skus` / `attributes`** | `[{"skuId": "sku_1", "name": "規格:4L*4桶整箱", "price": 199.0}]` | Purchased SKU variations and parsed `key:value` attributes extracted from featured customer reviews (`scrapeDetails: true`). | | **`mainImage` & `images`** | `https://img.alicdn.com/...` | **Permanent HD Photo Gallery:** Master resolution links that never expire. | *** ### 📤 Sample Output Preview ```json { "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/i4/TB1ikRuRVXXXXasXFXXSutbFXXX.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/i4/393647717/O1CN01gOUfCe26sRYB6nbu3_!!393647717.jpg", "images": [ "https://img.alicdn.com/imgextra/i4/393647717/O1CN01gOUfCe26sRYB6nbu3_!!393647717.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 Any Product Link** | ✅ **Yes (`detail.tmall.com/item.htm?id=...`)** | ⚠️ Often requires numeric shopId only | | **Resolve Seller from Brand Handle (`inman`)** | ✅ **Yes** | ⚠️ Limited | | **3-Axis Seller DSR Scores & Total Item Count** | ✅ **Yes (Included on every row)** | ❌ Often missing | | **Customer Reviews & Buyer Sentiment Tags** | ✅ **Yes (`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**](https://apify.com/unitbytes/taobao-tmall-scraper) | Keyword product search, seller catalogs, reviews & direct item details | | 🇨🇳 [**1688 Wholesale Factory Scraper**](https://apify.com/unitbytes/1688-scraper) | Factory-direct B2B wholesale pricing, MOQ, and Amazon FBA packaging specs | | 📸 [**1688 Reverse Image Search Scraper**](https://apify.com/unitbytes/1688-image-search-scraper) | Find direct Chinese factories by product photo | | 🌐 [**Alibaba B2B Supplier Scraper**](https://apify.com/unitbytes/alibaba-scraper) | Global B2B suppliers, verified export audits & OEM/ODM | | 🐟 [**Goofish (Xianyu) Search Scraper**](https://apify.com/unitbytes/goofish-xianyu-search-scraper) | Secondhand C2C deals, liquidation & sample sourcing | | 📕 [**Xiaohongshu (RedNote) Trend Scraper**](https://apify.com/unitbytes/xiaohongshu-rednote-trend-scraper) | Viral Chinese product trends, social commerce & KOL discovery | *** ### 💻 Python & Node.js API Usage ```python 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](https://apify.com/unitbytes/taobao-seller-shop-scraper/issues) or reach out to `contact@unitbytes.com`. - **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](https://blog.apify.com/is-web-scraping-legal/). # Actor input Schema ## `shopUrls` (type: `array`): 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/63978904.htm or https://shop63978904.taobao.com • Numeric Shop IDs: '63978904' • Seller handles or brand subdomains: 'inman', 'torras', or 'https://inman.tmall.com' • Any Product URL: https://detail.tmall.com/item.htm?id=1085260672042 (automatically resolves the seller and scrapes their storefront catalog) ## `sellers` (type: `array`): Optional list of seller handles, brand names, or numeric shop IDs (e.g. \['inman', '優送網', '34033352']). ## `startUrls` (type: `array`): Paste Taobao, Tmall, or World Taobao shop links or product URLs directly from your browser. ## `scrapeDetails` (type: `boolean`): 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). Disable for ultra-fast storefront catalog extraction (~1s per shop). ## `maxItems` (type: `integer`): Maximum total number of seller products to scrape across the run (1 to 10,000). ## `maxItemsPerSeller` (type: `integer`): Optional cap on how many products to extract per seller when batch-scraping multiple shops in a single run. ## `startPage` (type: `integer`): Page number to start scraping from (1, 2, 5). ## `sortBy` (type: `string`): Sorting order when expanding seller product catalogs. ## `priceMin` (type: `integer`): Minimum unit price in Chinese Yuan (CNY ¥). ## `priceMax` (type: `integer`): Maximum unit price in Chinese Yuan (CNY ¥). ## `proxyConfiguration` (type: `object`): Proxy settings. Automatically uses Apify Residential proxies on cloud runs to prevent rate limits. ## Actor input object example ```json { "shopUrls": [ "https://world.taobao.com/dianpu/63978904.htm" ], "scrapeDetails": true, "maxItems": 30, "startPage": 1, "sortBy": "default", "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): Extracted Taobao and Tmall seller storefront catalogs, 3-axis DSR ratings, customer reviews, sentiment tags, prices (CNY/HKD/TWD), and shop intelligence # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "shopUrls": [ "https://world.taobao.com/dianpu/63978904.htm" ], "maxItems": 30, "startPage": 1 }; // Run the Actor and wait for it to finish const run = await client.actor("unitbytes/taobao-seller-shop-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "shopUrls": ["https://world.taobao.com/dianpu/63978904.htm"], "maxItems": 30, "startPage": 1, } # Run the Actor and wait for it to finish run = client.actor("unitbytes/taobao-seller-shop-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "shopUrls": [ "https://world.taobao.com/dianpu/63978904.htm" ], "maxItems": 30, "startPage": 1 }' | apify call unitbytes/taobao-seller-shop-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,unitbytes/taobao-seller-shop-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/VnFNV2i0Km7Y68UJP/builds/gbuLhMjc3qHBrGuwP/openapi.json