API de estimación de ventas de Amazon por ASIN o BSR

Qué devuelve esta API

Amazon no publica cuántas unidades vende un producto. Toda cifra de ventas que ves en una herramienta para vendedores es una estimación, modelada sobre todo a partir del Best Sellers Rank. Esta API ofrece esas estimaciones de tres formas:

Una petición real para una fuente de agua para gatos en EE. UU. (ASIN B08NCDBT7Q) devolvió una serie diaria del 1 de septiembre de 2025 al 14 de octubre de 2026 y catorce filas mensuales. Una parte:

Las filas diarias llevan bsr junto a sales, así que ves la entrada al lado de la estimación. La serie muestra lo que una media mensual oculta: el Black Friday a más del triple de un día normal, un mes de verano un 50 % por encima de septiembre y la Nochebuena a un tercio de un día normal.

Ejemplo de petición

curl --request POST \
  --url https://ecommercedataapi.com/v1/amazon/sales/prediction/asin \
  --header "Content-Type: application/json" \
  --header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
  --data '{
    "marketplace": "US",
    "asin": "B08NCDBT7Q"
  }'

• asin es obligatorio; marketplace vale US por defecto. Códigos admitidos: US, UK, DE, FR, IT, ES, MX, CA, AU, JP, IN, AE, BR.
• La respuesta contiene asinDetail (título, categoría, valoración), dailyItemList y monthItemList. El mes en curso es parcial: octubre de 2026 tenía 14 días.
• Una llamada devuelve todo el historial, así que no pagas por paginar.

De un ranking a una cifra de ventas

Cuando solo tienes un ranking —de una captura, una lista de categoría o tu propio seguimiento— el endpoint de BSR lo convierte. En Pet Supplies (categoryId 2619533011), el BSR 300 devolvió estMonthSales: 23523 y estDailySales: 784, junto con un itemList de los rankings 1 a 1.300 en la misma llamada:

Esa es la curva sobre la que se construye toda estimación, y es empinada: pasar del puesto 1.000 al 100 multiplica las ventas por cinco. La fuente anterior estuvo entre el BSR 240 y 430 en septiembre y se estimó en 22.730 unidades, coherente con la curva.

Dos estimaciones lado a lado

El endpoint de tendencia de ventas usa otro modelo mensual. Para el mismo producto, septiembre de 2026 dio 22.548 unidades del padre frente a 22.730 del modelo diario: menos de un 1 % de diferencia. Julio de 2026 no coincidió: 12.190 frente a 35.501. Que dos modelos coincidan es una prueba; que no coincidan es motivo para mirar la serie diaria antes de fiarte de cualquiera de los dos meses.

El endpoint de tendencia también devuelve childUnitSales en pasos redondos (10000, 9000, 8000). Léelo como una franja, no como un recuento.

Usos habituales

1. Dimensionar a un competidor. Obtén la serie mensual de los listings principales de un nicho y súmalas. Combínalo con la investigación de productos para encontrar esos listings.
2. Ordenar una lista corta sin gastar. Si tu lista ya tiene BSR y categoría, una sola llamada de BSR devuelve toda la curva, así que estimas muchos productos con una petición.
3. Detectar la estacionalidad. Las filas diarias muestran picos de eventos y caídas en festivos; las mensuales, la temporada. La investigación de productos estacionales explica cómo leerlas.
4. Revisar un cambio de precio. price está en la misma fila que sales, así que ves si un cambio de precio vino con un cambio de ventas. Para un historial de precios más largo, consulta el historial de precios.

Límites que conviene conocer

• Son estimaciones, no cifras de Amazon. Úsalas para comparar productos y ver la tendencia. Qué pueden y qué no pueden decir las estimaciones de ventas explica el modelo y sus puntos ciegos.
• Las curvas de BSR son por categoría. El puesto 300 en una categoría no dice nada del puesto 300 en otra.
• El ranking es relativo al resto de la categoría: si toda la categoría se enfría, el ranking puede no moverse mientras las ventas bajan.
• Cada llamada correcta consume una unidad de facturación. Gestiona las respuestas 429 como se describe en errores y límites de uso.

Preguntas frecuentes

¿Ofrece Amazon una API oficial de ventas de productos de otros vendedores? No. La Selling Partner API solo informa de las ventas de tu propia cuenta. Las de cualquier otro ASIN solo se pueden estimar.

¿Por qué las herramientas no coinciden con el mismo ASIN? Cada herramienta ajusta su propia curva de ranking a ventas. Compara herramientas con los mismos productos en el mismo mes y quédate con la que se mueve con eventos que puedes verificar.

¿Puede llamarla un agente de IA? Sí. Los tres endpoints son herramientas del servidor MCP remoto, así que un asistente puede responder «cuánto vende este ASIN» con datos y no con una suposición.