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积分/次 |
工具参数
未传入的可选参数将使用平台默认值。
| 参数 | 类型 | 必填 | 说明 | 默认值 |
|---|---|---|---|---|
q | string | 否 | 商品搜索查询词。 | — |
loc | string | 否 | 商品搜索结果的位置筛选条件。 | — |
attr | string | 否 | 搜索结果的商品属性筛选条件。 | — |
page | string | 否 | 分页使用的从 1 开始的页码。 | — |
sort | enum (default | salesDesc | priceAsc | priceDesc) | 否 | AliExpress 商品搜索排序方式 | default |
catId | string | 否 | 用于筛选商品搜索结果的类别 ID。 | — |
locale | string | 否 | 用于 AliExpress 响应的语言环境。 | — |
region | string | 否 | AliExpress 市场地区。 | — |
brandId | string | 否 | 用于筛选商品搜索结果的品牌 ID。 | — |
currency | string | 否 | 用于商品价格的货币代码。 | — |
endPrice | number | 否 | 商品最高价格筛选(包含边界值)。 | — |
switches | string | 否 | 用于选择可选结果特性的搜索开关。 | — |
startPrice | number | 否 | 商品最低价格筛选(包含边界值)。 | — |
调用示例
复制请求代码,查看对应的返回示例。
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
{
"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。






