Una página de producto muestra el precio de hoy. No muestra que el precio era diez dólares más bajo la semana pasada, ni que el precio «anterior» que aparece al lado subió poco antes de que empezara el descuento.
El historial de precios es la diferencia entre ver el precio de un competidor y entender cómo fija sus precios. Una sola petición de API lo devuelve, junto con el historial de ranking y valoración que necesitas para juzgar si un cambio de precio sirvió de algo.
La petición
El endpoint de historial de producto recibe un ASIN y una ventana temporal en milisegundos:
curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/asin/history \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"asin": "B0D5B6RLYY",
"startTimestamp": 1757635200000,
"endTimestamp": 1760227200000,
"dailyLatest": true
}'startTimestampyendTimestampdelimitan la ventana. Los valores anteriores corresponden al 12 de septiembre y al 12 de octubre de 2025.dailyLatestpide la última observación de cada día en lugar de todas las observaciones.
Qué devuelve
La respuesta es un objeto con información del producto y un conjunto de series temporales. Cada serie es un array de pares { "timePoint": ..., "value": ... }:
| Serie | Qué sigue |
|---|---|
price | El precio de venta |
priceList | El precio de lista que aparece tachado al lado |
buyBox | El precio de la Buy Box |
buyBoxSellerIdHistory | Qué vendedor tenía la Buy Box |
dealPrice | El precio de oferta, cuando había una oferta activa |
bsr | El ranking de más vendidos en la categoría principal |
subSalesRank | El ranking en cada subcategoría |
reviews, rating | Número de reseñas y valoración en estrellas |
sellers | Número de vendedores en el listing |
Un mes de un producto real
Ejecutamos la petición anterior el 12 de octubre de 2026 para una fuente de agua para perros de 7 litros en el marketplace de Estados Unidos, pidiendo una ventana de 30 días de un año antes. Devolvió 31 puntos por serie. Ordenados por fecha:
| Fechas (2025) | Precio | Precio de lista | BSR en Productos para mascotas | Posición en la subcategoría |
|---|---|---|---|---|
| 12–15 sep. | 49,99 $ | 59,99 $ | 2.402–2.477 | 5–6 |
| 16–21 sep. | 49,99 $ | 69,99 $ | 2.295–2.565 | 4–5 |
| 22–25 sep. | 44,99 $ | 69,99 $ | 2.152–2.291 | 4–5 |
| 26 sep.–5 oct. | 39,99 $ | 69,99 $ | De 2.194 bajando a 1.611 | De 4 subiendo a 2 |
| 6–11 oct. | 49,99 $ | 69,99 $ | 1.370–1.780 | 2–3 |
Aquí se ven cuatro cosas que una página de producto nunca muestra.
El precio se movió por escalones. 49,99 $, luego 44,99 $ durante cuatro días, luego 39,99 $ durante diez y de vuelta a 49,99 $. Es una promoción planificada, no una rebaja permanente. Un competidor que hubiera igualado los 39,99 $ de forma permanente habría estado por debajo de un precio que dos semanas después ya no existía.
El precio de lista subió primero. El precio tachado pasó de 59,99 $ a 69,99 $ el 16 de septiembre, diez días antes de que el precio de venta llegara a 39,99 $. El descuento que veían los compradores se medía contra la cifra más alta. Los datos muestran la secuencia; no muestran el motivo.
El ranking mejoró durante el descuento y se mantuvo después. El BSR estuvo entre unos 2.300 y 2.570 a precio completo, bajó de forma sostenida hasta 1.611 durante el periodo de 39,99 $ y se mantuvo entre 1.370 y 1.780 en los seis días posteriores a la vuelta del precio. En la subcategoría, el producto pasó del quinto o sexto puesto al segundo o tercero.
El vendedor no cambió nunca. buyBoxSellerIdHistory muestra el mismo ID de vendedor todo el tiempo, y sellers se mantiene en 1. Nadie más competía por la Buy Box, así que los movimientos de precio fueron decisiones de la propia marca.
Una cautela sobre el tercer punto: que el ranking mejore mientras el precio es más bajo es lo esperable, pero un producto durante un mes no prueba la causa. Un BSR más bajo significa más ventas respecto a la categoría, y en un mes cambian también otras cosas.
Cuatro cosas que resolver en el código
1. Las series llegan en orden temporal. Cada array se ordena por timePoint antes de llegarte (el servicio de datos los devuelve desordenados). Si unes varias ventanas, vuelve a ordenar.
2. Trata -1 como dato ausente. dealPrice fue -1 todos los días porque no hubo ninguna oferta. buyBox fue -1 dos días, y reviews y rating uno. Fíltralos; no los representes como un precio de menos un dólar.
3. Une las series por día, no por marca de tiempo. En esta respuesta las observaciones de las distintas series comparten marcas de tiempo, pero no te fíes de ello. Reduce cada timePoint a una fecha antes de unir.
4. Lee con cuidado el número de reseñas. En esta ventana el recuento pasó de 3.109 a 3.366, con un salto de unas 200 en un solo día seguido de una pequeña bajada. Los recuentos de una familia de variaciones están agrupados, así que un cambio en la familia aparece como un salto. No son 200 reseñas nuevas en un día. ASIN padre e hijo explica la agrupación.
Para qué usarlo
Antes de igualar el precio de un competidor, comprueba si es su precio habitual o una promoción que termina la semana que viene.
Antes de un evento de ventas, consulta la ventana del año pasado de los principales competidores. Lo que hicieron entonces es la mejor guía disponible de lo que harán ahora. El ejemplo anterior es exactamente eso: una ventana de hace un año.
Cuando se mueva tu propio ranking, mira si un competidor cambió de precio en esos mismos días.
Al valorar un descuento, compara el precio de venta con priceList a lo largo del tiempo, no en un solo día.
Un proceso diario que guarda el precio de hoy es una herramienta distinta de esta. Monitorización de precios y cupones de la competencia trata ese caso y cuándo conviene cada uno. Dónde se sitúa un precio dentro de su categoría está en lee las franjas de precio de la categoría.
Lo que el historial de precios no puede decirte
Por qué cambió un precio. Ves la secuencia, no el razonamiento ni el coste que hay detrás.
Lo que pagó realmente un comprador. Los cupones van aparte del precio publicado. El endpoint de tendencias de cupones los devuelve.
Las unidades vendidas. El BSR es un ranking. Convertir el ranking en unidades es una estimación; consulta qué dicen y qué no dicen los datos de ventas de Amazon.
Todos los precios intermedios. Con dailyLatest obtienes una observación por día. Un precio que cambió y volvió a cambiar dentro del mismo día puede no aparecer.
Preguntas frecuentes
¿Hasta cuándo se remonta el historial? La petición anterior devolvió una ventana completa de un año antes. La cobertura depende del producto; prueba los ASIN que te interesen.
¿Son datos oficiales de Amazon? No. Amazon no ofrece una API pública de historial de precios. Son observaciones de la página pública del producto recogidas a lo largo del tiempo.
¿Una llamada devuelve varios productos? No. Un ASIN por llamada, y cada llamada correcta consume una unidad de facturación.
¿Puedo obtener el historial del producto de un competidor? Sí. El endpoint acepta cualquier ASIN de los marketplaces admitidos.