AliExpress Ricerca 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.
Prezzi e provider
Prezzi dell'API AliExpress Ricerca: una sola API, 2 provider intercambiabili
Serve per primo il provider più economico. Se fallisce, subentra il successivo nella stessa chiamata.
Provalo
Ottieni AliExpress Ricerca in una sola richiesta
{
"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"
}Riferimento completo di parametri e risposta - ogni campo, tipo ed esempio per questo endpoint.
Riferimento
Una richiesta, una sola forma di risposta.
Ogni campo che invii e ogni campo che ricevi, ciascuno con un esempio reale.
Ultima verifica 2026-10-23 · disponibilità e latenza misurate su 30d
Corpo della richiesta
JSON, inviato a questo 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.
Risposta
JSON, un valore di esempio per 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.
- deliveryDaysMaxintegerpuò richiedere
Most days the estimated delivery to the requested country takes, or null when not reported.
- deliveryDaysMinintegerpuò richiedere
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.
- isChoicebooleanpuò richiedere
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.
- listedUtcnumberpuò richiedere
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.
- shipFromstringpuò richiedere
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.
- storeNamestringpuò richiedere
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.
- totalResultsintegerpuò richiedere
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.
FAQ
Sull'API AliExpress Ricerca
L'API AliExpress Ricerca di AnyAPI restituisce dati AliExpress come JSON normalizzato da una sola chiamata 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 instrada ogni richiesta su 2 fonti e passa automaticamente a un'altra quando una fallisce. Costa da 0,85 USD ogni 1.000 richieste, in dollari statunitensi, senza abbonamento e senza minimo mensile. Negli ultimi 30 giorni, il 100,0% delle chiamate AliExpress Ricerca tramite AnyAPI è riuscito, con un tempo di risposta mediano di 3,2 secondi su 1 chiamate misurate.