Saltar para o conteúdo principal
Busque produtos na loja AliExpress (aliexpress.com) pela API de tarefas assíncronas. Envie COMMERCE_SERP com site aliexpress para receber os produtos que uma busca mostra, na ordem da loja. O COMMERCE_PRODUCT não lê as páginas de produto desta loja. Cada busca concluída custa 0.5 crédito.

Busca

Envie a tarefa e depois consulte GET /v1/async/task/{id} ou receba o webhook. Veja Tarefas assíncronas.

Parâmetros

  • site: Obrigatório. aliexpress.
  • query: Obrigatório. Termo de busca, de 1 a 500 caracteres.
  • limit: Inteiro opcional de 1 a 40, com padrão 20.
  • country: Opcional. O padrão é US, o país da loja. Qualquer outro país é recusado com 422 REGION_UNSUPPORTED.
Só os campos de payload listados acima são aceitos. Omita include: até include: {} retorna 422 VALIDATION_ERROR em payload.include antes da reserva de créditos.

Exemplo de resposta

Campos do resultado

  • site, query e country repetem a requisição. returnedCount é o número de itens em products.
  • Cada produto inclui rank, productId, title e url. productId é o ID de produto da própria loja. rank segue a ordem padrão da loja, e os anúncios que a loja marca como patrocinados ficam de fora.
  • price, rating e imageUrl aparecem quando a página de resultados os mostra. price é um número na currency do produto (ISO 4217); quando os tamanhos têm preços diferentes, é o menor. Os preços do AliExpress são os preços promocionais mostrados a um comprador sem login nos Estados Unidos.
  • rating usa uma escala de cinco pontos. O AliExpress mostra estrelas sem o número de avaliações, então os produtos dele não trazem reviewCount.
  • Cada busca retorna produtos da primeira página de resultados da loja.

Erros e cobrança

  • Uma busca que não retorna produtos termina como tarefa com falha.
  • Só as buscas concluídas são cobradas, 0.5 crédito cada.

Relacionado