API de datos de producto de Amazon: consulta por ASIN

Qué devuelve esta API

El endpoint de detalles de producto recibe un ASIN y devuelve los datos del listing como un único objeto JSON. No hay nada que extraer de una página.

Los campos que más se usan:

La lista completa está en la referencia de Product Details.

Ejemplo de petición

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

• asin es obligatorio; marketplace admite US, JP, UK, DE, FR, IT, ES, CA, IN, MX, BR, AU y AE. Usa ES con un ASIN de Amazon.es.
• El endpoint recibe un ASIN. No hay parámetro UPC, EAN ni GTIN, así que un código de barras hay que convertirlo en ASIN antes de llamar. Qué es un ASIN y en qué se diferencia de SKU, UPC y FNSKU explica los identificadores.

Consultar muchos productos

El endpoint de detalles devuelve un producto por llamada. Para comparar muchos ASIN en una sola petición, usa Product Search con el array asins, que devuelve precio, BSR, unidades mensuales estimadas, valoraciones y datos del vendedor de cada uno. Usa detalles cuando necesites el listing en sí (título, características, variaciones, atributos), y búsqueda cuando necesites una tabla comparativa.

Otros endpoints comparten el mismo ASIN de entrada:

• Historial de producto: instantáneas de precio, ranking, valoración y listing a lo largo del tiempo.
• Tendencias de ventas por ASIN: unidades e ingresos mensuales del listing padre y de cada hijo.
• Tendencias de cupones y detalles con tendencias de cupones.

Usos habituales

1. Completar una lista de productos. Toma los ASIN que ya sigues y añade título, marca, precio, BSR y categoría, para que una hoja de cálculo se convierta en una tabla de trabajo.
2. Vigilar a un competidor. Consulta el mismo ASIN cada día y compara price, bsrRank, rating y coupon. Seguimiento de precios y cupones de la competencia muestra la tarea diaria.
3. Revisar el listing antes de comparar. Mira variations y parent antes de poner dos productos lado a lado: las cifras de un padre abarcan toda la familia de variaciones. Consulta qué pueden y qué no pueden decir los datos de ventas de la API.
4. Puntuar un listing. lqs, las marcas de insignia y la longitud de features dan una lectura rápida de lo completo que está el listing de un competidor.

Límites que conviene conocer

• Los campos que no existen para un producto llegan como null o -1. El ejemplo documentado tiene primePrice: -1, deliveryPrice: -1, reviews: null y questions: null; compruébalos antes de operar con ellos.
• overviews es una cadena JSON que hay que analizar una segunda vez.
• Cada registro trae las marcas de tiempo createdTime y updatedTime en milisegundos. Revisa updatedTime antes de fiarte de un precio para una decisión.
• Cada llamada correcta consume una unidad de facturación. Gestiona las respuestas 429 según errores y límites de uso.

Preguntas frecuentes

¿Es la Product Advertising API de Amazon? No. La Product Advertising API está pensada para afiliados. Este endpoint devuelve datos de investigación como BSR, calidad del listing y variaciones, y no requiere una cuenta de Afiliados.

¿Puedo consultar por UPC o EAN? No directamente. Convierte primero el código de barras en un ASIN y después llama al endpoint.

¿Puede un agente de IA consultar productos? Sí. El endpoint está disponible como herramienta en el servidor MCP remoto, así que clientes MCP como Claude Code y Cursor pueden obtener un producto en plena conversación.