Taobao and Tmall API
Search Taobao and Tmall (淘宝/天猫) products by keyword and get price, discount price, sales count, shop name and ID, shop ratings, seller level, ship-from location, stock and images. Filter by price range or Tmall only. No login or cookies needed. Export to JSON, CSV or Excel.
Taobao and Tmall API in one table
| Official public API for people outside China | No. This tool collects the publicly visible data instead. |
|---|---|
| What you send | A keyword, a link or an ID, depending on the request type |
| What you get back | JSON rows with English field names; 5 request types |
| Login, cookies, Chinese phone number | None needed |
| Output formats | JSON, CSV, Excel, or the Apify API |
| Price | $0.008 per result on the Bronze tier, no subscription |
| Last verified with a real run | 2026-11-09 |
5 kinds of Taobao and Tmall request
Taobao (淘宝) is a large Chinese online marketplace run by Alibaba, where many independent shops sell to consumers. Tmall (天猫) is its sister platform for brand and official stores, and Tmall products also appear in Taobao search results. This Actor works on the Taobao search results page, so it covers both regular Taobao shops and Tmall stores.
- Search products by keyword
- Questions and answers of items (问大家)
- Products of shops
- Buyer reviews of items
- Products of shops by seller ID and shop ID (60 per request)
A real run, 27 fields per record
Run on 2026-10-27 with input {"keywords": ["phone case"], "maxResults": 3, "mode": "search"}. Personal fields of ordinary users are masked here.
| title | searchKeyword | shopName | salesText | descriptionRating | price |
|---|---|---|---|---|---|
| 影视飓风 PAN'S适用苹果iPhone18/17Pro&ProMax Luna Case新款光层手机壳防摔防刮... | phone case | 影视飓风官方旗舰店 | 1000+ | 4.88 | 109 |
| [壳膜套装]图拉斯Q3soft支点壳iPhone Duo适用苹果iPhoneduo手机壳折叠屏多case磁吸全包d... | phone case | 图拉斯旗舰店 | 1000+ | 4.84 | 916 |
All 27 fields in one record
typeproductitemId1022020209623urlhttps://item.taobao.com/item.htm?id=1022020209623searchKeywordphone casetitle影视飓风 PAN'S适用苹果iPhone18/17Pro&ProMax Luna Case新款光层手机壳防摔防刮...titleEnsubtitleprice109discountPrice109discountType优惠价salesText1000+salesCount1000commentCountisTmallshopId2220916989365shopName影视飓风官方旗舰店sellerLevel14sellerPositiveRate100descriptionRating4.88serviceRating4.91shippingRating4.92itemLocation浙江 杭州sellerLocationstock2496imageUrlhttps://img.alicdn.com/imgextra/i4/2220916989365/O1CN01M2...imageUrlsspuId8837741147
Call the Taobao and Tmall API
Every run is one HTTP call: send the input as JSON, get the rows back. The same works from Make, Zapier or n8n.
Pay per result
Bronze tier prices from the tool's listing; higher Apify tiers pay less. Free Apify users get two trial runs with their own input.
Full price table and worked examples
The Actor uses pay-per-event pricing. These are the charge events:
| Event | Price (USD) | When it is charged |
|---|---|---|
run-start |
$0.03 | Once per run, charged when the first request succeeds, even if that request returns nothing. It is not charged when the run fails from the start, or when your spending limit cannot cover it. Each further keyword, item or shop the run actually reaches pays one more start fee. That fee is charged before its first request and is kept even if it then fails or returns nothing. A later keyword, item or shop is only reached when the earlier ones did not fill maxResults. |
result |
$0.008 | For each record returned: a product (search, shop and shopProducts modes) or a question (questions mode). |
review |
$0.0045 | For each review returned (reviews mode). |
In shopProducts mode every shop pays two start fees ($0.06), because a shop request costs more. A shop's next page of 60 is only requested when the shop's fees and products already cover it. A shop request that was sent but got no answer is not repeated and the shop ends there; its two start fees are still charged, because the request may have been processed.
Worked examples:
- 100 products from one keyword cost $0.03 + 100 × $0.008 = $0.83.
-
100 products from two keywords, when the first keyword returns fewer than 100 and the run moves on to the second, cost 2 × $0.03 + 100 × $0.008 = $0.86. If the first keyword already returns 100 products, the second keyword is not searched and the run costs $0.83.
-
100 questions from one item cost $0.03 + 100 × $0.008 = $0.83. An item with fewer than 100 questions costs less, because only the questions returned are charged.
- 100 reviews of one item cost $0.03 + 100 × $0.0045 = $0.48. Reviews come 20 to a page, newest first; the run stops at the end of the item's reviews or when
maxResultsis reached. An item that returns no reviews at all still costs its start fee, and the next item still runs. - 100 products from one shop cost $0.03 + 100 × $0.008 = $0.83. Two shops that together fill 100 products cost $0.06 + 100 × $0.008 = $0.86.
- 100 products from one shop in
shopProductsmode cost 2 × $0.03 + 100 × $0.008 = $0.86; each further shop adds $0.06.
You never pay for more than maxResults items, and you are never charged for items that were not delivered. The run stops by itself if your spending limit is reached.
On the free Apify plan you get 2 free trial runs of this Actor with your own input, up to 10 results each, and nothing is charged; after that, runs return a stored sample dataset (a real result of the prefilled input). Use any paid Apify plan for full runs.
Taobao and Tmall API questions
Do I need a Taobao account, cookies or an API key?
No. No Taobao account, API keys, proxies or cookies are needed. You only need an Apify account to run the Actor.
Is this the official Taobao API?
No. This Actor is not affiliated with Taobao or Tmall. It is an independent tool that collects public search-result data and returns it as structured JSON, so you can use it as an alternative to building your own Taobao product search integration.
Is it legal to scrape Taobao?
The Actor only returns public listing data that anyone can see on a Taobao search page. It does not return buyer data, private shop data, phone numbers or messages. You are responsible for how you use the data and for following the laws and rules that apply to you.
How fresh is the data?
The data is collected live during each run. Prices, sales counts and stock are what Taobao shows at the time of the run.
Why are some fields empty?
Taobao search results do not include every field for every product, and a shop listing carries fewer fields than a search result. `commentCount` and `titleEn` are empty in search results, `subtitle` and `sellerLocation` are empty for many products, and `discountType` is `null` when there is no promotion.
Can I get SKUs or full product details?
Not yet. The Actor returns keyword search results, the questions and buyer reviews under items and the products of shops, with the fields listed above. The full SKU list and full product details are not included; each review does name the variant that buyer bought (`sku`).