Taobao & Tmall Scraper 淘宝 天猫 - Products, Prices, Reviews

Taobao Scraper

Scrape Taobao and Tmall products without login: search in English or Chinese and get title, price in CNY or any currency, shop, shop scores, seller and reviews. US$ 3.00 per 1,000 products, up to about 300 products per term.

What does this Taobao scraper do?

• Price per 1,000 products: US$ 3.00, no run start fee
• Product page (optional): + US$ 3.00 per 1,000, only when you turn it on (product links always include it)
• Inputs: search terms in English, Chinese or any language, category ids, shop ids, product links or ids
• English in, English out: terms translated to Chinese when needed; translateTitles adds titleEnglish, no extra charge
• Per search term: up to about 60 products (Taobao's best sellers for the term plus its monthly top-rated list), or up to about 300 with deepScan, which reads the term across price bands and price orders
• Prices: CNY, HKD and TWD as Taobao shows them, plus an optional conversion to USD, EUR or any currency
• Monitoring: only new products and price change tracking between runs
• Filters: price range in CNY, free shipping only, Tmall only; a cap for the whole run (maxTotalItems)
• Error rows: free, with an errorCode

What it fixes

• Search in English. led strip, wireless earbuds or pet bed have no Taobao page of their own; the Actor translates them (灯带, 无线耳机, 宠物床) and returns the products, with searchedAs in each row. Korean, Japanese, Spanish and other languages are translated before the search.
• Titles you can read. Turn on translateTitles and each product carries titleEnglish (and each review in the sample textEnglish), or any other language with targetLanguage.
• Many products in one run. A product that was taken down gives a free NOT_FOUND row; the rest goes on.
• Any product link works: item.taobao.com/item.htm?from=cart&id=..., ?ft=t&id=..., long Tmall links full of tracking parameters, world.taobao.com/item/ID.htm, a bare id, or the whole share text copied from the Taobao app with the link inside.
• Your limit is respected. A maxItems pasted from another Taobao actor caps the whole run (and the charges), instead of this form's default of 40 per search.
• Honest about what needs a login. Variant (SKU) grids, coupon prices, dispatch promise, description images and more reviews are not on Taobao's public pages; the Actor says so instead of inventing values.

Switching from another Taobao actor? Your existing input works

Paste the input you already use. These names and values are read as they are:

You may already send	Read as
keyword, keywords, query	searchTerms
items, itemUrls, itemId, product_url, productUrl, startUrls	productUrls
categoryIds, shopIds, shopId	categoryIds, shopIds
urlsFromFile (one link per line, or a link to a .txt, .csv or Google Sheet)	sorted into products, shops, categories and searches
mode: search, category, item, shop; operation: keywordSearch, productDetail, shopCatalog, productReviews	only the list of that mode is read
maxItems, maxResults	maxTotalItems (cap for the whole run)
minPrice, maxPrice, startPrice, endPrice (CNY)	minPrice, maxPrice
freeShippingOnly, tmallOnly	same names
scrapeDetails, enrichWithDetails, fetchReviews	includeDetails (product page with the review sample)
region (sg, my, th, au, jp, kr, ca...)	currency (SGD, MYR, THB, AUD, JPY, KRW, CAD...)

{ "mode": "search", "keywords": ["手机壳"], "maxItems": 30, "region": "sg", "scrapeDetails": true }

{ "items": ["https://item.taobao.com/item.htm?id=1010692564493", "https://detail.tmall.com/item.htm?id=971278517006"], "fetchReviews": true }

sort and sortBy are accepted and ignored (results come in best-seller order).

One real row

Product link https://item.taobao.com/item.htm?id=1010692564493 (collected on 2026-10-08; review text shortened):

{
  "type": "product",
  "itemId": "1010692564493",
  "url": "https://item.taobao.com/item.htm?id=1010692564493",
  "title": "新款老人机2026年...",
  "price": 185,
  "currency": "CNY",
  "shopId": "188555483",
  "shopName": "十三手机通讯",
  "shopDescriptionScore": 4.8,
  "categoryId": "1512",
  "imageUrl": "https://img.alicdn.com/imgextra/i1/2200733115816/O1CN012K4Bhv1spmdar9Ifq_!!2200733115816.jpg",
  "platform": "taobao",
  "location": "广东深圳",
  "categoryPath": ["手机行业导购条", "2999-3999元"],
  "seller": {
    "shopId": "188555483",
    "shopName": "十三手机通讯",
    "sellerId": "2200733115816",
    "sellerType": "individual",
    "creditLevel": 13,
    "totalItems": 16,
    "openedAt": "2019-03-04 21:59:56",
    "descriptionScore": 4.8,
    "serviceScore": 4.8,
    "logisticsScore": 4.9
  },
  "reviews": {
    "positiveRate": "99%",
    "neutralRate": "1%",
    "negativeRate": "0%",
    "positiveCountText": "2万+",
    "positiveCount": 20000,
    "negativeCount": 10,
    "sample": [{ "score": 5, "date": "2026.09.13 18:50", "text": "刚收到手机就来评价啦！...", "variant": "机身颜色:中国红【5G增强版】..." }]
  },
  "paymentMethods": ["蚂蚁花呗", "信用卡支付", "集分宝"],
  "detailsIncluded": true,
  "source": "https://item.taobao.com/item.htm?id=1010692564493"
}

A search row for led strip with translateTitles (2026-10-12) has "searchedAs": "灯带" and "titleEnglish": "LED light strip 220v waterproof super bright self-adhesive...". Search rows have the full title, plus priceHKD, priceTWD, promotionLabel, sellingPoints and position; with currency: "USD" it also has priceConverted (54.90 CNY became 8.19 USD at the rate of 0.1492).

Who uses this Taobao scraper

• Product sourcing and dropshipping research: what sells on Taobao for a keyword, at what price, from which shops.
• Price comparison: Taobao retail prices against your marketplace, in your currency.
• Shop and seller screening: individual or business seller, credit level, shop age and the three shop scores before you buy through an agent.
• Price monitoring: run on a schedule with "Only new products" and "Track price changes".

For factory and wholesale prices with quantity tiers and MOQ, see 1688 Scraper (for wholesale sourcing on 1688).

How to scrape Taobao

1. Type products in Search terms, in English or Chinese, or paste product, shop or category links.
2. Set how many products you want per search and, if you want, a price range or free shipping only.
3. Click Start. Products appear in the Output tab and export to JSON, CSV or Excel.

Taobao scraper input

Field	What it does
searchTerms	Terms in English, Chinese or any language (translated to Chinese when Taobao has no page for them), or a Taobao search link. Up to about 60 products each, about 300 with deepScan
deepScan	Reads each term across 9 price bands and both price orders for up to ~300 different products; with minPrice/maxPrice it reads that range directly
categoryIds	Category ids or world.taobao.com/category/ID.htm links. Up to 20 products each
shopIds	Shop ids or links (world.taobao.com/dianpu/ID.htm, shopID.taobao.com). Up to 60 products each
productUrls	item.taobao.com/item.htm?id=, detail.tmall.com/item.htm?id=, world.taobao.com/item/ID.htm links or numeric ids; always with the product page
maxItemsPerSearch	Default 40, per search term, category or shop
maxTotalItems	Optional cap for the whole run, across every input
minPrice, maxPrice	Price range in CNY for searches, categories and shops; products outside are skipped and not charged
freeShippingOnly	Only products marked as free shipping
tmallOnly	Only Tmall products (turns on the product page, where Taobao says Tmall or Taobao)
includeDetails	Adds the summary product page to every product found; one extra request per product
traditionalChinese	Off (default): simplified Chinese, as sellers write it. On: traditional Chinese
translateTitles	Adds titleEnglish to every product and textEnglish to the review sample; no extra charge. Also read from translate: true or language: "en"
targetLanguage	Language of the translation: en (default), es, pt, fr, de, ru, ko, ja... Other than English, the fields are titleTranslated and textTranslated
currency	Optional extra currency (USD, EUR, GBP...) at the European Central Bank reference rate of the day
onlyNew, trackPriceChanges	Monitoring between runs (state kept in your account)

{ "searchTerms": ["phone case", "led strip", "wireless earbuds"], "maxItemsPerSearch": 60, "includeDetails": true, "translateTitles": true, "currency": "USD" }

Output fields

From every search, category and shop: itemId, url (the Taobao or Tmall product link), pageUrl, title, price (CNY), originalPrice (when Taobao shows a higher price), currency, priceHKD, priceTWD, promotionLabel, sellingPoints, freeShipping, shopId, shopName, shopDescriptionScore, categoryId, rootCategoryId, imageUrl, images, reviewTags (some categories), position (rank in the list), source, searchedAs (searches only: the term that returned the product, translated to Chinese when needed), scrapedAt.

With the product page: platform (taobao or tmall), location, categoryPath, gallery, pagePrice, pageOriginalPrice, hasPriceRange, seller (shopId, shopName, sellerId, sellerType individual or business, creditLevel, totalItems, newItems, openedAt, descriptionScore, serviceScore, logisticsScore), reviews (positiveRate, neutralRate, negativeRate, positiveCount, negativeCount, sample with score, date, text and the variant bought), paymentMethods, titleShort, detailsIncluded.

With translateTitles: titleEnglish and textEnglish in the review sample (titleTranslated, textTranslated and translationLanguage for other languages; empty when the translation is unavailable). With currency: priceConverted, originalPriceConverted, convertedCurrency, exchangeRate, exchangeRateDate. With monitoring: isNewProduct, firstSeenAt, previousPrice, priceChange, isPriceDrop.

Error codes (never charged)

errorCode	Meaning
NO_RESULTS	Taobao has nothing for this search (also after translating it to Chinese), or the category or shop does not exist
NOT_FOUND	The product does not exist or was taken down
INVALID_INPUT	A value the Actor does not understand
UNSUPPORTED_MODE	Buyer questions and answers: they need a Taobao login
BLOCKED	Taobao showed a verification page after every retry; run again
NOT_REACHED, UNEXPECTED	The run timeout arrived, or something unforeseen broke; only that input is lost

How much does it cost to scrape Taobao?

Event	Per 1,000
Product delivered	US$ 3.00
Product page added (optional; always on for product links)	US$ 3.00

1,000 search results cost US$ 3.00; with the product page, US$ 6.00. Duplicates, products held back by "Only new products" and error rows are free, and there is no Apify compute bill on top.

Limitations

• Summary product page, no SKU or variant grid. The product page is Taobao's public summary page: it has no variant list, no per-variant price or stock, no attributes table and no description images. Its title can be shortened with "...", so the full title comes from search, category and shop rows.
• Search works for the terms Taobao has a public page for. Translation gets most English terms there, but a very long or unusual term may have no page even in Chinese: then a free NO_RESULTS row says which Chinese term was tried. Shorter, common terms work best.
• Titles are machine translated: good enough to read and filter, not a certified translation.
• Without login Taobao shows about 60 products per search term (its best sellers and its monthly top-rated list), 20 per category and 60 per shop. Deeper pages need a logged-in account; deepScan reaches about 300 products per term by reading price bands instead. For even more, use several related terms.
• Tmall product pages carry the review sample but not the positive rate or review counts; those come for Taobao shops.
• No sold count: Taobao hides it from visitors. shopDescriptionScore is the shop's "item as described" score, not a product rating.
• Prices are what Taobao shows to a visitor, before shipping and before coupons that need an account. price may differ slightly between the search row and the product page (pagePrice) when a promotion starts or ends.
• Proxy is included. Requests are paced to be polite, so expect about 1 to 2 seconds per page.
• No personal data: sellers come as shops (name, numeric ids, scores). Reviewer names and photos are never collected; Taobao already masks them.

Taobao scraper FAQ

Do I need a Taobao account? No. Everything comes from Taobao's public pages, without login.

Can I search in English? Yes. A term without its own Taobao page is translated to Chinese and searched again; searchedAs shows the term used. Turn on translateTitles to read the titles in English.

Does it include Tmall? Yes. Tmall products appear in the same results; with the product page on, platform says tmall and url points to detail.tmall.com.

How do I get variants and stock? They are not on Taobao's public pages. For wholesale variants and MOQ, see the 1688 Scraper above.

Try it now

Click Start with the example input: 40 products for phone case and 40 for led strip cost about US$ 0.24. Need a field, a filter or another source? Open an issue in the Issues tab of this page; user requests decide what the next version adds.

Changelog

• 2026-10-22: deepScan: up to about 300 different products per search term (price bands and price orders), and minPrice/maxPrice applied by Taobao itself when it is on.

• 2026-10-13, 0.1.4: search Taobao in English: a term without its own Taobao page is translated to Chinese and searched again (searchedAs in each row); terms in Korean, Japanese, Spanish and other languages work too. New translateTitles adds titleEnglish to every product and textEnglish to the review sample, or another language with targetLanguage. No price change.

• 2026-10-09: input from other Taobao actors works as it is; new maxTotalItems, minPrice, maxPrice, freeShippingOnly and tmallOnly; product links inside the app's share text.

• 2026-10-08, 0.1: first version. Search terms in Chinese or English, categories, shops and product links; prices in CNY, HKD, TWD and an optional extra currency; optional summary product page with seller and review data; only new products and price tracking; free error rows.