Taobao Tmall Search Products With Filters
26.19积分/次
ae_taobao_tmall_search_products_with_filters
按必填关键词搜索淘宝和天猫商品,用于商品发现与初步筛选。可选页码(默认第 1 页)、仅天猫筛选(默认关闭),以及用字符串填写的最低价和最高价(均包含边界)。排序支持销量(_sale,默认)、价格从高到低(_bid)、价格从低到高(bid)和通用排序(_coefp)。返回包含搜索结果数据、状态码、消息和记录时间的响应;结果数据内部字段未作明确约定,具体商品信息以实际返回为准,并需结合状态码和消息判断查询结果。
26.19积分/次
价格说明
26.19积分/次
| 条件 | 费用 |
|---|---|
| 每次调用 | 26.19积分/次 |
每次调用固定收取 26.19 积分。
工具参数
未传入的可选参数将使用平台默认值。
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
page | integer | 否 | 用于分页的页码。 | 1 |
sort | enum (_sale | _bid | bid | _coefp) | 否 | 淘宝搜索商品列表排序选项 | _sale |
tmall | boolean | 否 | 是否将结果筛选为仅天猫商品。 | false |
keyword | string | 是 | 搜索关键词。 | — |
endPrice | string | 否 | 最高价格筛选(包含)。 | — |
startPrice | string | 否 | 最低价格筛选(包含)。 | — |
调用示例
复制请求代码,查看对应的返回示例。
POST
/agent-api/v1/tool/executeX-Api-Key请求代码request.sh
curl --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"
}
}'返回示例response.json
{
"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"
}
}
}返回示例仅展示部分内容,不代表完整响应;复制内容为合法 JSON。



