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-08-04 — More accurate variants, new couponPrice Variants that were never purchasable (neighbouring products, dead promotional entries) no longer appear, and some products that previously returned a partial variant set now return all of it, so SKU counts can move in either direction — expect a one-off diff if you build on skus[]. Selling prices are corrected on a share of products. New couponPrice (券后价) at product and SKU level, and originalPrice is populated far more often. 变体更准确，新增券后价字段。

2026-07-18 — Major update Revamped for speed and reliability, with richer, more consistent product data. New fields per product: stock, sales and total-sold counts, per-variant swatch images (propsImages), a full property-option list (propsList), per-SKU price, original price and quantity, a Tmall flag, and a cleaner shop object. 全面升级：更快、更稳定，商品数据更丰富、更一致。

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, originalPrice and couponPrice (券后价, best-effort), stock, sales and totalSold, SKU matrix (per-SKU price, originalPrice, couponPrice, 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 (current selling price with any active promotion applied), originalPrice (pre-discount list price when the product is discounted), couponPrice (best-effort price after public shop and official promotions, at product and SKU level), hasDiscount/isPromotion 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": "40.34",
  "priceUSD": null,
  "originalPrice": "109.90",
  "couponPrice": "49.90",
  "suggestivePrice": null,
  "totalPrice": null,
  "isPromotion": true,
  "hasDiscount": true,
  "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",
      "couponPrice": "36.90",
      "quantity": 200,
      "propsIds": "1627207:42658520817",
      "propsNames": "1627207:42658520817:颜色分类:【到手3支】W1裸杏茶+W6红茶冻"
    },
    {
      "skuId": "5984981020695",
      "price": "40.34",
      "originalPrice": "109.90",
      "couponPrice": "36.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.

Do the discounted price and promotion info match Taobao? 优惠价格与优惠信息与淘宝一致吗？

price is the current selling price with any active shop promotion already applied, matching what a standard buyer sees on the product page. When a product is discounted, originalPrice and hasDiscount give the pre-discount list price, and every SKU carries its own price and originalPrice.

couponPrice (券后价) is the price after public promotions that any buyer receives: 满减, 满折, 官方立减, 官方立折, shop coupons, and product coupons. It is returned at product level and per SKU.

It is a best-effort field. An empty couponPrice means no public promotion was detected for that product, which is not the same as the product having none. Detection is strongest on shop coupons and 立减 promotions and weakest on threshold promotions (满减) in high-value categories such as electronics. Treat a present value as reliable and an absent one as unknown.

Prices that depend on your own account are never included, because they differ per buyer: 88VIP, 百亿补贴, 淘金币 balances, and platform subsidy (平台加补) pricing. A price lower than ours on your own screen usually means one of those applied to your account.

price 为商品当前实际售卖价（已包含店铺促销/活动价），与普通用户在商品页看到的价格一致。商品有折扣时，originalPrice 与 hasDiscount 提供折扣前原价，每个 SKU 也带有各自的 price 与 originalPrice。依赖账号的个性化价格（领券后的券后价、88VIP 价、百亿补贴价）与账号及时段相关，不包含在内。

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

✈️ Travel & stays

• Ctrip 携程
  • Ctrip Hotel Prices Scraper
  • Ctrip Hotel Reviews 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.