# Taobao 淘宝 Seller Catalog Scraper - Products & Prices (`zen-studio/taobao-seller-products-scraper`) Actor Extract product catalogs from Taobao (淘宝) and Tmall (天猫) sellers. Resolve seller handles, IDs, or product URLs, then export store product rows with prices, images, sales signals, categories, and shop metadata. - **URL**: https://apify.com/zen-studio/taobao-seller-products-scraper.md - **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community) - **Categories:** E-commerce, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $4.29 / 1,000 seller 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 淘宝 Seller Catalog Scraper - Store Products, Prices, Sales (2026)
Extract Taobao (淘宝) and Tmall seller catalogs by seller handle, seller ID, product URL, item ID, or seller/shop ID object - one row per product with prices, sales signals, images, category IDs, and shop metadata.
![Taobao Seller Catalog Scraper](https://iili.io/C9NnGkB.png) #### Copy to your AI assistant ```` zen-studio/taobao-seller-products-scraper on Apify. Extracts Taobao and Tmall seller catalogs and returns one product row per listing with input, inputType, sellerId, shopId, shopName, shopUrl, platform, isTmall, shop metadata, itemId, encodedItemId, url, title, titleOriginal, mainPictureUrl, CNY price fields, priceDetails, shipping flags, area limits, category IDs, comment tags, 30-day sales/order/comment signals, catalog page/rank metadata, and scrapedAt. Call ApifyClient("TOKEN").actor("zen-studio/taobao-seller-products-scraper").call(run\_input={"sellers":\["laolong998"],"maxItemsPerSeller":100}), then client.dataset(run\["defaultDatasetId"]).list\_items().items. Required: sellers. Optional: maxItemsPerSeller, sort (recommended, best\_selling, newly\_listed, lowest\_price, highest\_price). Sellers can be handles, seller IDs, Taobao/Tmall product URLs, itemId:123, item:123, itemId objects, or sellerId/shopId objects. Bare numeric sellers are seller IDs. Shop URLs alone are not supported. Pricing: $0.05 start fee plus $4.99/1,000 product rows before Store discounts. Free tier: 10 lifetime runs, 20 products/run. Token: https://console.apify.com/account/integrations ````
Zen Studio China Scrapers   •  Taobao, Tmall, and JD.com commerce data
 Seller Catalog
➤ You are here 		 Taobao Search ↗
Keyword product search 		 Taobao Detail ↗
Product detail by URL/ID 		 JD.com ↗
京东 prices + reviews
### How to Extract Seller Catalogs Put one or more seller locators in `sellers`. Accepted formats: - Seller handle: `laolong998` - Seller ID: `20133891` - Taobao product URL: `https://item.taobao.com/item.htm?id=14939664094` - Tmall product URL: `https://detail.tmall.com/item.htm?id=14939664094` - Item ID prefix: `itemId:14939664094` or `item:14939664094` - Item ID object: `{"itemId": "14939664094"}` - Seller/shop ID object: `{"sellerId": "20133891", "shopId": "34033352"}` Bare numeric values are seller IDs. Shop URLs alone are not enough because Taobao and Tmall shop URLs expose the shop ID but not the seller ID required to list products. #### Seller handle ```json { "sellers": ["laolong998"], "maxItemsPerSeller": 100 } ```` #### Seller and shop IDs ```json { "sellers": [{"sellerId": "20133891", "shopId": "34033352"}], "sort": "best_selling" } ``` #### Product URL to find the seller ```json { "sellers": [ "https://item.taobao.com/item.htm?id=14939664094", "https://detail.tmall.com/item.htm?id=14939664094" ], "maxItemsPerSeller": 50 } ``` #### Item ID ```json { "sellers": [ "itemId:14939664094", "item:14939664094", {"itemId": "14939664094"} ], "maxItemsPerSeller": 50 } ``` ### Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `sellers` | array | required | Seller locators to scrape. Supports seller handles, seller IDs, Taobao/Tmall product URLs, item ID prefixes, item ID objects, and objects with both `sellerId` and `shopId`. Bare numeric values are treated as seller IDs. | | `maxItemsPerSeller` | integer | `100` | Maximum product rows to return per seller. Test runs are capped at 5 products per seller; free-tier runs are capped at 20 products. | | `sort` | string | `recommended` | `recommended`, `best_selling`, `newly_listed`, `lowest_price`, or `highest_price`. | ### What Data Can You Extract from Taobao Seller Catalogs? One dataset row represents one product in a seller catalog. - **Seller and shop metadata**: `sellerId`, `shopId`, `shopName`, `shopUrl`, `platform`, `isTmall`, and the nested `shop` object. - **Product identity and media**: `itemId`, `encodedItemId`, product URL, title, original title, main image URL, category IDs, and scrape timestamp. - **Pricing and shipping**: `priceCurrency`, `price`, `discountPrice`, full `priceDetails`, `freeShipping`, and `areaLimit`. - **Demand and catalog signals**: `soldCount30Day`, `orderCount30Day`, `orderPayUV`, `commentCount`, `commentTags`, and `catalog` page/rank metadata. #### Output Example This is a complete product-row example. Large arrays can be shortened in exports, but this sample keeps the full object shape. ```json { "input": "laolong998", "inputType": "seller_handle", "sellerId": "20133891", "shopId": "34033352", "shopName": "喜尚3D眼镜", "shopUrl": "https://shop34033352.taobao.com", "platform": "Taobao", "isTmall": true, "shop": { "sellerId": "20133891", "shopId": "34033352", "shopName": "喜尚3D眼镜", "shopUrl": "https://shop34033352.taobao.com", "pictureUrl": "https://img.alicdn.com/imgextra/i2/TB1Wlhjcjgy_uJjSZK9SutvlFXa.jpg", "vendorId": "laolong998", "vendorName": "laolong998", "vendorDisplayName": "laolong998", "location": {}, "features": ["Tmall", "Expired"], "updatedTime": "2025-09-07T10:26:24.003Z", "descriptionMatchScore": "4.5", "serviceScore": "4.6", "deliveryScore": "4.7", "credit": { "level": 0, "score": 0, "totalFeedbacks": 0, "positiveFeedbacks": 0 }, "stats": { "allItemCount": "37", "fans": "1513", "shopFansNum": "1511", "years": "14" }, "featuredValues": { "userId": "20133891", "shopId": "34033352", "userScoreItem": "4.63636", "userScoreService": "4.63636", "userScoreDelivery": "4.63636", "TaobaoVendorId": "20133891", "itemScoreDif": "15.01", "serviceScorePercent": "4.8", "taobaoVendorId": "20133891", "serviceScoreDif": "-0.1", "years": "14", "consignmentDif": "-0.45", "allItemCount": "37", "DeliveryScorePercent": "4.8", "starts": "1162999605", "ServiceScorePercent": "4.8", "ShopId": "34033352", "goodRatePercentage": "98.93", "ItemScorePercent": "4.8", "stars": "13", "shopUrl": "https://shop34033352.taobao.com", "pageId": "206610216", "fans": "1513", "shopFansNum": "1511", "itemScorePercent": "4.8", "deliveryScorePercent": "4.8" } }, "itemId": "14939664094", "encodedItemId": "RmtJVy9zaExXTE44SGRlY29OYnhudz09", "url": "https://item.taobao.com/item.htm?id=14939664094", "title": "3D眼镜电影院专用Reald偏光不闪式通用3D眼睛电视近视三d眼镜", "titleOriginal": "3D眼镜电影院专用Reald偏光不闪式通用3D眼睛电视近视三d眼镜", "mainPictureUrl": "https://img.alicdn.com/i1/20133891/O1CN01F6tpho1ec7dJEbDLE_!!20133891.jpg", "priceCurrency": "CNY", "price": "5.00", "discountPrice": "5.00", "priceDetails": { "priceFen": 500, "discountPriceFen": 500, "discountPriceHKD": "5.82", "discountPriceTWD": "23.47", "discountPriceWorld": "5.00", "discountType": null }, "freeShipping": false, "areaLimit": false, "categoryId": "50018834", "rootCategoryId": "28", "commentCount": 13, "commentTags": [], "soldCount30Day": 1, "orderCount30Day": 1, "orderPayUV": 1, "catalog": { "sort": "recommended", "page": 1, "rank": 2, "pageSize": 60, "totalCount": 34, "totalPages": 1 }, "scrapedAt": "2026-05-21T07:31:00Z" } ``` ### Pricing This Actor uses pay-per-event pricing. Apify Store discounts may lower these unit prices. | Output | Base price | |--------|------------| | Actor start | `$0.05 / run` | | Seller product row | `$4.99 / 1,000 products` | You pay the start fee once per run, then the product row fee for each seller catalog product saved to the dataset. Free-tier users get 10 lifetime runs, capped at 20 products per run. When a free-tier account has used all lifetime runs, the dataset contains one uncharged row with `error`, `message`, and `upgradeUrl` so API clients can detect the block. ### FAQ #### Can I use a shop URL? No. Shop URLs alone are not enough because Taobao shop URLs expose the shop ID but not the seller ID required to list products. Use a seller handle, seller ID, Taobao/Tmall product URL, item ID, or an object with both `sellerId` and `shopId`. #### Are bare numeric sellers item IDs? No. Bare numeric values in `sellers` are seller IDs. For item IDs, use `itemId:123`, `item:123`, an object such as `{"itemId":"123"}`, or a product URL. #### What sort options are available? Use `recommended`, `best_selling`, `newly_listed`, `lowest_price`, or `highest_price`. #### Does `maxItemsPerSeller` always return exactly that number? The Actor returns up to `maxItemsPerSeller` per seller. Actual count depends on how many products Taobao returns for that catalog and sort mode. #### How does the free tier work? Free-tier users get 10 lifetime runs, capped at 20 products per run. If those runs are exhausted, the Actor writes one uncharged dataset row with `error`, `message`, and `upgradeUrl`. #### Why do some optional fields return `null` or empty arrays? Taobao does not expose every field for every product. The dataset schema keeps stable top-level keys so exports remain predictable. ### Support Open an issue on the Actor page if a seller consistently returns empty results, if a field changes type, or if a sort mode behaves differently than expected. For reproducible support, include the input JSON and the run ID. # Actor input Schema ## `sellers` (type: `array`): Seller locators to scrape.

Accepted formats:
• laolong998 seller handle
• 20133891 seller ID
• https://item.taobao.com/item.htm?id=14939664094 Taobao product URL
• https://detail.tmall.com/item.htm?id=14939664094 Tmall product URL
• itemId:14939664094 or item:14939664094 item ID prefix
• {"itemId":"14939664094"} item ID object
• {"sellerId":"20133891","shopId":"34033352"} seller/shop ID object

Bare numeric values are seller IDs. Shop URLs alone are not supported. ## `maxItemsPerSeller` (type: `integer`): Set the maximum product rows to return per seller.

Test runs are capped at 5 products per seller. Free-tier runs are capped at 20 products. ## `sort` (type: `string`): Choose how each seller catalog is ordered. ## Actor input object example ```json { "sellers": [ "https://detail.tmall.com/item.htm?id=14939664094" ], "maxItemsPerSeller": 100, "sort": "recommended" } ``` # Actor output Schema ## `results` (type: `string`): Link to the dataset containing all scraped seller product 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 = { "sellers": [ "https://detail.tmall.com/item.htm?id=14939664094" ] }; // Run the Actor and wait for it to finish const run = await client.actor("zen-studio/taobao-seller-products-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 = { "sellers": ["https://detail.tmall.com/item.htm?id=14939664094"] } # Run the Actor and wait for it to finish run = client.actor("zen-studio/taobao-seller-products-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 '{ "sellers": [ "https://detail.tmall.com/item.htm?id=14939664094" ] }' | apify call zen-studio/taobao-seller-products-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=zen-studio/taobao-seller-products-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Taobao 淘宝 Seller Catalog Scraper - Products & Prices", "description": "Extract product catalogs from Taobao (淘宝) and Tmall (天猫) sellers. Resolve seller handles, IDs, or product URLs, then export store product rows with prices, images, sales signals, categories, and shop metadata.", "version": "0.0", "x-build-id": "ssQeuGUy4O4dKSBi2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zen-studio~taobao-seller-products-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zen-studio-taobao-seller-products-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-seller-products-scraper/runs": { "post": { "operationId": "runs-sync-zen-studio-taobao-seller-products-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-seller-products-scraper/run-sync": { "post": { "operationId": "run-sync-zen-studio-taobao-seller-products-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": [ "sellers" ], "properties": { "sellers": { "title": "店铺 Sellers", "type": "array", "description": "Seller locators to scrape.

Accepted formats:
• laolong998 seller handle
• 20133891 seller ID
• https://item.taobao.com/item.htm?id=14939664094 Taobao product URL
• https://detail.tmall.com/item.htm?id=14939664094 Tmall product URL
• itemId:14939664094 or item:14939664094 item ID prefix
• {\"itemId\":\"14939664094\"} item ID object
• {\"sellerId\":\"20133891\",\"shopId\":\"34033352\"} seller/shop ID object

Bare numeric values are seller IDs. Shop URLs alone are not supported." }, "maxItemsPerSeller": { "title": "每店商品数 Max products per seller", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Set the maximum product rows to return per seller.

Test runs are capped at 5 products per seller. Free-tier runs are capped at 20 products.", "default": 100 }, "sort": { "title": "排序 Sort", "enum": [ "recommended", "best_selling", "newly_listed", "lowest_price", "highest_price" ], "type": "string", "description": "Choose how each seller catalog is ordered.", "default": "recommended" } } }, "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 } } } } } } } } } } ```