# Taobao & Tmall Shop Scraper - Store Products, Prices & Ratings (`hexagone-data/taobao-shop-scraper`) Actor

Scrape Taobao and Tmall shops: every product a visitor can reach (several sort orders merged, no duplicates), CNY/HKD/TWD prices, promo labels, selling points, images, ranks, shop ratings, Tmall flag, age, location. No login. Pay per row.

- **URL**: https://apify.com/hexagone-data/taobao-shop-scraper.md
- **Developed by:** [Hexagone Data](https://apify.com/hexagone-data) (community)
- **Categories:** E-commerce, Automation, Agents
- **Features:** Limited permissions
- **Stats:** 6 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.84 / 1,000 rows

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 Shop Scraper - Store Products, Prices & Ratings

Scrape the products of any Taobao or Tmall shop without a Taobao account: title, price in CNY with Taobao's HKD and TWD conversion, promotion label, selling points, images, categories, rank in each sort order, and the shop's ratings, Tmall flag, age and location. For sourcing and dropshipping research, competitor and reseller price monitoring, or importing a shop's catalogue into a spreadsheet.

### Why this one: every product a visitor can reach, counted against the shop's total

Taobao shows a visitor without an account **at most 60 products per sort order**. One reading of a shop gives 60 products, whatever its size. This Actor reads several sort orders (default, best sellers, newest, price low to high, price high to low), merges them **without duplicates**, and says per shop how many distinct products it read against the number Taobao announces. Measured on 13 shops on 13 Nov 2026: 191 distinct products instead of 60 on a 407-product shop, 282 on Uniqlo (1,052 announced), 80 of 81 on Dyson (complete). Each product keeps its rank in every sort order it appears in (`sortRanks`), so you also see which products are best sellers or newest.

When a shop is larger than what Taobao shows a visitor, the shop is marked `partial_collection` with both numbers. The rule for `done` is written out: up to 2 products or 3 % of Taobao's count missing counts as done, and the number missing is always given (`missingVsAnnounced`).

### Try it

Run it with the prefilled shop (`https://world.taobao.com/dianpu/63978904.htm`) and `maxItems` 50: you get 50 rows, the shop row and its first 49 products. Leave `maxItems` at 0 to get every product the sort orders show.

### What to paste

`shopUrls`, one shop per line, any of these forms:

- `https://world.taobao.com/dianpu/63978904.htm` (the shop page, any `?…` parameters; `_2.htm` page links read the same shop)
- `shop63978904.taobao.com`, `shop63978904.world.taobao.com`, `shop57303596.tmall.com`
- `inman.taobao.com`, `inman.world.taobao.com`, `uniqlo.tmall.com`, `uniqlo.world.tmall.com` (one extra request finds the shop id)
- the shop id alone: `63978904`

Refused with a reason, without any request and without any charge: product pages (`item.taobao.com`, `detail.tmall.com`, `world.taobao.com/item/…`: Taobao asks for a login to open a product), Taobao's login page (where a click on a product card leads a visitor), and any other site. Tmall Global addresses (`*.tmall.hk`) and mobile shop addresses (`shop<id>.m.taobao.com`) are refused as "not supported yet": paste the shop's `world.taobao.com` address or its id. Two addresses of the same shop are read once (`duplicate_input`).

Options: `sortOrders` (which orders to read and merge, in that order; `credit-des` gave the same list as `default` on 10 of 10 shops, so it is off by default), `maxProductsPerShop` (0 = all), `maxItems` (rows per run, shop rows included; 0 = no limit), `includeShopRow` (one row per shop), `shopDetails` (one more request per shop for its profile), `proxyConfiguration` (default: Apify residential, Hong Kong).

### Output

Two kinds of rows, in this order for each shop: one **shop row** (`recordType: "shop"`, if `includeShopRow`), then its **product rows** (`recordType: "product"`), in the order the sort orders were read, then by rank. Unknown values are `null`, never invented. In the Apify Console, the dataset tabs "Products" and "Shops" choose columns, they do not filter rows: both tabs list every row (shop rows and product rows); filter on `recordType` in your export, or set `includeShopRow` to false to get product rows only. Real rows (Uniqlo, from a run on Apify on 13 Nov 2026):

Product row:

```json
{
  "recordType": "product",
  "shopId": "57303596",
  "shopName": "Uniqlo官方旗艦店",
  "shopUrl": "https://world.taobao.com/dianpu/57303596.htm",
  "sellerId": "196993935",
  "shopRatingDescription": 4.8,
  "shopRatingService": 4.9,
  "shopRatingDelivery": 4.9,
  "shopTotalProducts": 1010,
  "itemId": "954148628855",
  "title": "羊毛羊絨混紡長大衣Uniqlo男裝女裝外套491375 478285",
  "url": "https://world.taobao.com/item/aTZjcGJuVElVdVI2U3JUSU01U0h2QT09.htm",
  "taobaoUrl": "https://item.taobao.com/item.htm?id=954148628855",
  "price": 999,
  "listPrice": 999,
  "currency": "CNY",
  "priceHKD": 1187.51,
  "priceTWD": 4978.82,
  "priceLabel": "優惠價",
  "sellingPoints": [],
  "cardTag": "優惠價",
  "freeShipping": false,
  "areaLimit": false,
  "categoryId": "50011159",
  "rootCategoryId": "30",
  "imageUrl": "https://img.alicdn.com/imgextra/i2/196993935/O1CN01oyiAGmcXWIG1chua_!!4611686018427380623-2-item_pic.png",
  "imageUrls": [
    "https://img.alicdn.com/imgextra/i2/196993935/O1CN01oyiAGmcXWIG1chua_!!4611686018427380623-2-item_pic.png"
  ],
  "reviewTags": [],
  "position": 6,
  "firstSeenSort": "default",
  "sortRanks": {
    "default": 6,
    "price-des": 9
  },
  "scrapedAt": "2026-11-13T03:46:10+00:00"
}
```

Shop row:

```json
{
  "recordType": "shop",
  "shopId": "57303596",
  "shopName": "Uniqlo官方旗艦店",
  "shopUrl": "https://world.taobao.com/dianpu/57303596.htm",
  "sellerId": "196993935",
  "logoUrl": "https://img.alicdn.com/imgextra/i2/196993935/O1CN01NCPCZC1ewHZvwOdnz_!!196993935.jpg",
  "ratingDescription": 4.8,
  "ratingService": 4.9,
  "ratingDelivery": 4.9,
  "totalProducts": 1010,
  "productsReachable": 283,
  "productsDelivered": 283,
  "sortsRead": [
    "default",
    "sales-des",
    "new-des",
    "price-asc",
    "price-des"
  ],
  "sortsIgnoredBySite": [],
  "status": "partial_collection",
  "statusReason": "visitor_window",
  "isTmall": true,
  "shopAgeYears": 18,
  "shopAgeLabel": "天猫18年店",
  "shopLocation": "上海",
  "shopNameOriginal": "优衣库官方旗舰店",
  "ratingsVsPeers": [
    {
      "type": "desc",
      "title": "描述相符",
      "score": 4.8,
      "level": "higher",
      "levelText": "高于46.22%",
      "percent": 46.22
    },
    {
      "type": "serv",
      "title": "服务态度",
      "score": 4.9,
      "level": "higher",
      "levelText": "高于39.98%",
      "percent": 39.98
    },
    {
      "type": "post",
      "title": "物流服务",
      "score": 4.9,
      "level": "higher",
      "levelText": "高于37.21%",
      "percent": 37.21
    }
  ],
  "scrapedAt": "2026-11-13T03:46:10+00:00"
}
```

Notes on the fields:

- `price` is the price the card shows (￥, CNY). `listPrice` is the price before discount in Taobao's list data; it was equal to `price` on all 1,461 products read on Apify on 13 Nov 2026 (Taobao's visitor list shows no struck price). `priceHKD` and `priceTWD` are Taobao's own conversions.
- `cardTag` is the tag the card shows: the first selling point, else the promotion label (`priceLabel`), else null.
- `url` is the card's link; opening a product needs a Taobao login, so product pages are not read and nothing from them is promised. `taobaoUrl` is the classic `item.taobao.com` address of the same id.
- `imageUrls`: the image of a product can change from one sort order to another (11 products of one shop): every image is kept; `imageUrl` is the one of the first sort order. Some shops also rotate their main images from one page load to the next (one shop of 11 measured on 13 Nov 2026: 19 of 296 images changed between two loads a few minutes apart): `imageUrl` is the image the page showed when it was read.
- Profile fields of the shop row (`isTmall`, `shopAgeYears`, `shopAgeLabel`, `shopLocation`, `shopNameOriginal`, `ratingsVsPeers`) are read from the data the shop's home page loads for a visitor; Taobao does not print them on screen. Some older Taobao shop pages carry no profile: these fields are then null (said in the Run summary); on Apify, 11 of 11 shops read on 13 Nov 2026 had their profile. `shopAgeYears` is the number of years Taobao gives in that data, for Tmall shops: it is null for ordinary Taobao shops, whose `shopAgeLabel` still carries the label (for example "15年老店", a 15-year-old shop; on Apify on 13 Nov 2026: 9 of 9 Tmall shops had `shopAgeYears`, 0 of 2 ordinary Taobao shops).
- `freeShipping`, `areaLimit` are given as Taobao gives them: `areaLimit` was true on 3 of 1,461 products read on Apify on 13 Nov 2026, `freeShipping` false on all of them; `reviewTags` was empty on every shop measured.

### Run summary

The key-value store holds `OUTPUT` (JSON) and `SUMMARY` (a readable page). For each address: `status` (`done`, `partial_collection`, `max_items_reached`, `no_results`, `not_found`, `blocked`, `sorts_ignored`, `invalid_url`, `duplicate_input`, `not_processed`), `statusReason`, `totalAnnounced` (Taobao's count), `productsDistinct` (distinct products read), `productsDelivered`, `missingVsAnnounced`, `sortsRead`, `sortsIgnoredBySite`, `sortsFailed`, `profileUnavailable` and a message.

- `done`: the distinct products read reach Taobao's count, with a tolerance: up to 2 products or 3 % of the count missing counts as done, and `missingVsAnnounced` gives the number. For 1 or 2 missing, the measured cause is that Taobao over-announces (80 of 81 on Dyson); for a larger gap within 3 %, the cause is not measured and these products may simply be out of a visitor's reach.
- `partial_collection` / `visitor_window`: the shop has more products than Taobao shows a visitor in the sort orders read; both numbers are given.
- `no_results`: the shop page is real but shows 0 products to visitors (this is not an empty search: header and ratings are shown). No row charged.
- `not_found`: Taobao sends the address to its home page (wrong id or closed shop). No row charged.
- `blocked`: Taobao showed its login wall, or a page without its product list, on every attempt (5 fresh sessions: 3 in Hong Kong, then Taiwan, then Singapore). Your URL is not the cause. No row charged.
- `sortsFailed`: a sort order that could not be read while others were (login wall, sent to Taobao's home page, or 0 products shown after another sort order showed some); the message gives the cause for each.
- `sorts_ignored`: Taobao applied none of the sort orders you asked for this proxy (it does that for datacenter and US IPs). No row charged.

### Pricing

Pay per event: **$0.0012 per delivered row** ($1.20 per 1,000 rows), a shop row or a product row, plus **$0.005 per run** (Apify's start fee, one per GB of memory: the default 512 MB is one start). Pages read, retries, sort orders, refused, empty, missing or blocked shops are never charged. Tier discounts of the Apify Store apply (Bronze -10 %, Silver -20 %, Gold to Diamond -30 %).

| Run | Price at the base rate (Free plan) |
|---|---|
| 20 rows | $0.029 |
| 1,000 rows | $1.205 |

A 407-product shop read with the 5 default sort orders gives 192 rows (1 shop row, 191 products). Set a maximum charge per run in Apify: the Actor stops at it and says so.

### Known limits

- **60 products per sort order**: Taobao shows a visitor without an account at most 60 products for each sort order, and its page links (`_2.htm`) send a visitor back to its home page. Large shops are therefore read partly; the Run summary gives the products read against Taobao's count. Measured union of the 5 sort orders: 191 of 407, 282 of 1,052, 80 of 81.
- **No product page**: opening a product needs a Taobao login, so the description, variants, stock, sales count and reviews of a product are not read.
- **Sort orders need a Hong Kong, Taiwan or Singapore visitor**: Taobao ignores `sort` for datacenter and US IPs (measured). The default proxy is Apify residential, Hong Kong. A sort order Taobao ignores is listed in `sortsIgnoredBySite`: its page was Taobao's default order, already delivered under `default` when you ask for it, so it adds no product and no rank. If Taobao's page ever stops saying which order it applied, the sort order is still delivered and the Run summary warns (`SORT_NOT_VERIFIABLE`).
- **Login wall**: Taobao sometimes shows a login wall instead of a shop; each page is tried on up to 5 fresh sessions (0 walls in 120 readings from Hong Kong on 13 Nov 2026; on Apify, 1 page without its data in 112, read on the next session). A shop still walled is `blocked`, never "empty", and no row of it is charged.
- Titles and shop names come in traditional Chinese (Taobao's page for Hong Kong visitors); `shopNameOriginal` gives the simplified name when the profile is read.
- Prices and lists change on Taobao at any time; two readings of the same pages gave the same list and order on 60 of 60 pages (13 Nov 2026), but within an hour large shops gain or lose products (Uniqlo: 1,023 then 1,016) and ranks move. `priceTWD` follows Taobao's own exchange rate, which it updates during the day.

### Support

Questions, a shop that does not read as expected, or a field you need: open an issue on the Actor's page with the run link. If the Actor is useful to you, please leave a review on its Store page: it helps other buyers find it.

This Actor is not affiliated with, endorsed by or sponsored by Taobao, Tmall or Alibaba Group. It reads only what Taobao shows a visitor without an account; respect Taobao's terms and the laws that apply to your use of the data.

# Actor input Schema

## `shopUrls` (type: `array`):

One Taobao or Tmall shop per line: https://world.taobao.com/dianpu/63978904.htm, shop63978904.taobao.com, inman.taobao.com, uniqlo.tmall.com, or the shop id alone (63978904). Product pages (item.taobao.com, detail.tmall.com) need a Taobao login and are refused with a reason: paste the shop address instead. Two addresses of the same shop are read once.

## `sortOrders` (type: `array`):

Taobao shows a visitor 60 products per sort order; each order read adds the products the others did not show (measured: 191 distinct products for 5 orders on a 407-product shop, 60 for one). Each order costs one page request, not a charge: you pay per delivered row. credit-des gave the same list as default on 10 of 10 shops.

## `maxProductsPerShop` (type: `integer`):

Stop each shop after this many products (in the order the sort orders were read). 0 = every product the sort orders show.

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

Total rows delivered by the run, shop rows included: the run stops there. 0 = no limit.

## `includeShopRow` (type: `boolean`):

Add one row per shop (recordType shop) before its products: name, ratings, products announced vs read, sorts read, status, profile. It is a delivered row.

## `shopDetails` (type: `boolean`):

Read the shop's home page once more (one request) for isTmall, shop age, location, original name and how its ratings compare to similar shops. These come from the data the page loads for a visitor; Taobao does not print them on screen. Some older shop pages carry no profile: the fields stay null.

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

Default: Apify residential proxy in Hong Kong. Taobao applies the sort orders only to visitors from Hong Kong, Taiwan or Singapore (measured; ignored for datacenter and US IPs) and shows its login wall to most server IPs.

## Actor input object example

```json
{
  "shopUrls": [
    "https://world.taobao.com/dianpu/63978904.htm"
  ],
  "sortOrders": [
    "default",
    "sales-des",
    "new-des",
    "price-asc",
    "price-des"
  ],
  "maxProductsPerShop": 0,
  "maxItems": 50,
  "includeShopRow": true,
  "shopDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "HK"
  }
}
```

# Actor output Schema

## `rows` (type: `string`):

Shop rows (recordType shop) and product rows (recordType product), every field.

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

Shop, product id, title, price CNY / HKD, label, sorts and rank, link.

## `shops` (type: `string`):

Shop rows: ratings, products announced vs read vs delivered, status, profile.

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

Readable per-shop summary: status, products delivered / read / announced, sorts read, reason for anything missing.

## `summaryJson` (type: `string`):

The same summary as JSON (OUTPUT record).

# 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 = {
    "shopUrls": [
        "https://world.taobao.com/dianpu/63978904.htm"
    ],
    "sortOrders": [
        "default",
        "sales-des",
        "new-des",
        "price-asc",
        "price-des"
    ],
    "maxProductsPerShop": 0,
    "maxItems": 50,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "HK"
    }
};

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

# Prepare the Actor input
run_input = {
    "shopUrls": ["https://world.taobao.com/dianpu/63978904.htm"],
    "sortOrders": [
        "default",
        "sales-des",
        "new-des",
        "price-asc",
        "price-des",
    ],
    "maxProductsPerShop": 0,
    "maxItems": 50,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "HK",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("hexagone-data/taobao-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"
  ],
  "sortOrders": [
    "default",
    "sales-des",
    "new-des",
    "price-asc",
    "price-des"
  ],
  "maxProductsPerShop": 0,
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "HK"
  }
}' |
apify call hexagone-data/taobao-shop-scraper --silent --output-dataset

```

## MCP server setup

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