Compras · Amazon
API de avaliações da Amazon
API de avaliações 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
As avaliações de clientes são o dado qualitativo mais rico que a Amazon publica – e também a parte do site que a Amazon protege com mais cuidado: desde 2023, a lista paginada de avaliações só é entregue a compradores logados. A API de avaliações da Amazon da everydata.io foi construída em torno dessa realidade. Ela solicita a lista com as suas opções de ordenação e filtro e, quando a Amazon responde com uma tela de login – o caso normal hoje –, recorre às principais avaliações exibidas na página de produto pública, junto com a nota agregada e o histograma de estrelas. Você sempre recebe dados de avaliação utilizáveis, e a resposta informa exatamente de qual fonte eles vieram.
- Plataforma
- Amazon
- Endpoint principal
- /amazon-lookup-reviews
- Cota por chamada
- 1 requisição
- Plano gratuito
- 100 req. / mêsdepois, a partir de € 30 / mês
Dados de Amazon, prontos para usar
A resposta é identificada por asin e domainCode e traz productTitle, productRating ("4.5 out of 5 stars"), countReviews e reviewSummary, o histograma de estrelas em percentuais (five_star: "71%" e assim por diante). reviews é o array de objetos de avaliação com title, text, rating, date, userName, verified, numberOfHelpful, imageUrlList, variationList (qual tamanho ou cor foi avaliado), reviewId e profilePath.
No modo fallback, responseStatus continua PRODUCT_FOUND_RESPONSE e responseMessage diz "Top reviews from product page (full review listing requires a signed-in Amazon session)". lastPage passa a ser 1 e sortBy, filterByStar, reviewerType, filterByKeyword e mediaType não são aplicados, porque a página de produto exibe um bloco fixo de principais avaliações. Somente quando não há nenhuma avaliação disponível o responseStatus passa a ser LOGIN_REQUIRED ou PRODUCT_NOT_FOUND_RESPONSE.
- Nota agregada, número total de avaliações e a distribuição de 1 a 5 estrelas por ASIN
- Principais avaliações com título, texto completo, nota, data, nome do avaliador e indicador de compra verificada
- Número de votos de utilidade, URLs das imagens anexadas e a variação avaliada em cada avaliação
- Consulta por asin + domainCode ou colando uma URL de produto
- Parâmetros de ordenação e filtro (recentes/úteis, filtro de estrelas, somente verificadas, somente com mídia, palavra-chave) aplicados sempre que a Amazon entrega a lista
- responseMessage transparente, que informa se você recebeu a lista paginada ou o fallback da página de produto
- Funciona em todos os marketplaces da Amazon; o texto das avaliações permanece no idioma do marketplace
O que equipes criam com isso
Análise de sentimento e de temas
Envie o título e o texto das avaliações para um pipeline de NLP para extrair reclamações e elogios recorrentes por ASIN e acompanhe como essa combinação muda após uma revisão do produto.
Monitoramento de notas para marcas
Consulte diariamente productRating, countReviews e o histograma de estrelas do seu catálogo; uma participação crescente de one_star é um alerta antecipado muito antes de a média se mover.
Pesquisa de produtos concorrentes
Compare as principais avaliações de ASINs concorrentes para descobrir quais características os clientes realmente mencionam e extraia a variação avaliada de variationList para identificar problemas de tamanho ou cor.
Widgets de avaliações em sites de afiliados e de comparação
Exiba nota, número de avaliações e algumas avaliações verificadas recentes ao vivo ao lado de um card de produto, em vez de manter cópias desatualizadas.
Requisição e resposta de exemplo
Chame GET /amz/amazon-lookup-reviews com asin e domainCode, ou apenas com url. Parâmetros opcionais: page, sortBy (recent ou helpful), filterByStar (one_star … five_star, positive, critical), reviewerType (all_reviews, avp_only_reviews ou verified_reviews), filterByKeyword e mediaType (all_contents ou media_reviews_only). O exemplo abaixo mostra uma resposta de fallback para um ASIN alemão, reduzida a uma avaliação.
GET /amz/amazon-lookup-reviews
curl "https://api.everydata.io/amz/amazon-lookup-reviews?asin=B09B8V1LZ3&domainCode=de&sortBy=recent&page=1" \
-H "x-api-key: YOUR_API_KEY"Resposta (resumida)
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Top reviews from product page (full review listing requires a signed-in Amazon session)",
"asin": "B09B8V1LZ3",
"productTitle": "Echo Dot (5. Generation, 2022) | Smarter Lautsprecher mit Alexa | Anthrazit",
"domainCode": "de",
"currentPage": 1,
"sortStrategy": "recent",
"countReviews": 48213,
"productRating": "4.7 out of 5 stars",
"reviewSummary": {},
"lastPage": 1,
"reviews": [
{
"title": "Guter Klang für die Größe",
"text": "Für die Küche völlig ausreichend, Alexa versteht auch aus einigen Metern Entfernung. Einrichtung über die App dauerte zwei Minuten.",
"rating": "5.0 out of 5 stars",
"date": "Rezension aus Deutschland vom 3. September 2026",
"userName": "Markus",
"verified": true,
"numberOfHelpful": 12,
"imageUrlList": [],
"variationList": [
"Farbe: Anthrazit"
],
"reviewId": "R1K2M3N4O5P6Q7"
}
]
}Leia o responseMessage antes de interpretar a paginação. "Product successfully found!" significa que a Amazon entregou a lista real: lastPage reflete a barra de paginação, sua ordenação e seus filtros foram aplicados e você pode percorrer as páginas. A mensagem de fallback significa que você tem as principais avaliações da página de produto – normalmente de oito a dez – e não há mais nada para paginar. A Amazon decide a cada requisição qual caso você recebe, então trate os dois no seu código em vez de presumir um deles.
date é retornado como a Amazon o exibe, incluindo o prefixo do idioma ("Reviewed in the United States on …", "Rezension aus Deutschland vom …"); faça o parsing da parte da data por marketplace. rating é uma string no mesmo formato "x.x out of 5 stars" de productRating, para que ambos possam ser tratados por um único parser. reviewSummary fica vazio quando a página não renderizou a tabela do histograma.
Se você só precisa do agregado, /amz/amazon-lookup-product-by-asin já retorna productRating, countReview e o mesmo array de principais avaliações. Use o endpoint de avaliações quando quiser tentar obter a lista ordenada e filtrada.
Endpoints relacionados
Avaliações de produtos. Avaliações de clientes paginadas, com filtro por estrelas.
Detalhes do produto por ASIN. Mesmo payload dos detalhes do produto, consultado por ASIN e marketplace.
Detalhes do produto. Página de produto completa por URL: título, preço, nota, imagens, características, variações, avaliações.
Pague por requisição, todas as plataformas incluídas
Cada chamada – seja com a lista entregue pela Amazon ou com o fallback da página de produto – conta como uma requisição. Monitorar 500 ASINs diariamente quanto a nota e principais avaliações exige cerca de 15.000 requisições por mês, o que cabe com folga no plano Production (50.000 requisições, € 80). As 100 requisições mensais do plano gratuito bastam para ver as duas variantes de resposta com os seus próprios produtos.
- Free
- 100 req. / mês
- Starter
- 5.000 req. · € 30
- Production
- 50.000 req. · € 80
- Business
- 300.000 req. · € 300
API de avaliações da Amazon: perguntas frequentes
Por que não recebo todas as avaliações de um produto?
A Amazon só mostra a lista paginada de avaliações para contas logadas, e a everydata.io não faz login nem contorna essa restrição. Quando a lista não está disponível, a API retorna as principais avaliações da página de produto pública e informa isso no responseMessage.
O filtro de estrelas e o de compra verificada são aplicados?
Somente quando a Amazon entrega a lista (responseMessage "Product successfully found!"). No modo fallback, o bloco de principais avaliações é fixo, então filterByStar, reviewerType, filterByKeyword, mediaType e sortBy não têm efeito e lastPage é 1.
Quantas avaliações vêm na resposta de fallback?
Tantas quantas a página de produto exibir, geralmente de oito a dez, escolhidas pela Amazon como as principais avaliações daquele marketplace. Os campos agregados countReviews e productRating continuam descrevendo todas as avaliações.
Posso consultar avaliações pela URL do produto?
Sim. Passe url em vez de asin e domainCode; a API extrai os dois da URL. Qualquer URL de produto amazon.<tld> funciona, incluindo links curtos /dp/ASIN.
Vocês traduzem as avaliações?
Não. As avaliações vêm no idioma do marketplace consultado. Para ler avaliações em alemão de um produto vendido internacionalmente, consulte com domainCode de.
Casos de uso relacionados
Obtenha as avaliações do seu primeiro ASIN
Crie uma conta gratuita e chame o endpoint de avaliações para qualquer produto – você verá nota, histograma e principais avaliações em segundos.