Taobao Catalogue Scraper - Products, CNY Prices & Shops
Pricing
from $1.92 / 1,000 products
Taobao Catalogue Scraper - Products, CNY Prices & Shops
Export Taobao and Tmall products by keyword, category or shop from Taobao's public overseas catalogue: CNY/HKD/TWD prices, discounts, shop scores and optional item-page seller details and review highlights. No login.
Pricing
from $1.92 / 1,000 products
Rating
0.0
(0)
Developer
Automation Lab
Maintained by CommunityActor stats
0
Bookmarked
3
Total users
2
Monthly active users
19 days ago
Last modified
Categories
Features
Share
Export Taobao (淘宝) and Tmall (天猫) products by keyword, category or shop from the public catalogue that Taobao publishes for overseas shoppers. Each product comes with its yuan (CNY) price, the Hong Kong dollar and New Taiwan dollar equivalents, Taobao's price label, images, shop ID and name, category IDs and the shop's description score. Turn on Include item details to add the seller profile, the three shop service scores, ship-from location, Taobao vs. Tmall, payment methods, review count, review highlights and the latest review.
No Taobao account, no cookies and no browser. The Actor reads plain catalogue pages, so runs are fast and cheap.
What does Taobao Catalogue Scraper do?
- Keyword search – enter Chinese or English keywords and get the best-selling matching products.
- Category listings – enter a numeric category ID (for example
1512for mobile phones). - Shop catalogues – enter a shop ID and get the products that shop lists.
- Catalogue links – paste
www.taobao.com/list/...orworld.taobao.com/...keyword, category, shop or item links. - Deep scan – Taobao shows signed-out visitors one page per listing (20 products per keyword or category, 60 per shop). Deep scan also reads the listing in price bands and other sort orders, which usually gives 100-230 unique products per keyword, about 120 per category and about 140 per shop.
- Price filter – keep only products between a minimum and maximum yuan price.
- Item details (optional) – open each product's catalogue page for the seller profile, service scores and buyer review summary.
Who is it for?
- Sourcing agents and importers who compare Chinese supplier prices for the same product every week.
- Cross-border e-commerce sellers (Shopee, Lazada, Amazon, eBay, Etsy) who check what a product costs on Taobao before listing it.
- Dropshippers and buying agents who need product links, CNY prices and shop scores for their customers.
- Brand owners who monitor how their products and lookalikes are priced on Taobao and Tmall.
- Market researchers and analysts who track price levels, best sellers and shop quality in a niche.
Why use this Taobao scraper?
- Recurring price comparisons – run the same keywords or shops on a schedule and compare yuan prices over time.
- More than one page – deep scan reaches several times the products a single signed-out page shows, including for categories.
- Shop quality at a glance – description, service and delivery scores, seller type (Tmall business or individual seller), shop age and size.
- Buyer voice – review count and highlights such as "声音质量好 (good sound) – 99 buyers", plus the latest review with the variant bought.
- Honest limits – Taobao does not serve numeric item links (
item.taobao.com/item.htm?id=...) to signed-out visitors, so the Actor rejects them up front with a clear message instead of charging for empty rows.
What data can you extract from Taobao?
| Field | Example | Available |
|---|---|---|
itemId, title | 1079352038299, 爱国者蓝牙耳机半入耳式2026新款... | Always (Taobao shortens the title on item pages, so catalogue item links given as input return the short title) |
price, currency, listPrice | 118, CNY, 118 | Always |
priceHkd, priceTwd | 140.41, 584.21 | Listings (null for catalogue item links given as input) |
discountType | 优惠价 (offer price), 特价秒杀 (flash sale) | When Taobao shows a label |
image, images | img.alicdn.com URLs | Always |
shopId, shopName | 503709453, 腔调会员精选旗舰店 | Always |
categoryId, rootCategoryId | 50005050, 50011972 | Always |
descriptionScore, freeShipping, areaLimited | 4.91, false, false | Listings |
sellingPoints | ["全网通制 信号稳定"] | When the seller sets them |
shopScores | description / service / delivery out of 5 | Shop listings and item details |
url, taobaoUrl | catalogue page and item.taobao.com link | Always |
platform, location, categoryPath | tmall, 上海, ["影音视听","耳机耳放","耳机"] | Item details |
originalPrice, promotionPrice, hasRangePrice | 118, 118, false | Item details |
sellerId, sellerType, sellerCreditLevel | 2215824413675, B, 19 | Item details |
shopOpenedAt, shopItemCount, shopNewItemCount | 2023-05-08, 1707, 172 | Item details |
paymentMethods | ["蚂蚁花呗","信用卡支付","集分宝"] | Item details |
reviewCount, reviewHighlights, latestReview | 3000+, tags with buyer counts, rating/text/date/variant | Item details, when the product has reviews |
detailsIncluded, detailError | true, null | Always; detailError explains why a product has no item details |
sourceType, sourceInput, searchSlice, position | search, 蓝牙耳机, price 200-500 CNY, best sellers, 3 | Always |
How much does it cost to scrape Taobao products?
This Actor uses pay-per-event pricing. You pay a small fee per run plus a fee per product saved. Products removed by your price filter, duplicates and failed pages are never charged. The run fee is taken together with the first saved product, so a run that finds no products costs nothing.
| Event | Free plan | Bronze | Silver | Gold and above |
|---|---|---|---|---|
| Run start (once per run, with the first product) | $0.001 | $0.001 | $0.001 | $0.001 |
| Product | $0.00368 | $0.0032 | $0.002496 | $0.00192 |
| Item page details (only with Include item details, also for catalogue item links; only when the details were added) | $0.00253 | $0.0022 | $0.001716 | $0.00132 |
Examples at Bronze prices:
- 100 products from a keyword search: $0.001 + 100 × $0.0032 = about $0.32.
- 100 products with item details: $0.001 + 100 × ($0.0032 + $0.0022) = about $0.54.
- 1,000 products from 10 keywords: $0.001 + 1,000 × $0.0032 = about $3.20.
Maximum cost per run: the Actor charges for each product before saving it and stops when your maximum cost per run is reached, so you never get rows beyond your budget. If the budget covers a product but not its item details, that last product is saved with listing fields only and only the product is charged.
Platform usage (compute and proxy) is included in these event prices; a typical 100-product run uses well under one cent of platform resources. Apify's free plan includes monthly credit, enough for several thousand products.
How to scrape Taobao products
- Open the Actor and enter one or more Search terms, for example
蓝牙耳机(Bluetooth earphones). Chinese keywords reach far more products. - Optionally add Category IDs, Shop IDs or catalogue links.
- Set Maximum products (shared between all inputs).
- Keep Deep scan on to go beyond the first page.
- Turn on Include item details if you need seller profiles and review summaries.
- Click Start, then download the results as JSON, CSV, Excel or HTML, or read them through the API.
Input parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
searchTerms | array of strings | – | Keywords to search in the Taobao catalogue. |
categoryIds | array of strings | – | Numeric category IDs, e.g. 1512. |
shopIds | array of strings | – | Numeric shop IDs (the shopId field of results). |
startUrls | array of URLs | – | Catalogue keyword, category, shop (/list/dianpu/<id>.htm) or item (/list/item/<code>.htm) links. |
maxItems | integer | 100 | Maximum products in total, shared equally between inputs. |
deepScan | boolean | true | Also read price bands and sort orders for more unique products. |
includeDetails | boolean | false | Add seller and review details from each product's item page. Also applies to catalogue item links given as input. |
minPrice, maxPrice | integer (CNY) | – | Keep only products in this yuan price range. |
Example input:
{"searchTerms": ["蓝牙耳机", "保温杯"],"shopIds": ["72104903"],"maxItems": 200,"deepScan": true,"includeDetails": true,"minPrice": 30,"maxPrice": 500}
Output example
One product with item details (real output, review text shortened):
{"itemId": "1079352038299","itemCode": "RjRZL1NqR2pVTkxHOTFNTUIvZU8wZz09","title": "爱国者蓝牙耳机半入耳式2026新款降噪高音质无线运动超长续航游戏","url": "https://www.taobao.com/list/item/RjRZL1NqR2pVTkxHOTFNTUIvZU8wZz09.htm","taobaoUrl": "https://item.taobao.com/item.htm?id=1079352038299","price": 118,"currency": "CNY","listPrice": 118,"priceHkd": 140.41,"priceTwd": 584.21,"discountType": null,"image": "https://img.alicdn.com/imgextra/i3/2215824413675/O1CN01E5GhXKqZBrE1chua_!!4611686018427384811-0-item_pic.jpg","shopId": "503709453","shopName": "腔调会员精选旗舰店","categoryId": "50005050","rootCategoryId": "50011972","descriptionScore": 4.91,"freeShipping": false,"areaLimited": false,"shopScores": { "description": 4.9, "service": 4.9, "delivery": 4.9 },"position": 1,"sourceType": "search","sourceInput": "蓝牙耳机","searchSlice": null,"detailsIncluded": true,"platform": "tmall","location": "上海","categoryPath": ["影音视听", "耳机耳放", "耳机"],"originalPrice": 118,"promotionPrice": 118,"sellerType": "B","sellerCreditLevel": 19,"shopOpenedAt": "2023-05-08","shopItemCount": 1707,"paymentMethods": ["蚂蚁花呗", "信用卡支付", "集分宝"],"reviewCount": "3000+","reviewHighlights": [{ "tag": "声音质量好", "count": 99 },{ "tag": "续航能力强", "count": 72 }],"latestReview": { "rating": 5, "text": "声音挺清晰的。价格实惠,很快收到", "date": "2026-10-04", "variant": "商品规格:黑色" },"detailError": null,"scrapedAt": "2026-11-03T07:19:31.570Z"}
A SUMMARY record in the run's key-value store lists, per input, how many pages were read, how many products were saved and any input Taobao had no page for.
Tips and limits
- Use Chinese keywords. Taobao does not translate searches;
phone caseonly matches titles that contain those English words. - Titles are in Simplified Chinese, as the sellers wrote them. Translate them downstream if needed.
- Prices are in yuan. HKD and TWD values are Taobao's own conversions.
- Signed-out limits: Taobao shows 20 products per keyword or category page and 60 per shop page. Deep scan multiplies this with price bands and sort orders, but it cannot list a whole category of 100,000 products.
- No SKU matrix. The public catalogue does not publish per-variant prices, stock or full descriptions.
- Numeric item links are not supported (
item.taobao.com/item.htm?id=...,detail.tmall.com/...). Use the catalogue item link from a result'surl, or search for the product or its shop. - Unknown inputs: a keyword with no matches or a shop ID that does not exist returns no products and is not charged; the log and
SUMMARYsay which input had no page. - Item details are best effort. If an item page cannot be loaded, the product is still saved with listing fields,
detailsIncluded: falseand adetailErrormessage. Such a product is billed as a product only, without the item-details fee. After 5 item pages fail in a row, the Actor stops opening item pages for the rest of the run and saves listing fields only. - Catalogue item links given as input return the item page's shortened title and no HKD/TWD prices. Results from keyword, category and shop listings keep the full title and all prices.
- If one deep-scan page cannot be loaded after several retries, the Actor skips that page, keeps everything else and logs it.
Integrations
- Weekly price tracking – schedule the Actor with your keywords or shop IDs and send the dataset to Google Sheets to see price changes week over week.
- Supplier shortlists – filter by
sellerType,shopScoresandreviewCountto shortlist reliable shops before contacting them. - Listing research – push results to Airtable or a database and match Taobao prices against your own store's prices.
- Alerts – use Make, Zapier or n8n to post to Slack when a product's
pricedrops below a threshold. - Webhooks – trigger your own pipeline when a run finishes.
Use the Taobao scraper through the API
cURL:
curl -X POST "https://api.apify.com/v2/acts/automation-lab~taobao-overseas-public-catalogue-products-and-prices/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \-H "Content-Type: application/json" \-d '{"searchTerms":["蓝牙耳机"],"maxItems":50}'
JavaScript:
import { ApifyClient } from 'apify-client';const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });const run = await client.actor('automation-lab/taobao-overseas-public-catalogue-products-and-prices').call({searchTerms: ['蓝牙耳机'],maxItems: 50,includeDetails: true,});const { items } = await client.dataset(run.defaultDatasetId).listItems();console.log(items.map((p) => `${p.title} – ¥${p.price}`));
Python:
from apify_client import ApifyClientclient = ApifyClient("YOUR_API_TOKEN")run = client.actor("automation-lab/taobao-overseas-public-catalogue-products-and-prices").call(run_input={"searchTerms": ["保温杯"], "maxItems": 50, "minPrice": 30, "maxPrice": 150})for item in client.dataset(run["defaultDatasetId"]).iterate_items():print(item["title"], item["price"], item["shopName"])
Use it with AI agents through MCP
Add the Actor to Claude Code:
claude mcp add --transport http apify \"https://mcp.apify.com?tools=automation-lab/taobao-overseas-public-catalogue-products-and-prices"
Or add this to the JSON configuration of Claude Desktop, Cursor or VS Code:
{"mcpServers": {"apify": {"url": "https://mcp.apify.com?tools=automation-lab/taobao-overseas-public-catalogue-products-and-prices"}}}
Selecting this Actor also adds the run, dataset and key-value store tools (get-actor-run, get-dataset-items, get-key-value-store-record, abort-actor-run), so the server exposes more than one tool. Check the exact tool names and arguments with tools/list and use only the ones you need.
A reliable way for an agent to go from a run to results:
- Start the run once and keep the returned run ID and
defaultDatasetId.call-actorwaits at most 45 seconds (default 30), so a larger scrape may still be running when it returns. Set your client's request timeout above that wait plus a few seconds. - Follow that same run. While it is
READYorRUNNING, callget-actor-runfor the same run ID with growing pauses (for example 2, 4, 8, then every 10 seconds) up to a deadline you choose, for example 120 seconds. Never start a new run just to check progress. If the client times out, check the run ID you already have. At the deadline, report that the run is still pending, with its run ID, and stop. - Handle the end state honestly.
SUCCEEDEDmeans you can read results.FAILED,ABORTEDorTIMED-OUTmeans report the failure and its status message; any rows already saved are a partial result, not the full answer. - Read results in bounded pages. Call
get-dataset-itemswith that dataset ID, an explicitlimit,offsetand only thefieldsyou need (for exampletitle,price,shopName,url). A sensible budget is pages of 20 rows from offset 0, at most 100 rows and at most 64 KiB of result text in total, whichever comes first. Measure the size of each page before giving it to the model; if a page or a row is too large, shorten or leave it out and say so. - Say when the result is partial. When you stop at the budget, report how many rows you read, the next
offsetto continue from and that more rows exist. For full exports, download the dataset (JSON, CSV or Excel) outside the chat instead of reading it all into the conversation.
These budget numbers are example choices for keeping an agent's context small, not Apify limits; they do not reduce what the Actor collects.
Example prompts:
- "Find 50 Bluetooth earphones (蓝牙耳机) on Taobao between 100 and 300 yuan and list the shops with the best service scores."
- "Get the products of Taobao shop 72104903 and tell me the cheapest five."
- "Compare Taobao prices for 保温杯 from Tmall shops versus individual sellers."
Is it legal to scrape Taobao?
This Actor reads only public catalogue pages that Taobao publishes for search engines and overseas visitors, without logging in. It does not collect buyers' personal data; review authors appear masked (***) on Taobao and are not exported. You are responsible for how you use the data: respect Taobao's terms, copyright in product images and descriptions, and the data-protection laws that apply to you. If unsure, ask a lawyer.
Taobao and Tmall are trademarks of Alibaba Group. This Actor is independent and not affiliated with or endorsed by them.
Error diagnostics: when an operation fails, the Actor sends sanitized diagnostic input, the exception and the Actor/build/run IDs to our private GlitchTip error-tracking service so we can repair it. Secret fields and URL query strings are removed, and reports are retained for 30 days.
FAQ
Why do I get only 20 products for my keyword? Turn on Deep scan (on by default). If it is on and you still see few products, the keyword has few matches in the catalogue; try a broader or Chinese keyword.
Why did my item link fail?
Numeric item links (item.taobao.com/item.htm?id=...) are not shown to signed-out visitors, so the Actor stops with a message. Use the url field from an earlier result (www.taobao.com/list/item/<code>.htm) or search for the product.
Why is reviewHighlights empty for some products?
Taobao only publishes review highlights for products with enough reviews. New products have none.
Can I get prices in US dollars? The Actor returns CNY plus Taobao's HKD and TWD conversions. Convert CNY to any currency downstream with your preferred rate.
A run logged "Skipped one result slice". Is my data incomplete? Taobao occasionally refuses one filtered page. The Actor retries with new connections and then skips only that page. You still get every other product; rerun later if you need the extra slice.
Related Actors
- 1688 Scraper – wholesale prices and suppliers from Alibaba's Chinese B2B marketplace.
- AliExpress Products Scraper – retail prices for products shipped from China.
- Alibaba Products Scraper – international B2B product listings and suppliers.