Taobao & Tmall Scraper - $1.50 / 1000 Products

Taobao & Tmall Scraper

Scrape Taobao and Tmall products as clean, structured JSON - search by keyword (Chinese or English) or category, or read item pages by the catalogue key every search result carries. Every product comes with its title, price in yuan plus local prices (SGD, HKD, TWD), shop, Taobao's price tag and its catalogue key (itemKey). Item pages add the ship-from location, category path, buyer rating split, the latest review, and the shop's service scores, credit level and opening date. Taobao and Tmall items both work. No Taobao account, cookies or proxies to set up.

Features

• Keyword search - the first page Taobao shows for a keyword (up to 20 products), in Taobao's order (position), sorted by relevance, best selling or price.
• Price filter - a minimum and maximum price in yuan.
• Categories - the top 20 best sellers of any Taobao category, by id or link.
• Item pages - by the catalogue key (itemKey) or catalogue link (catalogueUrl) that every search and category product carries. Taobao's public catalogue opens items only by this key, so numeric item ids and item.taobao.com / detail.tmall.com links usually fail now (failed inputs are not billed).
• Prices you can compute with - price as a number in CNY, with localPrices in SGD, HKD and TWD.
• Shop quality - shop name and id, and on item pages the shop's description, service and delivery scores, credit level, seller type and opening date.
• Buyer feedback - on item pages the positive / neutral / negative split with counts, and the latest review (stars, text, date, variant bought, whether it has photos or videos, and the buyer's follow-ups). No reviewer names, photos or videos are returned.
• Keyword fallback - when Taobao has no results page for a keyword, the closest keyword Taobao itself suggests is used, and the items say so (keywordSubstituted, matchedKeyword, notice).
• Deduplicated inputs - the same keyword, category or item given twice is fetched and billed once.

Use cases

• Sourcing and dropshipping - find products and check a shop's scores, credit level and age before ordering.
• Price research - compare prices across keywords and categories, in yuan and local currencies.
• Price monitoring - track the price of a list of Taobao and Tmall items (their itemKeys from a search) on a schedule.
• Best-seller tracking - follow the top products of a category or keyword over time.
• Market analysis - listing counts per keyword and category, price ranges, Tmall vs Taobao shops.

Input

Give any mix of searches, categories and product keys or catalogue links.

Field	Type	Default	Description
searches	array	-	Keywords, in Chinese or English (one search each, up to 20 products).
categories	array	-	Taobao category ids or category links (top 20 best sellers each).
productUrls	array	-	Catalogue keys (itemKey) or catalogue links (catalogueUrl) from a search or category (one item page each).
sort	string	relevance	Order of keyword searches: relevance, sales, price_asc, price_desc.
priceMin	integer	-	Keyword searches only: minimum price in yuan.
priceMax	integer	-	Keyword searches only: maximum price in yuan.
concurrency	integer	3	Inputs fetched at the same time (1-5).

With no input at all, the actor searches the example keyword 手机壳 (phone case).

Example input

{
  "searches": ["蓝牙耳机", "phone case"],
  "categories": ["50005050"],
  "productUrls": [
    "M3hoaXBUL3N4L2VnVUJncG9JWFphZz09",
    "https://www.taobao.com/list/item/RjRZL1NqR2pVTkxHOTFNTUIvZU8wZz09.htm"
  ],
  "sort": "sales",
  "priceMin": 100,
  "priceMax": 300
}

Output

One dataset item per product. From a search (source: "search") or a category (source: "category", with category instead of query):

{
  "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.53},
    {"currency": "HKD", "price": 137.73},
    {"currency": "TWD", "price": 572.08}
  ],
  "shopId": "72104903",
  "shopName": "图拉斯数码旗舰店",
  "descriptionMatchScore": 4.76,
  "freeShipping": false,
  "areaLimit": false,
  "categoryId": "150704",
  "rootCategoryId": "50008090",
  "sellingPoints": [],
  "reviewHighlights": [],
  "source": "search",
  "sort": "relevance",
  "totalResults": 32036,
  "query": "手机壳"
}

When Taobao has no results page for a keyword, its items carry the substitute:

{
  "query": "防水运动蓝牙耳机跑步专用挂耳式",
  "keywordSubstituted": true,
  "matchedKeyword": "运动防水蓝牙耳机",
  "notice": "Taobao has no list for '防水运动蓝牙耳机跑步专用挂耳式'; these are the results for its suggested keyword '运动防水蓝牙耳机'."
}

From a product key or catalogue link (source: "product", shortened):

{
  "itemId": "765833709683",
  "itemKey": "M3hoaXBUL3N4L2VnVUJncG9JWFphZz09",
  "url": "https://item.taobao.com/item.htm?id=765833709683",
  "catalogueUrl": "https://www.taobao.com/list/item/M3hoaXBUL3N4L2VnVUJncG9JWFphZz09.htm",
  "platform": "taobao",
  "title": "真无线蓝牙5.5耳机 ANC主动降噪高音质 2025新款五代顶配 杜比环绕音效 超长续航IPX5防水",
  "titleTruncated": false,
  "price": 388.0,
  "priceMax": null,
  "originalPrice": 388.0,
  "currency": "CNY",
  "hasPriceRange": false,
  "priceNote": "价格可能因优惠活动发生变化",
  "image": "https://img.alicdn.com/imgextra/i3/2523443838/O1CN01QULkBg1eDrFVYcid7_!!2523443838.jpg",
  "location": "广东深圳",
  "categoryId": "50005050",
  "categoryPath": ["影音视听", "耳机耳放", "耳机"],
  "freeShipping": false,
  "paymentMethods": ["蚂蚁花呗", "集分宝", "支付宝支付"],
  "rating": {
    "positivePercent": 99,
    "neutralPercent": 1,
    "negativePercent": 0,
    "positiveCount": 70000,
    "positiveCountText": "7万+",
    "negativeCount": 500,
    "negativeCountText": "500+"
  },
  "latestReview": {
    "rating": 5,
    "content": "拿到手试了下这款华强北Pro3代蓝牙耳机，连接OPPO手机秒连，音质日常听完全够用，戴着跑步也不会掉，这个价位能买到这品质真的很惊喜👍，商家回复问题也很耐心，挺满意的一次网购体验😋，凑个图发评价还能领淘金币，太值啦✨",
    "date": "2026-10-29T00:33:00Z",
    "variant": "颜色分类:【顺丰包邮】全天发货★即拍即发★到货快人一步",
    "hasMedia": false,
    "followUps": [
      {
        "content": "这款华强北Pro3代蓝牙耳机用了快一周，体验比我之前预期的好太多👍 顺丰寄来速度很快，降噪效果日常通勤够用，连我的OPPO手机秒连不卡顿，戴着逛一下午耳朵也不疼，这个价位能买到这个品质真的很惊喜，性价比拉满，推荐给想入平价耳机的朋友😊",
        "daysAfterReview": 0
      }
    ]
  },
  "shop": {
    "shopId": "467290190",
    "name": "深圳华强北正品直销总店",
    "url": "https://shop467290190.taobao.com",
    "sellerType": "C",
    "creditLevel": 17,
    "openedAt": "2019-08-05T16:41:09Z",
    "itemCount": 20,
    "newItemCount": 1,
    "scores": {"delivery": 4.8, "service": 4.8, "description": 4.7}
  },
  "shopId": "467290190",
  "shopName": "深圳华强北正品直销总店",
  "source": "product",
  "input": "M3hoaXBUL3N4L2VnVUJncG9JWFphZz09"
}

Item pages also carry images, rootCategoryId, areaLimit, sellableLanguages and the shop's logo. A review's hasMedia says whether the buyer added photos or videos (their links are not returned), and followUps are the buyer's later comments. sellerType is B for Tmall stores and C for Taobao stores. Dates are ISO 8601 in UTC.

Searches, categories and product keys or links that return nothing or cannot be read go to the ERRORS record in the run's key-value store, with the reason (for example an item Taobao no longer shows, a numeric item id Taobao's catalogue does not open, or a keyword with no results page and no usable suggestion). They are not billed.

Pricing

$1.50 per 1000 products (pay per result) - one dataset item is one product, from a search, a category or a product key. A product key or link is read from its own item page, so each product from productUrls also counts one product-details event at $1.50 per 1000 (a product page costs $3 per 1000 in total). Failed inputs are free.

Notes

• A keyword search returns one page of up to 20 products: that is all Taobao shows visitors who are not logged in. For more products, split a search into narrower keywords or price bands, or add the matching categories.
• The price filter keeps only products whose listed price is in the range, so a search may return fewer than 20.
• Variants (SKUs), stock and monthly sales need a Taobao login and are not included.
• Tmall item pages show a shortened title (titleTruncated) and no rating split; search results always carry the full title.
• Prices are those Taobao shows; coupons and app-only discounts are not applied.
• Titles, labels and reviews come in Chinese as sellers and buyers write them.
• Taobao share links (e.tb.cn, m.tb.cn) open only in the Taobao app; use the item's catalogue key or link from a search instead.
• Powered by ScrapeUnblocker.