Taobao 淘宝 Product Detail Scraper - SKUs, Prices, Reviews (2026)

Extract Taobao (淘宝) and Tmall (天猫) product detail rows from URLs or item IDs with SKUs, prices, attributes, optional reviews, images, videos, shop data, and category metadata - one row per product in clean structured JSON.

2026-07-18 — Major update Revamped for speed and reliability, with richer, more consistent product data. 全面升级：更快、更稳定，商品数据更丰富、更一致。

Copy to your AI assistant

zen-studio/taobao-detail-scraper on Apify. Extracts Taobao and Tmall product details from up to 1,000 product URLs or numeric item IDs and returns one dataset row per successful product with itemId, input, resolvedUrl, url, title, titleOriginal, isTmall, CNY price and originalPrice, stock, sales and totalSold, SKU matrix (per-SKU price, originalPrice, quantity, propsIds, propsNames), attributes, propsList, propsImages (per-variant swatch images), shop object (shopId, sellerId, shopName, shopUrl), mainPictureUrl, pictures, descriptionImages, descriptionHtml, video, categoryId, location, optional reviews, and scrape status fields. Call ApifyClient("TOKEN").actor("zen-studio/taobao-detail-scraper").call(run_input={"items":["https://item.taobao.com/item.htm?id=1003783113480"],"fetchReviews":true,"maxReviewsPerItem":20}), then client.dataset(run["defaultDatasetId"]).list_items().items. Required: items. Optional: fetchReviews, maxReviewsPerItem. PPE: detail row $9.99/1k, review $4.99/1k before Store discounts. Free tier: 10 lifetime runs, 1 product/run. Token: https://console.apify.com/account/integrations

Zen Studio China Scrapers   •  Taobao, JD.com, wholesale, and resale data
Taobao Detail ➤ You are here	Taobao Search ↗ Keyword products	1688 Products ↗ Wholesale data	JD.com ↗ 京东 prices + reviews	Goofish Search ↗ Resale listings

How to Extract Taobao Product Details

Paste direct product URLs, Tmall URLs, numeric item IDs, or short share and affiliate links that resolve to a product page. Add up to 1,000 inputs per run. Unsupported or expired links are skipped, and the run continues with the inputs that resolve.

Product URL

{
  "items": ["https://item.taobao.com/item.htm?id=1003783113480"]
}

Numeric item ID

{
  "items": ["1003783113480"]
}

Short share or affiliate link

{
  "items": ["https://s.click.taobao.com/t?e=..."]
}

Batch details

{
  "items": [
    "https://item.taobao.com/item.htm?id=1003783113480",
    "996313754846"
  ]
}

Details with buyer reviews

{
  "items": ["https://item.taobao.com/item.htm?id=1003783113480"],
  "fetchReviews": true,
  "maxReviewsPerItem": 20
}

Input Parameters

Parameter	Type	Default	Description
items	array	required	Up to 1,000 Taobao/Tmall product URLs, short share and affiliate links that resolve to product pages, or numeric item IDs. Test runs are capped at 5 products; free-tier runs are capped at 1 product (only the first URL/ID is processed).
fetchReviews	boolean	false	Attach customer reviews as a nested reviews array on each product row. Reviews are billed separately.
maxReviewsPerItem	integer	100	Maximum reviews to fetch per product when fetchReviews is enabled.

What Data Can You Extract from Taobao Details?

One dataset row represents one successfully fetched Taobao or Tmall product.

• Product identity: original input, input type, resolved URL, itemId, product URL, Chinese title, Tmall flag, scrape timestamp.
• Pricing and stock: CNY price and originalPrice, promotion/discount flags, available stock, sales, and totalSold counts.
• SKU matrix: per-SKU ID, CNY price and original price, quantity in stock, property IDs, and human-readable property names (color, spec, capacity, version).
• Attributes and variants: product attribute name/value pairs, a full propsList of every property option, and propsImages per-variant swatch images.
• Shop and media: shop object (shopId, sellerId, shopName, shopUrl), primary image, gallery pictures, descriptionImages, descriptionHtml, and product video when present.
• Optional customer reviews: buyer review text, dates, photos, videos, replies, append reviews, helpful counts, and anonymized user metadata when fetchReviews is enabled.
• Category and logistics: category ID, ship-from location, and shipping/fee fields when Taobao returns them.

Output Example

All top-level schema fields are shown. Large arrays are cropped to representative entries. titleOriginal mirrors title (the product's Chinese Taobao title). Fields Taobao does not expose for a given product are returned as null or empty.

{
  "input": "https://item.taobao.com/item.htm?id=996833066479",
  "inputType": "url",
  "resolvedUrl": "https://item.taobao.com/item.htm?id=996833066479",
  "itemId": "996833066479",
  "url": "https://item.taobao.com/item.htm?id=996833066479",
  "isTmall": true,
  "title": "木柯诗双头唇釉唇泥唇霜保湿滋润唇蜜唇釉显白口红学生唇油",
  "titleOriginal": "木柯诗双头唇釉唇泥唇霜保湿滋润唇蜜唇釉显白口红学生唇油",
  "priceCurrency": "CNY",
  "price": "35.20",
  "priceUSD": null,
  "originalPrice": "35.20",
  "suggestivePrice": "0.00",
  "totalPrice": "0.00",
  "isPromotion": false,
  "hasDiscount": false,
  "promoType": null,
  "brandName": "Mooekiss/木柯诗",
  "brandId": null,
  "categoryId": "50010807",
  "rootCategoryId": null,
  "categoryCrumbs": [],
  "stock": 3704,
  "minOrderQuantity": 0,
  "sales": 10000,
  "totalSold": null,
  "favCount": null,
  "fansCount": null,
  "skuCount": 19,
  "skus": [
    {
      "skuId": "5984981020694",
      "price": "40.34",
      "originalPrice": "109.90",
      "quantity": 200,
      "propsIds": "1627207:42658520817",
      "propsNames": "1627207:42658520817:颜色分类:【到手3支】W1裸杏茶+W6红茶冻"
    },
    {
      "skuId": "5984981020695",
      "price": "40.34",
      "originalPrice": "109.90",
      "quantity": 200,
      "propsIds": "1627207:42626898707",
      "propsNames": "1627207:42626898707:颜色分类:【到手3支】W4蔷薇粉+W6红茶冻"
    }
  ],
  "attributes": [
    {
      "name": "品牌",
      "value": "Mooekiss/木柯诗"
    },
    {
      "name": "品名",
      "value": "木柯诗双头唇釉PRO版1.5g+1.5g"
    },
    {
      "name": "化妆品备案编号/注册证号",
      "value": "浙G妆网备字2025016240"
    }
  ],
  "propsList": {
    "1627207:43428724243": "颜色分类:【到手3支】W1裸杏茶+W6红茶冻【粉蓝限定】",
    "1627207:44286083439": "颜色分类:【到手3支】W1裸杏茶+W4蔷薇粉【粉蓝限定】",
    "1627207:43428724244": "颜色分类:【到手3支】W1裸杏茶+W2芭乐桃【粉蓝限定】"
  },
  "propsImages": {
    "1627207:43428724243": "https://img.alicdn.com/imgextra/i3/2216372575469/O1CN011ZHdoK1qGrDalTxQE_!!2216372575469.png",
    "1627207:44286083439": "https://img.alicdn.com/imgextra/i3/2216372575469/O1CN01mknFmA1qGrEh28yGx_!!2216372575469.jpg"
  },
  "mainPictureUrl": "https://img.alicdn.com/imgextra/i2/2216372575469/O1CN01cpEPyF1qGrEfL2Z9y_!!4611686018427387117-2-item_pic.png",
  "pictures": [
    "https://img.alicdn.com/imgextra/i2/2216372575469/O1CN01cpEPyF1qGrEfL2Z9y_!!4611686018427387117-2-item_pic.png",
    "https://img.alicdn.com/imgextra/i4/2216372575469/O1CN013Ddpkq1qGrDVPMPEw_!!2216372575469.jpg"
  ],
  "descriptionImages": [
    "https://gw.alicdn.com/imgextra/i1/O1CN01vWMf4v25HVynQwwXa_!!6000000007501-2-tps-1240-450.png",
    "https://gtms01.alicdn.com/tps/i1/TB1AHXiGXXXXXXAXVXX.uTD.FXX-10-10.png"
  ],
  "video": {
    "url": "https://cloud.video.taobao.com/play/u/2216372575469/p/2/e/6/t/1/544747642461.mp4?appKey=38829"
  },
  "descriptionHtml": "<div style=\"width: 750.0px;height: auto;overflow: hidden;\"><div style=...",
  "shop": {
    "shopId": "390022360",
    "sellerId": "2216372575469",
    "shopName": "Mooekiss木柯诗旗舰店",
    "sellerNick": "Mooekiss木柯诗旗舰店",
    "shopUrl": "https://shop390022360.taobao.com/"
  },
  "location": "浙江金华",
  "postFee": null,
  "expressFee": null,
  "emsFee": null,
  "freight": null,
  "shippingTo": null,
  "itemWeight": null,
  "itemSize": null,
  "isVirtual": false,
  "createdTime": null,
  "modifiedTime": null,
  "delistTime": null,
  "reviews": [
    {
      "date": "2026年06月20日 10:12",
      "content": "颜色很正，滋润不拔干，回购了。",
      "rateId": 1309900112233,
      "photos": [],
      "video": null,
      "reply": null,
      "appendList": [],
      "useful": 3,
      "user": {
        "nick": "m***8",
        "vipLevel": 5,
        "anony": true,
        "rank": 5
      }
    }
  ],
  "_reviewsFetched": true,
  "_reviewsCount": 1,
  "scrapedAt": "2026-07-18T14:20:00Z",
  "_detailFetched": true
}

Pricing

This Actor uses pay-per-event pricing. You pay only for successfully fetched product detail rows and optional reviews. Apify Store discounts may lower these unit prices.

Output	Event	Base price
Product detail row	detail-result	$9.99 / 1,000 products
Customer review	review	$4.99 / 1,000 reviews

Store discount pricing:

Tier	Detail row / 1,000	Review / 1,000
No discount	$9.99	$4.99
Bronze	$8.99	$4.59
Silver	$8.79	$3.99
Gold	$7.99	$3.59

Free tier: 10 lifetime runs, 1 product per run.

Notes on Inputs

The Actor accepts direct Taobao/Tmall product URLs and numeric item IDs. Short share and affiliate links (for example s.click.taobao.com) are supported when they resolve to a product page. Unsupported links are skipped, and the run continues with the inputs that resolve.

FAQ

Can I use Chinese Taobao links?

Yes. Direct Taobao and Tmall product links work, including links whose titles and attributes are Chinese.

Can I pass only an item ID?

Yes. Numeric item IDs such as 1003783113480 are accepted.

Are search results included?

No. This Actor fetches detail rows for known products. Use Taobao Search Scraper when you need keyword discovery first.

Are reviews included by default?

No. Enable fetchReviews when you need buyer review text. Reviews are billed separately.

What currency are prices in?

Prices are returned in Chinese yuan (CNY) as decimal strings, for example "3019.00", at both the product level (price, originalPrice) and per SKU. The priceUSD field is reserved for a converted value and is currently null.

Why do some optional fields return null or empty arrays?

Taobao does not expose every field for every product. Empty top-level fields remain stable in the dataset schema, but the README example uses a populated real fixture and trims arrays only for readability.

How does the free tier work?

Free-tier users get 10 lifetime runs, capped at 1 product per run (only the first URL/ID is processed).

More Zen Studio scrapers for Chinese platforms

🛒 E-commerce

• Shopee
  • Shopee Product Detail Scraper
  • Shopee Product Reviews Scraper
  • Shopee Product Scraper
• Taobao 淘宝
  • Taobao Search Scraper
  • Taobao Seller Products Scraper
• JD.com 京东
  • JD.com Search Scraper
• 1688 阿里巴巴
  • 1688 Wholesale Scraper
  • Alibaba Scraper
  • 1688 Reviews Scraper
• Goofish 闲鱼
  • Goofish (Xianyu) Search Scraper
  • Goofish (Xianyu) Seller Scraper
  • Goofish (Xianyu) Item Detail Scraper
  • Goofish (Xianyu) Item Comments & Q&A Scraper
  • Goofish (Xianyu) Reverse Image Search Scraper
• Coupang 쿠팡
  • Coupang Review Scraper
  • Coupang Search Scraper
  • Coupang Product Detail Scraper

🎬 Short-video & social

• Douyin 抖音
  • Douyin Search Scraper
  • Douyin Profile Scraper
  • Douyin Video Scraper
  • Douyin Comments Scraper
  • Douyin Transcripts Scraper
  • Douyin Creator Rankings Scraper
  • Douyin Live Recorder
  • Douyin Hot Search Scraper
  • Douyin Product Search Scraper
• RedNote 小红书
  • RedNote User Profile Scraper
  • RedNote Search Scraper
  • RedNote Comments Scraper
  • RedNote Product Search Scraper
  • RedNote Note Detail Scraper
  • RedNote Product Reviews Scraper
  • RedNote Live Recorder
• Xigua 西瓜视频
  • Xigua Video Search Scraper
  • Xigua Video Detail Scraper
• Bilibili 哔哩哔哩
  • Bilibili Video Scraper
  • Bilibili Danmaku Scraper

🏠 Real estate & autos

• Anjuke 安居客
  • Anjuke For-Sale Listings Scraper
  • Anjuke New-Home Scraper
  • Anjuke Rental Listings Scraper
  • Anjuke Listing Detail Scraper
• 58.com 58同城
  • 58.com Real Estate Scraper
• Autohome 汽车之家
  • Autohome (Che168) Used-Car Scraper

Support

Open an issue on the Actor page if a product URL consistently fails, if a field changes type, or if a supported product returns incomplete data.

For reproducible support, include the input JSON and the run ID.