Taobao Tmall Search Products With Filters
Search Taobao and Tmall products using a required keyword. Optionally choose a page (default 1), restrict results to Tmall (off by default), or set inclusive minimum and maximum prices as strings. Sorting supports sales volume (_sale, default), price high to low (_bid), price low to high (bid), and general sorting (_coefp). Returns search-result data together with a status code, message, and record time. The fields within the result data are not specified; available product information depends on the returned response.
Pricing
| Condition | Charge |
|---|---|
| Each call | 26.19 credits/call |
A fixed charge of 26.19 credits applies per call.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | 用于分页的页码。 | 1 |
sort | enum (_sale | _bid | bid | _coefp) | No | 淘宝搜索商品列表排序选项 | _sale |
tmall | boolean | No | 是否将结果筛选为仅天猫商品。 | false |
keyword | string | Yes | 搜索关键词。 | — |
endPrice | string | No | 最高价格筛选(包含)。 | — |
startPrice | string | No | 最低价格筛选(包含)。 | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_taobao_tmall_search_products_with_filters' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"keyword": "双眼皮贴",
"page": 1,
"sort": "bid"
}
}'{
"code": 0,
"data": {
"code": "SUCCESS",
"extraMap": {
"MtopCostMillis": 92
},
"model": {
"brandList": [
{
"brandId": 708308673,
"brandName": "健美创研",
"count": 36
}
],
"costMillis": 92,
"extraMap": {
"Endpoint": "taobao_item",
"EndpointHost": "[REDACTED]",
"WorldsearchIP": "[REDACTED]",
"WorldsearchName": "[REDACTED]",
"afterSearchCostMillis": 1,
"sp_status": "OK"
},
"itemList": [],
"page": {
"nextNo": 2,
"pageNo": 1,
"pageSize": 10,
"prevNo": 1,
"showBegin": 1,
"showEnd": 3
},
"success": true
}
},
"message": null,
"recordTime": "2026-11-12T11:44:24.667130544",
"requestParams": {
"body": null,
"query": {
"keyword": "双眼皮贴",
"page": "1",
"sort": "bid",
"tmall": "false"
}
}
}This example shows part of the response. Copied content is valid JSON.



