Taobao & Tmall API: product search, SKUs, reviews, stores
4 Taobao & Tmall endpoints covering products and shops, from $0.033 a call. No Taobao & Tmall account or cookie needed.
Connect your AI
Paste this into your agent
Read https://okdata.online/agents.md and set up okdata for me; my key is in the OKDATA_API_KEY environment variable.
Claude Code, Cursor, Codex and other agents that can open a link set themselves up from it.
MCP serverhttps://api.okdata.online/mcp
Ask about Taobao & Tmall from Claude, Cursor and other agents: the Taobao & Tmall MCP page
- Endpoints
- 4 endpoints
- In 2 groups, one response format
- Lowest price
- From $0.033
- A call, paid from a prepaid balance
- Freshness
- Live
- Read from the platform when you call
- Monthly fee
- $0
- No subscription or minimum spend
Every Taobao & Tmall endpoint
One row per endpoint: the request, what comes back and what one call costs.
Products
3Shops
1Prices are per call unless marked /item. A call that reached the data source is charged even when it comes back empty or fails.
What people do with Taobao & Tmall data
Each job has its own page with the endpoints it takes, a worked run and its cost.
Product research
“What do the best sellers cost, and what do buyers complain about?”
- Product search$0.043
- Product details$0.033
- Product reviews$0.043
4 endpoints here, from $0.033How it works
Competitor monitoring
“What did our competitors post this week, and what took off?”
- Product search$0.043
- Product details$0.033
- Shop products$0.043
3 endpoints here, from $0.033How it works
Word of mouth
“What do buyers complain about most?”
- Product reviews$0.043
1 endpoint here, from $0.043How it works
Start in three steps
The example is Taobao product search; every Taobao & Tmall endpoint is called the same way and answers in the same shape.
Get a key
Create an account and a key in the console. A new key comes with $0.10 to try, no card.
Connect your AI, or call it yourself
Paste this sentence into Claude Code, Cursor, Codex or another agent that can open a link, and it sets itself up. Or send the request below with your key in the Authorization header.
Set up okdata for me by following https://okdata.online/agents.md. Here is my okdata API key: okd_…. Keep it safe and use it for all okdata calls.
Swap the placeholder for your own key, or sign in and copy it with the key filled in.
Make the first call
Items arrive in data.items (one object in data.item), the next page in page.next_cursor and what you were charged in meta.billing.amount.
cURL
curl -G "https://api.okdata.online/v1/taobao/products/search" \ -H "Authorization: Bearer $OKDATA_API_KEY" \ --data-urlencode 'query=咖啡磨豆机'Python
import os import requests resp = requests.get( "https://api.okdata.online/v1/taobao/products/search", headers={"Authorization": f"Bearer {os.environ['OKDATA_API_KEY']}"}, params={"query": "咖啡磨豆机"}, timeout=60, ) body = resp.json() if body["code"] != "ok": raise RuntimeError(f"{body['code']}: {body['message']} (charged: {body['charged']})") for row in body["data"]["items"]: print(row["price"], row["currency"], row["sold"], row["title"][:60]) print("cost: $" + body["meta"]["billing"]["amount"])TypeScript
const url = new URL('https://api.okdata.online/v1/taobao/products/search'); url.searchParams.set('query', "咖啡磨豆机"); const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.OKDATA_API_KEY}`, }, }); const body = await res.json(); if (body.code !== 'ok') throw new Error(`${body.code}: ${body.message}`); for (const row of body.data.items) { console.log(row.price, row.currency, row.sold, row.title.slice(0, 60)); } console.log('cost: $' + body.meta.billing.amount);MCPtools/call
{ "name": "call", "arguments": { "capability": "taobao.products.search", "query": "咖啡磨豆机" } }
Questions about the Taobao & Tmall API
What does the Taobao & Tmall API cost?
Each of the 4 endpoints has its own price, from $0.033 to $0.043 a call; the cheapest is Taobao product details at $0.033. You pay per call from a prepaid balance, with no subscription. A call that reaches the data source is charged even when it comes back empty, not found or failed; one stopped before that, such as for bad parameters, is free.
Do I need a Taobao & Tmall account or cookie?
No. You call https://api.okdata.online with one okdata key and get public Taobao & Tmall data back; no Taobao & Tmall account, cookie or QR login is involved.
How fresh is the data?
Every endpoint reads Taobao & Tmall at the moment you call; nothing is served from an old copy.
Can my AI agent use the Taobao & Tmall API?
Yes. Connect the MCP server at https://api.okdata.online/mcp: its find tool lists these 4 endpoints with their prices, and its call tool runs them on your key.
Can I try it for free?
New accounts get $0.10 of trial credit with no card: enough for 3 calls to Taobao product details.
