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.

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, title, titleOriginal, url, CNY and USD price fields, full priceDetails, SKU matrix, attributes, promotions, shop object, gallery media, videos, related recommendation groups, optional reviews, descriptionHtml, weight, delivery, category, location, product metadata, 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, 20 products/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 links that resolve to a product page. Add up to 1,000 inputs per run. Unsupported or expired links fail validation before any product detail charge.

Product URL

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

Numeric item ID

{
  "items": ["1003783113480"]
}

Short Taobao share link

{
  "items": ["https://e.tb.cn/h.hPY04k4RPfAco8F?tk=0CCI430IUqd"]
}

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 links that resolve to product pages, or numeric item IDs. Test runs are capped at 5 products; free-tier runs are capped at 20 products.
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, translated title when available, original Chinese title, scrape timestamp.
• Pricing and stock: CNY price, USD converted price, full nested priceDetails, delivery price, SKU-level price objects, quantity, and sales counts.
• SKU matrix: SKU ID, quantity, sales count, configurator IDs, and per-SKU CNY/USD price details.
• Attributes, shop, promotions, and media: translated and original attributes, promotion prices, shop/vendor object, primary image, gallery image sizes and dimensions, videos, description HTML, product metadata, category root path.
• Optional customer reviews: buyer review text, dates, photos, videos, replies, append reviews, helpful counts, and anonymized user metadata when fetchReviews is enabled.
• Additional detail metadata: weight, delivery costs, product features, featured values, sell status, location, category IDs, related recommendation groups, and update timestamps when returned.

Output Example

Arrays are trimmed for readability. Optional null or empty fields are omitted here. titleOriginal keeps the Chinese Taobao title; title is the translated detail title when available.

{
  "input": "https://item.taobao.com/item.htm?id=1003783113480",
  "inputType": "url",
  "resolvedUrl": "https://item.taobao.com/item.htm?id=1003783113480",
  "itemId": "1003783113480",
  "url": "https://item.taobao.com/item.htm?id=1003783113480",
  "title": "Apple/苹果 iPhone 15 Plus 苹果15 苹果15ProMax国行 苹果15手机",
  "titleOriginal": "Apple/苹果 iPhone 15 Plus 苹果15 苹果15ProMax国行 苹果15手机",
  "priceCurrency": "CNY",
  "price": "3019.00",
  "priceUSD": "445.00",
  "priceDetails": {
    "originalPrice": "3019.00",
    "convertedPriceWithoutSign": "445.00",
    "convertedPriceList": {
      "internal": {"price": "3019.00", "code": "CNY"},
      "displayedMoneys": [{"price": "445.00", "code": "USD"}]
    },
    "priceWithoutDelivery": {"originalPrice": "3019.00"},
    "oneItemPriceWithoutDelivery": {"originalPrice": "3019.00"}
  },
  "deliveryPrice": "0.00",
  "brandName": "Apple/苹果",
  "skuCount": 30,
  "skus": [
    {
      "skuId": "ot-s-1003783113480-1",
      "quantity": 0,
      "salesCount": 0,
      "configurators": [
        {"pid": "1627207", "vid": "28323"},
        {"pid": "12304035", "vid": "25484125"}
      ],
      "price": {
        "originalPrice": "3019.00",
        "convertedPriceWithoutSign": "445.00",
        "currencyName": "USD",
        "deliveryPrice": "0.00"
      }
    }
  ],
  "attributes": [
    {
      "pid": "上市时间",
      "vid": "2023-09",
      "name": "Time to market",
      "value": "2023-09",
      "originalName": "上市时间",
      "originalValue": "2023-09",
      "isConfigurator": false
    },
    {
      "pid": "售后服务",
      "vid": "店铺保修",
      "name": "After-sales service",
      "value": "Shop warranty",
      "originalName": "售后服务",
      "originalValue": "店铺保修",
      "isConfigurator": false
    }
  ],
  "promotions": [
    {
      "id": "ot-d-promotion-1003783113480",
      "name": "Promotion",
      "price": {
        "originalPrice": "3019.00",
        "convertedPriceWithoutSign": "445.00"
      },
      "configuredItems": [
        {
          "skuId": "5993905756232",
          "price": {
            "originalPrice": "5179.00",
            "convertedPriceWithoutSign": "762.00"
          }
        }
      ]
    }
  ],
  "shop": {
    "vendorName": "优信数码科技",
    "vendorDisplayName": "优信数码科技",
    "shopId": "35384276",
    "taobaoVendorId": "87764758",
    "shopUrl": "https://shop35384276.taobao.com/",
    "featuredValues": {
      "userScoreDelivery": "4.93837",
      "userScoreItem": "4.93539",
      "userScoreService": "4.95527"
    }
  },
  "mainPictureUrl": "https://img.alicdn.com/imgextra/i3/87764758/...",
  "pictures": [
    {
      "url": "https://img.alicdn.com/imgextra/i3/87764758/...",
      "small": "https://img.alicdn.com/imgextra/i3/87764758/..._100x100q90.jpg",
      "smallWidth": 100,
      "smallHeight": 100,
      "medium": "https://img.alicdn.com/imgextra/i3/87764758/..._310x310q90.jpg",
      "mediumWidth": 310,
      "mediumHeight": 310,
      "large": "https://img.alicdn.com/imgextra/i3/87764758/..._600x600q90.jpg",
      "largeWidth": 600,
      "largeHeight": 600,
      "isMain": true
    }
  ],
  "videos": [
    {
      "url": "https://cloud.video.taobao.com/play/...",
      "previewUrl": "https://img.alicdn.com/..."
    }
  ],
  "relatedGroups": [
    {
      "type": "Recommendations",
      "displayName": "Recommended items",
      "items": [
        {
          "itemId": "882583316506",
          "url": "https://item.taobao.com/item.htm?id=882583316506",
          "title": "Turas three-in-one power bank...",
          "titleOriginal": "图拉斯三合一随心充...",
          "priceCNY": "448.00",
          "priceUSD": "66.00"
        }
      ]
    }
  ],
  "descriptionHtml": "<!DOCTYPE html>...",
  "weightInfo": {
    "type": "Default",
    "displayName": "Approx weight",
    "weight": 0
  },
  "categoryId": "otc-101413",
  "externalCategoryId": "1512",
  "rootPath": {
    "Content": [
      {"Id": "otc-101413", "ExternalId": "1512"}
    ]
  },
  "isSellAllowed": false,
  "features": ["FakeQuantity", "Expired"],
  "featuredValues": {"TotalSales": "200"},
  "reviews": [
    {
      "date": "2026年05月13日 23:24",
      "content": "评价方未及时做出评价,系统默认好评!",
      "rateId": 1304852821306,
      "photos": [],
      "video": null,
      "reply": null,
      "appendList": [],
      "useful": 0,
      "user": {
        "nick": "g***2",
        "vipLevel": 6,
        "anony": true,
        "rank": 5
      }
    }
  ],
  "_reviewsFetched": true,
  "_reviewsCount": 1,
  "scrapedAt": "2026-05-15T14:13:22Z",
  "_detailFetched": true,
  "_detailError": null
}

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, 20 products per run.

Notes on Inputs

The Actor accepts direct Taobao/Tmall product URLs and numeric item IDs. Short share links are supported when they resolve to a product page. Unsupported links fail before any product detail charge.

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". When converted pricing is available, priceUSD and SKU-level converted price fields are also included.

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 20 products per run.

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.