# Taobao & Tmall Scraper & API: Products & Shops ($1/1k) (`unitbytes/taobao-tmall-scraper`) Actor โšก Fast & Cheap ($1.05/1k): Monitor & scrape Taobao (ๆท˜ๅฎ) & Tmall products, seller shop catalogs, DSR ratings & prices. Sentiment tags, CNY/HKD/TWD prices & HD photos, zero cookies. - **URL**: https://apify.com/unitbytes/taobao-tmall-scraper.md - **Developed by:** [UnitBytes | Enterprise Web Data](https://apify.com/unitbytes) (community) - **Categories:** E-commerce, Lead generation, Agents - **Features:** Limited permissions - **Stats:** 52 total users, 17 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.05 / 1,000 product listing scrapeds 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/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README

Taobao and Tmall Search & Product Catalog Scraper API by UnitBytes

## ๐Ÿ›๏ธ Taobao & Tmall ๆท˜ๅฎ Product Scraper โ€” Cross-Border Catalog, Seller Shops, DSR & Prices (ๆท˜ๅฎ & ๅคฉ็Œซ API)
Taobao and Tmall Search Scraper API Logo - UnitBytes E-Commerce Intelligence
[![Available on Apify](https://img.shields.io/badge/Available_on-Apify-28B52A?style=for-the-badge\&logo=apify\&logoColor=white)](https://console.apify.com/actors/deplqV6g1hYjwrETX?addFromActorId=deplqV6g1hYjwrETX) [![Price](https://img.shields.io/badge/Price-From_$0.0015%2Fitem-orange?style=for-the-badge)](#-cost-effective-pay-per-event-ppe-pricing) [![Free Trial](https://img.shields.io/badge/Free_Monthly_Trial-Up_to_3%2C330_Products-brightgreen?style=for-the-badge)](#-cost-effective-pay-per-event-ppe-pricing) [![Details](https://img.shields.io/badge/Catalog-Shops_%26_3--Axis_DSR-blue?style=for-the-badge)](#-what-data-you-get-spreadsheet-columns-preview) [![Export](https://img.shields.io/badge/Export-Excel%2C_CSV%2C_Sheets-green?style=for-the-badge)](#-how-to-use-in-3-simple-steps-no-coding-required) [![Auth](https://img.shields.io/badge/Auth-100%25_Cookieless-teal?style=for-the-badge)](#-how-to-use-in-3-simple-steps-no-coding-required) **The fastest, cheapest cookieless Taobao (ๆท˜ๅฎ) & Tmall (ๅคฉ็Œซ) cross-border catalog scraper on Apify. Extracts publicly indexed Taobao Global (`world.taobao.com`) product listings, overseas-enabled seller shop catalogs, Seller DSR ratings, buyer sentiment tags, multi-currency prices (`CNY`, `HKD`, `TWD`), and permanent HD photos by Keyword Tag, Shop URL, or Direct Product URL โ€” Zero Login, Zero Cookies & Zero Chinese Phone Number Required.** [**๐Ÿš€ Try it Free on Apify**](https://console.apify.com/actors/deplqV6g1hYjwrETX?addFromActorId=deplqV6g1hYjwrETX) โ€ข [**โš ๏ธ What Works vs. Limitations**](#-honest-breakdown-what-works-vs-what-does-not-work-read-before-running) โ€ข [**๐Ÿ“Š View Sample Data**](#-sample-output-preview) โ€ข [**โ“ FAQ**](#-frequently-asked-questions-faq)

Try it for Free
โšก 1-Click Free Trial: Extract 3,330+ Product Listings FREE every month with Apify's $5 credit โ€ข No credit card required

*** > \[!TIP] > ๐Ÿ’ฐ **Cheapest Cookieless Taobao & Tmall Scraper on Apify Store**: Only **$1.50 per 1,000 items** ($0.0015/item for Keyword Search & Seller Storefronts, or $0.0040/item for Direct Product URL lookups) โ€” 3x to 10x cheaper than competitors who charge $5.00 to $15.00. If a domestic-only product, shop, or unindexed keyword returns 0 results, you are charged **$0.00**. *** ### โš ๏ธ Honest Breakdown: What Works vs. What Does NOT Work (Read Before Running) > \[!IMPORTANT] > **Why Domestic Taobao (`s.taobao.com` / `item.taobao.com`) Does Not Work Cookieless:**\ > Domestic Mainland Taobao strictly blocks all unauthenticated traffic behind mandatory account login walls and interactive slider CAPTCHAs. Because this actor operates **100% cookieless** (you do not need to supply your own Chinese Taobao account or login cookies), **it cannot scrape the login-gated domestic Mainland Taobao portal directly**.\ > Instead, this actor extracts data from **Taobao Global (`world.taobao.com`)** โ€” Alibaba's official public cross-border catalog for international buyers (Singapore, Hong Kong, Taiwan, Malaysia, etc.). **Please read the exact differences below so your expectations match how this actor works:** #### โœ… What IS Working (Cookieless via `world.taobao.com`) - **Overseas-Indexed Keyword & Category Tags (`queries`)**: Searching Chinese product keywords (e.g. `ๆ‰‹ๆœบๅฃณ`, `่“็‰™่€ณๆœบ`, `ๅฅณ่ฃ…`, `่ฟž่กฃ่ฃ™`, `่ฟๅŠจ้ž‹`, `็›ฒ็›’`) or English product & brand terms (e.g. `phone case`, `wireless earbuds`, `xiaomi power bank`, `anime figure` โ€” automatically resolved to Chinese Taobao tags) on `world.taobao.com/product/{tag}.htm`. - **Fast Summary Mode (`scrapeDetails: false`, default โ€” `$0.0015/item` / `$1.50/1k`)**: Returns full untruncated product titles, `CNY`/`HKD`/`TWD` prices, promo badges (`discountType`), selling points (`sellPoints`), seller `shopId` & `shopName`, `dsrDescription` score, canonical `world.taobao.com/item/{itemIdStr}.htm` URL (`url`), and primary HD photo (`mainImage`). - **Full Product Detail Mode (`scrapeDetails: true` โ€” `$0.004/item` / `$4.00/1k`)**: Enriches every discovered product with its detail page, adding **`reviewCount`**, **`ratingGoodCount`**, **`reviewTags`** (sentiment tags with buyer counts), **`reviews`** (featured customer reviews & buyer videos), **3-axis Seller DSR scores** (`dsrDescription`, `dsrService`, `dsrDelivery`), **`skus` & `attributes`**, shipping origin (**`location`**), **`categoryPath` & `breadcrumbs`**, **`sellerCreditLevel`**, **`shopOpenedAt`**, **`shopItemCount`**, and up to **15 HD gallery & description images** (`images`). - **Overseas-Indexed Seller Storefronts (`shopUrls`)**: Extracting storefront product listings (`world.taobao.com/dianpu/{shopId}.htm`), 3-axis Seller DSR ratings (`dsrDescription`, `dsrService`, `dsrDelivery`), and total listed item counts (`shopItemCount`) for Taobao & Tmall sellers participating in Taobao Global cross-border shipping at **$0.0015/item** (or enriched with full product details when `scrapeDetails: true`). - **Direct Product Detail Pages (`itemUrls`)**: Extracting public detail pages (`world.taobao.com/item/{itemIdStr}.htm`, e.g. `https://world.taobao.com/item/Y1QrcEVrd3JLNWVjWno4SDJBVHByZz09.htm`) for cross-border eligible items โ€” returning full untruncated titles, base & promo prices (`CNY`), 3-axis Seller DSR scores, total `reviewCount`, crowd-sourced buyer sentiment tags (`reviewTags`), **featured customer reviews** (`reviews`), SKU specs (`skus`, `attributes`), shipping origin (`location`), category breadcrumbs (`categoryPath`), and up to **15 HD images**. Every returned item includes both its `world.taobao.com/item/{itemIdStr}.htm` URL (`url`) and its Mainland `item.taobao.com` / `detail.tmall.com` link (`taobaoUrl`). - **Zero-Charge Protection on Unavailable Targets**: Any product, shop, or keyword that returns 0 results finishes cleanly and charges **$0.00**. #### โŒ What Does NOT Work (Where Domestic Taobao Expectations Differ) 1. **Domestic-Only & Raw Numeric Product URLs (`itemUrls`) Do NOT Work**: - `world.taobao.com` now requires the encrypted `itemIdStr` token in direct `/item/{itemIdStr}.htm` URLs (which is automatically returned in the `url` field of every search and shop result) and redirects raw numeric `item.taobao.com/item.htm?id=...` or `detail.tmall.com/item.htm?id=...` URLs and domestic-only Mainland listings to a 404 (`taglist-404`), outputting `status: "UNAVAILABLE"` (`$0.00` charged). 2. **Domestic-Only Shops (`shopUrls`) & Unindexed Brand Subdomains Do NOT Work**: - Domestic `shopXXXX.taobao.com` and `*.tmall.com` storefronts require a logged-in account on Mainland Taobao. This actor queries `world.taobao.com/dianpu/{shopId}.htm`. - If a shop is **domestic-only** (not indexed on `world.taobao.com/dianpu/`), the run returns **0 products** (`$0.00` charged). - Custom Tmall brand subdomains (`https://.tmall.com`) do not contain the numeric `shopId` in the URL. While the actor attempts to resolve the brand handle via keyword search on `world.taobao.com`, **niche or unindexed custom subdomains will not resolve**. Always prefer passing a numeric `shopId`, `shop{id}.taobao.com`, `world.taobao.com/dianpu/{id}.htm`, or a cross-border product URL from that seller. 3. **Free-Text Long-Tail Search (`s.taobao.com`) & Sequential Page Pagination Do NOT Work**: - Logged-in domestic `s.taobao.com` is a full free-text search engine. By contrast, `world.taobao.com/product/{keyword}.htm` is a **curated category/tag index**. Broad category and product keywords (`ๆ‰‹ๆœบๅฃณ`, `ๅซ่กฃ`, `ๅ……็”ตๅฎ`) work reliably, whereas **pasting full 60-character product titles, specific model numbers, or obscure long-tail phrases** will often return 0 results or fall back to a broader tag. - Furthermore, `world.taobao.com` only serves **1 page (~60 items) per tag view**. To extract more than 60 items for a query or shop, the scraper automatically scans across multiple sort orders (`sales`, `default`, `credit`, `price_asc`, `price_desc`), CNY price bands, and property filters (`pvids`) with strict deduplication โ€” rather than paginating sequentially through page 2, 3, 4 of a single domestic search query. 4. **Login-Gated Domestic Detail Fields Are NOT Exposed**: - **No Full Interactive SKU / Price / Stock Matrix**: Public `world.taobao.com` pages serve `MOST_SIMPLIFIED` payloads (`itemSkuDO: null`, `props: null`) and do not expose the login-gated multi-color/size SKU selector table or inventory stock quantities. - **No Exact Monthly Unit Sales (`salesCount`)**: Domestic `ๅทฒๅ”ฎ X+` monthly sales volume requires a logged-in domestic account (`salesCount` is empty on public pages; use **`reviewCount`** and **`sortBy: "sales"`** instead). - **Featured Review Snippets Only on `itemUrls` (Not Full Review Pagination)**: Direct `itemUrls` lookups extract the **1โ€“2 featured customer reviews** and **sentiment tag counts (`reviewTags`)** embedded in the public detail page โ€” they cannot paginate through hundreds of historical reviews. - **Shortened Titles on Direct `itemUrls`**: On direct product detail pages (`world.taobao.com/item/{id}.htm`), Taobao truncates the raw item title header (typically ~10โ€“25 characters ending in `...`). **Full 60-character product titles** are returned when scraping via **`queries`** or **`shopUrls`**. *** ### ๐Ÿš€ How to Use in 3 Simple Steps (No Coding Required!) You don't need any programming skills, proxies, or Chinese accounts to use this scraper. Follow these 3 easy steps: ``` โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ” โ”‚ Step 1: Enter Keywords or URLs โ”‚ โ”€โ”€โ”€โ–บ โ”‚ Step 2: Click Start โ”‚ โ”€โ”€โ”€โ–บ โ”‚ Step 3: Download Spreadsheet โ”‚ โ”‚ 'phone case', 'ๅฅณ่ฃ…' or URLs โ”‚ โ”‚ Scraper runs in the cloud โ”‚ โ”‚ Export to Excel, CSV or Sheets โ”‚ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜ ``` 1. **Step 1: Enter your search keywords or product URLs**\ In **Search Queries**, type what you are looking for in English or Chinese (e.g. `phone case`, `smart watch`, `wireless earbuds`, or `ๅฅณ่ฃ…`), or paste direct product links into **Product URLs / IDs (`itemUrls`)**. 2. **Step 2: Click "Save & Start"**\ Hit the green button at the bottom of the screen. The actor runs securely in the cloud and extracts full product details, reviews, and ratings in real time. 3. **Step 3: Download your results**\ When the run finishes, click **Export** to download your complete product catalog as an **Excel (XLSX)**, **CSV**, or **Google Sheet** file, complete with permanent, working HD product photo links. > \[!TIP] > **No Chinese Phone Number or Login Required!**\ > No Taobao/Tmall account credentials or manual cookies required โ€” extracts publicly available catalog and store data automatically. *** ### ๐Ÿ“Š What Data You Get (Spreadsheet Columns Preview) Every product extracted includes rich e-commerce, supplier, and product intelligence. Here are the key columns in your exported spreadsheet: | Column Name | Sample Value | What It Tells You | | :--- | :--- | :--- | | **`itemId`** | `1085260672042` | Unique numeric product ID on Taobao / Tmall. | | **`platform`** | `tmall` / `taobao` | Marketplace indicator (`tmall` for official brand stores, `taobao` for retail merchants). | | **`title`** | `[ๆฎผ่†œๅฅ—่ฃ]็คบไพ‹Q3softๆ”ฏ้ปžๆฎผiPhone Duo้ฉ็”จ่˜‹ๆžœ...` | Full 60-character product listing title when discovered via `queries` or `shopUrls` (note: direct `itemUrls` lookups return a shortened ~10โ€“25 char title from `world.taobao.com`). | | **`price` / `originalPrice`** | `876.0` / `876.0` | Current promotion price and original list price in Chinese Yuan (`ยฅ CNY`). | | **`priceHkd` / `priceTwd`** | `1040.07` / `4320.17` | Cross-border retail pricing in Hong Kong Dollars (`HKD`) and Taiwan Dollars (`TWD`). | | **`dsrDescription` / `dsrService` / `dsrDelivery`** | `4.84` / `4.8` / `4.9` | **Seller DSR Scores:** Official Taobao/Tmall rating (`dsrDescription` on search cards; all 3 axes on `shopUrls` and `itemUrls`). | | **`reviewCount` & `reviewTags`** | `58` / `[{"tag": "่ณชๆ„Ÿๅพˆๅผท", "count": 6}]` | Verified buyer review volume and crowd-sourced product sentiment tags with buyer vote counts. | | **`reviews` & `categoryPath`** | `[{"rating": 5, "content": "..."}]` | Featured customer review excerpt, shipping origin (`location`), and category breadcrumb hierarchy (included on direct `itemUrls` lookups). | | **`shopName` & `shopId`** | `็คบไพ‹ๆ•ธ็ขผๆ——่‰ฆๅบ—` (`103710607`) | Verified storefront name, numeric `shopId`, and total item count (`shopItemCount` on `shopUrls` / `itemUrls`). | | **`mainImage` & `images`** | `https://img.alicdn.com/imgextra/i1/O1CN01example_item_01.jpg` | **Permanent HD Photo Gallery:** Up to 5 master resolution links that never expire and work in Shopify/Excel. | | **`url` & `taobaoUrl`** | `https://world.taobao.com/item/1085260672042.htm` / `https://detail.tmall.com/item.htm?id=1085260672042` | Direct links to the product page on Taobao Global (`url`) and Mainland Taobao/Tmall (`taobaoUrl`). | *** ### ๐Ÿ“ค Sample Output Preview > Real unedited JSON output from live runs, ready for 1-click export to Excel, CSV, Google Sheets, Airtable, or Shopify: #### 1. Keyword Search & Seller Storefront Mode (`queries` / `shopUrls` โ€” $1.50 / 1,000 items) ```json { "itemId": "1085260672042", "title": "[ๆฎผ่†œๅฅ—่ฃ]็คบไพ‹Q3softๆ”ฏ้ปžๆฎผiPhone Duo้ฉ็”จ่˜‹ๆžœiPhoneduoๆ‰‹ๆฉŸไฟ่ญทๆฎผๆ‘บ็–Šๅฑๅคšcase็ฃๅธๅ…จๅŒ…douไฟ่ญทๅฅ—ๅค–ๆฎผไฟ่ญทip", "platform": "tmall", "catalogSource": "taobao_retail", "url": "https://world.taobao.com/item/1085260672042.htm", "taobaoUrl": "https://detail.tmall.com/item.htm?id=1085260672042", "price": 876.0, "originalPrice": 876.0, "promotionPrice": 876.0, "currency": "CNY", "priceHkd": 1040.07, "priceTwd": 4320.17, "discountType": "ๆ–ฐๅ“ไฟƒ้Šท", "reviewCount": 20, "reviewTags": [ { "tag": "่ณชๆ„Ÿๅพˆๅผท", "count": 6 }, { "tag": "ๆ‰‹ๆ„Ÿๅพˆๅฅฝ", "count": 5 }, { "tag": "ๆ”ฏๆžถๅพˆๅฏฆ็”จ", "count": 5 }, { "tag": "ๅœ–ๆกˆ่จญ่จˆ็ฒพ็ทป", "count": 4 } ], "shopId": "103710607", "shopName": "็คบไพ‹ๆ•ธ็ขผๆ——่‰ฆๅบ—", "sellerNick": "็คบไพ‹ๆ•ธ็ขผๆ——่‰ฆๅบ—", "shopUrl": "https://world.taobao.com/dianpu/103710607.htm", "taobaoShopUrl": "https://shop103710607.taobao.com", "dsrDescription": 4.84, "categoryId": "150704", "rootCategoryId": "50008090", "mainImage": "https://img.alicdn.com/imgextra/i1/O1CN01example_item_01.jpg", "images": [ "https://img.alicdn.com/imgextra/i1/O1CN01example_item_01.jpg" ], "scrapedAt": "2026-10-25T12:53:39+00:00", "searchQuery": "phone case", "detailLevel": "summary" } ``` #### 2. Direct Product URL Lookup (`itemUrls` โ€” $4.00 / 1,000 items) ```json { "itemId": "1085260672042", "title": "[ๆฎผ่†œๅฅ—่ฃ]็คบไพ‹Q3...", "platform": "tmall", "catalogSource": "taobao_retail", "url": "https://world.taobao.com/item/1085260672042.htm", "taobaoUrl": "https://detail.tmall.com/item.htm?id=1085260672042", "price": 876.0, "originalPrice": 876.0, "promotionPrice": 876.0, "currency": "CNY", "reviewCount": 58, "ratingGoodCount": "58", "shopId": "103710607", "sellerUserId": "1659916565", "shopName": "็คบไพ‹ๆ•ธ็ขผๆ——่‰ฆๅบ—", "sellerNick": "็คบไพ‹ๆ•ธ็ขผๆ——่‰ฆๅบ—", "sellerType": "B", "sellerTypeLabel": "Tmall Flagship Store", "sellerCreditLevel": 19, "shopOpenedAt": "2013-04-24 14:44:53", "shopItemCount": 349, "shopNewItemCount": 26, "shopUrl": "https://world.taobao.com/dianpu/103710607.htm", "taobaoShopUrl": "https://shop103710607.taobao.com", "shopIcon": "https://img.alicdn.com/imgextra/i1/O1CN01example_item_01.jpg", "dsrDescription": 4.8, "dsrService": 4.8, "dsrDelivery": 4.9, "reviewTags": [ { "tag": "่ณชๆ„Ÿๅพˆๅผท", "count": 6 }, { "tag": "ๆ‰‹ๆ„Ÿๅพˆๅฅฝ", "count": 5 } ], "reviews": [ { "rating": 5, "content": "็™ฝ่‰ฒ็ด ็šฎ็ด‹ๅพˆๆผ‚ไบฎ๏ผŒไธŠๆ‰‹ๅ้ฅ‹ๆ„Ÿๅพˆๅผท๏ผŒๆ‘ธ่ตทไพ†่ƒฝๆ„Ÿ่ฆบๅˆฐๅพˆๅผท็š„่ณชๆ„Ÿใ€‚ๆ”ฏๆžถ่ฝ‰่ตทไพ†ๅพˆ็ตฒๆป‘๏ผŒๅŒๆ™‚้‚Š็ทฃ่™•็†็š„ๅพˆๆฝคไธ็กŒๆ‰‹ใ€‚", "date": "2026.10.14 18:16", "sku": "้ฉ็”จๆ‰‹ๆฉŸๅž‹่™Ÿ:iPhone Duo;้ก่‰ฒๅˆ†้กž:ๅˆฉ่ฝ็™ฝ", "user": "***", "videos": [] } ], "categoryId": "150704", "rootCategoryId": "50008090", "categoryPath": "้ฆ–้  > ้˜ฟ่ฃB2Cๅ•†ๅŸŽ > ๆ‰‹ๆฉŸๅŠ้…ไปถ > ๆ‰‹ๆฉŸ้…ไปถ > ไฟ่ญทๅฅ—/็Ÿฝ่† ๅฅ—", "location": "ๅปฃๆฑๆฑ่Žž", "freeShipping": false, "mainImage": "https://img.alicdn.com/imgextra/i1/O1CN01example_item_01.jpg", "images": [ "https://img.alicdn.com/imgextra/i1/O1CN01example_item_01.jpg" ], "scrapedAt": "2026-10-25T12:53:32+00:00", "detailLevel": "full" } ``` *** ### ๐ŸŽฏ Who Is This For? Top Use Cases #### ๐Ÿ“ฆ 1. Cross-Border Product Research & Dropshipping (Shopify, Amazon, TikTok Shop) - Discover consumer products and emerging trends across apparel, electronics, beauty, accessories, and home goods that are already eligible for international/cross-border shipping on Taobao Global. - Analyze **buyer sentiment tags** (`reviewTags`) and **seller DSR ratings** to spot quality issues before stocking a product. - Photos are permanent, hotlink-unblocked master HD images so you can import directly into Shopify or WooCommerce without `403 Forbidden` errors. #### ๐Ÿช 2. Overseas-Indexed Seller Storefront & Brand Monitoring (`shopUrls`) - Paste any Taobao Global shop link (`world.taobao.com/dianpu/63978904.htm`), numeric `shopId` (`shop63978904.taobao.com`), or cross-border product URL into **`shopUrls`** to extract that seller's overseas-indexed catalog, total item count (`shopItemCount`), and 3-axis DSR scores (`dsrDescription`, `dsrService`, `dsrDelivery`). *(Note: Domestic-only shops not indexed on `world.taobao.com/dianpu/` return 0 items at `$0.00` charged.)* - Need factory-direct B2B wholesale tiers and MOQs on 1688.com? Use our dedicated [1688 Wholesale Factory Scraper](https://apify.com/unitbytes/1688-scraper). #### ๐Ÿ“ˆ 3. Competitor Monitoring & Price Intelligence (`itemUrls`) - Paste cross-border indexed product links into **`itemUrls`** to track live pricing (`CNY`), 3-axis DSR scores, featured reviews, and review volume over time. *(Domestic-only restricted items return `UNAVAILABLE` at `$0.00` charged.)* #### ๐Ÿค– 4. AI Agents, LLM Fine-Tuning & Market Research - Feed clean, flat e-commerce product listings and buyer sentiment data into AI agents, market analysis bots, and recommendation engines via the Apify API or MCP server. *** ### ๐ŸฅŠ Market Comparison: Why UnitBytes Outperforms Alternatives | Capability / Metric | ๐Ÿ›๏ธ UnitBytes Scraper | โš ๏ธ Other Market Scrapers | | :--- | :---: | :---: | | **Search & Shop Catalog Price (per 1,000 items)** | ๐ŸŸข **$1.05 โ€“ $1.50** | ๐Ÿ”ด $3.00 โ€“ $15.98 | | **Direct Product URL Price (per 1,000 items)** | ๐ŸŸข **$3.00 โ€“ $4.00** | ๐Ÿ”ด $5.00 โ€“ $15.98 | | **Free Monthly Allowance ($5 Credit)** | ๐ŸŸข **Up to 3,330+ Products** | ๐Ÿ”ด ~500 items or limited runs | | **Buyer Sentiment Tags & Featured Reviews** | โœ… **Included** | โŒ Missing | | **3-Axis Seller DSR Scores (Desc / Serv / Ship)** | โœ… **Yes (Included)** | โŒ Missing | | **Direct Product URL Scraping (`itemUrls`)** | โœ… **`world.taobao.com` Indexed Items** | โš ๏ธ Often search-only | | **Seller Storefront Catalogs (`shopUrls`)** | โœ… **`world.taobao.com/dianpu` Indexed Shops** | ๐Ÿ”ด Search-only | | **Zero Account / 100% Cookieless** | โœ… **Yes (No cookies needed)** | โš ๏ธ Often requires manual cookies or accounts | | **Permanent Image Links (Shopify Ready)** | โœ… **Yes (Hotlink Unblocked)** | โš ๏ธ Expiring CDN links (403 Forbidden) | | **Zero Duplicate Items Across Views** | โœ… **100% Deduplicated** | โš ๏ธ Repeats items across pages | | **Empty Run / Unavailable Item Fee** | โœ… **$0.00** | โš ๏ธ Charged full compute or run fee | *** ### ๐Ÿ’ก Cost-Effective Pay-Per-Event (PPE) Pricing You only pay for the products you actually extract (1 event per itemโ€”never double-billed). There are no hidden browser compute fees or hourly server surcharges: | Apify Plan Tier | Monthly Apify Fee | Search & Shop Catalog (`search-item`) per 1,000 | Direct Product URL (`full-detail`) per 1,000 | What Apify's $5.00 Free Credit Gets You | | :--- | :---: | :---: | :---: | :--- | | **Free Plan** | **$0 / mo** | **$1.50** ($0.0015 / item) | **$4.00** ($0.0040 / item) | **3,330 Search/Shop** or **1,250 Direct URL** products free/mo | | **Starter (Bronze)** | **$49 / mo** | **$1.35** ($0.00135 / item) | **$3.67** ($0.00367 / item) | Dropshipping catalog exports & daily price monitoring | | **Scale (Silver)** | **$499 / mo** | **$1.20** ($0.00120 / item) | **$3.33** ($0.00333 / item) | Large-scale retail intelligence & review sentiment tracking | | **Business (Gold+)** | **$999+ / mo** | **$1.05** ($0.00105 / item) | **$3.00** ($0.00300 / item) | Enterprise data pipelines & LLM training datasets | - **Zero-Charge Billing Protection**: The startup fee is nominal ($0.00005). If your search keyword returns 0 products or is blocked by target rate limits, you are charged **$0.00**. *** ### โšก UnitBytes ยท Chinese E-Commerce & Global Sourcing Ecosystem
โšก UnitBytes ยท B2B Sourcing, E-Commerce Demand & Global Lead Intelligence Ecosystem
๐Ÿ›๏ธ Taobao & Tmall Products
๐Ÿ“ You are here
Retail catalog, reviews, sentiment tags & 3-axis DSR 		๐Ÿช Taobao & Tmall Seller Shops
Storefront Catalogs (ๆท˜ๅฎๅบ—้“บ)
Full shop inventories, new arrivals & seller DSR audits 		๐ŸŒ 1688 Global & Arbitrage
โœจ English Search & Margins
English search, CE/FCC/RoHS filters, Amazon/TikTok margins & 15 currencies
๐Ÿ‡จ๐Ÿ‡ณ 1688 Factory Direct
Wholesale B2B & MOQ
Direct factory prices, SKU matrices & Amazon FBA specs 		๐Ÿ“ธ 1688 Reverse Image Search
Photo-to-Factory (ไปฅๅ›พๆœๆฌพ)
Upload any product photo or URL to find the exact 1688 factory 		๐ŸŒ Alibaba Wholesale
Global B2B & MOQ
Verified suppliers, inspection audits & tiered pricing
๐ŸŸ Goofish Search & Deals
C2C Resale & Arbitrage
Zero-login ้—ฒ้ฑผ search, price drops & liquidation 		โญ Goofish Sellers & Reviews
Zhima Credit & Store Audits
Active/sold seller catalogs & buyer unboxing photos 		๐Ÿ“ˆ Google Shopping Trends
๐Ÿ”ฅ Breakout Product Demand
Rising e-commerce products, seasonal buying curves & regions
๐Ÿ“Š Google Trends All-in-One
5-Surface Search Intelligence
Web, YouTube, Shopping & News search breakouts from $0.30/1K 		๐Ÿ“ Google Maps Email & Leads
B2B Contacts & Tech Stack
Verified business emails, phone numbers, social links & pixels 		๐Ÿ’ฌ Google Maps Reviews (10K)
Customer Sentiment & ORM
Up to 10,000 reviews per place by newest, rating or keyword
๐Ÿ–ผ๏ธ Google Maps Photos & Menus
4K Place, Menu & Video Feeds
Original =s0 photos, restaurant menus, MP4 videos & Local Guides 		๐Ÿ‡ฐ๐Ÿ‡ท Naver Place & Naver Map
Korean B2B Leads & Menus
South Korean local businesses, KRW menus, hours & reviews 		โญ Naver Place Reviews (๋„ค์ด๋ฒ„)
Korean Receipt & Blog Reviews
Receipt-verified visitor reviews, photo filters & Naver Blog links
*** ### ๐Ÿ“ฅ Input Parameters Guide | Parameter | Type | Default | How to Use It | | :--- | :--- | :--- | :--- | | `queries` | Array of Strings | `["phone case"]` | **Search keywords / product tags (`world.taobao.com/product/{tag}.htm`).** Best with concise Chinese category/product terms (`ๆ‰‹ๆœบๅฃณ`, `่“็‰™่€ณๆœบ`, `ๅฅณ่ฃ…`) or common English product nouns (`phone case`, `smart watch`, `wireless earbuds`). Runs in fast summary mode (`$0.0015`/item) with full 60-character titles. | | `itemUrls` | Array of Strings | `[]` | **Direct product URLs or numeric IDs (`world.taobao.com/item/{id}.htm`).** Accepts `item.taobao.com`, `detail.tmall.com`, or `world.taobao.com` URLs. Extracts public detail fields (`full-detail`, `$0.0040`/item) for **overseas-indexed items**; **domestic-only products** return `status: "UNAVAILABLE"` at **$0.00 charged**. | | `shopUrls` | Array of Strings | `[]` | **Seller / Shop URLs or IDs (`world.taobao.com/dianpu/{shopId}.htm`).** Extracts storefront listings for **overseas-indexed shops** (best with `world.taobao.com/dianpu/63978904.htm`, `shop63978904.taobao.com`, numeric `shopId`, or a cross-border product URL). **Domestic-only shops** return 0 items at **$0.00 charged**. | | `startUrls` | Array of Objects | `[]` | Search, shop storefront, or product URLs copied from your browser. Routed automatically to the matching `world.taobao.com` endpoint. | | `maxItems` | Integer | `30` | Total number of products you want to extract (e.g. 30, 100, 500). | | `startPage` | Integer | `1` | Skips initial result batches (~60 items per offset) across the multi-view scan plan. | | `sortBy` | String | `default` | Primary sort order: `default` (Relevance / Best Sellers), `sales` (Best Sellers), `price_asc` (Lowest Price), `price_desc` (Highest Price). | | `priceMin` | Integer | `None` | Minimum price filter in Chinese Yuan (ยฅ CNY). | | `priceMax` | Integer | `None` | Maximum price filter in Chinese Yuan (ยฅ CNY). | *** ### ๐Ÿ’ป Developer API & Integrations For developers building automated data feeds, integrations, or AI pipelines: #### ๐Ÿ Python Integration ```python from apify_client import ApifyClient ## Initialize client with your Apify API Token client = ApifyClient("YOUR_APIFY_TOKEN") ## Run the actor (Search + Direct Product URLs) run = client.actor("unitbytes/taobao-tmall-scraper").call( run_input={ "queries": ["ๆ‰‹ๆœบๅฃณ", "wireless earbuds"], "itemUrls": ["https://detail.tmall.com/item.htm?id=1085260672042"], "maxItems": 50, "sortBy": "sales", } ) ## Fetch results from dataset dataset_items = client.dataset(run["defaultDatasetId"]).list_items().items print(f"Scraped {len(dataset_items)} products.") for item in dataset_items[:3]: print( f"- {item['title']} (ยฅ{item['price']}) | Reviews: {item.get('reviewCount')} " f"| DSR: {item.get('dsrDescription')}/{item.get('dsrService')}/{item.get('dsrDelivery')} | Shop: {item.get('shopName')}" ) ``` #### ๐ŸŸจ Node.js Integration ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' }); const run = await client.actor('unitbytes/taobao-tmall-scraper').call({ queries: ['ๆ‰‹ๆœบๅฃณ', 'phone case'], maxItems: 50, sortBy: 'sales', }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Scraped ${items.length} products.`); ``` #### ๐Ÿ”Œ MCP Server Setup: Claude Code, Cursor & AI Agents Connect this scraper directly to **Claude Code**, **Claude Desktop**, **Cursor**, or any MCP-compatible AI agent via the hosted Apify MCP server: ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=actors,docs,unitbytes/taobao-tmall-scraper" } } } ``` *** ### โ“ Frequently Asked Questions (FAQ) #### Why did my `item.taobao.com`, `detail.tmall.com`, or `shopXXXX.taobao.com` link return `UNAVAILABLE` or 0 results? Domestic Mainland Taobao (`item.taobao.com`, `detail.tmall.com`, `s.taobao.com`) requires a logged-in Chinese Taobao account and slider CAPTCHA verification. Because this actor is **100% cookieless**, it fetches products and shops via **Taobao Global (`world.taobao.com`)**. If a product or shop is **domestic-only** (not opted into Taobao's overseas cross-border catalog), `world.taobao.com` redirects it to a 404 (`taglist-404`) and the actor exits cleanly with **$0.00 charged**โ€”even if that URL opens when you are logged into domestic Taobao in your browser. #### Why do search results or item counts differ from what I see when logged into domestic `s.taobao.com`? 1. **Cross-Border Subset vs. Domestic Catalog**: `world.taobao.com` only indexes listings eligible for cross-border shipping, which is a subset of the domestic Mainland catalog. 2. **Tag Index vs. Free-Text Search**: `world.taobao.com/product/{keyword}.htm` matches curated category/product tags (e.g. `ๆ‰‹ๆœบๅฃณ`, `่ฟž่กฃ่ฃ™`, `่“็‰™่€ณๆœบ`). Searching a broad product noun works well, whereas pasting a long 60-character product title or obscure model string will often return 0 results. 3. **Multi-View Scanning vs. Sequential Pages**: Each tag page on `world.taobao.com` serves 1 page (~60 items). When `maxItems > 60`, the actor automatically widens coverage by scanning across sort orders (`sales`, `default`, `credit`, `price_asc`, `price_desc`), CNY price bands, and property filters (`pvids`) rather than paginating sequentially through page 2, 3, 4 of a single domestic search query. #### Why are `salesCount`, full SKU inventory tables, or full review histories missing? On public `world.taobao.com` pages without a logged-in domestic account: - **Monthly unit sales (`salesCount`)** are not exposed publicly; use **`reviewCount`** (e.g. `58`, `20000`) and **`sortBy: "sales"`** as public popularity indicators. - **SKU variants & stock counts**: Public `world.taobao.com/item/{id}.htm` pages return `MOST_SIMPLIFIED` payloads (`itemSkuDO: null`, `props: null`) and do not expose the login-gated interactive multi-color/size SKU selector or stock counts. - **Customer reviews (`reviews`)** on direct `itemUrls` lookups include the **1โ€“2 featured reviews** and **crowd-sourced sentiment tag counts (`reviewTags`)** embedded in the public page, not full multi-page historical review pagination. #### Do I need a Taobao account, Alipay, or a Chinese phone number? **No.** The actor operates 100% cookieless against `world.taobao.com`. You never have to register an account, provide cookies, or verify SMS codes. #### Can I search using English keywords, or should I use Chinese keywords? **Short Chinese keywords work best** (e.g. `ๆ‰‹ๆœบๅฃณ`, `่“็‰™่€ณๆœบ`, `ๅฅณ่ฃ…`, `่ฟž่กฃ่ฃ™`, `่ฟๅŠจ้ž‹`) because `world.taobao.com` is indexed in Chinese. Common English product nouns (e.g. `phone case`, `wireless earbuds`, `iphone 16 case`, `smart watch`, `hoodie`, `sneakers`) are automatically mapped to their corresponding Chinese Taobao tags while preserving your original `searchQuery` column. #### What is the difference between `queries` / `shopUrls` and `itemUrls`? - **`queries` & `shopUrls` ($0.0015/item)**: Fetches the `world.taobao.com` search/shop catalog pages (~2 seconds per run). Every item includes the **full 60-character untruncated title**, **CNY & local currency prices (`HKD`, `TWD`)**, **promotion label (`discountType`)**, **`shopId` / `shopName` / `shopUrl` / `taobaoShopUrl`**, **Seller DSR scores**, **`reviewCount`**, **`reviewTags`**, and **up to 5 permanent HD gallery photos (`images`)**. - **`itemUrls` ($0.0040/item)**: Fetches the direct detail pages (`world.taobao.com/item/{id}.htm` + `/lang/en-us/item/{id}.htm`) for specific product links, returning the **full untruncated product title**, **up to 15 HD product & description gallery photos (`images`)**, **3-axis Seller DSR Scores** (`dsrDescription`, `dsrService`, `dsrDelivery`), **1โ€“2 Featured Customer Reviews** (`reviews`), **Shipping Origin** (`location`), and **Category Breadcrumbs** (`categoryPath`). #### What happens if my search, shop, or product URL returns zero results? If a query, shop, or direct item URL is unavailable on `world.taobao.com`, the actor finishes cleanly with exit code 0 and you are charged **$0.00**. *** ### ๐ŸŒ Related Chinese E-Commerce, Wholesale Sourcing & Global Intelligence Actors Combine our specialized Chinese e-commerce, B2B procurement, search demand, and local business lead scrapers: | Actor | Purpose & Superpowers | Pricing | | :--- | :--- | :--- | | [**Taobao & Tmall Product Scraper**](https://apify.com/unitbytes/taobao-tmall-scraper?fpr=939u3w\&fp_sid=ecosystem) *(๐Ÿ“ You are here)* | China's premier retail marketplace: customer reviews, 3-axis DSR scores, buyer sentiment tags & multi-currency prices | From $0.0015 / item | | [**Taobao & Tmall Seller Catalog & Shop Scraper**](https://apify.com/unitbytes/taobao-seller-shop-scraper?fpr=939u3w\&fp_sid=ecosystem) | Extract full Taobao & Tmall seller storefront catalogs (`ๆท˜ๅฎๅบ—้“บ`), shop item counts, new arrivals & 3-axis DSR ratings | From $0.0015 / item | | [**1688 Global Scraper & Arbitrage API (AliTrading)**](https://apify.com/unitbytes/1688-global-scraper?fpr=939u3w\&fp_sid=ecosystem) | English search, CE/FCC/RoHS/UL/CPC certification filters, 24h/48h dropshipping, 15 currencies & 9-market Amazon/TikTok Shop arbitrage leaderboards | From $0.0015 / item | | [**1688 Factory Direct Scraper & Price Monitor**](https://apify.com/unitbytes/1688-scraper?fpr=939u3w\&fp_sid=ecosystem) | Direct manufacturer sourcing, true factory prices, full SKU matrices, stock monitoring & Amazon FBA packaging specs | From $0.0015 / item | | [**1688 Reverse Image Search (Photo-to-Factory)**](https://apify.com/unitbytes/1688-image-search-scraper?fpr=939u3w\&fp_sid=ecosystem) | Visual product search (`ไปฅๅ›พๆœๆฌพ / ๆ‹็ซ‹ๆท˜`): upload any product photo, URL, or Base64 to find the exact 1688 factory | From $0.0015 / item | | [**Alibaba Wholesale Scraper**](https://apify.com/unitbytes/alibaba-scraper?fpr=939u3w\&fp_sid=ecosystem) | Global B2B product catalog, MOQ brackets, volume tiers, FBA carton specs & Verified Supplier audits | From $0.0015 / item | | [**Alibaba Supplier Scraper**](https://apify.com/unitbytes/alibaba-supplier-scraper?fpr=939u3w\&fp_sid=ecosystem) | 1 Row = 1 unique audited manufacturer with factory floor size, annual output & TรœV/SGS verification | From $0.0015 / item | | [**Alibaba Seller Inventory & Store Catalog Scraper**](https://apify.com/unitbytes/alibaba-seller-inventory-scraper?fpr=939u3w\&fp_sid=ecosystem) | Full store catalog pagination, Ready-to-Ship (`rts`) inventory filter, 30d buyer views & 180d sales | From $0.0015 / item | | [**Goofish / Xianyu Fast Search & Deals Scraper**](https://apify.com/unitbytes/goofish-xianyu-search-scraper?fpr=939u3w\&fp_sid=ecosystem) | Alibaba's C2C resale market (`้—ฒ้ฑผ`): liquidation deals, seller price-drop sniping & secondhand arbitrage | From $0.0015 / item | | [**Goofish / Xianyu Sellers, Inventory & Reviews Scraper**](https://apify.com/unitbytes/goofish-scraper?fpr=939u3w\&fp_sid=ecosystem) | Merchant due diligence, Zhima Credit (`่Š้บปไฟก็”จ`) ratings, active/sold store catalogs & buyer unboxing photos | From $0.001 / item | | [**Google Shopping Trends Scraper**](https://apify.com/unitbytes/google-shopping-trends-scraper?fpr=939u3w\&fp_sid=ecosystem) | Breakout physical merchandise demand (`froogle`), seasonal buying curves & top shopper regions | From $0.30 / 1K | | [**Google Trends Scraper & Data API (All-in-One)**](https://apify.com/unitbytes/google-trends-scraper?fpr=939u3w\&fp_sid=ecosystem) | All 5 endpoints (`interest_over_time`, `trending_now`, `interest_by_region`, `related_queries`, `related_topics`) across 5 Google properties | From $0.30 / 1K | | [**Google Maps Email & Leads Scraper (B2B Contacts)**](https://apify.com/unitbytes/google-maps-leads-scraper?fpr=939u3w\&fp_sid=ecosystem) | Extract B2B business leads with verified website emails, phone numbers, social links, tech stack & ad pixels | From $0.50 / 1K | | [**Google Maps Reviews Scraper (All 10K Reviews)**](https://apify.com/unitbytes/google-maps-reviews-scraper?fpr=939u3w\&fp_sid=ecosystem) | Extract up to 10,000 reviews per place sorted by newest/lowest rating, server-side keyword filter & policy report links | From $0.25 / 1K | | [**Google Maps Photos Scraper (Places, Menus & Local Guides)**](https://apify.com/unitbytes/google-maps-photos-scraper?fpr=939u3w\&fp_sid=ecosystem) | Original `=s0` full-resolution place & menu photos, playable MP4 videos, 360ยฐ & Local Guide photo feeds | Pay-Per-Event | | [**Naver Place & Map Scraper (๋„ค์ด๋ฒ„ ํ”Œ๋ ˆ์ด์Šคยท์ง€๋„)**](https://apify.com/unitbytes/naver-place-scraper?fpr=939u3w\&fp_sid=ecosystem) | South Korean local business leads, KRW menus, 7-day hours, `0507` SmartCall phones, GPS & visitor/blog reviews | From $1.00 / 1K | | [**Naver Place Reviews Scraper (๋„ค์ด๋ฒ„ ํ”Œ๋ ˆ์ด์Šค ๋ฆฌ๋ทฐ)**](https://apify.com/unitbytes/naver-place-reviews-scraper?fpr=939u3w\&fp_sid=ecosystem) | Receipt-verified Korean visitor reviews, server-side photo review filter, sentiment keywords & linked Naver Blog reviews | From $0.50 / 1K | | [**Naver Map Scraper: Korean Leads & Menus (๋„ค์ด๋ฒ„ ์ง€๋„)**](https://apify.com/unitbytes/naver-map-scraper?fpr=939u3w\&fp_sid=ecosystem) | Korean B2B business discovery, road addresses, subway directions, amenities & full menu pricing | From $1.00 / 1K | *** ### โš–๏ธ Compliance & Privacy This actor extracts **strictly publicly available e-commerce catalog data** from Taobao and Tmall product pages. It does not log in, bypass private authentication walls, or collect private user messages. Personal data is protected by regulations such as GDPR and CCPAโ€”see Apify's guide on [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/) and ensure you have a legitimate basis when processing public marketplace data. #### Disclaimer This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Alibaba Group, Taobao, Tmall, or any of their subsidiaries. *** ### ๐Ÿ” Search Keywords & Tags `taobao-scraper` โ€ข `tmall-scraper` โ€ข `taobao-product-details` โ€ข `taobao-reviews-scraper` โ€ข `tmall-reviews-scraper` โ€ข `taobao-api` โ€ข `tmall-api` โ€ข `taobao-dropshipping` โ€ข `taobao-product-scraper` โ€ข `taobao-sku-scraper` โ€ข `taobao-url-scraper` โ€ข `taobao-dsr-ratings` โ€ข `taobao-to-shopify` โ€ข `taobao-to-excel` โ€ข `china-sourcing` โ€ข `1688-alternative` โ€ข `alibaba-alternative` โ€ข `scrape-taobao` โ€ข `scrape-tmall` โ€ข `taobao-pricing` โ€ข `taobao็ˆฌ่™ซ` โ€ข `ๅคฉ็Œซ็ˆฌ่™ซ` โ€ข `ๆท˜ๅฎๅ•†ๅ“่ฏฆๆƒ…้‡‡้›†` โ€ข `ๆท˜ๅฎ่ฏ„่ฎบ้‡‡้›†` โ€ข `ๆท˜ๅฎๆ•ฐๆฎ้‡‡้›†` โ€ข `ๅคฉ็Œซๆ•ฐๆฎ้‡‡้›†` โ€ข `taobao-seller-ratings` โ€ข `pay-per-event` # Actor input Schema ## `queries` (type: `array`): Product keywords to search on Taobao Global (world.taobao.com), which lists Taobao & Tmall products sold cross-border. Supports Chinese product/category terms (e.g. 'ๆ‰‹ๆœบๅฃณ', '่“็‰™่€ณๆœบ', '่ฟž่กฃ่ฃ™', '็›ฒ็›’') or English product & brand terms ('phone case', 'wireless earbuds', 'xiaomi power bank', 'anime figure' - auto-resolved to Chinese Taobao tags). $0.0015/item ($0.00 charged on 0 results). ## `shopUrls` (type: `array`): Seller shops to scrape from Taobao Global (world.taobao.com/dianpu/{shopId}.htm). Most reliable: numeric shop ID ('63978904'), https://shop63978904.taobao.com, https://world.taobao.com/dianpu/63978904.htm, or a world.taobao.com/item/{itemIdStr}.htm product URL from that shop. Brand handles ('inman', 'https://sanfu.tmall.com') are resolved via search for indexed brands. Domestic-only shops return 0 products at $0.00 charged. ## `itemUrls` (type: `array`): Taobao Global product URLs (e.g. https://world.taobao.com/item/Y1QrcEVrd3JLNWVjWno4SDJBVHByZz09.htm) or Taobao/Tmall mobile app share links & clipboard text (e.g. 'ใ€ๆท˜ๅฎใ€‘https://e.tb.cn/h.xxx ใ€Œๅ•†ๅ“ๆ ‡้ข˜ใ€'). Products are read from Taobao Global (world.taobao.com/item/{itemIdStr}.htm). Mobile share links with titles are unwrapped and matched by exact itemId on Taobao Global; bare numeric item.taobao.com/detail.tmall.com links without titles and Mainland domestic-only listings return status 'UNAVAILABLE' at $0.00 charged. ## `startUrls` (type: `array`): Paste Taobao, Tmall, World Taobao, or e.tb.cn/m.tb.cn share URLs directly (search listings, shop storefronts like world.taobao.com/dianpu/... or shopXXXX.taobao.com, world.taobao.com/product/... keyword pages, or direct product item URLs). Routed automatically to the matching catalog engine. ## `maxItems` (type: `integer`): Maximum number of products to scrape (1 to 10,000). ## `maxItemsPerSeller` (type: `integer`): Optional cap on how many products to extract per seller when scraping multiple shops in shopUrls. ## `startPage` (type: `integer`): Page number to start scraping from (e.g. 1, 2, 5). Allows paginating through large catalogs without tokens. ## `sortBy` (type: `string`): Sorting order for product search results. ## `priceMin` (type: `integer`): Minimum unit price in Chinese Yuan (CNY ยฅ). ## `priceMax` (type: `integer`): Maximum unit price in Chinese Yuan (CNY ยฅ). ## `resumptionToken` (type: `string`): Optional encrypted resumption token copied from a previous run or dataset item. Restores session and cursor to continue scraping seamlessly with zero duplicates. ## `proxyConfiguration` (type: `object`): Proxy settings. Automatically uses Apify Residential proxies on cloud runs to prevent rate limits. ## Actor input object example ```json { "queries": [ "phone case" ], "maxItems": 30, "startPage": 1, "sortBy": "default", "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `results` (type: `string`): Extracted Taobao and Tmall products, seller 3-axis DSR scores, customer reviews, sentiment tags, prices (CNY/HKD/TWD), and shop intelligence # 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 = { "queries": [ "phone case" ], "maxItems": 30, "startPage": 1 }; // Run the Actor and wait for it to finish const run = await client.actor("unitbytes/taobao-tmall-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 = { "queries": ["phone case"], "maxItems": 30, "startPage": 1, } # Run the Actor and wait for it to finish run = client.actor("unitbytes/taobao-tmall-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "queries": [ "phone case" ], "maxItems": 30, "startPage": 1 }' | apify call unitbytes/taobao-tmall-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,unitbytes/taobao-tmall-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/deplqV6g1hYjwrETX/builds/rliOUGaYlzwK4VxZb/openapi.json