# Taobao 淘宝 Product Detail Scraper - SKUs, Prices, Reviews (`zen-studio/taobao-detail-scraper`) Actor Extract SKUs, prices, attributes, optional reviews, images, videos, shop data, and category metadata from Taobao (淘宝) and Tmall (天猫) product URLs or item IDs. Export clean JSON, CSV, and Excel rows. - **URL**: https://apify.com/zen-studio/taobao-detail-scraper.md - **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 4 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $7.99 / 1,000 products This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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](https://iili.io/BpFQGAx.png) #### 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 ```json { "items": ["https://item.taobao.com/item.htm?id=1003783113480"] } ```` #### Numeric item ID ```json { "items": ["1003783113480"] } ``` #### Short Taobao share link ```json { "items": ["https://e.tb.cn/h.hPY04k4RPfAco8F?tk=0CCI430IUqd"] } ``` #### Batch details ```json { "items": [ "https://item.taobao.com/item.htm?id=1003783113480", "996313754846" ] } ``` #### Details with buyer reviews ```json { "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. ```json { "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": "...", "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. # Actor input Schema ## `items` (type: `array`): Add Taobao or Tmall products to fetch.

Supported URL formats:Also accepted: numeric item IDs such as 1003783113480, plus short share links when they resolve to a product page. ## `fetchReviews` (type: `boolean`): Add customer reviews as a nested reviews array on each product row.

Reviews are billed separately. Keep off unless review text is needed. ## `maxReviewsPerItem` (type: `integer`): Set the maximum reviews to attach to each product when 买家评价 Customer reviews is enabled. ## Actor input object example ```json { "items": [ "https://item.taobao.com/item.htm?id=1003783113480" ], "fetchReviews": false, "maxReviewsPerItem": 100 } ``` # Actor output Schema ## `results` (type: `string`): Link to the dataset containing all scraped Taobao product detail rows. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "items": [ "https://item.taobao.com/item.htm?id=1003783113480" ] }; // Run the Actor and wait for it to finish const run = await client.actor("zen-studio/taobao-detail-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "items": ["https://item.taobao.com/item.htm?id=1003783113480"] } # Run the Actor and wait for it to finish run = client.actor("zen-studio/taobao-detail-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "items": [ "https://item.taobao.com/item.htm?id=1003783113480" ] }' | apify call zen-studio/taobao-detail-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=zen-studio/taobao-detail-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Taobao 淘宝 Product Detail Scraper - SKUs, Prices, Reviews", "description": "Extract SKUs, prices, attributes, optional reviews, images, videos, shop data, and category metadata from Taobao (淘宝) and Tmall (天猫) product URLs or item IDs. Export clean JSON, CSV, and Excel rows.", "version": "0.0", "x-build-id": "z9PQXx50N0CHkBo0q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zen-studio~taobao-detail-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zen-studio-taobao-detail-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/zen-studio~taobao-detail-scraper/runs": { "post": { "operationId": "runs-sync-zen-studio-taobao-detail-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/zen-studio~taobao-detail-scraper/run-sync": { "post": { "operationId": "run-sync-zen-studio-taobao-detail-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "items" ], "properties": { "items": { "title": "商品链接或 ID Product URLs or IDs", "maxItems": 1000, "type": "array", "description": "Add Taobao or Tmall products to fetch.

Supported URL formats:
  • https://item.taobao.com/item.htm?id=1003783113480
  • https://detail.tmall.com/item.htm?id=1003783113480
  • https://e.tb.cn/h.hPY04k4RPfAco8F?tk=0CCI430IUqd
Also accepted: numeric item IDs such as 1003783113480, plus short share links when they resolve to a product page.", "items": { "type": "string" } }, "fetchReviews": { "title": "买家评价 Customer reviews", "type": "boolean", "description": "Add customer reviews as a nested reviews array on each product row.

Reviews are billed separately. Keep off unless review text is needed.", "default": false }, "maxReviewsPerItem": { "title": "每商品评价数 Reviews per product", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Set the maximum reviews to attach to each product when 买家评价 Customer reviews is enabled.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```