«Búsqueda por ASIN» abarca tres tareas distintas: encontrar el ASIN de un producto, convertir otro identificador en un ASIN y obtener los datos del producto una vez lo tienes.
Cuál estás haciendo depende de lo que tienes en la mano. El identificador del que partes decide la ruta, y para uno de ellos no hay ruta.
Parte de lo que tienes
| Tienes | Qué hacer | ¿Funciona? |
|---|---|---|
| Un ASIN | Consultar los datos del producto directamente | Sí |
| La URL de una página de producto | Leer el ASIN de la URL y consultar | Sí |
| Un código de barras UPC o EAN | Buscar el código en Amazon, leer el ASIN del resultado y consultar | Sí, en dos pasos |
| Un nombre de producto o una palabra clave | Buscar, elegir el producto y tomar su ASIN | Sí |
| Tu propio SKU | Consultarlo en tu cuenta de vendedor | Sí, solo en tu cuenta |
| El SKU de un competidor | Nada | No |
La última fila sorprende. Un SKU es una etiqueta que un vendedor inventa para su propio inventario. Es privado de su cuenta, así que no existe una «búsqueda por SKU» pública para el producto de otro. Lo que sí puedes consultar es el ASIN, que es público. Qué es un ASIN explica quién asigna cada identificador.
Encontrar el ASIN
En cualquier página de producto, el ASIN es el segmento de diez caracteres que sigue a /dp/:
https://www.amazon.com/dp/B08CK5Z5Q1
^^^^^^^^^^También aparece en la sección de información del producto de la página. Un ASIN tiene siempre diez caracteres, letras mayúsculas y dígitos.
Consultar un ASIN
El endpoint de detalle de producto recibe un ASIN y devuelve el listing como un único objeto JSON:
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"
}'| Campo | Qué te dice |
|---|---|
title, brand, parent | Qué producto es y cuál es su listing padre |
price, coupon | Precio actual y texto del cupón |
bsrRank, bsrLabel, subcategories | Ranking de más vendidos, su categoría y los rankings de subcategoría |
rating, ratings | Valoración en estrellas y número de valoraciones |
sellerName, sellers, fulfillment | Quién lo vende, cuántos vendedores hay y cómo se envía |
variations, variationList | La familia de variaciones y el ASIN de cada una |
features, dimensions, weight | Viñetas y tamaño físico |
El endpoint solo acepta un ASIN. No hay parámetro de UPC, EAN ni GTIN, así que un código de barras tiene que convertirse en ASIN antes de llamarlo. La página de la API de datos de producto de Amazon tiene la lista completa de campos.
Consultar muchos ASIN
Llamar al endpoint de detalle una vez por producto funciona, y para una tabla comparativa es la vía lenta. El endpoint de búsqueda de productos acepta un array asins y devuelve los mismos campos de comparación para todos en una sola petición:
curl --request POST \
--url https://ecommercedataapi.com/v1/amazon/product/competitor-lookup \
--header "Content-Type: application/json" \
--header "X-API-Key: ${ECOMMERCE_DATA_API_KEY}" \
--data '{
"marketplace": "US",
"asins": ["B08CK5Z5Q1", "B07Z82895W"]
}'Cada elemento incluye price, bsr, units y revenue (ventas mensuales estimadas), rating, ratings y datos del vendedor. Envía asins o keyword, no ambos.
Usa el detalle cuando necesites el listing en sí: título, viñetas, variaciones, atributos. Usa la búsqueda cuando necesites una tabla para comparar productos por precio, ranking y ventas estimadas.
Cuatro cosas que salen mal
1. El marketplace equivocado. Un ASIN suele existir en varios marketplaces, pero el precio, el ranking y las reseñas son independientes en cada uno. Una consulta en Estados Unidos no dice nada de Japón.
2. Valores ausentes. Un campo que no existe para un producto vuelve como null o -1, por ejemplo primePrice: -1. Compruébalo antes de hacer cálculos.
3. Padre contra hijo. Las cifras de un ASIN padre cubren toda la familia de variaciones; las de un hijo, una sola variación. Comparar el padre de un producto con el hijo de otro puede desviarse varias veces. ASIN padre e hijo explica qué cifras se agrupan.
4. Un ASIN que deja de resolverse. Los listings se fusionan, se dividen y se eliminan. Un proceso de larga duración debe gestionar el «no encontrado» en lugar de dar por hecho que un ASIN es permanente.
Preguntas frecuentes
¿Puedo consultar un producto por UPC? Aquí no en una sola llamada. Busca el UPC en Amazon, lee el ASIN del resultado y consulta el ASIN.
¿Existe una búsqueda por SKU de Amazon? Para tus propios SKU, en tu cuenta de vendedor. Para los de otros, no: los SKU son privados. Consulta el ASIN.
¿Necesito una llamada por producto?
Para los datos completos del listing, sí. Para precio, ranking, ventas estimadas y valoraciones, envía una lista en asins y los obtienes en una llamada.
¿Puedo consultar un ASIN desde un asistente de IA? Sí. Ambos endpoints son herramientas del servidor MCP remoto, así que puedes preguntar en lenguaje natural. Consultar datos de Amazon en Claude Code muestra la configuración.