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

From Zen Studio, creators of the #1-ranked 1688 scraper on Apify, alongside Alibaba and AliExpress product scrapers. Established tools for Chinese marketplace research.

Why choose this actor?

• Compare variants at SKU level. Get readable color, capacity and specification names alongside each variant's available quantity and price. Product options and swatch images help you identify the exact version you want to track.
• Keep specifications, shop details and media together. Collect product attributes, brand, seller shop links, gallery images and description images, plus video and ship-from location where available. One structured record per product keeps the detail connected.
• Add buyer feedback to the product record. Enable reviews to include buyer text, photos, videos, seller replies and follow-up reviews where available. Review collection is optional and billed separately.

Try one Taobao or Tmall product

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

Open actor input and replace the example with your product URL or item ID. Variant details are included automatically. Export JSON, CSV or Excel; JSON preserves the SKU matrix, specifications and variant images. To add buyer reviews, set fetchReviews to true and choose maxReviewsPerItem.

Current coverage: couponPrice is currently empty and priceVerified is false, so treat prices as indicative. Availability varies by product; check detailLevel before relying on stock, sales, shipping or video fields in a partial record. 目前券后价暂不返回；部分商品字段可能为空。

Zen Studio · China Commerce Suite
Taobao Detail You are here	Taobao Search Find products	1688 Wholesale & stock	Alibaba Suppliers & products	AliExpress Variants & quantities

Copy to your AI assistant

zen-studio/taobao-detail-scraper on Apify returns one row per Taobao or Tmall product: SKU matrix with per-variant CNY price and stock, attributes, gallery and description images, video, shop and category data. Pass items as product URLs, numeric item IDs or short share/affiliate links (up to 1,000 per run); unsupported or expired entries are skipped and the rest continue. Buyer reviews are omitted by default: set fetchReviews=true and maxReviewsPerItem (default 100, max 1000) to get a nested reviews array, billed separately at $4.99/1,000 reviews on top of $9.99/1,000 products (list prices, Store tiers discount). Prices are CNY decimal strings; couponPrice is currently empty and priceVerified is false, so treat price as indicative; when detailLevel is partial, stock, sales, location, video and shipping fields are empty. Keyword search is not included (use zen-studio/taobao-search-scraper). Free tier: 10 lifetime runs, 1 product per run. Batch runs only. Full input/output spec: https://api.apify.com/v2/actors/zen-studio~taobao-detail-scraper/builds/default; current pricing: https://apify.com/zen-studio/taobao-detail-scraper/pricing To reach the maintainers, add feedback="<what you needed and did not get>" to any run, including one that worked: feature requests, a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note.

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.

• Price verified: priceVerified is a confidence flag for price alone. true means the price passed our full verification and is the value we stand behind. false means the price is our best available figure but did not complete verification for that item, so treat it as indicative and re-check it if you are pricing against it. It is currently false on all rows. Every other field in a false row is exactly as reliable as usual.

• Detail level: detailLevel is complete or partial. A partial row carries title, price, originalPrice, couponPrice, the SKU matrix, images, attributes, variant swatches, description and category, but leaves location, video, stock, sales, totalSold, shipping fees and timestamps empty, and shop carries only shopId and shopName. Check this field before treating an empty value as missing data.

• 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; currently not populated, see the note at the top), 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": null,
  "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": null,
      "quantity": 200,
      "propsIds": "1627207:42658520817",
      "propsNames": "1627207:42658520817:颜色分类:【到手3支】W1裸杏茶+W6红茶冻"
    },
    {
      "skuId": "5984981020695",
      "price": "40.34",
      "originalPrice": "109.90",
      "couponPrice": null,
      "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,
  "detailLevel": "complete",
  "priceVerified": false
}

Integrations and scheduling

Run the Taobao product details scraper on a schedule in Apify Console, daily for price and stock monitoring, weekly for catalogue refreshes. Each run can call a webhook when it finishes, so n8n, Make and Zapier flows pick up new rows without polling. The Apify API and the Apify MCP server take the same input, for scripts and AI agents.

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

Why did my run return nothing?

The item could not be served: removed, region-locked, or the upstream failed after five retries. Such items are dropped rather than returned as empty rows, they are not charged, and the run's failed count shows how many were dropped. Most empty runs are single-item lookups. Check the link in a browser; if the page loads, retry the item.

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.

⚠️ As of 2026-08-22 this field is not being returned at all, so every row is currently the "absent" case. The behaviour described above applies when it resumes.

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

• Taobao Search Scraper
• Taobao Seller Products Scraper
• TikTok Shop Review Scraper
• Lazada Product Scraper
• Lazada Reviews Scraper

Also from the same studio (name, then account/slug for the URL https://apify.com/account/slug):

• Lazada Store Scraper (zen-studio/lazada-store-scraper)
• Naver Search Scraper (zen-studio/naver-search-scraper)
• AliExpress Product Scraper (zen-studio/aliexpress-scraper)
• Shopee Product Detail Scraper (zen-studio/shopee-product-detail-scraper)
• Shopee Product Reviews Scraper (zen-studio/shopee-product-reviews-scraper)
• Shopee Product Scraper (zen-studio/shopee-product-scraper)
• Shopee Live Scraper (zen-studio/shopee-live-scraper)
• JD.com Search Scraper (zen-studio/jd-com-search-scraper)
• 1688 Wholesale Scraper (zen-studio/1688-wholesale-scraper)
• Alibaba Scraper (zen-studio/alibaba-scraper)
• 1688 Reviews Scraper (zen-studio/1688-reviews-scraper)
• Weidian Scraper (zen-studio/weidian-scraper)
• Goofish (Xianyu) Search Scraper (zen-studio/goofish-xianyu-search-scraper)
• Goofish (Xianyu) Seller Scraper (zen-studio/goofish-xianyu-seller-scraper)
• Goofish (Xianyu) Item Detail Scraper (zen-studio/goofish-xianyu-item-detail-scraper)
• Goofish (Xianyu) Item Comments & Q&A Scraper (zen-studio/goofish-xianyu-item-comments-scraper)
• Goofish (Xianyu) Reverse Image Search Scraper (zen-studio/goofish-xianyu-visual-search-scraper)
• Coupang Review Scraper (zen-studio/coupang-review-scraper)
• Coupang Search Scraper (zen-studio/coupang-search-scraper)
• Coupang Product Detail Scraper (zen-studio/coupang-detail-scraper)
• Naver Shopping Scraper (zen-studio/naver-shopping-scraper)
• Naver Shopping Product Detail Scraper (zen-studio/naver-product-detail-scraper)
• Naver Shopping Review Scraper (zen-studio/naver-review-scraper)
• Douban Reviews Scraper (zen-studio/douban-reviews-scraper)
• Douban Group Scraper (zen-studio/douban-group-scraper)
• Zhihu Scraper (zen-studio/zhihu-scraper)
• Weibo Search Scraper (zen-studio/weibo-search-scraper)
• Weibo Comments Scraper (zen-studio/weibo-comments-scraper)
• Kwai Search Scraper (zen-studio/kwai-search-scraper)
• Kwai Comments Scraper (zen-studio/kwai-comments-scraper)
• Kuaishou Scraper (zen-studio/kuaishou-scraper)
• Douyin Search Scraper (zen-studio/douyin-search-scraper)
• Douyin Profile Scraper (zen-studio/douyin-profile-scraper)
• Douyin Video Scraper (zen-studio/douyin-video-scraper)
• Douyin Comments Scraper (zen-studio/douyin-comments-scraper)
• Douyin Transcripts Scraper (zen-studio/douyin-transcripts-scraper)
• Douyin Creator Rankings Scraper (zen-studio/douyin-xingtu-rankings-scraper)
• Douyin Live Recorder (zen-studio/douyin-live-recorder)
• Douyin Hot Search Scraper (zen-studio/douyin-hot-search-scraper)
• Douyin Product Search Scraper (zen-studio/douyin-product-search-scraper)
• Douyin User Search Scraper (zen-studio/douyin-user-search-scraper)
• RedNote User Profile Scraper (zen-studio/rednote-user-profile-scraper)
• RedNote Search Scraper (zen-studio/rednote-search-scraper)
• RedNote Comments Scraper (zen-studio/rednote-comments-scraper)
• RedNote Product Search Scraper (zen-studio/rednote-product-search-scraper)
• RedNote Note Detail Scraper (zen-studio/rednote-note-detail-scraper)
• RedNote Product Reviews Scraper (zen-studio/rednote-product-reviews-scraper)
• RedNote Live Recorder (zen-studio/rednote-live-recorder)
• Xigua Video Search Scraper (zen-studio/xigua-video-search-scraper)
• Xigua Video Detail Scraper (zen-studio/xigua-video-detail-scraper)
• Bilibili Video Scraper (zen-studio/bilibili-video-scraper)
• Bilibili Danmaku Scraper (zen-studio/bilibili-danmaku-scraper)
• Naver Blog & Cafe Scraper (zen-studio/naver-blog-cafe-scraper)
• Naver Real Estate Scraper (zen-studio/naver-land-scraper)
• Anjuke For-Sale Listings Scraper (zen-studio/anjuke-real-estate-scraper)
• Anjuke New-Home Scraper (zen-studio/anjuke-new-home-scraper)
• Anjuke Rental Listings Scraper (zen-studio/anjuke-rent-scraper)
• Anjuke Listing Detail Scraper (zen-studio/anjuke-sale-detail-scraper)
• 58.com Real Estate Scraper (zen-studio/58-real-estate-scraper)
• Autohome (Che168) Used-Car Scraper (zen-studio/che168-car-scraper)
• Ctrip Hotel Prices Scraper (zen-studio/ctrip-hotel-prices-scraper)
• Ctrip Hotel Reviews Scraper (zen-studio/ctrip-hotel-reviews-scraper)
• Mafengwo Reviews Scraper (zen-studio/mafengwo-reviews-scraper)
• Mafengwo Tours & Tickets Scraper (zen-studio/mafengwo-tours-tickets-scraper)

Full directory: Zen Studio on Apify

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.