AliExpress 搜索 API
Search AliExpress by keyword with optional sort, price-range, page, ship-to country and currency, and get title, price, original price, units sold and image for each product in one normalized response.
价格与服务商
AliExpress 搜索 API 价格：一个 API，2 个可互换的服务商
最便宜的服务商优先响应。如果它失败，下一个会在同一次调用中接手。
试一试
一个请求获取 AliExpress 搜索
{
"data": {
"items": [
{
"currency": "USD",
"deliveryDaysMax": 42,
"deliveryDaysMin": 42,
"image": "https://example.com/image.jpg",
"images": [
"https://example.com/image.jpg"
],
"isChoice": true,
"isSponsored": true,
"listedUtc": 12.5,
"originalPrice": 19.99,
"price": 19.99,
"productId": "a1b2c3d4",
"rating": 4.6,
"shipFrom": "example",
"skuId": "a1b2c3d4",
"soldCount": 12500,
"storeName": "Example title",
"title": "Example title",
"url": "https://example.com/page"
}
],
"totalResults": 12500
},
"found": true,
"reason": "not_found"
}完整的参数与响应参考：这个接口的每个字段、类型和示例。
参考
一个请求，一种响应结构。
你发送的每个字段和收到的每个字段，都附有真实示例。
最近验证于 2026-10-23 · 可用率和延迟按 30d 统计
请求体
JSON，POST 到这个接口。
- querystring
minecraft room projector
Search keywords, e.g. "wireless earbuds".
- countrystring
Ship-to country as a 2-letter ISO code, e.g. US or DE. It changes prices, availability and delivery estimates.
- currencystring
Price currency as a 3-letter ISO code, e.g. USD or EUR.
- maxPricenumber
Optional maximum product price, in the requested currency.
- minPricenumber
Optional minimum product price, in the requested currency.
- pageinteger
1-based results page of about 60 products; AliExpress serves no results past page 60. Each page is billed as one request.
- requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `shipFrom`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. Naming a combination that no single source returns together is refused as invalid input, with no charge.
- sortenum
Result order: best_match (AliExpress relevance, the default), best_seller (most orders first), price_low, or price_high.
响应
JSON，每个字段一个示例值。
Matching AliExpress product cards for the requested page. Populated whenever the provider has data for the entity.
- currencystring
Price currency code, e.g. "USD", or null when no price is shown. Populated whenever the provider has data for the entity.
- deliveryDaysMaxinteger可设为必填
Most days the estimated delivery to the requested country takes, or null when not reported.
- deliveryDaysMininteger可设为必填
Fewest days the estimated delivery to the requested country takes, or null when not reported.
- imagestring
Primary product image URL, or null when the card shows none. Populated whenever the provider has data for the entity.
- imagesstring[]
Every product image URL the card carries, primary first; empty when the card shows none.
- isChoiceboolean可设为必填
True when the product carries the AliExpress Choice badge, or null when the serving source does not report it.
- isSponsoredboolean
True when the card is a paid placement, or null when not reported.
- listedUtcnumber可设为必填
UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. The day the product was first listed, as midnight UTC of that date; null when the serving source does not report it.
- originalPricenumber
Price before the current discount, or null when the product is not discounted.
- pricenumber
Current price in the requested currency, or null when the card shows no price. Populated whenever the provider has data for the entity.
- productIdstring
AliExpress product id, the number in the product URL; pass it to the AliExpress Product or AliExpress Reviews SKU. Populated whenever the provider has data for the entity.
- ratingnumber
Average customer rating, 0-5, or null when the product is unrated.
- shipFromstring可设为必填
2-letter ISO code of the country the product ships from, e.g. "CN", or null when not reported.
- skuIdstring
Id of the product variant the card's price is for, or null when not reported.
- soldCountinteger
Number of units sold, or null when not shown. One source reads it from AliExpress's rounded label, so "60,000+ sold" comes back as 60000. Populated whenever the provider has data for the entity.
- storeNamestring可设为必填
Name of the store selling the product, or null when the card does not show it.
- titlestring
Product title. Populated whenever the provider has data for the entity.
- urlstring
AliExpress product page URL with tracking query parameters removed. Populated whenever the provider has data for the entity.
Search result wrapper, or null when nothing matched.
- totalResultsinteger可设为必填
Total products AliExpress reports for the search, or null when the serving source does not report it.
- foundboolean
True when the search returned at least one product.
- reason"not_found"
Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
常见问题
关于 AliExpress 搜索 API
AnyAPI 的 AliExpress 搜索 API 只需一次 POST 请求 /v1/run/aliexpress.search，就以统一格式的 JSON 返回 AliExpress 数据。Search AliExpress by keyword with optional sort, price-range, page, ship-to country and currency, and get title, price, original price, units sold and image for each product in one normalized response.AnyAPI 会在 2 个数据源之间路由每个请求，某个数据源失败时自动切换。费用：每千次请求 US$0.85 起，以美元计价，无需订阅，也没有每月最低消费。过去 30 天，通过 AnyAPI 发起的 AliExpress 搜索 API 调用中有 100.0% 成功，响应时间中位数为 3.2 秒，共测量 1 次调用。