Pricing

Rating

Developer

Actor stats

Categories

Share

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.

👁 Taobao Detail Scraper

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

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

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, variant option imageUrl / miniImageUrl values when Taobao returns them, 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

All top-level schema fields are shown. Large arrays are cropped to representative entries. 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",
"brandId":"Apple/苹果",
"brandName":"Apple/苹果",
"stuffStatus":"New",
"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":"1627207",
"vid":"28323",
"name":"Body color",
"value":"Fuchsia",
"originalName":"机身颜色",
"originalValue":"粉色",
"isConfigurator":true,
"imageUrl":"http://img.alicdn.com/imgextra/i3/87764758/O1CN01NgwUJr1l1DZlFCoYW_!!87764758.jpg",
"miniImageUrl":"http://img.alicdn.com/imgextra/i3/87764758/O1CN01NgwUJr1l1DZlFCoYW_!!87764758.jpg"
}
],
"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/..."
}
],
"ulandItemUrl":"https://uland.taobao.com/item/edetail?id=1003783113480",
"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
},
"weightInfos":[],
"physicalParameters":{},
"location":{},
"categoryId":"otc-101413",
"externalCategoryId":"1512",
"rootPath":{
"Content":[
{"Id":"otc-101413","ExternalId":"1512"}
]
},
"firstLotQuantity":1,
"nextLotQuantity":1,
"masterQuantity":5000,
"volume":0,
"isSellAllowed":false,
"sellDisallowReason":"IsNotDeliverable",
"isFiltered":false,
"providerType":"Taobao",
"createdTime":"2026-02-01T14:34:20.751Z",
"updatedTime":"2026-02-27T14:46:35.104Z",
"lastUpdatedTime":"2026-02-27T14:46:35.104Z",
"features":["FakeQuantity","Expired"],
"featuredValues":{"TotalSales":"200"},
"hasInternalDelivery":true,
"deliveryCosts":[],
"hasHierarchicalConfigurators":false,
"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
}

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.

Store discount pricing:

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 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". 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.

More Zen Studio scrapers for Chinese platforms

🛒 E-commerce

• 👁 Image
  Taobao 淘宝
  • Taobao Search Scraper
  • Taobao Seller Products Scraper
• 👁 Image
  JD.com 京东
  • JD.com Search Scraper
• 👁 Image
  1688 阿里巴巴
  • 1688 Wholesale Scraper
  • Alibaba Scraper
• 👁 Image
  Goofish 闲鱼
  • Goofish (Xianyu) Search Scraper
  • Goofish (Xianyu) Seller Scraper
  • Goofish (Xianyu) Item Detail Scraper
  • Goofish (Xianyu) Item Comments & Q&A Scraper

🎬 Short-video & social

• 👁 Image
  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
• 👁 Image
  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
• 👁 Image
  Xigua 西瓜视频
  • Xigua Video Search Scraper
  • Xigua Video Detail Scraper

🏠 Real estate & autos

• 👁 Image
  Anjuke 安居客
  • Anjuke For-Sale Listings Scraper
  • Anjuke New-Home Scraper
  • Anjuke Rental Listings Scraper
  • Anjuke Listing Detail Scraper
• 👁 Image
  58.com 58同城
  • 58.com Real Estate Scraper
• 👁 Image
  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.