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 积分。

工具参数

未传入的可选参数将使用平台默认值。

参数类型必填说明默认值
pageinteger否用于分页的页码。1
sortenum (_sale | _bid | bid | _coefp)否淘宝搜索商品列表排序选项_sale
tmallboolean否是否将结果筛选为仅天猫商品。false
keywordstring是搜索关键词。—
endPricestring否最高价格筛选(包含)。—
startPricestring否最低价格筛选(包含)。—

调用示例

复制请求代码,查看对应的返回示例。

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
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。