Taobao Tmall Search Scraper
Pricing
from $1.60 / 1,000 taobao/tmall product scrapeds
Taobao Tmall Search Scraper
Search public Taobao and Tmall listings by keyword or world.taobao.com product or category URL. Each product row has item ID, title, CNY price, shop, Tmall flag, image and URL from the crawlable overseas catalogue.
Pricing
from $1.60 / 1,000 taobao/tmall product scrapeds
Rating
0.0
(0)
Developer
Khadin Akbar
Maintained by CommunityActor stats
0
Bookmarked
29
Total users
8
Monthly active users
7 days ago
Last modified
Categories
Features
Share
What is Taobao Tmall Search Scraper — Product Listings, Prices & Shops?
Type a keyword, get one dataset row per Taobao or Tmall product: item ID, title, price in yuan (plus USD, EUR and GBP), shop, Tmall flag, image and item link. It reads the public overseas catalogue over plain HTTP, so there is no login, no browser and no cookies to manage. Turn on Go deeper and one keyword can return 100 or more unique products instead of one page of 20 (in our tests: 100 to 150 on most keywords, fewer when a keyword has a small catalogue).
You pay per unique product saved. The price per product gets lower on higher Apify plans, so check the Pricing tab. Pages that are blocked or empty cost you nothing.
Taobao and Tmall are trademarks of their respective owners. This independent Actor is not affiliated, associated, or endorsed by Alibaba Group, Taobao, or Tmall.
What's new
- More results per keyword.
expandSortsnow goes through every sort order and then the top categories for the keyword, so one keyword can return 100 to 150 unique products, not about 40. - Prices in your currency. Rows carry
priceUsd,priceEur,priceGbp(and JPY, KRW, SGD, MYR, AED on request) from a daily rate table, plus the date of that table. - Fewer failed runs. The Actor starts on datacenter IPs and retries on residential IPs only when Taobao blocks a page, with a hard limit of 3 paid retries per page.
- Faster big jobs. Keywords run four at a time, and a run that hits the time limit ends as
PARTIALwith the rows it already saved, not as a timeout. - New fields.
discountPct,sellingPoint,buyerTags,categoryRootId, and anagentSummaryin the run output for AI agents.
Best fit for this Actor
- Product researchers who start with a keyword such as
iphoneor机械键盘and want listing cards with price and shop. - Sourcing and price-comparison teams who keep Tmall storefronts with
tmallOnly, or filter a price range. - AI agents that call a bounded search tool through Apify MCP and read the dataset plus
OUTPUT.
What it does not return: sales counts, shop ratings, SKU variants, stock or reviews. Those live on item pages that Taobao does not serve openly. For one product or one shop, use our Taobao Product Detail Scraper or Taobao Seller Catalog Scraper. For B2B supply, try Alibaba Listings Scraper; for retail price baselines, AliExpress Product Search Scraper.
Practical scenario
A merchandiser checks iPhone prices before a sourcing call. They run searchQueries: ["iphone"] with expandSorts: true and maxResults: 100, filter tmallOnly, and export CSV with priceCny, priceUsd, shopName and url. Duplicates are dropped by item ID, so every row is a different product.
Input
| Field | Type | What it controls |
|---|---|---|
searchQueries | array | Keywords, one per query. Chinese keywords usually match more of the catalogue. Prefill: iphone. |
startUrls | array | Optional world.taobao.com /product/{keyword}.htm or /category/{id}.htm pages. |
maxResults | integer | Hard cap on billed rows across the whole run. Prefill 3, default 40, maximum 2000. |
sortBy | enum | sales, relevance, credit, priceAsc, or priceDesc. |
tmallOnly | boolean | Keep only listings marked as Tmall. |
minPrice / maxPrice | number | Yuan bounds applied after extraction. |
expandSorts | boolean | Go deeper: every sort order, then the top categories. 100 to 150 unique products per keyword in our tests. |
currencies | array | Extra price currencies: USD, EUR, GBP, JPY, KRW, SGD, MYR, AED. Default USD, EUR, GBP. |
proxyConfiguration | object | Leave the default. |
Quick start input
{"searchQueries": ["iphone"],"maxResults": 3,"sortBy": "sales"}
Go-deeper input
{"searchQueries": ["iphone", "机械键盘"],"maxResults": 200,"expandSorts": true,"tmallOnly": false,"currencies": ["USD", "EUR"]}
What data you receive
One record is one public catalogue card. Download as JSON, CSV, Excel or HTML.
| Field | Description |
|---|---|
itemId | Numeric item identifier |
title | Listing title |
priceCny / priceOriginalCny / discountPct | Displayed yuan price, original price, percent off when shown |
priceUsd, priceEur, priceGbp, … / fxRatesDate | Converted prices and the date of the rate table |
priceHkd / priceTwd | Hong Kong and Taiwan dollar prices from the card |
isTmall / platform | Tmall badge from the public title or shop |
shopName / shopUrl / shopId | Storefront on the card |
sellingPoint / buyerTags | Selling-point text and buyer comment tags when the card shows them |
categoryId / categoryRootId | Taobao category of the card |
imageUrl / images | Primary image and gallery |
url / taobaoUrl | world.taobao.com item link and item.taobao.com link |
searchQuery / sortBy / position | Where the row came from |
scrapedAt | ISO 8601 collection time |
Illustrative output record
{"itemId": "974671890820","title": "Apple iPhone 17","url": "https://world.taobao.com/item/abcItemSlug.htm","taobaoUrl": "https://item.taobao.com/item.htm?id=974671890820","platform": "tmall","isTmall": true,"priceCny": 5999,"priceOriginalCny": 5999,"priceUsd": 899.85,"priceEur": 780.0,"priceGbp": 676.6,"fxRatesDate": "2026-11-14","discountPct": null,"shopName": "Example Tmall Store","categoryId": "1512","imageUrl": "https://img.alicdn.com/imgextra/example.jpg","searchQuery": "iphone","sortBy": "sales","position": 1,"scrapedAt": "2026-11-14T10:00:00.000Z"}
Pricing
Billing is Pay per event. Platform usage is covered by the Actor owner. The Pricing tab shows the live price per product for your plan; higher plans pay less per product.
| Event | When it fires |
|---|---|
| Actor start | Once per run, tiny fixed fee |
| Product scraped | Each unique, validated listing saved to the dataset |
Duplicates, rows dropped by tmallOnly, minPrice or maxPrice, and blocked or empty pages are not billed. maxResults is your cost ceiling: the run stops as soon as it has saved that many products, and maxTotalChargeUsd also stops it.
Use through the API
curl "https://api.apify.com/v2/acts/khadinakbar~taobao-tmall-search-scraper/runs" \-H "Authorization: Bearer $APIFY_TOKEN" \-H "Content-Type: application/json" \-d '{"searchQueries":["iphone"],"maxResults":100,"expandSorts":true}'
Read the default dataset items after the run reaches a terminal status.
Use with AI agents through Apify MCP
Search public Taobao and Tmall listings for the keyword iphone, go deep, keep at most 100 unique products, return title, CNY and USD price, shop, Tmall flag, and item URL, then report the outcome.
Read OUTPUT first: it holds the outcome and an agentSummary with results per keyword, sort orders and categories used, blocked pages, and stop reason. Keep source URLs as provenance and use maxResults as the cost control. Connect through Apify MCP for the current client setup.
Best results and workflow guidance
- Start with a specific keyword and a small
maxResults, then raise it once the rows look right. - Use Chinese keywords for mainland-style coverage.
- Use
expandSortswhen you need depth; each extra page returns about 20 products, and overlap is removed for you. - Turn on
tmallOnlyfor official-storefront comparison. - Pass item URLs to a product-detail Actor when you need specs beyond the listing card.
Empty matches finish as a completed empty dataset. If Taobao keeps blocking every page, the run ends as failed and charges only the start fee.
FAQ
What input does it need?
One or more keywords in searchQueries, for example iphone or 机械键盘. You can add world.taobao.com /product/ or /category/ pages in startUrls. Product-detail URLs are ignored, because this Actor only runs searches.
How many products can one keyword return?
About 20 per catalogue page. With expandSorts on, the Actor reads every sort order and the top categories for the keyword and removes duplicates, which gave 100 to 150 unique products per keyword in our tests. The real number depends on the keyword and on the route Taobao serves that day, so treat it as a typical result, not a guarantee.
Why is there no sales count, rating or reviews column?
The public catalogue card does not carry them, and the item pages that do are not served openly. We would rather leave the column out than guess.
What do the extra currencies mean?
They are your yuan price converted at a daily rate table, with the table date in fxRatesDate. If the rate table is unavailable that day, those fields are empty and the run says so in its warnings.
What does it cost?
A tiny start fee per run, plus one charge per unique product saved. The per-product price depends on your plan and is on the Pricing tab. maxResults caps the number of billed rows.
What happens with no matches or blocked pages?
No matches: the run finishes as a completed empty dataset with no product charges. Blocked pages: the Actor retries (datacenter first, then at most 3 residential retries per page), and if it still cannot read a page it says so in the run summary and moves on. A run that saved some rows ends as PARTIAL.
Is it legal to scrape Taobao?
It reads public catalogue pages only, with no login. Rules differ by country and by use, so check applicable laws and the site terms before you rely on the data.
Responsible use
Use this Actor only on public catalogue pages you are authorized to access, and in line with applicable laws and the site terms of service. Keep personal data out of the workflow unless you have a lawful basis. It is provided for legitimate product research, price monitoring, and sourcing.