API para 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.
Preços e provedores
Preços do endpoint Buscar da API para AliExpress: uma API, 2 provedores intercambiáveis
O provedor mais barato atende primeiro. Se ele falhar, o próximo assume na mesma chamada.
Teste
Obtenha Buscar do AliExpress em uma só requisição
{
"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"
}Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.
Referência
Uma requisição, um formato de resposta.
Cada campo que você envia e cada campo que você recebe, cada um com um exemplo real.
Última verificação em 2026-10-23 · disponibilidade e latência medidas em 30d
Corpo da requisição
JSON, enviado via POST para 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.
Resposta
JSON, um valor de exemplo 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.
- deliveryDaysMaxintegerpode ser exigido
Most days the estimated delivery to the requested country takes, or null when not reported.
- deliveryDaysMinintegerpode ser exigido
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.
- isChoicebooleanpode ser exigido
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.
- listedUtcnumberpode ser exigido
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.
- shipFromstringpode ser exigido
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.
- storeNamestringpode ser exigido
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.
- totalResultsintegerpode ser exigido
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.
Dúvidas frequentes
Sobre o endpoint Buscar da API para AliExpress
O endpoint Buscar da AnyAPI para AliExpress retorna dados de AliExpress em JSON normalizado com uma chamada POST para /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. A AnyAPI distribui cada requisição entre 2 fontes, com failover automático quando uma falha. Custa a partir de US$ 0,85 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Buscar da API para AliExpress feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 3,2 segundos, em 1 chamadas medidas.