Compras · Amazon
API de resultados de busca da Amazon
API de resultados de busca da Amazon: dados ao vivo de Amazon no momento em que você pede, limpos e estruturados – prontos para seu próprio app, uma planilha ou um assistente de IA. Sem scraping, nada para manter.
100 requisições grátis por mês · sem cartão de crédito · uma chave de API para todas as plataformas
Fatos principais
Atualizado em
A página de busca da Amazon é a vitrine do marketplace: quais ASINs aparecem para uma consulta, quais deles são posições pagas, quanto custam e quantas pessoas os compraram no último mês. A API de resultados de busca da Amazon da everydata.io carrega essa página ao vivo para qualquer palavra-chave e marketplace e retorna a grade de resultados como um array JSON – uma chamada por página de resultados, com a mesma ordenação que um comprador escolheria e com os produtos patrocinados sinalizados ou removidos.
- Plataforma
- Amazon
- Endpoint principal
- /amazon-search-by-keyword-asin
- Cota por chamada
- 1 requisição
- Plano gratuito
- 100 req. / mêsdepois, a partir de € 30 / mês
Dados de Amazon, prontos para usar
Cada chamada retorna os produtos de exatamente uma página de resultados, na ordem do ranking. numberOfProducts informa quantos produtos orgânicos havia naquela página, numberOfSponsoredProducts quantos anúncios estavam misturados e resultCount é o número da própria Amazon ("mais de 100.000 resultados") para a palavra-chave. foundProducts e foundSponsoredProducts são listas simples de ASINs, práticas para uma verificação rápida de posição sem mexer nos objetos de detalhe.
searchProductDetails traz os detalhes de cada card: productDescription (o título do card), asin, price e retailPrice como números com currency, productRating e countReview, o selo prime, salesVolume ("mais de 50 compras no mês passado"), a deliveryMessage exibida pela Amazon e um indicador sponsored. dpUrl é o link relativo do produto, para você montar uma URL canônica com o host do marketplace. starFilterParam e categories expõem os refinamentos que a Amazon ofereceu junto com os resultados.
- Lista de resultados ranqueada por página, com contagens de orgânicos e patrocinados separadas
- Por card: ASIN, título, preço, preço de tabela, moeda, nota, número de avaliações e URL da imagem
- Elegibilidade Prime, selo de volume de vendas e a mensagem de entrega da Amazon por produto
- sortBy: relevanceblender, price-asc-rank, price-desc-rank, review-rank, date-desc-rank
- Restrinja a consulta a um alias de busca (category) ou a um id de browse node (browseNode)
- excludeSponsored=true para remover anúncios; withCache=true para aceitar uma página em cache de 10 minutos
- Todos os marketplaces via domainCode – com, de, co.uk, fr, it, es, ca, co.jp, in, com.au, nl, se, pl e outros
O que equipes criam com isso
Monitoramento de posição por palavra-chave para vendedores e agências
Busque as páginas 1–3 de cada palavra-chave monitorada uma vez por dia, localize seus ASINs em foundProducts e armazene a posição. Separe posições orgânicas e patrocinadas com o indicador sponsored.
Share of shelf e monitoramento de concorrentes
Conte quantos cards da primeira página pertencem a cada marca para suas consultas principais na amazon.com, .de e .co.uk. salesVolume acrescenta um sinal de demanda por concorrente.
Descoberta de produtos e sourcing
Ordene por review-rank ou date-desc-rank para encontrar produtos bem avaliados ou recém-anunciados em um nicho e depois obtenha os detalhes da lista selecionada pelo endpoint de produto.
Painéis de inteligência de anúncios
numberOfSponsoredProducts por página e a lista de ASINs patrocinados mostram o quanto uma palavra-chave é disputada e quais concorrentes compram posições para ela.
Requisição e resposta de exemplo
Chame GET /amz/amazon-search-by-keyword-asin com um keyword e um domainCode. page tem padrão 1 e vai até 400; sortBy tem padrão relevanceblender, que é a ordem "Destaques" da Amazon. O parâmetro category recebe um alias de busca exatamente como a Amazon o usa no menu de departamentos – aps para todos os departamentos, electronics, computers e assim por diante. Um alias inválido gera um resultado vazio, não um erro, então mantenha uma lista de aliases conhecidos por marketplace.
GET /amz/amazon-search-by-keyword-asin
curl "https://api.everydata.io/amz/amazon-search-by-keyword-asin?keyword=laptop&domainCode=com&page=1&sortBy=relevanceblender&excludeSponsored=false" \
-H "x-api-key: YOUR_API_KEY"Resposta (resumida)
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Product successfully found!",
"sortStrategy": "relevanceblender",
"domainCode": "com",
"keyword": "laptop",
"numberOfProducts": 26,
"numberOfSponsoredProducts": 6,
"resultCount": 100000,
"selectedCategory": "aps",
"foundSponsoredProducts": [
"B0FGJ14KRX",
"B0GY7F4FDK"
],
"foundProducts": [
"B0HFJ9BNPL",
"B0HF38QXHL"
],
"searchProductDetails": [
{
"productDescription": "Acer Aspire 14 AI Copilot+ PC - Intel Core Ultra 5 226V & 14” WUXGA Touch | 16GB LPDDR5X | 1TB Gen 4 SSD",
"asin": "B0FGJ14KRX",
"countReview": 20,
"imgUrl": "https://m.media-amazon.com/images/I/61kp09SeFyL._AC_UY218_.jpg",
"price": 548.44,
"retailPrice": 0,
"productRating": "4.0 out of 5 stars",
"prime": false,
"dpUrl": "/dp/B0FGJ14KRX",
"salesVolume": "50+ bought in past month",
"sponsored": true,
"currency": "USD"
}
],
"starFilterParam": {
"Apply 4 Stars & Up filter to narrow results": "p_72:1248879011"
},
"currentPage": 1,
"lastPage": 20
}A paginação é explícita: currentPage repete o que você pediu e lastPage é a página mais alta que a Amazon linkou na barra de paginação. Uma página típica tem de 16 a 60 cards, dependendo do layout, então numberOfProducts varia. As posições no ranking são o índice do array searchProductDetails somado ao deslocamento das páginas anteriores – a API não renumera os cards, então as entradas patrocinadas mantêm sua posição real, a menos que você passe excludeSponsored=true.
Os resultados dependem do marketplace e do local de entrega padrão da Amazon para aquela requisição; a deliveryMessage no exemplo ("Ships to Germany") mostra qual local foi aplicado. Um retailPrice de 0 significa que nenhum preço riscado (de tabela) foi exibido, e um price de 0 significa que o card não tinha preço nenhum, o que acontece com itens com variações que exigem uma seleção antes.
O cache de 10 minutos (withCache=true) ajuda quando várias partes do seu sistema disparam a mesma consulta em poucos minutos – a segunda chamada é respondida a partir do cache e retorna mais rápido. browseNode restringe uma consulta a um id de node como 10158976011 quando o alias é amplo demais.
Endpoints relacionados
Buscar produtos. Busca por palavra-chave com paginação, ordenação e filtro de patrocinados.
Detalhes do produto por ASIN. Mesmo payload dos detalhes do produto, consultado por ASIN e marketplace.
Mais vendidos. Lista de mais vendidos para a URL de uma categoria.
Pague por requisição, todas as plataformas incluídas
Uma página de resultados equivale a uma requisição, seja qual for o tamanho da página. Monitorar 100 palavras-chave nas três primeiras páginas diariamente consome cerca de 9.000 requisições por mês – o plano Production (50.000 requisições, € 80) cobre isso com folga para vários marketplaces, e o Starter (5.000 requisições, € 30) atende um conjunto menor de palavras-chave apenas na página 1. Falhas 5xx do lado da Amazon não são cobradas.
- Free
- 100 req. / mês
- Starter
- 5.000 req. · € 30
- Production
- 50.000 req. · € 80
- Business
- 300.000 req. · € 300
Construa passo a passo
API de resultados de busca da Amazon: perguntas frequentes
Quantos produtos são retornados por página?
Exatamente o que a Amazon exibiu naquela página – geralmente entre 16 e 60 cards, informados em numberOfProducts mais numberOfSponsoredProducts. Para um número fixo de resultados, continue solicitando páginas até ter o suficiente ou até currentPage chegar a lastPage.
Posso filtrar resultados por preço ou nota?
Não como parâmetros diretos. Use sortBy para ordenar por preço ou avaliações e depois filtre no cliente por price e productRating. O campo starFilterParam mostra o refinamento que a Amazon ofereceu, que você pode reutilizar como uma restrição no estilo browseNode quando aplicável.
Os produtos patrocinados estão incluídos?
Por padrão, sim, cada um marcado com sponsored: true e listado separadamente em foundSponsoredProducts. Defina excludeSponsored=true para receber apenas resultados orgânicos.
A busca funciona com códigos EAN ou UPC?
Sim – a Amazon trata um GTIN como palavra-chave e geralmente retorna o ASIN correspondente como primeiro resultado. Essa é a forma padrão de converter códigos de barras em ASINs antes de chamar o endpoint de produto.
Em quais marketplaces posso buscar?
Em todos os marketplaces da Amazon via domainCode, de com e de até co.jp, com.au, pl, ae e sg. Títulos e mensagens de entrega vêm no idioma do marketplace.
Casos de uso relacionados
Faça sua primeira busca na Amazon
Cadastre-se gratuitamente, envie uma palavra-chave e receba a página de resultados completa em JSON – 100 requisições por mês sem custo.