GET /v1/aliexpress/search/products_v1
AliExpress Product Search API (V1)
stable · 20 credits per success
Search AliExpress products with optional query, page, sort, category, brand, location, attribute, price, locale, region and currency controls. Use it for product discovery, catalogue research and market category analysis.
Request parameters
| Name | Type | In | Required | Description | Example |
|---|---|---|---|---|---|
| q | string | query | no | 商品搜索查询词。 | demo |
| loc | string | query | no | 商品搜索结果的位置筛选条件。 | demo |
| attr | string | query | no | 搜索结果的商品属性筛选条件。 | demo |
| page | string | query | no | 分页使用的从 1 开始的页码。 | 1 |
| sort | string | query | no | 商品搜索结果的排序方式。 可用值： - `default`：默认结果顺序 - `salesDesc`：销量，从高到低 - `priceAsc`：价格，从低到高 - `priceDesc`：价格，从高到低 | default |
| catId | string | query | no | 用于筛选商品搜索结果的类别 ID。 | demo |
| locale | string | query | no | 用于 AliExpress 响应的语言环境。 | demo |
| region | string | query | no | AliExpress 市场地区。 | demo |
| brandId | string | query | no | 用于筛选商品搜索结果的品牌 ID。 | demo |
| currency | string | query | no | 用于商品价格的货币代码。 | demo |
| endPrice | number | query | no | 商品最高价格筛选（包含边界值）。 | 0 |
| switches | string | query | no | 用于选择可选结果特性的搜索开关。 | demo |
| startPrice | number | query | no | 商品最低价格筛选（包含边界值）。 | 0 |
Response fields
Field dictionary coming soon — the executable panel shows the live shape.
Errors
| code | HTTP | Meaning | Billed |
|---|---|---|---|
| 40001 | 400 | Invalid parameters | no |
| 40102 | 401 | Invalid or revoked API Key | no |
| 40201 | 402 | Insufficient credits | no |
| 40402 | 404 | Resource not found | no |
| 42201 | 422 | Quality gate failed | no |
| 42901 | 429 | Rate limit exceeded | no |
| 50401 | 504 | Upstream timeout | no |
| 50201 | 502 | Upstream error | no |
Billing
Success costs 20 credits. Any failure — including a 200 that fails the quality gate — costs 0.