Taobao / Tmall · Search APIs
Taobao Keyword Search
Search the Taobao marketplace by keyword. Supports sorting by sales, price and credit, price-range filters and pagination — the same result set a buyer sees in the app, as structured JSON.
$0.0030/call · 100 free 450ms avg 99.9% uptime
GEThttp://localhost:8001/v1/taobao/search
Go to Dashboard → API Keys to get your API key. Send it on every request as Authorization: Bearer <key> — see the examples below.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| q | string | required | Search keyword (Chinese or English) |
| page | number | optional | Page number, default 1 |
| sort | string | optional | default | sales | price_asc | price_desc |
| price_min | number | optional | Minimum price filter (CNY) |
| price_max | number | optional | Maximum price filter (CNY) |
Request example
curl "http://localhost:8001/v1/taobao/search?q=wireless%20earbuds" \
-H "Authorization: Bearer YOUR_API_KEY"Response example
Switch tabs to see the error envelope for each status code. Non-200 responses are never charged.
{
"success": true,
"data": {
"total": 48210,
"page": 1,
"items": [
{
"item_id": "675432198765",
"title": "Wireless Earbuds ANC Pro",
"price": 89,
"sales": 12000,
"shop": "TechAudio Store"
}
]
},
"error": null
}Try Taobao Keyword Search with Orlabia Tech
100 free calls included with every new account.