Taobao Scraper

Search Taobao in English: terms are translated to Chinese for you, titles come back in English.

Taobao Scraper turns Taobao and Tmall products into clean JSON, CSV or Excel, without login, cookies or a Taobao account. Search in English, Chinese or any language (a term without its own Taobao page is translated to Chinese and searched again), read categories and shops, or paste product links, and get each product's title, price in CNY (plus HKD and TWD, or any currency you pick), promotion label, shop, shop score, category ids and images. Turn on the product page to add seller type, credit level, shop age, the three shop scores, review positive rate and a review sample.

US$ 3.00 per 1,000 products. No monthly fee, no start fee. Error rows are free.

At a glance

• 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)
• 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.
• Live data, every run, read from Taobao at run time, never from a cache.
• 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.
• Results in the dataset, in JSON, CSV or Excel, not hidden in a key-value store record.
• 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, sortBy and deep-scan options are accepted and ignored (public pages 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).

What you can do with it

• 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).

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
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" }

How English search works. Taobao has a public search page for almost every Chinese term but only for common English ones. The Actor opens the page of your term as written and, when there is none, translates it to Chinese and searches again; searchedAs shows the term used.

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

Pricing

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 and Taobao's sort options need a logged-in account, so they are not available. For more products, 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.
• The Actor uses Apify's datacenter proxy and, when Taobao refuses it, a residential IP in Singapore or Hong Kong for that request. 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.

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.

Changelog

• 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.