Taobao Scraper — Tmall & Taobao Products, Prices & Shops (淘宝/天猫商品采集)

Export Taobao and Tmall products for any keyword — title, price in CNY (plus the HKD and TWD prices Taobao shows), promotion label, shop, shop score, category, image, selling points and review tags — and, on demand, the ship-from city, Tmall-or-Taobao flag, seller ID, shop ratings, shop age, review count and a recent buyer review. No login, no cookies, no API key.

Taobao Scraper is a Taobao and Tmall data extractor (淘宝商品爬虫 / 天猫数据采集 / 淘宝商品数据导出) that turns a list of search keywords into a clean spreadsheet of products. Type what a shopper would type into Taobao — 蓝牙耳机 (Bluetooth earphones), 连衣裙 (dresses), 保温杯 (vacuum flasks), 空气炸锅 (air fryers), 机械键盘 (mechanical keyboards), 零食 (snacks), "phone case" — and the Actor returns Taobao's best-selling products for that keyword, then follows Taobao's own related searches (淘宝搜索联想词: 蓝牙耳机 → 蓝牙耳机降噪, 蓝牙耳机运动, 蓝牙耳机小米 …) to reach hundreds of products per keyword and tens of thousands per run. It is a practical Taobao API alternative and Tmall API alternative for people who cannot or do not want to log in: you scrape taobao.com without an account, export Taobao products to CSV, Excel or JSON, look up Taobao item details by URL or item ID (item.taobao.com, detail.tmall.com, plain IDs), and feed the rows into product research, price monitoring, sourcing, brand protection or AI pipelines.

The data comes from Taobao's public product catalogue — the server-rendered pages Taobao publishes at www.taobao.com/list/… for search engines and for shoppers outside mainland China (淘宝海外热卖页). Taobao's robots.txt explicitly allows these pages (Allow: /list/*). They carry the same product IDs, titles, shop names and prices as the Taobao app, but without login walls, sliders or signed APIs. Since 2025 Taobao's normal search (s.taobao.com) and its item pages (item.taobao.com, detail.tmall.com) send logged-out visitors to a login page, so a tool that does not use your account has exactly this catalogue to work with — this Actor uses it fully and honestly, and this README tells you precisely what it can and cannot deliver.

All numbers on this page were measured on the Apify platform on 24–25 October 2026.

Disclaimer: This Actor is an independent tool. It is not affiliated with, endorsed by, or sponsored by Taobao, Tmall or Alibaba Group. "Taobao", "Tmall", 淘宝 and 天猫 are trademarks of their respective owners.

---

Table of contents

• At a glance
• What you get: the Taobao product fields
• How it works: the public catalogue and related searches
• Who uses this Taobao scraper
• Cookbook: 18 ready-to-run inputs
• Keyword cheat-sheet
• Tutorial: scrape Taobao in the Apify Console
• Tutorial: scrape Taobao with the API
• Input reference
• Output data dictionary with measured fill rates
• Real output sample
• Scale and speed
• Prices on Taobao: what the numbers mean
• What you pay
• Integrations
• Performance tips
• Troubleshooting: every status message explained
• Honest limits
• Comparison: official API, manual copying and this Actor
• FAQ
• Glossary
• Is it legal to scrape Taobao?
• Changelog
• Support

---

At a glance

What you type	Search keywords in Chinese or English (蓝牙耳机, 连衣裙, 保温杯, phone case), Taobao/Tmall search URLs, item URLs or item IDs, or category IDs
What you get	One row per product: itemId, title, price (CNY), promoLabel, priceHKD, priceTWD, shopId, shopName, shopUrl, shopDescriptionScore, categoryId, rootCategoryId, imageUrl, sellingPoints, reviewTags, url, catalogUrl, plus how it was found (searchKeyword, matchedKeyword, rank, keywordResultCount)
Item details (optional)	platform (Tmall / Taobao), sellerType, sellerId, shipFrom (发货地), categoryPath, itemPagePrice, shop ratings for description / service / logistics, shopOpenedAt, shopItemCount, shopCreditLevel, reviewCountText (e.g. 1000+), reviewMentions, latestReviews, paymentMethods
Depth	20 best sellers per keyword page; related-search expansion gave 760 unique products for the single keyword 蓝牙耳机 and 12,000 unique products from 50 keywords (0 duplicates)
Speed	First products after ~2 s; 1,000 products in 26 s; 12,000 in 217 s; with item details 1,000 in 218 s
Quality	12 random rows hand-checked against each product's own Taobao page: item ID, shop, shop ID and category matched 11/11, price 10/11 (see Prices on Taobao)
Formats	JSON, CSV, Excel, XML, HTML table, RSS; API, webhooks, schedules, Make, Zapier, n8n, Google Sheets
Price	Pay per product: $4.00 per 1,000 on the Free plan, down to $2.60 per 1,000 on higher plans — item details included at the same price
Needs	Nothing: no Taobao account, no cookies, no app key, no proxy setup

---

What you get: the Taobao product fields

Every row is one product, identified by Taobao's numeric item ID (the id= of every Taobao and Tmall product link). Products are de-duplicated across the whole run: a product that shows up for several keywords is saved once, under the first keyword that found it.

Identity and links

• itemId — Taobao's item ID as text, e.g. "1074835457451". The same ID works on item.taobao.com, detail.tmall.com, in the Taobao app and in this Actor's item lookup.
• title — the full product title as the seller wrote it, in Chinese (or the original language): "bloommark纯钛保温杯钛双生系列女高颜值水杯便携杯子送节日礼物".
• url — the product link on Taobao (https://item.taobao.com/item.htm?id=…), or on Tmall (https://detail.tmall.com/item.htm?id=…) when item details say the product is a Tmall product. Both open the product in the Taobao app or a logged-in browser.
• catalogUrl — the product's page in Taobao's public catalogue (https://www.taobao.com/list/item/….htm), which anyone can open without logging in.
• imageUrl — the main product image on Taobao's image CDN (img.alicdn.com).

Price

• price — the price in Chinese yuan (CNY) as shown with the product on Taobao's keyword or category page, e.g. 219.
• promoLabel — the label Taobao shows next to that price: 优惠价 (discounted price), 特价秒杀 (flash sale), 新品促销 (new-product promotion), 热销款 (hot seller), 超级立减活动价 (instant-discount event price), 天猫U先 (Tmall trial pack) and others. Empty when the price has no label.
• currency — always "CNY" for price.
• priceHKD, priceTWD — the Hong Kong dollar and New Taiwan dollar prices Taobao itself shows overseas shoppers for the same product.
• itemPagePrice (item details) — the price on the product's own page. See Prices on Taobao for why it can be lower than price.

Shop and seller

• shopId, shopName, shopUrl — the shop (店铺) that sells the product, e.g. 350369320, bloommark旗舰店, https://shop350369320.taobao.com/.
• shopDescriptionScore — the shop's "item as described" score (描述相符) with two decimals, e.g. 4.87.
• platform (item details) — "Tmall" or "Taobao".
• sellerType (item details) — Taobao's own seller type: "B" (Tmall business seller) or "C" (Taobao marketplace seller).
• sellerId (item details) — the seller's numeric user ID.
• shopRatingDescription, shopRatingService, shopRatingLogistics (item details) — the shop's three dynamic ratings (店铺动态评分: 描述 / 服务 / 物流), one decimal, e.g. 4.8, 4.9, 4.9.
• shopOpenedAt (item details) — when the shop opened, Beijing time, ISO 8601: "2024-12-25T09:43:36+08:00".
• shopItemCount, shopNewItemCount (item details) — products listed in the shop, and recently added ones.
• shopCreditLevel (item details) — Taobao's seller credit level as a number (measured range 2–20).
• shopLogoUrl (item details) — the shop's logo image.

Category and origin

• categoryId, rootCategoryId — Taobao's leaf category (叶子类目) and top-level category (一级类目) IDs, e.g. 50006889 and 122952001.
• categoryPath (item details) — the category names Taobao shows for the product: "淘宝国际 > 厨房/餐饮用具 > 杯子/水杯/水壶 > 保温杯".
• shipFrom (item details) — the ship-from location (发货地), e.g. "浙江金华", "广东深圳", "上海".

Reviews and buyer voice

• reviewTags — review tags Taobao shows on the keyword page for some products, with counts: [{"tag": "口感味道好", "count": 20}, …].
• sellingPoints — short selling points the seller added (卖点): ["意式釉惑 持久水光唇"].
• reviewCountText (item details) — the review count as Taobao displays it: "300+", "1000+", "1万+" or an exact small number such as "43".
• reviewMentions (item details) — what buyers mention and how often, from the product page: [{"tag": "外观设计好看", "count": 63}, {"tag": "保温效果好", "count": 21}, …] (including negative ones such as 材质差).
• latestReviews (item details) — the recent review Taobao shows on the product page: text, star rating, date (Beijing time) and the variant the buyer bought.
• paymentMethods (item details) — payment methods listed on the page (蚂蚁花呗, 信用卡支付, 集分宝, 支付宝支付).

How the product was found

• searchKeyword — the keyword you entered that led to this product.
• matchedKeyword — the Taobao keyword page the product was on (your keyword or one of Taobao's related searches for it).
• matchedCategoryId — set instead when the product came from a category page.
• rank — the product's position on that page (1–20, best-selling first).
• keywordResultCount — how many products Taobao says it has for that keyword or category (淘宝当前有…件相关的商品在售), e.g. 30365 for 保温杯.
• source — keyword, category or item.
• scrapedAt — when the row was saved (UTC, ISO 8601).

---

How it works: the public catalogue and related searches

Taobao publishes a public, server-rendered catalogue of its products at www.taobao.com/list/:

• Keyword pages — www.taobao.com/list/product/<keyword>.htm lists the 20 best-selling products for a keyword (热卖), with price, shop, category and image, and says how many products Taobao has for it.
• Category pages — www.taobao.com/list/category/<categoryId>.htm lists the 20 best sellers of a category.
• Product pages — www.taobao.com/list/item/<itemId>.htm shows one product with its price, ship-from city, Tmall/Taobao flag, shop ratings, shop age, review count, what buyers mention and a recent review.

These pages are meant for search engines and overseas shoppers, and Taobao serves them without a login. Taobao serves page 1 of each keyword to everyone; page 2 onwards, re-sorting and price filters are reserved for logged-in shoppers (we measured this: page 2 redirects to the Taobao home page, and sort or price parameters are ignored). The Actor therefore never pretends to paginate. It goes deeper the honest way:

1. Your keyword's page — the 20 best sellers for it.
2. The keyword's own category — the best sellers of the category Taobao files the keyword under (for 手机: category 1512, mobile phones).
3. Taobao's related searches — Taobao's search box suggests related queries for every keyword (蓝牙耳机 → 蓝牙耳机降噪, 蓝牙耳机运动, 蓝牙耳机小米, 蓝牙耳机入耳式 …). The Actor opens the catalogue page of each suggestion, then the suggestions of the suggestions, breadth-first, until the keyword reaches Max products per keyword, the run reaches Max products, or Taobao has no more related searches.

Every product is saved once (de-duplicated by item ID), with the keyword page and rank where it was first found, so you can always tell which rows came from your exact keyword (matchedKeyword equals searchKeyword) and which from a related search.

With Include item details on, each product's public product page is opened too and its fields are merged into the row.

Item lookups work the same way from the other end: an item URL or ID goes straight to the product's catalogue page. Products Taobao does not publish in the catalogue (removed listings, some restricted categories such as alcohol, very old listings) are reported in the run summary instead of producing empty rows.

Routes. The Actor fetches pages directly from the Apify platform first (fastest; in the 12,000-product run 2,508 pages came directly and none was refused), moves a request to Apify's datacenter proxy pool when Taobao answers with its anti-bot captcha page, and uses a US residential proxy only as a capped rescue. Chinese residential addresses are refused by these overseas pages, so they are never used.

---

Who uses this Taobao scraper

1. Cross-border sellers and dropshippers — "what sells in China right now?"

Product researchers for Amazon, Shopee, Lazada, TikTok Shop, Etsy and Ozon run their niche keywords (宠物自动喂食器, 露营帐篷, 收纳盒) with expansion on and sort the result by rank and keywordResultCount. Taobao's best-seller pages are a leading indicator: what ranks in the top 20 there in October is often what ships to marketplaces abroad weeks later. sellingPoints and reviewMentions tell them which features buyers actually talk about.

2. Taobao purchasing agents (代购) — "quote the customer in their currency"

Agents who buy on behalf of customers in Hong Kong, Taiwan and overseas use priceHKD and priceTWD — Taobao's own converted prices — next to the CNY price, and item lookups to refresh a customer's wish-list of item links before quoting.

3. Sourcing teams and importers — "which city makes this?"

With item details on, shipFrom shows where products ship from. In a 1,000-product sample of electronics, flasks, face masks, keyboards and tea, the top origins were 广东深圳 (134), 浙江金华 (101), 广东广州 (97), 广东东莞 (89) and 上海 (81). Buyers use the city clusters to plan factory visits and freight.

4. Brand owners and brand-protection teams — "who sells our brand?"

Run brand keywords (小米 充电宝, 华为耳机, Dior香水) and group the rows by shopId / shopName. Official stores (旗舰店) versus resellers, platform (Tmall vs Taobao), shopOpenedAt (new shops are a risk signal) and shopCreditLevel make a quick distribution and grey-market map.

5. Price monitoring and repricing — "the same products, every day"

Schedule the same keyword list daily and join the runs on itemId. price and promoLabel show when products go on 特价秒杀 or 新品促销; itemPagePrice (item details) adds the product-page price. Re-check a fixed portfolio with item lookups.

6. Category managers and market researchers — "how is this category built?"

The 12,000-product run spanned 6,452 shops, 686 leaf categories and 80 top-level categories. Analysts measure price bands (median price in that run: ¥79.9), the Tmall share (73% of a 1,000-product details sample), promotion intensity (promoLabel) and shop concentration per keyword.

7. Marketing and content agencies — "what do buyers praise and complain about?"

reviewMentions turns Taobao's review summary into counts: 外观设计好看 63, 保温效果好 21, 材质差 3. Agencies brief creators and write product copy in the words buyers use.

8. Investors and equity analysts — "is this brand winning on Taobao?"

Count a brand's products in the top 20 across hundreds of related keywords and track it over time.

9. AI and data teams — "a Chinese product corpus with structure"

Titles in Chinese, category IDs and paths, images, prices and review phrases make training and evaluation sets for product classification, title translation, attribute extraction and price estimation. The Actor's output is consistent JSON with stable keys.

10. Deal and price-comparison sites — "the Taobao side of a comparison"

Clean CNY prices per keyword, with url sending readers to the product.

11. Logistics and freight forwarders — "where will the parcels come from?"

shipFrom per product and shop shows pick-up regions and consolidation hubs.

12. Academic researchers and journalists — "China e-commerce in numbers"

Reproducible public data on prices, promotions, shop ages and seller types, with the page and rank of every product.

13. Developers building shopping tools — "a Taobao product API without an account"

Call the Actor through the Apify API with a keyword or item ID and get JSON back in seconds — no Taobao login to manage, no token refresh, no slider.

14. Supplier risk and compliance — "are our suppliers' shops healthy?"

Shop ratings, shop age and credit level for the shops behind your products.

15. Trend scouts — "what is Taobao suggesting?"

The matchedKeyword values of an expanded run show which long-tail searches Taobao promotes around a topic right now.

---

Cookbook: 18 ready-to-run inputs

Copy any of these into the Input tab (JSON view) or send them through the API.

1. Quick sample: one keyword, 40 products

{ "keywords": ["蓝牙耳机"], "maxItemsPerKeyword": 40, "maxItems": 40 }

Measured: 40 products in 8 s, first products after 2 s.

2. Exactly Taobao's best sellers, no related searches

{ "keywords": ["连衣裙", "保温杯", "空气炸锅"], "expandKeywords": false }

The 20 best sellers of each keyword page (shared products are saved once).

3. Go deep on one keyword

{ "keywords": ["蓝牙耳机"], "maxItemsPerKeyword": 0, "maxItems": 5000 }

0 means "no per-keyword limit": the Actor follows Taobao's related searches until they run out. Measured on 24 Oct 2026: 760 unique products from 152 related keyword pages in 61 s.

4. A category sweep with many keywords (the 12,000-product pull)

{
  "keywords": ["手机", "连衣裙", "零食", "口红", "运动鞋", "蓝牙耳机", "笔记本电脑", "茶叶", "面膜", "羽绒服"],
  "maxItemsPerKeyword": 300,
  "maxItems": 3000
}

Measured with 50 such keywords and maxItems: 12000: 12,000 unique products in 217 s, no duplicates.

5. Add item details (ship-from city, Tmall/Taobao, shop ratings, reviews)

{ "keywords": ["保温杯"], "includeDetails": true, "maxItems": 200 }

6. Look up products by URL or ID

{
  "itemUrls": [
    "https://detail.tmall.com/item.htm?id=1079804116256",
    "https://item.taobao.com/item.htm?id=1077599959318",
    "547210205891"
  ]
}

Each one becomes a row with full item details.

7. Paste a Taobao or Tmall search URL

{ "keywords": ["https://s.taobao.com/search?q=%E6%9C%BA%E6%A2%B0%E9%94%AE%E7%9B%98"] }

The q parameter (here 机械键盘) is used as the keyword. list.tmall.com search URLs work the same way.

8. Best sellers of a category

{ "categories": ["50005050", "https://www.taobao.com/list/category/1512.htm"], "maxItems": 200 }

50005050 is 蓝牙耳机 (Bluetooth earphones), 1512 is 手机 (mobile phones). With expansion on, the category name's related searches are followed too.

9. English keywords

{ "keywords": ["phone case", "airpods", "led"], "maxItems": 300 }

Taobao's catalogue has pages for many English and mixed keywords; Chinese keywords usually return more.

10. Brand monitoring

{ "keywords": ["小米充电宝", "华为耳机", "苏泊尔保温杯"], "includeDetails": true, "maxItemsPerKeyword": 200 }

Group the result by shopName and platform to see official stores against resellers.

11. Daily price tracking of a keyword list

{ "keywords": ["空气炸锅", "电动牙刷", "扫地机器人"], "maxItemsPerKeyword": 100, "maxItems": 300 }

Save it as a task, schedule it daily and join the datasets on itemId.

12. Refresh a fixed product portfolio

{ "itemUrls": ["701966799270", "759787732397", "1048628899942", "1018901417797"] }

13. Shop and origin analysis

{ "keywords": ["收纳盒", "台灯", "雨伞"], "includeDetails": true, "maxItems": 600 }

Pivot on shipFrom, sellerType, shopOpenedAt and the shop ratings.

14. Review intelligence

{ "keywords": ["面膜", "防晒霜"], "includeDetails": true, "maxItemsPerKeyword": 150 }

Explode reviewMentions into one row per mention to rank what buyers praise and criticise per product and per shop.

15. Faster item details

{ "keywords": ["电动牙刷", "台灯"], "includeDetails": true, "maxItems": 400, "maxConcurrency": 16 }

Measured: 400 products with details in 70 s at 16 parallel requests.

16. A hard spending cap

{ "keywords": ["零食"], "maxItems": 250 }

Combine it with the run option Maximum cost per run; the Actor stops at whichever limit comes first.

17. Trend scouting through related searches

{ "keywords": ["露营"], "maxItemsPerKeyword": 500, "maxItems": 500 }

Count products per matchedKeyword to see which related searches Taobao pushes.

18. Your own proxy

{ "keywords": ["汉服"], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "SG" } }

Not needed normally; never choose a mainland-China exit (refused by these pages).

---

Keyword cheat-sheet

Short, common keywords have catalogue pages; long product titles usually do not. In a 40-keyword test on 24 Oct 2026, 37 had a catalogue page; the three without one were T恤男 (capitalised — the Actor lowercases automatically, and t恤男 works), iphone16手机壳 (a long model phrase) and 茅台 (alcohol). With expansion on, Taobao's related searches still produce products for most long phrases.

Vertical	Keywords that work well
Phones & accessories	手机, 苹果15, 华为mate70, 手机壳, 钢化膜, 数据线, 充电宝, 蓝牙耳机, 小米手环
Computers & office	笔记本电脑, 机械键盘, 鼠标, 显示器, 台灯
Home & kitchen	保温杯, 电饭煲, 空气炸锅, 扫地机器人, 收纳盒, 花盆, 雨伞
Women's fashion	连衣裙, 卫衣, 汉服, 羽绒服, 瑜伽裤女, 围巾
Men's fashion	t恤男, 牛仔裤, 运动鞋, 帆布鞋, 双肩包
Beauty & care	口红, 面膜, 防晒霜, 洗发水, 沐浴露, 香水, 电动牙刷
Food	零食, 茶叶, 坚果
Baby & pets	奶粉, 纸尿裤, 玩具, 积木, 猫粮, 狗粮
Sports & outdoor	自行车, 头盔, 钓鱼竿, 露营帐篷, 瑜伽垫
English	phone case, airpods, dress, led

Tips: prefer the noun a shopper types (保温杯, not 304不锈钢双层真空保温杯大容量); add one qualifier at most (蓝牙耳机降噪); write Latin letters in lowercase or let the Actor do it.

---

Tutorial: scrape Taobao in the Apify Console

1. Open the Actor and go to the Input tab.
2. In Search keywords, add one keyword per line, e.g. 保温杯 and 空气炸锅. You can also paste Taobao search URLs.
3. Keep Expand with related searches on to get hundreds of products per keyword, or turn it off for exactly the 20 best sellers per keyword.
4. Set Max products per keyword (default 200) and Max products for the whole run (default 1,000).
5. Turn on Include item details if you need the ship-from city, Tmall/Taobao, shop ratings and reviews.
6. Optionally paste product links into Item URLs or IDs or category IDs into Categories.
7. Click Start. Products appear in the Output tab within seconds; the status line shows progress (Saved 412/1,000 products · 48 pages · 7 s).
8. When the run finishes, use Export for CSV, Excel, JSON, XML or HTML. The Overview, Prices, Item details and Keywords & categories views show the most useful columns for each job.
9. The Storage → Key-value store → SUMMARY record explains the run: products saved, keyword pages fetched, keywords without a catalogue page, items not in the catalogue, and how each request route performed.

---

Tutorial: scrape Taobao with the API

Replace <YOUR_API_TOKEN> with your Apify API token (Console → Settings → Integrations).

curl: run and wait, then download the products

curl -s -X POST "https://api.apify.com/v2/acts/logiover~taobao-scraper/run-sync-get-dataset-items?token=<YOUR_API_TOKEN>&format=json" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["保温杯"], "maxItems": 100}' > taobao.json

run-sync-get-dataset-items waits for the run (up to 5 minutes) and returns the rows directly — ideal for small pulls. Use format=csv or format=xlsx for spreadsheets.

Node.js (apify-client)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('logiover/taobao-scraper').call({
    keywords: ['蓝牙耳机', '机械键盘'],
    maxItemsPerKeyword: 300,
    maxItems: 600,
    includeDetails: false,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
for (const p of items) console.log(p.itemId, p.price, p.shopName, p.title);

Python (apify-client)

from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
run = client.actor("logiover/taobao-scraper").call(run_input={
    "itemUrls": ["https://detail.tmall.com/item.htm?id=1079804116256", "547210205891"],
})
for p in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(p["itemId"], p["platform"], p["shipFrom"], p["price"], p["reviewCountText"])

Python: daily price diff on itemId

import pandas as pd
from apify_client import ApifyClient

client = ApifyClient("<YOUR_API_TOKEN>")
runs = client.actor("logiover/taobao-scraper").runs().list(desc=True, limit=2).items
today, yesterday = (pd.DataFrame(client.dataset(r["defaultDatasetId"]).list_items().items) for r in runs)
m = today.merge(yesterday, on="itemId", suffixes=("", "_prev"))
changed = m[m["price"] != m["price_prev"]][["itemId", "title", "price_prev", "price", "promoLabel", "shopName"]]
print(changed.sort_values("price").to_string(index=False))

Large pulls

Start the run asynchronously (POST /v2/acts/logiover~taobao-scraper/runs), poll GET /v2/actor-runs/<runId>, then page through GET /v2/datasets/<datasetId>/items?offset=…&limit=1000. The run's SUMMARY record has the outcome and counters.

---

Input reference

Field	Type	Default	What it does
keywords	array of strings	—	Search keywords (Chinese or English), Taobao/Tmall search URLs (s.taobao.com/search?q=…, list.tmall.com/search_product.htm?q=…) or catalogue keyword URLs (www.taobao.com/list/product/….htm). Latin letters are lowercased, because Taobao's catalogue pages are keyed by the lowercase form.
expandKeywords	boolean	true	Follow the keyword's category and Taobao's related searches until the per-keyword limit. Off = exactly the keyword's own page (20 best sellers).
maxItemsPerKeyword	integer	200	Unique products per keyword (or category) before its expansion stops. 0 = no per-keyword limit.
maxItems	integer	1000	Unique products for the whole run. 0 = no limit (the run's maximum cost and timeout still apply).
includeDetails	boolean	false	Open each product's catalogue page and add the item-detail fields. One extra request per product.
itemUrls	array of strings	—	Product links or IDs: item.taobao.com/item.htm?id=…, detail.tmall.com/item.htm?id=…, m.taobao.com / h5.m.taobao.com links with id=, www.taobao.com/list/item/….htm, world.taobao.com/item/….htm, or plain numeric IDs. Each becomes a row with item details.
categories	array of strings	—	Taobao category IDs or catalogue category URLs (www.taobao.com/list/category/<id>.htm).
maxConcurrency	integer	12	Parallel page requests (1–32). Raise to 16–20 for faster item details.
proxyConfiguration	object	no proxy	Leave as is — the Actor manages its own route ladder. A custom proxy is tried first if you set one.

Input values that are not Taobao/Tmall links are ignored and listed in the log. A run with no keyword, item and category fails at once with INVALID_INPUT.

---

Output data dictionary with measured fill rates

Fill rate = share of rows where the field is not empty. List fields: the 12,000-product run of 24 Oct 2026 (50 keywords). Item-detail fields: a 1,000-product run with includeDetails: true on 24 Oct 2026 (UTC). Arrays count as filled when they have at least one element.

Field	Type	Meaning	Fill rate	Example
itemId	string	Taobao item ID	100%	"1074835457451"
title	string	Product title	100%	"bloommark纯钛保温杯钛双生系列…"
url	string	Product link on Taobao / Tmall	100%	"https://detail.tmall.com/item.htm?id=1074835457451"
catalogUrl	string	Public catalogue page	100%	"https://www.taobao.com/list/item/bXFL….htm"
price	number	Price in CNY on the keyword/category page	99.8%	219
promoLabel	string	Label next to the price	85.9%	"优惠价"
currency	string	Currency of price	100%	"CNY"
priceHKD	number	Taobao's Hong Kong dollar price	99.8%	260.02
priceTWD	number	Taobao's New Taiwan dollar price	99.8%	1080.04
shopId	string	Shop ID	99.99%	"350369320"
shopName	string	Shop name	99.99%	"bloommark旗舰店"
shopUrl	string	Shop link	99.99%	"https://shop350369320.taobao.com/"
shopDescriptionScore	number	"Item as described" score, 2 decimals	100%	4.87
categoryId	string	Leaf category ID	100%	"50006889"
rootCategoryId	string	Top-level category ID	100%	"122952001"
imageUrl	string	Main image	100%	"https://img.alicdn.com/imgextra/O1CN019V…png"
sellingPoints	array of strings	Seller's selling points	18.1%	["意式釉惑 持久水光唇"]
reviewTags	array of objects	Review tags on the keyword page	10.0%	[{"tag":"口感味道好","count":20}]
platform	string	Tmall or Taobao (details)	100%	"Tmall"
sellerType	string	B (Tmall) or C (Taobao) (details)	100%	"B"
sellerId	string	Seller user ID (details)	100%	"2219144099650"
shipFrom	string	Ship-from location (details)	100%	"浙江金华"
categoryPath	string	Category names (details)	91.0%	"淘宝国际 > 厨房/餐饮用具 > 杯子/水杯/水壶 > 保温杯"
itemPagePrice	number	Price on the product page, CNY (details)	100%	199
shopRatingDescription	number	Shop rating: description (details)	100%	4.8
shopRatingService	number	Shop rating: service (details)	100%	4.9
shopRatingLogistics	number	Shop rating: logistics (details)	100%	4.9
shopOpenedAt	string	Shop opening time, ISO 8601 +08:00 (details)	100%	"2024-12-25T09:43:36+08:00"
shopItemCount	number	Products in the shop (details)	100%	57
shopNewItemCount	number	Recently added products (details)	96.9%	2
shopCreditLevel	number	Seller credit level (details)	100%	9
shopLogoUrl	string	Shop logo (details)	98.6%	"https://img.alicdn.com/imgextra/i1/…png"
reviewCountText	string	Review count as displayed (details)	89.0%	"300+"
reviewMentions	array of objects	What buyers mention, with counts (details)	85.1%	[{"tag":"外观设计好看","count":63}]
latestReviews	array of objects	Recent review: text, rating, date, sku (details)	98.8%	see sample
paymentMethods	array of strings	Payment methods (details)	100%	["信用卡支付","集分宝","支付宝支付"]
searchKeyword	string	Your keyword	100% in keyword runs	"保温杯"
matchedKeyword	string	Keyword page the product was on	96.2%	"保温杯"
matchedCategoryId	string	Category page the product was on	3.9% (the rest came from keyword pages)	"1512"
rank	number	Position on that page, 1–20	100%	4
keywordResultCount	number	Products Taobao has for the keyword/category	100%	30365
source	string	keyword, category or item	100%	"keyword"
scrapedAt	string	Save time, ISO 8601 UTC	100%	"2026-10-24T22:31:28.660Z"

Fields marked (details) are present in the rows only when Include item details is on, and always for item lookups. matchedKeyword and matchedCategoryId complement each other: every keyword-mode row has one of them. price is empty for the 0.2% of products whose price Taobao only shows in its app (see the next section).

---

Real output sample

Two rows exactly as saved by platform runs on 24 Oct 2026 (UTC). First, a keyword row with item details (run cQowP7JUyzJKf0WNw, keyword 保温杯):

{
  "itemId": "1074835457451",
  "title": "bloommark纯钛保温杯钛双生系列女高颜值水杯便携杯子送节日礼物",
  "url": "https://detail.tmall.com/item.htm?id=1074835457451",
  "catalogUrl": "https://www.taobao.com/list/item/bXFLL1lSTkxycnNjeFIxQ2ZwZ0szdz09.htm",
  "price": 219,
  "promoLabel": "优惠价",
  "currency": "CNY",
  "priceHKD": 260.02,
  "priceTWD": 1080.04,
  "shopId": "350369320",
  "shopName": "bloommark旗舰店",
  "shopUrl": "https://shop350369320.taobao.com/",
  "shopDescriptionScore": 4.87,
  "categoryId": "50006889",
  "rootCategoryId": "122952001",
  "imageUrl": "https://img.alicdn.com/imgextra/O1CN019VbWygmqBJH1chua_!!6000000000879-2-yinhe.png",
  "sellingPoints": [],
  "reviewTags": [],
  "platform": "Tmall",
  "sellerType": "B",
  "sellerId": "2219144099650",
  "shipFrom": "浙江金华",
  "categoryPath": "淘宝国际 > 厨房/餐饮用具 > 杯子/水杯/水壶 > 保温杯",
  "itemPagePrice": 199,
  "shopRatingDescription": 4.8,
  "shopRatingService": 4.9,
  "shopRatingLogistics": 4.9,
  "shopOpenedAt": "2024-12-25T09:43:36+08:00",
  "shopItemCount": 57,
  "shopNewItemCount": 2,
  "shopCreditLevel": 9,
  "shopLogoUrl": "https://img.alicdn.com/imgextra/i1/2219144099650/O1CN01viw1XD2L9l3nT1f8l_!!2219144099650.png",
  "reviewCountText": "300+",
  "reviewMentions": [
    { "tag": "保温效果好", "count": 21 },
    { "tag": "密封性非常好", "count": 13 },
    { "tag": "尺寸合适", "count": 12 },
    { "tag": "外观设计好看", "count": 63 },
    { "tag": "价格便宜", "count": 6 },
    { "tag": "配色好看", "count": 6 },
    { "tag": "细节做得很好", "count": 5 },
    { "tag": "材质差", "count": 3 }
  ],
  "latestReviews": [
    {
      "text": "提车后买的第一个小配件哈哈。弹跳吸管单手就能开，等红灯抿一口很顺手。小硅胶帽专门收纳吸管盖，挂在挂绳上不会丢，这个细节加分。尺寸塞进杯架刚好不晃。钛杯没有怪味，装过美式，第二天冲一冲就干净了。",
      "rating": 5,
      "date": "2026-10-07T16:25:00+08:00",
      "sku": "颜色分类:430ml流动-纯钛咖啡杯[【内外纯钛+纯钛吸管+限定礼袋】]"
    }
  ],
  "paymentMethods": ["信用卡支付", "集分宝", "支付宝支付"],
  "searchKeyword": "保温杯",
  "matchedKeyword": "保温杯",
  "matchedCategoryId": null,
  "rank": 4,
  "keywordResultCount": 30365,
  "source": "keyword",
  "scrapedAt": "2026-10-24T22:31:28.660Z"
}

Second, a category row without item details (run Je2e2q8q2FaWJ9Zm2, category 1512 手机):

{
  "itemId": "1081525478551",
  "title": "Apple/苹果 iPhone 18 Pro",
  "url": "https://item.taobao.com/item.htm?id=1081525478551",
  "catalogUrl": "https://www.taobao.com/list/item/eHNLbXFpWTZqVFpnUGtNa3BZd0wyUT09.htm",
  "price": 9999,
  "promoLabel": "优惠价",
  "currency": "CNY",
  "priceHKD": 11871.81,
  "priceTWD": 49312.07,
  "shopId": "107922698",
  "shopName": "Apple Store 官方旗舰店",
  "shopUrl": "https://shop107922698.taobao.com/",
  "shopDescriptionScore": 4.88,
  "categoryId": "1512",
  "rootCategoryId": "1512",
  "imageUrl": "https://img.alicdn.com/imgextra/O1CN01K07O05Uz4nH1chua_!!6000000000091-2-yinhe.png",
  "sellingPoints": [],
  "reviewTags": [],
  "searchKeyword": null,
  "matchedKeyword": null,
  "matchedCategoryId": "1512",
  "rank": 1,
  "keywordResultCount": 31200,
  "source": "category",
  "scrapedAt": "2026-10-24T22:32:30.024Z"
}

CSV columns (list mode, in order): itemId, title, url, catalogUrl, price, promoLabel, currency, priceHKD, priceTWD, shopId, shopName, shopUrl, shopDescriptionScore, categoryId, rootCategoryId, imageUrl, sellingPoints/0…, reviewTags/0/tag, reviewTags/0/count…, searchKeyword, matchedKeyword, matchedCategoryId, rank, keywordResultCount, source, scrapedAt; detail columns follow reviewTags. Arrays become numbered columns in CSV/Excel.

---

Scale and speed

Measured on the Apify platform, default settings (1,024 MB memory, 12 parallel requests) unless noted:

Pull	Products	Time	Duplicates	Date (UTC)
Prefill: 1 keyword, maxItems 40	40	8.2 s end-to-end, first products at ~2 s	0	24 Oct 2026
5 keywords, defaults	1,000	26 s	0	24 Oct 2026
50 keywords × up to 300	12,000	217 s (1,646 keyword pages + 49 category pages)	0	24 Oct 2026
1 keyword, no per-keyword limit (蓝牙耳机)	760	61 s (472 related searches tried, 152 with products)	0	24 Oct 2026
5 keywords with item details	1,000	218 s	0	24 Oct 2026
4 keywords with item details, 16 parallel	400	70 s	0	24 Oct 2026
Item lookups (5 inputs: 1 duplicate, 1 not in catalogue)	3	5.8 s	—	24 Oct 2026

Peak memory in the 12,000-product run was 167 MB. In list mode one page brings up to 20 products; with expansion the average was about 7 new products per page, because related searches share many best sellers.

How far can you go? There is no fixed ceiling: each keyword reaches several hundred products before Taobao's related searches run out (760 for 蓝牙耳机), and every additional keyword adds its own. Product pages (item details) are rate-limited more strictly by Taobao than keyword pages, which is why detail runs are slower; the Actor spreads them over its routes automatically.

---

Prices on Taobao: what the numbers mean

• price is the price shown with the product on Taobao's best-seller page for the keyword or category. In our 12,000-row run it equalled Taobao's discounted-price field for every row, so there is one price column, plus promoLabel saying what kind of price it is (优惠价 on 52% of rows, 特价秒杀 13%, 新品促销 5%, no label 14%).
• itemPagePrice (item details) is the price on the product's own page. In a 1,000-product details run on 24 Oct 2026, the two were equal for 776 products and different for 224 — and in every one of those 224 cases the product page showed the lower price (for example ¥129.9 特价秒杀 on the keyword page and ¥99.9 on the product page). Taobao notes on its pages that prices change with promotions (价格可能因优惠活动发生变化); variant-dependent prices and newer promotions are the usual reasons. If you want the lowest public price, use itemPagePrice; if you want the price shoppers see in the best-seller listing, use price.
• Hidden prices. A small number of products — mostly the 百亿补贴 subsidy channel (shop 百亿补贴官方精选) — are published with the placeholder price 99999 or 999999; their real price is only shown in the Taobao app. The Actor does not pass that placeholder on: price, priceHKD, priceTWD and itemPagePrice are empty for those rows (20 of 12,000 rows in our run).
• priceHKD / priceTWD are Taobao's own conversions for overseas shoppers, not ours.
• Spot check (24 Oct 2026, UTC): 12 random rows of the 12,000-product run were compared with each product's own Taobao page. 11 had a product page; for all 11 the item ID, shop name, shop ID and category matched, and the price matched for 10 (the 11th: ¥23.2 on the keyword page, ¥19.6 on the product page). The 12th product had no public product page any more.

---

What you pay

Pay per product (one dataset item = one product). Apify's Store discounts apply automatically on higher plans:

Plan	Free	Bronze	Silver	Gold	Platinum	Diamond
Per 1,000 products	$4.00	$3.53	$3.07	$2.60	$2.60	$2.60

Item details are included in the same price per product — they only take longer. You pay for saved products, not for pages, related-search requests, retries or items that were not found.

Pull	Products	Free plan	Gold and above
Quick sample	40	$0.16	$0.10
One keyword, deep	760	$3.04	$1.98
Typical research pull	1,000	$4.00	$2.60
Category sweep	10,000	$40.00	$26.00
Catalogue build	100,000	$400.00	$260.00

Maximum cost per run

Maximum cost per run (a run option in the Console and the API) caps what one run can spend. The Actor turns it into a product budget at your plan's price before it starts, never writes a product past it, and ends the run successfully with a status message that starts with MAX_COST: and says how many products were saved. Example: a $1.00 cap on the Free plan covers 250 products. If the cap covers fewer products than maxItems, the run saves what the cap covers — raise the cap to get more.

---

Integrations

• Google Sheets — use the built-in Google Sheets integration on the Actor, or schedule a run and import the dataset's CSV export URL with IMPORTDATA.
• Airtable — send dataset items to a table with the Apify–Airtable integration or a Make/Zapier step; upsert on itemId.
• Make (Integromat) — the Apify "Run an Actor" module with any cookbook JSON, then "Get dataset items" and iterate.
• Zapier — "Run Actor" action plus "New dataset item" trigger; good for alerts on price changes.
• n8n — the Apify node runs the Actor and returns items; join with your product database on itemId.
• Webhooks — add a webhook for ACTOR.RUN.SUCCEEDED; the payload contains the dataset ID to download.
• Schedules — save an input as a task and schedule it hourly, daily or weekly for monitoring.
• MCP and AI agents — through Apify's MCP server an assistant can call logiover/taobao-scraper with a keyword or item ID and reason over the JSON.
• Data warehouses — export JSON or CSV to BigQuery, Snowflake, Redshift, Postgres or S3; itemId, shopId, sellerId and categoryId are stable join keys across runs.
• BI tools — Power BI and Tableau read the CSV/JSON dataset endpoints.

---

Performance tips

• Start with the defaults. 1,000 products in about half a minute is usually enough to see a niche.
• Many short keywords beat one long one. Every keyword has its own top 20 and its own related searches.
• Use maxItemsPerKeyword to balance a sweep, so one broad keyword does not take the whole maxItems.
• Turn on item details only when you need them. List mode runs at roughly 40–55 products per second; with details it is about 5 per second.
• For detail runs, raise maxConcurrency to 16–20. The Actor spreads product pages across its routes and pauses a route that Taobao refuses.
• Look up known products with itemUrls instead of searching again.
• Keep Latin keywords in lowercase (the Actor does it for you) and prefer Chinese keywords for maximum coverage.
• One big run is cheaper in time than many small ones: related searches already visited in the run are not fetched twice.

---

Troubleshooting: every status message explained

Status message	Run status	What it means and what to do
Saved 412/1,000 products · 48 pages · 7 s	running	Progress: products saved / limit, pages fetched, seconds since start.
COMPLETED: 1,000 products saved (limit reached) in 26 s.	Succeeded	The run reached maxItems (or every keyword its maxItemsPerKeyword).
COMPLETED: 3 products saved in 5 s — 1 item(s) are not in Taobao's public catalogue (removed, restricted or never listed there).	Succeeded	Some item URLs have no public product page (removed listings, alcohol and other restricted categories, very old items). The others were saved.
COMPLETED: … — N keyword(s) have no Taobao catalogue page (…)	Succeeded	Those keywords have no page of their own; with expansion on, their related searches were still used. Try a shorter or more common keyword.
PARTIAL: … — N page(s) could not be read after retries	Succeeded	Taobao refused some pages on every route after six attempts. The saved products are complete rows; rerun later for the missing pages.
PARTIAL: … — stopped at the run timeout — raise the timeout for more	Succeeded	The run's timeout came before the limits. Increase the timeout or lower maxItems.
MAX_COST: saved N products — the run's maximum cost per run is reached. …	Succeeded	The run's maximum cost covered N products. Raise "Maximum cost per run" for more.
EMPTY_RESULT: the run finished but nothing matched. Taobao has no public catalogue page and no related searches for: …	Succeeded	Taobao answered, but it has nothing public for these keywords. Use a shorter or more common keyword; Chinese works best.
EMPTY_RESULT: … Turn on "Expand with related searches" …	Succeeded	Same, with expansion off: turning it on often finds products through related searches.
INCOMPLETE_NO_ROWS: no products saved and N page(s) could not be read …	Failed	Some pages failed and nothing was saved, so "no results" cannot be confirmed. Retry later.
BLOCKED: no Taobao page could be fetched (…) after N attempt(s) on DIRECT, DC, RES …	Failed	Taobao refused every route for the whole run. This is an access failure, not an empty result; retry later or set your own non-Chinese proxy.
FETCH_FAILED: no Taobao page could be fetched (…)	Failed	Network failures on every route (timeouts, connection errors). Retry later.
INVALID_INPUT: give at least one search keyword …	Failed	The input had no keyword, item URL/ID or category.

Log lines you may see: Route DIRECT refused list pages (captcha page) — paused for 30 s. (normal — the Actor switched route), Ignored N input value(s) that are not Taobao/Tmall … (an input line was not a Taobao link), Resumed after a platform restart: N product(s) already saved are not written or charged again.

---

Honest limits

• No sales counts. Taobao's public pages no longer show 月销 / 已售 (monthly sales / units sold) to logged-out visitors; there is no sales column rather than a made-up one. rank (best-seller position), reviewCountText and reviewMentions are the public popularity signals.
• 20 products per keyword page. Taobao serves page 1 of each keyword publicly; deeper pages, sorting and price filters need a login. Depth comes from more keywords and Taobao's related searches, which typically yield several hundred products per broad keyword.
• Best-seller order only. You cannot sort by price or newest; sort the dataset yourself.
• No variants, specifications, descriptions or image galleries. SKU lists (颜色分类/尺码), parameter tables, description images and the full photo set are only on the logged-in product page. The latestReviews[].sku text shows one variant a buyer bought.
• One recent review per product, not all reviews. Full review lists require a login on Taobao.
• Titles in item lookups are shortened. For item URLs/IDs the title comes from the product's public page, which shortens long titles (ending in "...") or shows a short rewritten title. Keyword and category rows always have the full title.
• Not every product has a public page. Removed listings and some restricted categories (alcohol such as 茅台, adult products) are missing from the catalogue; they are counted in the run summary.
• Prices can differ between pages (see Prices on Taobao) and some subsidy-channel prices are hidden.
• Mainland-China exits are refused by these overseas pages; the Actor never uses them.
• Shop pages list no products publicly, so there is no "all products of a shop" mode.

---

Comparison: official API, manual copying and this Actor

	Taobao Open Platform API	Copying by hand / browser extensions	This Actor
Account needed	Registered developer app, approval, often a business licence in China	A logged-in Taobao account	None
Keyword product search	Limited to approved app types (e.g. affiliate tools), quotas per app	Yes, page by page	Yes — best sellers per keyword plus related searches
Item details by ID	With approved permissions	Yes, one at a time	Yes, in bulk (public fields)
Sales counts, SKUs, full reviews	Depends on permissions	Yes when logged in	No (not public)
Output	JSON via SDK	Whatever you paste	JSON, CSV, Excel, API, webhooks
Scale	Rate-limited per app	Minutes per product	12,000 products in under 4 minutes
Maintenance	SDK and permission upkeep	Manual	Maintained Actor; you pay per product

The Open Platform suits registered partners who need logged-in data such as orders or full SKU lists; manual copying suits a handful of products; this Actor is for public Taobao and Tmall product data in bulk without an account.

---

FAQ

How do I scrape Taobao without logging in?

Add your keywords and start the Actor. It reads Taobao's public catalogue pages (www.taobao.com/list/…), which Taobao serves without login; no account, cookie or slider is involved.

Is there a Taobao API for product search?

Taobao's Open Platform offers APIs to registered and approved developer apps. For public product data without an app or account, this Actor acts as a Taobao product search API: call it over the Apify API with a keyword and get JSON back.

Does it scrape Tmall too?

Yes. Tmall products are part of the same catalogue; with item details on, platform says Tmall or Taobao and url points to detail.tmall.com for Tmall products. In a 1,000-product sample, 734 were Tmall and 266 Taobao.

How many products can I get per keyword?

20 from the keyword's own page; with related-search expansion typically several hundred (760 for 蓝牙耳机 on 24 Oct 2026). Use more keywords for more.

How many products can one run deliver?

As many as your keywords reach — 12,000 unique products from 50 keywords in 217 seconds in our test, with no duplicates.

Why are there only 20 products for my keyword with expansion off?

Taobao publishes page 1 (20 best sellers) of each keyword publicly; further pages need a login. Turn expansion on to add Taobao's related searches.

Can I get monthly sales (月销) or sold counts (已售)?

No. Taobao removed them from its public pages; they are shown only to logged-in users. The Actor does not estimate or invent them.

Can I scrape Taobao product details by item ID?

Yes — put IDs or links in Item URLs or IDs. You get price, Tmall/Taobao, seller, ship-from city, shop ratings and age, review count, buyer mentions and a recent review.

Which item URL formats are accepted?

item.taobao.com and detail.tmall.com links with id=, mobile links with id=, catalogue links (www.taobao.com/list/item/….htm, world.taobao.com/item/….htm) and plain numeric IDs.

Why was my item URL reported as "not in Taobao's public catalogue"?

Taobao does not publish every product: removed listings, very old listings and some restricted categories (alcohol, adult) have no public page. Those items cannot be read without a login.

Can I search in English?

Yes — Taobao's catalogue has pages for many English and mixed keywords (phone case, airpods, led). Chinese keywords usually give more products.

Do I need a proxy?

No. The Actor fetches directly from the platform first and switches to Apify's datacenter and residential proxies by itself when Taobao refuses an address.

Why not a Chinese residential proxy?

These are Taobao's overseas pages; mainland-China addresses get Taobao's captcha instead. The Actor uses a US residential exit as its rescue route.

How fresh is the data?

Every run reads the live pages at run time; scrapedAt records when. Taobao's catalogue pages themselves state the month they were updated.

How is a product's position (rank) defined?

Its place (1–20) on the Taobao best-seller page where it was found — the keyword page in matchedKeyword or the category page in matchedCategoryId.

What does keywordResultCount mean?

The number of products Taobao says it has for that keyword or category ("淘宝当前有30,365件保温杯相关的商品在售").

Why do some rows have a different matchedKeyword than my keyword?

They were found on one of Taobao's related searches for your keyword. Filter matchedKeyword == searchKeyword for your exact keyword's top 20.

Why is price different from itemPagePrice?

The keyword page and the product page show prices from different moments and variants; when they differ, the product page is lower in every case we measured. Both are Taobao's published prices.

Why is price empty for a few products?

Taobao publishes 99999 instead of a price for some subsidy-channel (百亿补贴) products whose price only appears in its app. The Actor leaves the price empty rather than saving a fake one.

Are prices in RMB?

price and itemPagePrice are in CNY (人民币, yuan). priceHKD and priceTWD are Taobao's own Hong Kong and Taiwan dollar prices.

Can I get all products of a shop?

Not publicly: Taobao's public shop pages show the shop's ratings but no product list. Run keywords that include the brand or shop name instead.

How do I get Taobao reviews?

With item details on you get the review count, what buyers mention with counts, and the recent review Taobao shows publicly. Full review lists need a login and are not available.

Can I limit the cost of a run?

Yes: set maxItems and the run option Maximum cost per run. The Actor stops cleanly at the limit.

Can I schedule daily Taobao price monitoring?

Yes. Save your input as a task and schedule it; join successive datasets on itemId.

Can I export Taobao data to Excel?

Yes — Export → Excel (or CSV, JSON, XML, HTML) in the Console, or format=xlsx on the dataset items API.

Does it work with Google Sheets, Make, Zapier or n8n?

Yes, through Apify's integrations for each of them; see Integrations.

Can an AI agent use it?

Yes. Through Apify's MCP server, assistants can call the Actor with a keyword or item ID and read the JSON rows.

Does it solve captchas or sliders?

No. It never solves or bypasses captchas; when Taobao answers with one, the request moves to another route.

Is the Chinese text encoded correctly?

Yes — all text is UTF-8 Unicode, exactly as Taobao shows it (titles, shop names, labels, reviews).

What happens if the platform restarts the run?

The Actor remembers saved item IDs and never saves or charges a product twice.

Can I scrape 1688, Xianyu or AliExpress with it?

No — this Actor is for Taobao and Tmall products only.

---

Glossary

Term	Meaning
淘宝 (Taobao)	Alibaba's consumer marketplace; small and large sellers (C shops)
天猫 (Tmall)	Alibaba's mall for brands and licensed sellers (B shops), part of the same catalogue
天猫超市 (Tmall Supermarket)	Tmall's own grocery and household store
天猫国际 (Tmall Global)	Tmall's cross-border import channel
淘宝海外	Taobao for overseas shoppers; serves the public catalogue pages
宝贝	"Treasure" — Taobao's word for a product listing
店铺 / 掌柜	Shop / shop owner
旗舰店	Flagship store (official brand store on Tmall)
发货地	Ship-from location (shipFrom)
类目 / 叶子类目 / 一级类目	Category / leaf category / top-level category
关键词 / 联想词	Keyword / related search (search-box suggestion)
热卖	Best-selling
优惠价	Discounted price
特价秒杀	Flash-sale special price
新品促销	New-product promotion
超级立减	Instant discount event
百亿补贴	"Ten-billion subsidy" channel; prices shown only in the app
店铺动态评分 (DSR)	Shop dynamic ratings: 描述相符 (description), 服务态度 (service), 物流服务 (logistics)
信用等级	Seller credit level (shopCreditLevel)
评价 / 买家秀	Reviews / buyer photo reviews
卖点	Selling point (sellingPoints)
月销 / 已售	Monthly sales / units sold (not public any more)
花呗 / 集分宝 / 支付宝	Huabei credit / Jifenbao points / Alipay (paymentMethods)

---

Is it legal to scrape Taobao?

This Actor reads pages that Taobao publishes publicly for search engines and overseas visitors, without logging in and without bypassing any access control; Taobao's robots.txt allows these /list/ pages. The data is product and shop information that businesses publish to sell. Reviews are shown as Taobao publishes them, without reviewer names. Laws on data use still apply to you: if your use touches personal information (for example shop owners who are individuals), comply with China's Personal Information Protection Law (PIPL), the EU GDPR and other laws that apply to you, respect Taobao's terms, and do not use the data for spam or unlawful purposes. If in doubt, ask a lawyer about your specific use.

---

Changelog

• 1.0 (25 October 2026) — First release: keyword search with Taobao related-search expansion, categories, item lookups by URL or ID, optional item details (Tmall/Taobao, seller, ship-from city, shop ratings, review count, buyer mentions, recent review), placeholder-price filtering, route ladder (direct → datacenter → residential rescue), run summary, pay per product.

---

Support

Found a problem, need a field, or want a custom pull? Open an issue on the Actor's Issues tab with the run ID — we reply within 24 hours.