AliExpress Search Products

17.46积分/次
ae_aliexpress_search_products

搜索电商市场商品,适用于商品发现、商品目录研究和市场品类分析。所有输入均为可选:可提供查询词 q、类别 ID catId、品牌 ID brandId、位置筛选 loc、商品属性筛选 attr,以及可选结果特性开关 switches。page 为字符串形式的页码,从 1 开始;sort 可选 default(默认顺序)、salesDesc(销量从高到低)、priceAsc(价格从低到高)或 priceDesc(价格从高到低),默认值为 default。startPrice 和 endPrice 为数值类型的价格上下限,均包含边界值;locale、region 和 currency 分别控制响应语言环境、市场地区和价格货币。返回内容包括搜索数据 data、响应码 code、响应消息 message 和记录时间 recordTime。data 内的具体商品字段及分页信息未作约定,应结合实际返回内容和响应消息理解结果;筛选 ID、属性及开关等取值格式未在接口中明确说明。

效率工具
17.46积分/次

价格说明

17.46积分/次
条件费用
每次调用17.46积分/次

工具参数

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

参数类型必填说明默认值
qstring否商品搜索查询词。—
locstring否商品搜索结果的位置筛选条件。—
attrstring否搜索结果的商品属性筛选条件。—
pagestring否分页使用的从 1 开始的页码。—
sortenum (default | salesDesc | priceAsc | priceDesc)否AliExpress 商品搜索排序方式default
catIdstring否用于筛选商品搜索结果的类别 ID。—
localestring否用于 AliExpress 响应的语言环境。—
regionstring否AliExpress 市场地区。—
brandIdstring否用于筛选商品搜索结果的品牌 ID。—
currencystring否用于商品价格的货币代码。—
endPricenumber否商品最高价格筛选(包含边界值)。—
switchesstring否用于选择可选结果特性的搜索开关。—
startPricenumber否商品最低价格筛选(包含边界值)。—

调用示例

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

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_aliexpress_search_products' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "currency": "USD",
    "endPrice": 17,
    "locale": "en_US",
    "page": "1",
    "q": "acrylic nail polish rack wall mounted",
    "region": "US",
    "sort": "salesDesc",
    "startPrice": 9
  }
}'
返回示例response.json
JSON部分内容
{
  "code": 0,
  "data": {
    "result": {
      "base": {
        "pageSize": "20",
        "q": "acrylic nail polish rack wall mounted",
        "sortValues": [
          "default"
        ],
        "switchesList": [],
        "totalResults": "828"
      },
      "resultList": [
        {
          "delivery": null,
          "item": {
            "averageStarRate": 4.9,
            "image": "//ae-pic-a1.aliexpress-media.com/kf/S0a6804d21ac44b1ca487fca8dec6cdb8H.jpg",
            "itemId": "3256807801535351",
            "itemUrl": "//www.aliexpress.com/item/3256807801535351.html",
            "title": "Stainless Steel Bathroom Shelf Shampoo Makeup Shower Storage Shelf Bathroom Wall Mount Corner Organizer Rack",
            "type": "natural"
          },
          "sellingPoints": null
        }
      ]
    }
  },
  "message": null,
  "recordTime": "2026-11-06T15:15:31.603772089",
  "requestParams": {
    "body": null,
    "query": {
      "currency": "USD",
      "endPrice": "17",
      "locale": "en_US",
      "page": "1",
      "q": "acrylic nail polish rack wall mounted",
      "region": "US"
    }
  }
}

返回示例仅展示部分内容,不代表完整响应;复制内容为合法 JSON。