Compras · Amazon
API de ofertas da Amazon
API de ofertas 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 ofertas da Amazon concentra os descontos por tempo limitado do marketplace: ofertas relâmpago (Lightning Deals) com contagem regressiva, Best Deals, ofertas exclusivas Prime e os eventos sazonais construídos sobre elas. A API de ofertas da Amazon da everydata.io lê essa grade ao vivo em qualquer marketplace e retorna cada oferta com preço atual, preço de referência, desconto e status. Os filtros de departamento, faixa de desconto, nota em estrelas, faixa de preço e acesso Prime correspondem diretamente aos refinamentos da página, e um endpoint complementar informa quais valores de filtro são válidos no momento.
- Plataforma
- Amazon
- Endpoint principal
- /amazon-search-deals-v2
- Cota por chamada
- 1 requisição
- Plano gratuito
- 100 req. / mêsdepois, a partir de € 30 / mês
Dados de Amazon, prontos para usar
Uma resposta de ofertas contém currentPage, lastPage, countDeals, domainCode e usedFilter – um eco do estado de refinamento aplicado, para você conferir se os filtros foram aplicados. deals é o array de cards de oferta: id e dealType (BEST_DEAL, LIGHTNING_DEAL …), title, url, asin, price, retailPrice, savingAmount, savingPercentage, currency, dealState (AVAILABLE e, depois, outros status conforme a oferta avança), badgeMessage ("Limited time deal"), productRating, countReview, imgUrls e brand, quando a Amazon exibe a marca.
GET /amz/amazon-deal-filter-v2 retorna o vocabulário de filtros atual de um marketplace: departamentos como pares label/value ("Appliances" → 2619526011), níveis de discountRange ("10% off or more" → 1), minProductStarRating, faixas de priceRange, accessType para Prime Exclusive e Prime Early Access, marcas e coleções ativas, como Lightning deals. Use esses valores no endpoint de ofertas em vez de fixá-los no código – IDs de departamento e faixas variam de marketplace para marketplace.
- Preço da oferta, preço de tabela, savingAmount e savingPercentage como números, com moeda
- dealType, dealState e badgeMessage para distinguir ofertas relâmpago de Best Deals contínuas
- ASIN, URL do produto, imagens, nota, número de avaliações e marca por card de oferta
- Filtros: departments, discountRange (1–5), minProductStarRating (1–4), priceRange (1–5), primeEarly, primeExclusive
- Endpoint de descoberta de filtros com IDs de departamento, faixas e coleções ativas válidos por marketplace
- 30 ofertas por página, espelhando a grade da própria Amazon
- Todos os marketplaces via domainCode – com, de, co.uk, fr, it, es, ca, co.jp e outros
O que equipes criam com isso
Agregadores de ofertas e serviços de alerta
Consulte a grade de ofertas a cada poucos minutos no Prime Day ou na Black Friday, filtre por savingPercentage e productRating e envie novas ofertas relâmpago aos assinantes antes que se esgotem.
Monitoramento de promoções da concorrência
Marcas acompanham quais concorrentes fazem ofertas no seu departamento, qual é o tamanho do desconto e por quanto tempo uma oferta fica AVAILABLE – insumo para o próprio calendário promocional.
Conteúdo de afiliados
Gere diariamente páginas de "melhores ofertas abaixo de 25 em Eletrônicos" com os filtros priceRange e departments, linkando cada ASIN com a sua tag.
Pesquisa de anomalias de preço
Armazene retailPrice junto com o endpoint de histórico de preços para verificar se os preços de referência das ofertas refletem preços reais recentes.
Requisição e resposta de exemplo
Chame GET /amz/amazon-search-deals-v2 com domainCode e page. Adicione departments com um ou mais IDs do endpoint de filtros (separados por vírgula), discountRange, minProductStarRating e priceRange como dígitos únicos, e primeEarly ou primeExclusive como booleanos. O exemplo busca ofertas no departamento Appliances com pelo menos 25% de desconto e nota mínima de 4 estrelas.
GET /amz/amazon-search-deals-v2
curl "https://api.everydata.io/amz/amazon-search-deals-v2?domainCode=com&page=1&departments=2619526011&discountRange=2&minProductStarRating=4" \
-H "x-api-key: YOUR_API_KEY"Resposta (resumida)
{
"responseStatus": "PRODUCT_FOUND_RESPONSE",
"responseMessage": "Product successfully found!",
"currentPage": 1,
"lastPage": 2,
"countDeals": 30,
"domainCode": "com",
"usedFilter": {
"state": {
"refinementFilters": {
"departments": [
"2619526011"
],
"reviewRating": [
"4"
],
"percentOff": [
"2"
]
}
},
"version": 1
},
"deals": [
{
"id": "35911091",
"dealType": "BEST_DEAL",
"title": "Ultra Pain Relief Cooling Pillow for Neck Support, Adjustable Cervical Pillow, Odorless Ergonomic Contour Memory Foam",
"url": "https://www.amazon.com/Adjustable-Cervical-Sleeping-Ergonomic-Orthopedic/dp/B0C1GQ54QD",
"price": 31.32,
"retailPrice": 52.22,
"savingAmount": 20.9,
"savingPercentage": 40,
"asin": "B0C1GQ54QD",
"badgeMessage": "Limited time deal",
"productRating": "4.2",
"countReview": 23511,
"currency": "USD",
"dealState": "AVAILABLE"
}
]
}A paginação acompanha a grade de ofertas um a um: 30 cards por página. lastPage é o que a paginação da Amazon mostrava no momento da coleta, mas a página de ofertas muda o tempo todo – ofertas se esgotam, novas ofertas relâmpago começam –, então o loop seguro é incrementar page até o array deals vir vazio, em vez de parar em lastPage. Remova duplicatas por id ou asin, porque um card pode passar da página 2 para a página 1 entre duas chamadas.
Nem todo card traz todos os campos. Cards que a Amazon exibe sem selo de oferta – muitas vezes produtos "relacionados" no fim da grade – chegam sem price, retailPrice ou dealType. Considere savingPercentage como o desconto de referência e retailPrice como o preço de referência da Amazon, que pode ser um preço de tabela ou um preço típico recente, dependendo do marketplace.
productRating é uma string simples como "4.2" nos cards de oferta, diferente do formato "4.2 out of 5 stars" das páginas de produto. Um ID de departamento que não existe no marketplace retorna um array deals vazio, com seu filtro ecoado em usedFilter.
Endpoints relacionados
Ofertas do dia. Ofertas do dia de um marketplace, 30 por página, com filtros de departamento, desconto, preço e nota.
Filtros de ofertas. Valores de filtro válidos (departamentos, faixas de desconto, faixas de preço) para o endpoint de ofertas.
Detalhes do produto por ASIN. Mesmo payload dos detalhes do produto, consultado por ASIN e marketplace.
Histórico de preços. Preços históricos coletados por esta API.
Pague por requisição, todas as plataformas incluídas
Cada página de ofertas e cada consulta de filtros é uma requisição; o vocabulário de filtros muda raramente, então busque-o uma vez por dia por marketplace. Um monitor que consulta cinco departamentos a cada dez minutos, em duas páginas, usa cerca de 43.000 requisições por mês – o plano Production (50.000 requisições, € 80) cobre isso; se os picos em dias de evento ultrapassarem a cota mensal, faça upgrade a qualquer momento (proporcional). Respostas 5xx do site de origem nunca são cobradas.
- Free
- 100 req. / mês
- Starter
- 5.000 req. · € 30
- Production
- 50.000 req. · € 80
- Business
- 300.000 req. · € 300
API de ofertas da Amazon: perguntas frequentes
Como encontro IDs de departamento válidos?
Chame GET /amz/amazon-deal-filter-v2 com o domainCode. departments lista pares label/value como "Appliances" → 2619526011; passe o value para o endpoint de ofertas. Os IDs variam entre marketplaces, então consulte-os por domainCode.
O que significam os valores de discountRange e priceRange?
São as posições ordinais das faixas que a Amazon oferece – por exemplo, discountRange 1 é "10% off or more" e 2 é "25% off or more"; priceRange 1 é "Under 25". O endpoint de filtros retorna os rótulos atuais de cada valor.
Por que a página 3 retorna um array vazio, se lastPage indicava 4?
A grade de ofertas muda continuamente à medida que ofertas expiram e começam, então o número de páginas da sua primeira chamada pode não valer um minuto depois. Faça o loop até o array deals vir vazio e remova duplicatas por id.
Posso buscar apenas ofertas relâmpago?
Não há um parâmetro específico, mas cada card traz dealType e badgeMessage, então filtre LIGHTNING_DEAL no lado do cliente. O campo collections do endpoint de filtros mostra se há uma coleção de Lightning deals ativa no momento.
A API retorna a contagem regressiva da oferta?
Não. dealState informa se a oferta está AVAILABLE no momento, mas o cronômetro e a barra de percentual resgatado não são incluídos. Consulte em intervalos curtos para detectar rapidamente ofertas esgotadas.
Casos de uso relacionados
Comece a coletar ofertas da Amazon
Crie uma conta gratuita, busque o vocabulário de filtros do seu marketplace e leia a grade de ofertas ao vivo em JSON – 100 requisições por mês incluídas.