Taobao & Tmall Product Scraper

Scrapes Taobao and Tmall products — by keyword, category, shop or item URL. Pure HTTP: no browser, no login, no proxy.

What you get

One record per product:

{
  "recordType": "product",
  "itemId": 559660567175,
  "itemUrl": "https://world.taobao.com/item/M0tXcXBYZWZjc3NaaFpRdUVTMTBGQT09.htm",
  "title": "綠聯3.5英寸硬碟外接盒 支援24TB SATA固態硬碟讀取器",
  "itemType": "tmall",
  "priceCurrency": "CNY",
  "priceOriginal": 119.9,
  "pricePromotion": 119.9,
  "categoryId": 50003213,
  "rootCategoryId": 11,
  "breadcrumb": [{"name": "硬碟盒", "url": "https://world.taobao.com/category/53996073.htm"}],
  "images": ["https://img.alicdn.com/imgextra/..."],
  "location": "廣東東莞",
  "freeShipping": true,
  "shopId": 67095450,
  "shopName": "綠聯數碼旗艦店",
  "shopSince": "2011-05-30 14:37:22",
  "sellerItemCount": 1320,
  "dsr": {"post": 4.9, "serv": 4.8, "desc": 4.8},
  "reviewCount": 1,
  "sampleReviews": [{"content": "硬碟盒不錯，適合兩種尺寸sata硬碟。", "score": 5, "date": "2026.08.15 15:17", "sku": "顏色分類:USB繁星款★5Gbps★"}],
  "keywords": ["綠聯3.5英寸硬碟外接盒", "SATA固態硬碟讀取器"]
}

Products found through a keyword, category or shop but not opened in detail come back as "recordType": "listing" records, with the same identifiers plus priceHKD, priceTWD, reviewTags (review tag names with counts) and sellPoints. Set Fetch full details to upgrade them to complete product records.

Input

Field	Description
itemUrls	Item URLs, numeric IDs or SEO tokens — returns the full product record
keywords	Search terms, e.g. phone case, 手機殼
categoryIds	Category IDs or URLs, e.g. 11
shopIds	Shop IDs or URLs — returns the shop profile plus its catalogue
fetchDetails	Open every listed product for the complete record
maxItemsPerSource	Cap per keyword, category or shop (default 60)
locale	Storefront locale for localised prices, e.g. en-us

Run it with no input at all and it returns a small default sample, so you can see the shape of the data before configuring anything.

What it does not do

• No SKU matrix. Colour/size variants and their individual stock and prices are not on these pages.
• No sales counts. Taobao does not publish units sold on the catalogue pages this actor reads.
• No pagination and no custom ranking. Keyword and category pages return one page of products in Taobao's own order (shops return up to 60). Taobao serves a ranking it will not let a scraper re-sort, so results always come in the catalogue's default order — use several keywords for broader coverage.
• One review sample per product. The catalogue exposes a single recent review, not the full review history.
• Prices are exactly as published. Some sellers put a placeholder price in the millions on an item they would rather quote privately — Taobao shows that number on the public page, and so does this actor, rather than guessing which prices are real.
• Public catalogue only. Items not listed in the public catalogue have no page to read and are skipped with a note in the log.

Output

All records land in the run's default dataset, ready to export as JSON, CSV or Excel.