All scrapers

E-commerce

Taobao & Tmall Scraper

taobao.com

93.5% Success rate
3.8s Avg response
Bot detection + rate limiting Protection
1,018 calls Measured over

Taobao and Tmall, Alibaba Group's consumer marketplaces in China, are served through two dedicated plugin endpoints rather than the generic page fetch. Give the search endpoint a keyword - in Chinese for the most listings, like '手机壳', or in English - or a category id, and it returns the products Taobao lists for it, already parsed: item id and catalogue key, title, link and image, the price in yuan with Taobao's price tag (such as a discount price) and the same price in local currencies, the shop id and name, the shop's description score, free shipping, the category ids, selling points and review highlights, plus Taobao's count of matching listings and the brand and property filters you can apply next. Sort by relevance, sales or price, filter by a price range in yuan or by one brand or property, and get up to 20 products per keyword. A keyword Taobao has no public list for is answered with the list of the closest keyword Taobao itself suggests, and the response says so. The item endpoint takes the catalogue key each search result carries (itemKey), or the item's catalogue link, and returns the item: the platform (Taobao or Tmall), title, price, original price and price range in yuan, image, ship-from location, category path, free shipping, payment methods, the buyer rating split (Taobao items only, Tmall does not publish it), the latest review with stars, text, date, variant and media but no reviewer identity, and the shop with its seller type, credit level, opening date, number of items and description, service and delivery scores. It reads the catalogue Taobao publishes for signed-out visitors, so no Taobao login is involved, and SKUs, stock and monthly sales, which Taobao shows only after a login, are not included. Text comes back in Chinese, as sellers write it.

What you can extract

  • Item id and catalogue key (itemKey), title, link and catalogue link, image and position in the list
  • Price in yuan (CNY) with Taobao's price tag, and local prices in SGD, HKD and TWD
  • Shop id and name, description match score, free shipping, category ids, selling points and review highlights
  • Taobao's count of matching listings, and brand and property filters for the next search
  • Search by keyword in Chinese or English, or by category, sorted by relevance, sales or price and filtered by a price range in yuan or one brand or property; up to 20 products per keyword
  • Item: platform (Taobao or Tmall), price, original price and price range, image, ship-from location, category path, free shipping and payment methods
  • Item: buyer rating split (Taobao items) and the latest review with stars, text, date, variant and media (no reviewer identity)
  • Item: shop name, link, logo, seller type, credit level, opening date, number of items and description, service and delivery scores

Dedicated endpoints

/marketplace/taobao-search

A keyword or category list on Taobao

The products Taobao lists for a keyword (q, in Chinese or English, or a Taobao search link) or a category (category: an id or a category list link): a products array with position, itemId, itemKey (the item's catalogue key, which the item endpoint takes as item_id), title, url, catalogueUrl (the item's public catalogue page), image, price (yuan), currency, priceLabel, localPrices (the same price in the storefront's currency, HKD and TWD), shopId, shopName, descriptionMatchScore, freeShipping, categoryId, rootCategoryId, sellingPoints and reviewHighlights, plus totalResults, filterOptions (brand and property facets; pass an option's filter value back as filter), matchedKeyword and keywordSubstituted. sort is relevance, sales, price_asc or price_desc, and price_min and price_max (yuan) and filter narrow a keyword search; a category returns its best sellers. Up to 20 products per call.

/marketplace/taobao-product

One Taobao or Tmall item

One item by item_id, the itemKey that taobao-search returns for every product, or by url, the item's catalogue link (catalogueUrl, or the world.taobao.com item link with the same key): itemId, itemKey, url, catalogueUrl, platform (taobao or tmall), title (titleTruncated when Taobao shortens it, as it does for Tmall items), price, originalPrice and priceMax (for a price range) in yuan, image, location (ships from), categoryId, rootCategoryId, categoryPath, freeShipping, paymentMethods, sellableLanguages, rating (positive, neutral and negative split and counts; Taobao items only), latestReview (rating, content, date, variant, hasMedia and followUps; no reviewer identity) and shop (shopId, name, url, logo, sellerType B = Tmall or C = Taobao, creditLevel, openedAt, itemCount and scores for description, service and delivery). Taobao's public catalogue opens items only by that key, so a numeric item id or an item.taobao.com or detail.tmall.com link usually answers 404. A 404, like an item with no public page, is not billed.

How to scrape it

curl -X POST \
  -H "X-ScrapeUnblocker-Key: $SU_API_KEY" \
  "https://api.scrapeunblocker.com/marketplace/taobao-search?q=%E6%89%8B%E6%9C%BA%E5%A3%B3&sort=sales"
import requests

resp = requests.post(
    "https://api.scrapeunblocker.com/marketplace/taobao-search",
    headers={"X-ScrapeUnblocker-Key": SU_API_KEY},
    params={"q": "手机壳", "sort": "sales"},
)
print(resp.text)
import { ScrapeUnblockerClient } from 'scrapeunblocker';

const su = new ScrapeUnblockerClient({ apiKey: process.env.SU_API_KEY });

const results = await su.taobaoSearch('手机壳', {
  sort: 'sales',
});
const item = await su.taobaoProduct('M3hoaXBUL3N4L2VnVUJncG9JWFphZz09');
console.log(results);
console.log(item);

Requests are POST and take their parameters in the query string. Browser rendering always happens - there is no flag to enable.

Example response

{
  "query": { "q": "手机壳", "category": null, "sort": "sales", "priceMin": null, "priceMax": null, "filter": null },
  "matchedKeyword": "手机壳",
  "keywordSubstituted": false,
  "source": "sg.world.taobao.com",
  "sort": "sales",
  "currency": "CNY",
  "localCurrency": "SGD",
  "totalResults": 59366,
  "resultsCollected": 20,
  "products": [
    {
      "position": 1,
      "itemId": "1078907312106",
      "itemKey": "SnA2dmxGcWpIZXRWLzJoZ0tCQjdXQT09",
      "title": "【新款18勃艮第红色】图拉斯雪雾适用iPhone18ProMax手机壳苹果17磁吸外壳16pm高级磨砂15Pro保护套14P全包13",
      "url": "https://item.taobao.com/item.htm?id=1078907312106",
      "catalogueUrl": "https://www.taobao.com/list/item/SnA2dmxGcWpIZXRWLzJoZ0tCQjdXQT09.htm",
      "image": "https://img.alicdn.com/imgextra/O1CN01MD26uLjX8UC1chua_!!6000000000818-2-yinhe.png",
      "price": 116.0,
      "currency": "CNY",
      "priceLabel": "优惠价",
      "localPrices": [
        { "currency": "SGD", "price": 22.56 },
        { "currency": "HKD", "price": 137.78 },
        { "currency": "TWD", "price": 580.38 }
      ],
      "shopId": "72104903",
      "shopName": "图拉斯数码旗舰店",
      "descriptionMatchScore": 4.76,
      "freeShipping": false,
      "areaLimit": false,
      "categoryId": "150704",
      "rootCategoryId": "50008090",
      "sellingPoints": [],
      "reviewHighlights": []
    },
    {
      "position": 2,
      "itemId": "582890145005",
      "itemKey": "SmFWQlNHc2lpUGEzZHVBTlJ6eS9RQT09",
      "title": "绿联适用苹果iPhone18ProMax气囊柔盾17手机壳防摔16Pro透明保护套全包+15镜头14超薄13软壳散热高级12xr11",
      "url": "https://item.taobao.com/item.htm?id=582890145005",
      "catalogueUrl": "https://www.taobao.com/list/item/SmFWQlNHc2lpUGEzZHVBTlJ6eS9RQT09.htm",
      "image": "https://img.alicdn.com/imgextra/O1CN01H6TunABXd6C1chua_!!6000000000337-2-yinhe.png",
      "price": 29.9,
      "currency": "CNY",
      "priceLabel": "热销款",
      "localPrices": [
        { "currency": "SGD", "price": 5.82 },
        { "currency": "HKD", "price": 35.52 },
        { "currency": "TWD", "price": 149.6 }
      ],
      "shopId": "67095450",
      "shopName": "绿联数码旗舰店",
      "descriptionMatchScore": 4.87,
      "freeShipping": false,
      "areaLimit": false,
      "categoryId": "150704",
      "rootCategoryId": "50008090",
      "sellingPoints": [ "全面防护 双C大气囊防摔", "军工级认证 升级气囊防摔" ],
      "reviewHighlights": []
    }
  ],
  "filterOptions": [
    {
      "name": "品牌",
      "propertyId": "20000",
      "options": [
        { "name": "ISIDO/艾思度", "filter": "20000-127298092", "count": 92 },
        { "name": "TORRAS/图拉斯", "filter": "20000-16374678", "count": 101 },
        { "name": "X-IT", "filter": "20000-26061730", "count": 6 }
      ]
    }
  ]
}

Read the API docs

Frequently asked questions

Is it legal to scrape Taobao?

Collecting publicly available Taobao and Tmall data such as item titles, prices, shop names and ratings is lawful in many jurisdictions, but the rules depend on your country, the data you collect and how you use it. Reviews come back without the reviewer's identity. ScrapeUnblocker returns the public catalogue; what you collect and how you use it is your responsibility.

How do I scrape Taobao without getting blocked?

Taobao's item pages, search page and data APIs all ask for a login, and an address Taobao does not trust gets its interstitial - a slider or a login prompt - as a normal 200, so a plain scraper stores the interstitial as if it were data. The plugins read the catalogue Taobao publishes for signed-out visitors, with a browser-free session on ISP exits outside mainland China and Europe, where Taobao serves that catalogue; when Taobao answers with the interstitial, they move to a fresh exit a bounded number of times and then answer 502 rather than return it. In ScrapeUnblocker's benchmark it returned real data on 93.5% of 1,018 calls, about 3.8s per call. Chinese keywords returned products on 99.4% of calls; English keywords only when Taobao has a public list for them (58% of the English ones), so search in Chinese where you can.

What Taobao data can I get?

The search endpoint returns, for each product, the item id, title, link and image, the price in yuan with Taobao's price tag, the same price in local currencies, the shop id and name, the shop's description match score, free shipping, the category ids, selling points and review highlights, plus Taobao's count of matching listings and the brand and property filters you can use next. The item endpoint returns the platform (Taobao or Tmall), title, price, original price and price range, image, ship-from location, category path, free shipping, payment methods, the buyer rating split for Taobao items, the latest review with stars, text, date, variant and media, and the shop with its seller type, credit level, opening date, number of items and description, service and delivery scores.

Why are SKUs, stock and monthly sales missing?

Taobao shows them only to signed-in visitors. The plugins read the catalogue Taobao publishes for signed-out visitors and use no Taobao account, so variants (SKUs), stock and monthly sales are not included. Tmall items appear there with a shortened title, and come back with titleTruncated: true.

How many products can I get per search?

Up to 20 per keyword or category: Taobao shows signed-out visitors only the first 20 products of a list. To reach more listings for a keyword, split it with price ranges (price_min, price_max) or with the brand and property filters in filterOptions, and change the sort order; totalResults shows how many listings Taobao reports. When Taobao has no public list for a keyword, the call returns the list of the closest keyword Taobao itself suggests, with keywordSubstituted: true and the keyword used in matchedKeyword.

Can I search Taobao in English?

Yes, q takes English as well as Chinese, but Chinese keywords match far more listings, because Taobao sellers write their titles in Chinese. Titles and text come back as sellers write them, in Chinese. A Taobao search link also works as q.

How much does it cost to scrape Taobao?

Every call that returns data is one request: a list of up to 20 products or one item. 1 request = 1 credit, EUR 1.00 per 1,000 on pay as you go, down to about EUR 0.55 per 1,000 on the Ultimate plan. Keywords and items Taobao has no public page for (404), blocks and timeouts are not billed, and the free trial includes 500 requests with no card.

Related scrapers

Taobao & Tmall and other names and marks of taobao.com belong to their owner and are used here only to identify the website this API works with. ScrapeUnblocker is an independent service, not affiliated with, endorsed by or sponsored by the owner of taobao.com.

Start scraping this site today

Free tier included. No credit card required to test it.