# Taobao Scraper (`automly/taobao-scraper`) Actor

Scrape Taobao and Tmall products by keyword, category, shop or product link: title, price in yuan (plus HKD, TWD and 12 local storefront currencies), shop, photos, with optional seller scores, credit level, ratings and the latest review.

- **URL**: https://apify.com/automly/taobao-scraper.md
- **Developed by:** [Automly](https://apify.com/automly) (community)
- **Categories:** E-commerce, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 1,000 products

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 Scraper

### What is Taobao Scraper?

**Taobao Scraper** is a tool that lets you **scrape products from Taobao and Tmall**: title, price in Chinese yuan (plus Hong Kong and Taiwan dollars, or the currency of 12 Taobao country storefronts), promotion label, shop, photos, category and product link, with an option to add the seller's profile (Taobao or Tmall, individual or business seller, credit level, shop opening date, number of products and its three service scores), the rating split, the newest review, where the product ships from and its category path. Search by keyword, open a category or a shop, or paste Taobao and Tmall product links, click **Start**, and download the products as Excel, CSV or JSON.

- ⚡ **Fast:** Taobao's top 40 products for a keyword in a few seconds
- 🏪 **Seller checks built in:** credit level, shop age, catalogue size and the description, service and delivery scores
- 💱 **13 storefronts:** prices in CNY, SGD, MYR, THB, VND, PHP, KHR, MOP, AUD, NZD, KRW, JPY or CAD, with yuan, HKD and TWD on every product
- 🛍️ **Taobao and Tmall:** item.taobao.com, detail.tmall.com, detail.tmall.hk, m.intl.taobao.com and world.taobao.com links, or bare item ids
- 🔓 **No login:** no Taobao account, cookies or app needed

### What can Taobao Scraper do?

- **Scrape Taobao search results** for any keyword, like `手机壳`, `连衣裙`, `蓝牙耳机`, `phone case` or `lipstick`
- **Scrape a Taobao category** by its id or link, like `50064014` (mineral and purified water)
- **Scrape a Taobao shop's products** by its shop id or link, with the shop's scores on every row
- **Scrape Taobao and Tmall product pages** from their links or item ids
- **Check a seller before you order:** credit level, shop opening date, number of products and its three service scores
- **Compare prices across storefronts:** the same search in Singapore dollars, Malaysian ringgit, yen or Australian dollars
- **Track Taobao prices and promotions** with a daily schedule
- Export to Excel, CSV, JSON, HTML or XML, or send the data to Google Sheets, Make, Zapier and more

### What data can you extract from Taobao?

| | | |
|---|---|---|
| 🏷️ Full title and product link | 💰 Price, currency and yuan price | 💱 HKD and TWD prices |
| 🎁 Promotion label and original price | 📸 Main photo | 🆔 Product, shop and category IDs |
| 🏪 Shop name | 🚚 Free shipping flag | ⭐ Shop description score |
| 🛒 Taobao or Tmall\* | 👤 Seller type and credit level\* | 📅 Shop opening date and size\* |
| 📊 Description, service and delivery scores\* | 👍 Positive, neutral and negative review share\* | 💬 The newest review, with the option bought\* |
| 📍 Ships from\* | 🗂️ Category path\* | 💳 Payment methods\* |

\* With **Include seller and rating details**, and always for product links. Shop rows also carry the shop's three scores and seller id without details.

### How to scrape Taobao

1. [Create a free Apify account](https://console.apify.com/sign-up).
2. Open **Taobao Scraper**.
3. Enter search words, category ids, shop ids or product links, one per line.
4. Pick a storefront for the currency and turn on **Include seller and rating details** if you want the seller profile.
5. Click **Start**, then download the products as Excel, CSV, JSON or HTML.

### How much does it cost to scrape Taobao?

You pay per product saved. A product with seller and rating details costs a little more than a product from a search, category or shop list alone.

| Apify plan | Products per 1,000 | Products with details per 1,000 |
|---|---|---|
| Free | $2.79 | $4.49 |
| Starter (Bronze) | $2.49 | $3.99 |
| Scale (Silver) | $2.29 | $3.49 |
| Business (Gold) and higher | $1.99 | $2.99 |

Platform usage is included in these prices, so you pay nothing else for the run.

Example: 1,000 products from searches cost $2.79 on the Free plan and $1.99 on Business. With seller and rating details, the same 1,000 cost $4.49 and $2.99.

Every Apify account gets **$5 of free usage each month**, which is plenty to try the scraper on real searches. **Max products** keeps the cost of a run under control, and you can also set a maximum cost per run.

### ⬇️ Input

| Setting | What it does |
|---|---|
| **Search words** | What to search for, like `手机壳` or `phone case`, one per line. Chinese words find the most |
| **Storefront (currency)** | Global (yuan) by default, or one of 12 country storefronts for local prices and simplified Chinese titles |
| **Categories** | Category ids or links, like `50064014` |
| **Shops** | Shop ids or links, like `188555483` or `https://shop188555483.taobao.com` |
| **Product links or ids** | Taobao and Tmall product links or item ids; search, category and shop links work here too |
| **Include seller and rating details** | Opens each product's page for the seller profile, ratings, newest review and more |
| **Max products** | Most products to save in the run (default 100). Set 0 for no limit |
| **Proxy configuration** | Leave the default |

Phone cases and Bluetooth earphones in Singapore dollars, with seller details:

```json
{
  "searchQueries": ["手机壳", "蓝牙耳机"],
  "region": "sg",
  "includeDetails": true,
  "maxItems": 80
}
```

A category, a shop and two product links:

```json
{
  "categoryIds": ["50064014"],
  "shopIds": ["188555483"],
  "startUrls": [
    "https://item.taobao.com/item.htm?id=730344766230",
    "https://detail.tmall.com/item.htm?id=1083623832870"
  ]
}
```

### ⬆️ Output

Each product is one row. A product from a shop with details on looks like this (shortened):

```json
{
  "itemId": "1010306177499",
  "title": "新款老人機2026年5G全網通4G老年人手機電信移動備用手機超長待機",
  "url": "https://world.taobao.com/item/1010306177499.htm",
  "taobaoUrl": "https://item.taobao.com/item.htm?id=1010306177499",
  "price": 185,
  "currency": "CNY",
  "priceCny": 185,
  "originalPriceCny": null,
  "priceHkd": 219.72,
  "priceTwd": 910.11,
  "promotion": null,
  "image": "https://img.alicdn.com/imgextra/i4/2200733115816/O1CN01b0JeIQ1spmeAaOAva_!!2200733115816.png",
  "shopId": "188555483",
  "shopName": "十三手機通訊",
  "categoryId": "1512",
  "freeShipping": false,
  "platform": "taobao",
  "shipsFrom": "廣東深圳",
  "positiveRatePercent": 100,
  "positiveReviews": "200+",
  "negativeReviews": "0",
  "latestReview": {
    "rating": 5,
    "text": "整體使用體驗很棒，看影片玩遊戲都滿意。",
    "date": "2026-10-13T13:34:00",
    "variant": "機身顏色:中國紅【5G增強版】（訊號更好）;網路類型:行動版;套餐類型:官方標配;儲存容量:768MB",
    "reviewer": "***"
  },
  "sellerId": "2200733115816",
  "sellerType": "individual",
  "sellerCreditLevel": 13,
  "shopOpenedAt": "2019-03-04T21:59:56",
  "shopItemCount": 16,
  "shopScores": { "description": 4.8, "service": 4.8, "delivery": 4.9 },
  "paymentMethods": ["蚂蚁花呗", "信用卡支付", "集分宝"],
  "rank": 2,
  "region": "world",
  "sourceType": "shop",
  "source": "188555483",
  "scrapedAt": "2026-10-22T12:04:09Z"
}
```

The **Products** table shows photo, title, price, shop and rank; the **Sellers and ratings** table shows the seller profile, scores and the newest review. The run report (in the run's storage) lists every input with the products Taobao counts for it, what was saved, and any input that does not exist on Taobao.

### How can I use Taobao data?

- **Dropshipping and sourcing:** find suppliers for a product and check their credit level, shop age and scores before you order through an agent
- **Price research:** compare yuan prices with the same products on Amazon, AliExpress or Shopee, or watch a list of products every day
- **Brand monitoring:** see which shops sell your brand on Taobao and Tmall, at what price and with which promotions
- **Market research:** sample Taobao's best-ranked products for a keyword or category and see which sellers and cities lead
- **Seller lists:** collect shop ids and names from searches, then read each shop's products and scores

### How many products can I scrape from one search?

Taobao shows its **top 40 products** for a search word or a category, and **up to 60** for a shop, to visitors who are not logged in. To cover more of a market, add more search words (other phrasings, brands, models, Chinese and English), add the categories the products belong to (every row has its `categoryId`), and read the shops you find (every row has its `shopId`). A product found by several inputs is saved once.

### Use with AI agents (MCP)

AI assistants can run Taobao Scraper through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp). Ask in plain words, for example "find the top Taobao sellers of Bluetooth earphones with their scores", and the agent runs:

```json
{ "searchQueries": ["蓝牙耳机"], "includeDetails": true, "maxItems": 40 }
```

### Integrations and API

Run Taobao Scraper from your code with the [Apify API](https://docs.apify.com/api/v2), the [Python client](https://docs.apify.com/api/client/python/) or the [JavaScript client](https://docs.apify.com/api/client/js/). Schedule it daily or weekly, and send each run's products to Google Sheets, Slack, Make, Zapier, Airbyte or a webhook.

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("automly/taobao-scraper").call(run_input={
    "searchQueries": ["手机壳"],
    "region": "world",
    "includeDetails": True,
    "maxItems": 40,
})
for product in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(product["title"], product["priceCny"], product["shopName"])
```

### ❓FAQ

#### How much does it cost to scrape Taobao?

You pay per product saved, and products with seller and rating details cost a little more. The **Pricing** tab has the exact prices for your plan, and a new Apify account's monthly $5 of free usage covers a good first test.

#### Does it scrape Tmall too?

Yes. Tmall products show up in searches, categories and shops like any other, and Tmall links (`detail.tmall.com`, `detail.tmall.hk`) work as product links. With details on, `platform` says `taobao` or `tmall`, and `taobaoUrl` points to the right site.

#### Do I need a Taobao account?

No. The scraper only reads what Taobao shows to any visitor who is not logged in. You do not need an account, cookies or the Taobao app.

#### Does it give variants (SKUs), stock or sales numbers?

No. Taobao shows option lists with their prices and stock, sales counts and the full review list only to logged-in shoppers, so they are not in the data. You get the product's price (and `hasPriceRange: true` when the price depends on the option), the rating split and the newest review with the option that buyer chose.

#### Why is the title shortened on some products?

Taobao prints a shortened title on product pages. Products found by a search, category or shop always have their full title; a product pasted as a link has the title its page shows (`pageTitle`), ending in "...".

#### Which currencies and languages are supported?

The global storefront gives yuan prices with titles in traditional Chinese. The country storefronts (Singapore, Malaysia, Thailand, Vietnam, the Philippines, Cambodia, Macau, Australia, New Zealand, South Korea, Japan and Canada) give search results in their own currency with titles in simplified Chinese. Every product also carries its yuan, Hong Kong dollar and Taiwan dollar prices.

#### What happens with a search word, product or shop that does not exist?

It is listed as not found in the run's log and report, and the run carries on with the other inputs. Taobao only has result lists for real product words, so a made-up word or a long sentence may have none: try a shorter word or its Chinese name.

#### Can I get more than 40 products for a keyword?

Taobao shows 40 per search word to visitors. Add related words, the categories and the shops you find to reach more; each product is saved once per run. See [How many products can I scrape from one search?](#how-many-products-can-i-scrape-from-one-search)

#### Is it legal to scrape Taobao?

The scraper collects only public product and shop information that Taobao shows to anyone without logging in, and no personal data: reviewer names come masked by Taobao. Check the rules that apply to your use, such as copyright on photos and your local data laws. Taobao Scraper is not affiliated with or endorsed by Taobao, Tmall or Alibaba Group.

#### Something does not work. What can I do?

Open the **Issues** tab and tell us the input you used and what you expected. We read every issue and usually reply within a day. If the scraper helps you, a review on the Store helps other buyers find it.

# Actor input Schema

## `searchQueries` (type: `array`):

What to search Taobao for, one word or phrase per line, e.g. 手机壳, 连衣裙, phone case, lipstick. Chinese words find the most. Each search gives Taobao's top products for it (up to 40), in the storefront chosen below.

## `region` (type: `string`):

Which Taobao storefront the search words run in, e.g. Singapore for prices in SGD and simplified Chinese titles. The yuan price, plus HKD and TWD, comes with every product anyway. Categories, shops and product links always give yuan prices.

## `categoryIds` (type: `array`):

Taobao category ids or links, e.g. 50064014 or https://world.taobao.com/category/50064014.htm. Each gives the category's top products (up to 40).

## `shopIds` (type: `array`):

Taobao shop ids or links, e.g. 188555483, https://world.taobao.com/dianpu/188555483.htm or https://shop188555483.taobao.com. Each gives the shop's listed products (up to 60) with the shop's scores. Every product row carries its shopId, so you can feed shops back here.

## `startUrls` (type: `array`):

Taobao or Tmall product links or item ids, e.g. https://item.taobao.com/item.htm?id=730344766230, https://detail.tmall.com/item.htm?id=1083623832870, world.taobao.com/item/... or 730344766230. Search, category and shop links work here too.

## `includeDetails` (type: `boolean`):

Open each product's page and add Taobao or Tmall, the seller (id, individual or business, credit level, shop opening date, item count, its three service scores), the rating split, the latest review, ships-from city, category path and payment methods. Slower and charged as a detailed product. Product links always come with these details.

## `maxItems` (type: `integer`):

Most products to save in the whole run, e.g. 100. Set 0 for no limit (every product the inputs list).

## `proxyConfiguration` (type: `object`):

Leave the default.

## Actor input object example

```json
{
  "searchQueries": [
    "手机壳"
  ],
  "region": "world",
  "includeDetails": true,
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `products` (type: `string`):

No description

## `details` (type: `string`):

No description

## `results` (type: `string`):

No description

## `report` (type: `string`):

No description

# 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 = {
    "searchQueries": [
        "手机壳"
    ],
    "region": "world",
    "includeDetails": true,
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("automly/taobao-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 = {
    "searchQueries": ["手机壳"],
    "region": "world",
    "includeDetails": True,
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("automly/taobao-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 '{
  "searchQueries": [
    "手机壳"
  ],
  "region": "world",
  "includeDetails": true,
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call automly/taobao-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automly/taobao-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/zgubVYVT2nQbdWlcV/builds/NYpc2Q1CdwfiA28gf/openapi.json