AliExpress Search Products
Search marketplace products for product discovery, catalog research, and category analysis. All inputs are optional: provide search terms (q), category or brand IDs (catId, brandId), location (loc), product attributes (attr), or result feature switches (switches). page is a string containing a page number starting at 1. sort supports default ordering (default), sales high to low (salesDesc), price low to high (priceAsc), and price high to low (priceDesc); the default is default. Numeric startPrice and endPrice set inclusive price limits. locale, region, and currency control the response locale, market region, and price currency. The response includes the search payload (data), a response code (code), a message (message), and a recorded time (recordTime). Product fields and pagination details within data are not specified, so use the actual returned content and response message to interpret results.
Pricing
| Condition | Charge |
|---|---|
| Each call | 17.46 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
q | string | No | 商品搜索查询词。 | — |
loc | string | No | 商品搜索结果的位置筛选条件。 | — |
attr | string | No | 搜索结果的商品属性筛选条件。 | — |
page | string | No | 分页使用的从 1 开始的页码。 | — |
sort | enum (default | salesDesc | priceAsc | priceDesc) | No | AliExpress 商品搜索排序方式 | default |
catId | string | No | 用于筛选商品搜索结果的类别 ID。 | — |
locale | string | No | 用于 AliExpress 响应的语言环境。 | — |
region | string | No | AliExpress 市场地区。 | — |
brandId | string | No | 用于筛选商品搜索结果的品牌 ID。 | — |
currency | string | No | 用于商品价格的货币代码。 | — |
endPrice | number | No | 商品最高价格筛选(包含边界值)。 | — |
switches | string | No | 用于选择可选结果特性的搜索开关。 | — |
startPrice | number | 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_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
}
}'{
"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"
}
}
}This example shows part of the response. Copied content is valid JSON.






