API de AliExpress: Buscar
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.
Precios y proveedores
Precios del endpoint Buscar de la API de AliExpress: una API, 2 proveedores intercambiables
El proveedor más barato responde primero. Si falla, el siguiente toma el relevo en la misma llamada.
Pruébalo
Obtén Buscar de AliExpress en una sola solicitud
{
"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"
}Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.
Referencia
Una solicitud, un formato de respuesta.
Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.
Verificado por última vez el 2026-10-23 · disponibilidad y latencia medidas en 30d
Cuerpo de la solicitud
JSON, enviado por POST a este endpoint.
- 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.
Respuesta
JSON, un valor de ejemplo por campo.
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.
- deliveryDaysMaxintegerse puede exigir
Most days the estimated delivery to the requested country takes, or null when not reported.
- deliveryDaysMinintegerse puede exigir
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.
- isChoicebooleanse puede exigir
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.
- listedUtcnumberse puede exigir
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.
- shipFromstringse puede exigir
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.
- storeNamestringse puede exigir
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.
- totalResultsintegerse puede exigir
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.
Preguntas frecuentes
Acerca del endpoint Buscar de la API de AliExpress
El endpoint Buscar de AnyAPI para AliExpress devuelve datos de AliExpress como JSON normalizado con una sola llamada POST a /v1/run/aliexpress.search. 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 enruta cada solicitud entre 2 fuentes y recurre automáticamente a otra cuando una falla. Cuesta desde US$0.85 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 100.0% de las llamadas al endpoint Buscar de la API de AliExpress a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 3.2 segundos en 1 llamadas medidas.