Compras · Amazon
API de ofertas de Amazon
La API de ofertas de Amazon te da datos de Amazon en tiempo real en el momento en que los pides, limpios y estructurados, listos para tu propia app, una hoja de cálculo o un asistente de IA. Sin scraping, nada que mantener.
100 solicitudes gratis al mes · sin tarjeta de crédito · una clave de API para todas las plataformas
Datos clave
Actualizado el
La página de ofertas de Amazon concentra los descuentos por tiempo limitado del marketplace: ofertas flash con cuenta atrás, Best Deals, ofertas exclusivas de Prime y los eventos de temporada basados en ellas. La API de ofertas de Amazon de everydata.io lee esa cuadrícula en directo en cualquier marketplace y devuelve cada oferta con precio actual, precio de referencia, ahorro y estado. Los filtros de departamento, rango de descuento, valoración en estrellas, rango de precio y acceso Prime se corresponden directamente con los filtros de la página, y un endpoint complementario te indica qué valores de filtro son válidos en este momento.
- Plataforma
- Amazon
- Endpoint principal
- /amazon-search-deals-v2
- Cuota por llamada
- 1 solicitud
- Plan gratuito
- 100 solicitudes / mesdespués, desde 30 € / mes
Datos de Amazon, listos para usar
Una respuesta de ofertas contiene currentPage, lastPage, countDeals, domainCode y usedFilter, un eco de los filtros aplicados para que puedas comprobar que han surtido efecto. deals es el array de tarjetas de oferta: id y dealType (BEST_DEAL, LIGHTNING_DEAL …), title, url, asin, price, retailPrice, savingAmount, savingPercentage, currency, dealState (AVAILABLE y estados posteriores a medida que avanza la oferta), badgeMessage ("Limited time deal"), productRating, countReview, imgUrls y brand cuando Amazon la muestra.
GET /amz/amazon-deal-filter-v2 devuelve el vocabulario de filtros vigente de un marketplace: departamentos como pares etiqueta/valor ("Appliances" → 2619526011), escalones de discountRange ("10% off or more" → 1), minProductStarRating, franjas de priceRange, accessType para Prime Exclusive y Prime Early Access, marcas y colecciones activas como Lightning deals. Pasa estos valores al endpoint de ofertas en lugar de fijarlos en el código: los IDs de departamento y las franjas varían según el marketplace.
- Precio de oferta, precio de lista, savingAmount y savingPercentage como números con moneda
- dealType, dealState y badgeMessage para distinguir las ofertas flash de las Best Deals continuas
- ASIN, URL del producto, imágenes, valoración, número de reseñas y marca en cada tarjeta de oferta
- Filtros: departments, discountRange (1–5), minProductStarRating (1–4), priceRange (1–5), primeEarly, primeExclusive
- Endpoint de descubrimiento de filtros con IDs de departamento válidos, franjas y colecciones activas por marketplace
- 30 ofertas por página, igual que la cuadrícula de Amazon
- Todos los marketplaces por domainCode: com, de, co.uk, fr, it, es, ca, co.jp y más
Lo que los equipos construyen con esto
Agregadores de ofertas y servicios de alertas
Consulta la cuadrícula de ofertas cada pocos minutos en Prime Day o Black Friday, filtra por savingPercentage y productRating y envía las nuevas ofertas flash a tus suscriptores antes de que se agoten.
Monitorización de promociones de la competencia
Las marcas vigilan qué competidores lanzan ofertas en su departamento, lo profundo que es el descuento y cuánto tiempo sigue una oferta en AVAILABLE, datos para su propio calendario promocional.
Contenido de afiliados
Genera cada día páginas de "mejores ofertas por menos de 25 en Electrónica" con los filtros priceRange y departments, enlazando cada ASIN con tu tag.
Investigación de anomalías de precio
Guarda retailPrice junto al endpoint de historial de precios para comprobar si los precios de referencia de las ofertas reflejan precios recientes reales.
Solicitud y respuesta de ejemplo
Llama a GET /amz/amazon-search-deals-v2 con domainCode y page. Añade departments con uno o varios IDs del endpoint de filtros (separados por comas), discountRange, minProductStarRating y priceRange como dígitos sueltos, y primeEarly o primeExclusive como booleanos. El ejemplo pide ofertas del departamento Appliances con al menos un 25 % de descuento y un mínimo de 4 estrellas.
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"Respuesta (abreviada)
{
"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"
}
]
}La paginación sigue la cuadrícula de ofertas uno a uno: 30 tarjetas por página. lastPage es lo que mostraba la paginación de Amazon en el momento de la consulta, pero la página de ofertas cambia constantemente (las ofertas se agotan, empiezan nuevas ofertas flash), así que lo seguro es incrementar page hasta que el array deals llegue vacío en lugar de parar en lastPage. Elimina duplicados por id o asin, porque una tarjeta puede pasar de la página 2 a la 1 entre dos llamadas.
No todas las tarjetas incluyen todos los campos. Las tarjetas que Amazon muestra sin insignia de oferta (a menudo productos "relacionados" al final de la cuadrícula) llegan sin price, retailPrice ni dealType. Toma savingPercentage como el descuento de referencia y retailPrice como el precio de referencia de Amazon, que puede ser un precio de lista o un precio habitual reciente según el marketplace.
En las tarjetas de oferta, productRating es una cadena simple como "4.2", a diferencia de la forma "4.2 out of 5 stars" de las páginas de producto. Un ID de departamento que no existe en el marketplace devuelve un array deals vacío con tu filtro reflejado en usedFilter.
Endpoints relacionados
Ofertas del día. Ofertas del día de un marketplace, 30 por página, con filtros de departamento, descuento, precio y valoración.
Filtros de ofertas. Valores de filtro válidos (departamentos, rangos de descuento, rangos de precio) para el endpoint de ofertas.
Detalles del producto por ASIN. Los mismos datos que los detalles del producto, por ASIN y marketplace.
Historial de precios. Precios históricos recopilados por esta API.
Paga por solicitud, con todas las plataformas incluidas
Cada página de ofertas y cada consulta de filtros es una solicitud; el vocabulario de filtros cambia poco, así que basta con obtenerlo una vez al día por marketplace. Un rastreador que consulta cinco departamentos cada diez minutos en dos páginas usa unas 43.000 solicitudes al mes: el plan Production (50.000 solicitudes, 80 €) lo cubre; si los picos de los días de evento te hacen superar la cuota mensual, cambia de plan en cualquier momento (prorrateado). Las respuestas 5xx del sitio de origen nunca se cobran.
- Free
- 100 solicitudes / mes
- Starter
- 5000 solicitudes · 30 €
- Production
- 50.000 solicitudes · 80 €
- Business
- 300.000 solicitudes · 300 €
API de ofertas de Amazon: preguntas frecuentes
¿Cómo encuentro IDs de departamento válidos?
Llama a GET /amz/amazon-deal-filter-v2 con el domainCode. departments lista pares etiqueta/valor como "Appliances" → 2619526011; pasa el valor al endpoint de ofertas. Los IDs varían entre marketplaces, así que consúltalos para cada domainCode.
¿Qué significan los valores de discountRange y priceRange?
Son las posiciones ordinales de las franjas que ofrece Amazon: por ejemplo, discountRange 1 es "10% off or more" y 2 es "25% off or more"; priceRange 1 es "Under 25". El endpoint de filtros devuelve las etiquetas actuales de cada valor.
¿Por qué la página 3 devuelve un array vacío si lastPage decía 4?
La cuadrícula de ofertas cambia continuamente a medida que las ofertas caducan y empiezan otras, así que el número de páginas de tu primera llamada puede no ser válido un minuto después. Repite hasta que el array deals esté vacío y elimina duplicados por id.
¿Puedo pedir solo ofertas flash?
No con un parámetro específico, pero cada tarjeta incluye dealType y badgeMessage, así que filtra LIGHTNING_DEAL en el cliente. El campo collections del endpoint de filtros indica si hay una colección de ofertas flash activa.
¿La API devuelve la cuenta atrás de la oferta?
No. dealState indica si la oferta está AVAILABLE en ese momento, pero no se incluyen el temporizador ni la barra de porcentaje reclamado. Consulta a intervalos cortos para detectar rápido cuándo se agota.
Casos de uso relacionados
Empieza a obtener ofertas de Amazon
Crea una cuenta gratuita, obtén el vocabulario de filtros de tu marketplace y lee la cuadrícula de ofertas en directo en JSON: 100 solicitudes al mes incluidas.