# Taobao & Tmall Product Scraper 淘宝天猫—Search & Sale (`axon-studio/taobao-tmall-scraper`) Actor

Reliable, no-login Taobao (淘宝) & Tmall (天猫) product search API. Search by English or Chinese keywords, sort by top sales or price, filter Tmall flagship stores, and extract CNY/USD prices, monthly sales, provinces & Superbuy/CNFans links. Ready for n8n & MCP.

- **URL**: https://apify.com/axon-studio/taobao-tmall-scraper.md
- **Developed by:** [Axon Studio](https://apify.com/axon-studio) (community)
- **Features:** Limited permissions
- **Stats:** 14 total users, 8 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.70 / 1,000 item 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

Scrape real-time product listings, CNY (`¥`) and USD (`$`) prices, monthly sales volume, Tmall (`天猫`) flagship store badges, seller warehouse provinces (`regionEn`), HD product images, and 1-click purchasing agent links (`CNFans`, `Superbuy`, `Hoobuy`, `AllChinaBuy`, `Mulebuy`, `Sugargoo`) directly from **Taobao (`淘宝`) and Tmall (`天猫`)**.

Built for **cross-border e-commerce sellers, dropshippers, sourcing agents, and market researchers** — **100% no Taobao cookies, no QR login, and no proxies required**. Type keywords in plain English or Simplified Chinese and get clean, structured product datasets in seconds. Free plan users get instant sample previews plus 1 live custom search trial (up to 10 items); upgrade to any paid Apify plan to unlock unlimited live searches up to **5,000 products per run**.

[![Open in Apify Console](https://img.shields.io/badge/🚀_Try_Free_in_Apify_Console-Taobao_%26_Tmall_Search-FF5000?style=for-the-badge)](https://apify.com/axon-studio/taobao-tmall-scraper)
[![Auto EN to ZH Translation](https://img.shields.io/badge/Auto_EN→ZH_Localization-CNY_%26_USD_Prices-blueviolet?style=for-the-badge)](https://apify.com/axon-studio/taobao-tmall-scraper)
[![100% No Cookie](https://img.shields.io/badge/Zero_Taobao_Login-Ready_for_n8n_%26_Claude_MCP-00A1D6?style=for-the-badge)](https://apify.com/axon-studio/taobao-tmall-scraper)

| Need | Actor |
| :--- | :--- |
| **Taobao & Tmall Product Search (淘宝/天猫商品搜索)** | **[axon-studio/taobao-tmall-scraper](https://apify.com/axon-studio/taobao-tmall-scraper)** *(Current)* |
| **Goofish / Xianyu Second-Hand Deals (闲鱼二手海淘)** | **[axon-studio/goofish-xianyu-scraper](https://apify.com/axon-studio/goofish-xianyu-scraper)** |
| **WeChat Official Account Articles & Markdown (微信公众号)** | **[axon-studio/wechat-official-account-scraper](https://apify.com/axon-studio/wechat-official-account-scraper)** |
| **Douyin Videos, 1080p MP4 & Shop (抖音短视频/商城)** | **[axon-studio/douyin-scraper](https://apify.com/axon-studio/douyin-scraper)** |
| **Sina Weibo Search, Posts & Hot Trends (新浪微博)** | **[axon-studio/weibo-scraper](https://apify.com/axon-studio/weibo-scraper)** |
| **Bilibili Videos, Danmaku & UP Creators (哔哩哔哩 B站)** | **[axon-studio/bilibili-scraper](https://apify.com/axon-studio/bilibili-scraper)** |
| **BlackCat Consumer Complaints (新浪黑猫投诉)** | **[axon-studio/blackcat-complaints-scraper](https://apify.com/axon-studio/blackcat-complaints-scraper)** |

#### Copy to your AI assistant (Claude, ChatGPT, Cursor & Windsurf)

```text
Help me use axon-studio/taobao-tmall-scraper on Apify to search Taobao (淘宝) and Tmall (天猫) products by keyword. Read https://apify.com/axon-studio/taobao-tmall-scraper.md for complete documentation, input schema, output fields, and pricing. Configure the optimal input JSON for my product research (supports English or Chinese keywords, top-sales sorting, Tmall-only filtering, and CNY price range filters).
```

***

### What Can This Taobao & Tmall Scraper Do? (Features)

| Capability | Built-In Advantage |
| :--- | :--- |
| **Direct Keyword Product Discovery** | Search across hundreds of millions of Taobao (`淘宝`) and Tmall (`天猫`) listings by keyword with **zero cookies or Taobao accounts required**. |
| **4 Native Taobao Sort Orders (`sort`)** | Sort by **Top Sales First (`_sale`)** to spot bestsellers, **Comprehensive Relevance (`_coefp`)**, **Price: Low to High (`bid`)**, or **Price: High to Low (`_bid`)**. |
| **Tmall Flagship & Price Range Filters** | Restrict results to verified **Tmall (`tmallOnly: true`)** brand stores and filter by exact minimum/maximum CNY `¥` price (`minPrice` / `maxPrice`). |
| **Auto EN ↔ ZH E-Commerce Localization** | Enter plain English product queries (`"mechanical keyboard"`, `"wireless earbuds"`, `"hoodie"`) and automatically translate them into high-recall Simplified Chinese search terms. |
| **CNY + USD Pricing & Normalized Sales** | Converts Chinese sales badges (`"4万+人付款"`) into clean integers (`40000`) and automatically calculates USD `$` prices (`priceUsd`). |
| **6 Cross-Border Agent Links Included** | Every product includes ready-to-buy `CNFans`, `Superbuy`, `Hoobuy`, `AllChinaBuy`, `Mulebuy`, and `Sugargoo` links plus bilingual seller warehouse locations (`regionEn`). |

***

### How to Scrape Taobao & Tmall in 3 Easy Steps

1. **Enter `keywords`** — Type one or more product keywords in **English or Chinese** (e.g., `mechanical keyboard`, `wireless earbuds`, `连衣裙`).
2. **Choose Sort & Filters (Optional)** — Keep the default `Top Sales First (_sale)` sort order, toggle `tmallOnly` if you only want official brand stores, or set `minPrice` / `maxPrice`.
3. **Click "Start"** — Download your product dataset in **JSON, CSV, Excel, or Parquet**, or connect directly to **n8n, Make, Google Sheets, or Claude MCP**.

***

### Taobao & Tmall Scraper Use Cases

| Buyer Profile | E-Commerce & Market Intelligence Use Case |
| :--- | :--- |
| **Dropshippers & Shopify / Amazon Sellers** | Discover top-selling Chinese products sorted by monthly sales volume (`_sale`) and compare Taobao/Tmall factory pricing against Western retail prices |
| **Cross-Border Purchasing Agents & Communities** | Generate structured product feeds with 1-click `CNFans`, `Superbuy`, `Hoobuy`, `AllChinaBuy`, `Mulebuy`, and `Sugargoo` purchasing links |
| **Global Brand & Price Monitoring Teams** | Track authorized Tmall flagship store pricing (`tmallOnly: true`), discount spreads, and unauthorized gray-market sellers across China |
| **AI Shopping & Sourcing Agents** | Connect via Apify MCP Server or REST API so AI assistants can query live Chinese product catalogs and prices in real time |

***

### Input

All parameters are configured in the **Input** tab (`"required": []` — all fields have smart defaults). Below is the complete 1-to-1 parameter reference table and JSON input examples:

| Input Field | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| **`keywords`** | `array` | `[]` *(Prefill: `["mechanical keyboard"]`)* | One or more product search keywords in English or Simplified Chinese. |
| **`sort`** | `string` | `"_sale"` | `"_sale"` (Top Sales First), `"_coefp"` (Comprehensive Relevance), `"bid"` (Price: Low to High), or `"_bid"` (Price: High to Low). |
| **`tmallOnly`** | `boolean` | `false` | When `true`, filters results exclusively to verified Tmall (`天猫`) flagship and brand stores. |
| **`minPrice`** | `integer` | `null` | Optional minimum product price in Chinese Yuan (`CNY ¥`), passed as `startPrice`. |
| **`maxPrice`** | `integer` | `null` | Optional maximum product price in Chinese Yuan (`CNY ¥`), passed as `endPrice`. |
| **`autoLocalize`** | `boolean` | `true` | Automatically translates English search keywords into Simplified Chinese Taobao search terms. |
| **`maxResults`** | `integer` | `40` | Maximum number of products to extract (`1`–`5,000`). Free plan includes 1 live custom search preview (up to 10 items); paid plans unlock up to 5,000 items. |
| **`onlyNewResults`** | `boolean` | `false` | Delta Mode: skips `itemId`s already scraped in previous runs using persistent Key-Value Store (`axon-taobao-delta-store`). |

#### 1. Discover Top-Selling Products Using English Keywords (JSON)

```json
{
  "keywords": ["mechanical keyboard", "wireless mouse"],
  "sort": "_sale",
  "tmallOnly": false,
  "autoLocalize": true,
  "maxResults": 40
}
```

#### 2. Filter Verified Tmall Flagship Stores with CNY Price Range (JSON)

```json
{
  "keywords": ["连衣裙", "hoodie"],
  "sort": "_sale",
  "tmallOnly": true,
  "minPrice": 100,
  "maxPrice": 500,
  "maxResults": 100,
  "onlyNewResults": false
}
```

***

### Output

All scraped products are saved to your Apify **Dataset** and can be exported to JSON, CSV, Excel, XML, or Parquet. Below is a sample JSON output item matching the `"mechanical keyboard"` input above:

```json
{
  "itemId": "738492018472",
  "platform": "tmall",
  "isTmall": true,
  "title": "狼蛛F99无线三模客制化机械键盘Gasket结构全键热插拔RGB游戏办公",
  "price": 249.0,
  "priceUsd": 34.58,
  "originalPrice": 349.0,
  "salesCount": 40000,
  "salesText": "4万+人付款",
  "shopName": "狼蛛数码旗舰店",
  "sellerId": "220849102841",
  "shopId": "108492018",
  "regionName": "广东 东莞",
  "regionEn": "Guangdong Dongguan",
  "freeShipping": true,
  "images": [
    "https://img.alicdn.com/imgextra/i1/220849102841/O1CN01AULA99Keyboard01_!!220849102841.jpg"
  ],
  "agentLinks": {
    "cnfans": "https://cnfans.com/product/?shop_type=taobao&id=738492018472",
    "superbuy": "https://www.superbuy.com/en/page/buy/?nTag=Home-search&from=search-input&url=https%3A%2F%2Fdetail.tmall.com%2Fitem.htm%3Fid%3D738492018472",
    "hoobuy": "https://hoobuy.com/product/1/738492018472",
    "allchinabuy": "https://www.allchinabuy.com/en/page/buy/?nTag=Home-search&from=search-input&url=https%3A%2F%2Fdetail.tmall.com%2Fitem.htm%3Fid%3D738492018472",
    "mulebuy": "https://mulebuy.com/product/?shop_type=taobao&id=738492018472",
    "sugargoo": "https://www.sugargoo.com/#/home/productDetail?productLink=https%3A%2F%2Fdetail.tmall.com%2Fitem.htm%3Fid%3D738492018472&platform=TMALL"
  },
  "itemUrl": "https://detail.tmall.com/item.htm?id=738492018472",
  "queryOriginal": "mechanical keyboard",
  "queryUsed": "机械键盘",
  "scrapedAt": "2026-11-11T12:00:00+00:00"
}
```

#### Output Field Definitions

- **`itemId` / `platform` / `isTmall`**: 12-digit Taobao/Tmall product ID, marketplace name (`"tmall"` or `"taobao"`), and verified Tmall boolean flag.
- **`title` / `itemUrl`**: Clean HTML-stripped product title and direct `item.taobao.com` or `detail.tmall.com` URL.
- **`price` / `priceUsd` / `originalPrice`**: Current selling price in CNY (`¥`), converted USD (`$`) price, and original pre-discount price.
- **`salesCount` / `salesText`**: Parsed integer sales count (`40000`) and raw Taobao sales badge (`"4万+人付款"`).
- **`shopName` / `sellerId` / `shopId`**: Store title and unique seller/shop identifiers.
- **`regionName` / `regionEn` / `freeShipping`**: Warehouse location in Chinese (`"广东 东莞"`), English (`"Guangdong Dongguan"`), and free shipping badge.
- **`images` / `agentLinks`**: High-resolution product image URLs and 1-click purchasing links for 6 cross-border agents.

#### Data Coverage (Always Populated vs. Conditional)

| Coverage Tier | Fields |
| :--- | :--- |
| **Always Populated (100%)** | `itemId`, `platform`, `isTmall`, `title`, `price`, `priceUsd`, `salesCount`, `salesText`, `freeShipping`, `images`, `agentLinks`, `itemUrl`, `queryOriginal`, `queryUsed`, `scrapedAt` |
| **Conditional (When Provided by Seller)** | `originalPrice`, `shopName`, `sellerId`, `shopId`, `regionName`, `regionEn` (populated whenever exposed on the search card) |

***

### Automated Daily Taobao Price & Sales Monitoring (Schedules, API, n8n & Claude MCP)

1. Run the Actor once with your target `keywords` and `sort: "_sale"`.
2. In **Apify Console → Schedules → Create new schedule**, select **`axon-studio/taobao-tmall-scraper`** and set your cron interval (e.g., daily).
3. Enable **`onlyNewResults: true`** (Delta Mode) to receive only newly discovered product listings on each run.

#### Python, JavaScript & Synchronous REST API Integration

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_API_TOKEN")
run = client.actor("axon-studio/taobao-tmall-scraper").call(run_input={
    "keywords": ["mechanical keyboard", "wireless mouse"],
    "sort": "_sale",
    "tmallOnly": False,
    "minPrice": 80,
    "maxPrice": 500,
    "autoLocalize": True,
    "maxResults": 40,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["platform"], item["title"], item["price"], item["salesCount"])
```

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_API_TOKEN' });
const run = await client.actor('axon-studio/taobao-tmall-scraper').call({
    keywords: ['mechanical keyboard'],
    sort: '_sale',
    maxResults: 40,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);
```

```bash
curl -X POST "https://api.apify.com/v2/acts/axon-studio~taobao-tmall-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keywords":["mechanical keyboard"],"sort":"_sale","maxResults":20}'
```

***

### How Much Does It Cost to Scrape Taobao & Tmall? (Pricing)

**Pay-Per-Event pricing with volume discounts for Bronze, Silver, and Gold plans**

- **Free Plan Preview**: Includes instant sample runs on the default keyword plus **1 live custom keyword search preview** (up to 10 products) with no credit card required; upgrade to any paid Apify plan to unlock unlimited live searches up to 5,000 products per run.
- **No Extra Server Compute Fees**: Memory and CPU usage are included in the Pay-Per-Event rate.

***

### FAQ & Legal Compliance

#### Do I need a Taobao account, cookies, or Chinese proxies?

**No.** All requests are handled automatically without requiring personal Taobao login cookies or external proxies.

#### Can I search Taobao in English?

**Yes.** With `autoLocalize: true` (default), English product keywords are automatically translated into native Simplified Chinese search terms.

#### Is it legal to scrape public Taobao & Tmall product listings?

This Actor extracts publicly visible e-commerce product metadata (titles, prices, sales badges, and store names) and does not access private buyer accounts. Under **GDPR** and **PIPL**, ensure you have a lawful basis for market research or price comparison. *Not affiliated with Alibaba Group.*

# Actor input Schema

## `keywords` (type: `array`):

Enter one or more product keywords in English or Chinese (e.g., 'mechanical keyboard', 'wireless earbuds', 'hoodie', '连衣裙'). English keywords are automatically translated into Chinese.

## `sort` (type: `string`):

Choose how Taobao & Tmall search results are sorted.

## `tmallOnly` (type: `boolean`):

When enabled, filters results exclusively to verified Tmall (天猫) brand stores.

## `minPrice` (type: `integer`):

Minimum product price in Chinese Yuan (passed directly as 'startPrice' to Taobao search).

## `maxPrice` (type: `integer`):

Maximum product price in Chinese Yuan (passed directly as 'endPrice' to Taobao search).

## `autoLocalize` (type: `boolean`):

Automatically translates English queries into high-recall Simplified Chinese Taobao search terms.

## `maxResults` (type: `integer`):

Maximum number of Taobao/Tmall products to return (Free plan preview: 1 live custom search run capped at 10 items; unlimited runs & up to 5,000 items unlocked for paid plans).

## `onlyNewResults` (type: `boolean`):

When enabled, skips product IDs (itemId) already scraped in previous runs using persistent named Key-Value Store state.

## Actor input object example

```json
{
  "keywords": [
    "mechanical keyboard"
  ],
  "sort": "_sale",
  "tmallOnly": false,
  "autoLocalize": true,
  "maxResults": 40,
  "onlyNewResults": false
}
```

# Actor output Schema

## `dataset` (type: `string`):

Dataset containing extracted Taobao and Tmall product items.

## `summary` (type: `string`):

JSON summary report with keyword statistics and run metadata.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "keywords": [
        "mechanical keyboard"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("axon-studio/taobao-tmall-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "keywords": ["mechanical keyboard"] }

# Run the Actor and wait for it to finish
run = client.actor("axon-studio/taobao-tmall-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 '{
  "keywords": [
    "mechanical keyboard"
  ]
}' |
apify call axon-studio/taobao-tmall-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,axon-studio/taobao-tmall-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 <APIFY_API_TOKEN>` 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/hVIiACLcSyPjZGxdS/builds/SGSyMLY2d5FzrFGGX/openapi.json
