Volver al blog

Búsqueda de ASIN de Amazon: Convierte un ASIN en un registro de producto con la API de Scraper.

Isabella Garcia
Isabella Garcia

Web Data Collection Specialist

29-Jun-2026

TL;DR:

  • Un ASIN es la clave principal de Amazon para un producto, y la API de Scraper de Amazon lo convierte en un registro completo del producto. Pasa una URL de producto que contenga el ASIN y el actor scraper.amazon devuelve campos de título, marca, precios, disponibilidad, calificaciones, vendedor y categoría como JSON estructurado.
  • La búsqueda se realiza a través de un único endpoint autenticado: POST https://api.scrapeless.com/api/v1/scraper/request con un encabezado x-api-token, un actor de scraper.amazon, y un objeto input que lleva la url y un type de product.
  • La respuesta separa los datos crudos y analizados en una única carga. Cada llamada devuelve tres claves de nivel superior: html (la página renderizada), metadata (el eco de la solicitud) y result (el objeto del producto analizado), para que puedas leer campos limpios o recurrir a HTML.
  • La asignación de país es un campo de solicitud de primera clase. Un objeto proxy con un country de US enruta la búsqueda a través de la salida residencial de EE. UU., lo que mantiene los precios, la disponibilidad, y la Buy Box consistentes con lo que ve un comprador en EE. UU.
  • El mismo actor cubre más que búsquedas de productos. Cambiar type a keywords convierte al actor en un lector de resultados de búsqueda (página, palabra clave y un array result de listados), por lo que el enriquecimiento de ASIN y el descubrimiento comparten una integración.
  • Gratis para comenzar. Las nuevas cuentas de Scrapeless incluyen créditos gratuitos para la API de Scraper, regístrate en app.scrapeless.com.

Introducción: convierte un ASIN en un registro de producto estructurado

Cada producto en Amazon lleva un ASIN de diez caracteres, y es el único identificador que se mantiene constante mientras el título, precio y vendedor de un listado cambian. Los equipos de precios, constructores de catálogos y agentes de IA basan sus datos en ello. La parte difícil es ir en la otra dirección: de un ASIN de vuelta a campos de producto limpios y actuales.

Raspar una página de producto a mano significa renderizar una página pesada en JavaScript, sobrevivir a los desafíos de acceso que Amazon presenta al tráfico de centros de datos, y luego escribir selectores contra un markup que cambia entre diseños y regiones. Los selectores se rompen, los precios regresan localizados al país incorrecto, y el vendedor de la Buy Box que analizaste pertenece a una región diferente a la que querías.

Esta guía explica una búsqueda de ASIN en la API de Scraper de Amazon de Scrapeless — el actor gestionado scraper.amazon en la línea más amplia de la API de Scraping. Envías una URL de producto, el actor renderiza y analiza la página del lado del servidor, y obtienes un objeto de producto estructurado de vuelta. El recorrido cubre el endpoint y sus parámetros, una solicitud autenticada, el esquema de respuesta real, y un lector en Python que consume los campos analizados.


Qué hace la API de Búsqueda de ASIN de Amazon

La API de Scraper de Amazon toma una URL de producto que contiene un ASIN y devuelve el registro del producto analizado para ese listado. Le das la ruta de producto canónica — https://www.amazon.com/dp/<ASIN> — y el actor scraper.amazon maneja la renderización, anti-detección y extracción de campos en el servidor, luego devuelve JSON.

  • Resuelve un ASIN a campos de producto. Una única llamada type: product devuelve el título, marca, precio, disponibilidad, calificación, cantidad de reseñas, vendedor, y ruta de categoría para el ASIN en la URL.
  • Lee tanto el objeto analizado como la página cruda. El objeto result lleva los campos estructurados; la clave html lleva los bytes de la página renderizada para cualquier cosa que el parser no haya levantado.
  • Fija la región de la tienda. Un valor proxy.country enruta la búsqueda a través de la salida residencial de ese país, por lo que los precios y la disponibilidad coinciden con esa localidad en lugar de una salida aleatoria.
  • Reutiliza la integración para el descubrimiento. El mismo actor acepta una URL de búsqueda con type: keywords y devuelve resultados de búsqueda paginados, por lo que el descubrimiento del catálogo y el enriquecimiento por ASIN pasan por un solo endpoint.
  • Salta la plomería del navegador. Sin navegador sin cabeza local, sin grupo de proxies y sin mantenimiento de selectores: lees campos del esquema analizado en lugar de mantener ninguno.

Endpoints y parámetros

La búsqueda de ASIN de Amazon es una llamada sincrónica al endpoint de solicitud de la API de Scraper.

Copy
POST https://api.scrapeless.com/api/v1/scraper/request

El cuerpo de la solicitud lleva tres campos de nivel superior:

Campo Tipo Requerido Descripción
actor string El identificador del servicio de raspado — scraper.amazon para Amazon.
input object Parámetros de la tarea. Para una búsqueda de ASIN: url (la URL del producto /dp/<ASIN>) y type (product).
proxy object no Configuración de salida. country (por ejemplo, US) fija la región de la tienda.

Dentro de input, la búsqueda de ASIN utiliza dos campos:

Campo de input Ejemplo Descripción
url https://www.amazon.com/dp/B07ZPKBL9V La URL canónica del producto. El ASIN está en la sección de ruta /dp/.
tipo producto Selecciona el parser de detalles del producto. Establezca en keywords para leer una URL de resultados de búsqueda en su lugar.

La autenticación es un único encabezado, x-api-token, que lleva su clave de API de Scrapeless. La búsqueda de productos devuelve en línea: el cuerpo JSON regresa en la misma respuesta HTTP, por lo que no se necesita un paso de sondeo de resultados para scraper.amazon.

Obtenga su clave de API en el plan gratuito: app.scrapeless.com


Una búsqueda de ASIN autenticada

Esta solicitud busca un único ASIN y fija la salida a la tienda de EE. UU. El encabezado x-api-token lleva su clave; guárdela en una variable de entorno en lugar de en el comando.

bash Copy
# Búsqueda de un ASIN (B07ZPKBL9V) y fijar la tienda de EE. UU.
curl -s -X POST "https://api.scrapeless.com/api/v1/scraper/request" \
  -H "Content-Type: application/json" \
  -H "x-api-token: ${SCRAPELESS_API_KEY}" \
  -d '{
    "actor": "scraper.amazon",
    "input": {
      "url": "https://www.amazon.com/dp/B07ZPKBL9V",
      "type": "producto"
    },
    "proxy": { "country": "US" }
  }'

La respuesta llega como un objeto JSON con claves html, metadata y result. El objeto metadata refleja la solicitud: el tipo que solicitó y un rawUrl apuntando a la página renderizada almacenada:

json Copy
{
  "rawUrl": "https://api.scrapeless.com/storage/scrapeless.scraper.amazon/<hash>.html",
  "type": "producto"
}

El esquema de respuesta

Los datos estructurados del producto se encuentran bajo result. A continuación se muestra la estructura devuelta para el ASIN B07ZPKBL9V, con los nombres de campo exactamente como los emite el actor y los valores capturados de la búsqueda en vivo.

json Copy
{
  // El esquema refleja exactamente lo que emite el parser de producto scraper.amazon.
  // Los valores son una captura real para el ASIN B07ZPKBL9V; la matriz de características es una muestra ilustrativa.
  "result": {
    "asin": "B07ZPKBL9V",
    "input_asin": "B07ZPKBL9V",
    "parent_asin": "B0GR1S2JM2",
    "title": "Apple iPhone 11, 64GB, PRODUCT RED - Desbloqueado (Renovado)",
    "brand": "Apple",
    "manufacturer": "Apple Computer",
    "final_price": "$174.00",
    "initial_price": "$174.64",
    "discount": "-11%",
    "availability": "Solo quedan 4 en stock - ordene pronto.",
    "is_available": true,
    "reviews_count": 60289,
    "seller_name": "WirelessSource",
    "categories": ["Teléfonos celulares y accesorios", "Teléfonos celulares"],
    "domain": "https://www.amazon.com",
    "url": "https://www.amazon.com/dp/B07ZPKBL9V",
    "images_count": 1,
    "features": ["...", "...", "..."]
  }
}

El objeto producto lleva más que los campos anteriores: el result completo también expone buybox_seller, number_of_sellers, product_dimensions, item_weight, date_first_available, model_number, variations, product_details, prices_breakdown, y una matriz anidada de images, entre otros. Los campos que no se aplican a una lista dada regresan vacíos en lugar de estar ausentes, por lo que debe codificarse contra la presencia, no la ausencia.

Algunos campos merecen una segunda mirada:

  • asin vs input_asin vs parent_asin. input_asin es el ASIN que envió; asin es la lista a la que se resolvió la página; parent_asin es el grupo de variaciones al que pertenece la lista. Para una variación hija, los tres pueden diferir.
  • Los precios son cadenas con su glifo de moneda. final_price es "$174.00", no un número: analice el valor numérico usted mismo si necesita aritmética, y consulte prices_breakdown para los precios desglosados.
  • is_available es el booleano en el que bifurcar. availability es la cadena comprensible ("Solo quedan 4 en stock"); is_available es el indicador de máquina.
  • reviews_count es un entero. Cuenta las calificaciones en la lista en el momento de la búsqueda y se mueve entre llamadas.

Manejo de la salida estructurada

En código, la búsqueda es una solicitud POST y una lectura de result. Este lector de Python extrae los campos que la mayoría de los catálogos necesitan y imprime un registro plano.

python Copy
import os
import requests

API_URL = "https://api.scrapeless.com/api/v1/scraper/request"


def lookup_asin(asin: str, country: str = "US") -> dict:
    """Resuelve un ASIN de Amazon a su registro de producto analizado."""
    payload = {
        "actor": "scraper.amazon",
        "input": {
            "url": f"https://www.amazon.com/dp/{asin}",
            "type": "producto",
        },
        "proxy": {"country": country},
    }
    headers = {
        "Content-Type": "application/json",
        "x-api-token": os.environ["SCRAPELESS_API_KEY"],
    }
    response = requests.post(API_URL, json=payload, headers=headers, timeout=120)
    response.raise_for_status()
    return response.json()["result"]


if __name__ == "__main__":
    product = lookup_asin("B07ZPKBL9V")
    record = {
        "asin": product.get("asin"),
        "title": product.get("title"),

"marca": product.get("brand"),
"precio": product.get("final_price"),
"en_stock": product.get("is_available"),
"cantidad_de_calificaciones": product.get("reviews_count"),
"vendedor": product.get("seller_name"),
"categoría": " > ".join(product.get("categories") or []),
}
print(record)

Copy
El lector toma todo de `result` y trata los campos faltantes como `None` a través de `.get()`, lo que coincide con cómo el actor devuelve campos no aplicables vacíos. Para enriquecer una lista de ASINs, itera sobre ellos y mantiene la concurrencia moderada: unos pocos trabajadores a la vez son suficientes y mantienen limpio el egreso de cada tienda.

Para el descubrimiento del catálogo en lugar de la mejora por ASIN, cambia `type` a `keywords` y pasa una URL de búsqueda (`https://www.amazon.com/s?k=<query>`); la misma llamada devuelve un objeto `result` con `keyword`, `current_page`, `total_page`, y un array `result` de listados que puedes retroalimentar a la búsqueda de ASIN anterior. El mismo patrón se escala al resto de un pipeline de precios competitivos o catálogo; emparejalo con el resumen clasificado en [la mejor guía de scrapers de Amazon](https://www.scrapeless.com/es/blog/best-amazon-scrapers-2026) para ver dónde se adapta un actor gestionado en comparación con las alternativas, y consulta [precios de la API de scraping](https://www.scrapeless.com/es/pricing?utm_source=website&utm_medium=blog&utm_campaign=scraperapi&utm_term=amazon-asin-lookup-api) antes de aumentar el volumen de llamadas.

---

## Conclusión: construir un feed de productos clave ASIN

Una búsqueda de ASIN de Amazon se reduce a cuatro decisiones: enviar la URL `/dp/<ASIN>`, establecer `type` a `product`, fijar el `proxy.country` a la tienda que desees, y leer los campos analizados de `result`. La API de Scraper [gestionada de Amazon](https://www.scrapeless.com/es/product/scraping-api?utm_source=website&utm_medium=blog&utm_campaign=scraperapi&utm_term=amazon-asin-lookup-api) maneja el renderizado, la anti-detección y el análisis, por lo que codificas contra el esquema analizado en lugar de un conjunto de selectores que se rompe en el próximo rediseño.

Desde aquí, el mismo actor `scraper.amazon` alimenta un pipeline más amplio: `type: keywords` descubre ASINs, `type: product` enriquece cada uno, y un egreso con país fijado mantiene precios y disponibilidad honestos por región. La referencia completa de solicitud y respuesta se encuentra en la [documentación de Scrapeless](https://docs.scrapeless.com?utm_source=website&utm_medium=blog&utm_campaign=scraperapi&utm_term=amazon-asin-lookup-api). Trata los precios como cadenas, diferencia en `is_available`, y lee los campos vacíos como anulables en lugar de errores.

---

## ¿Listo para construir tu pipeline de datos impulsado por IA?

Únete a nuestra comunidad para reclamar un plan gratuito y conectarte con desarrolladores que están construyendo pipelines de datos de productos de Amazon: [Discord](https://discord.gg/VU2vtbq7Q2) · [Telegram](https://t.me/scrapeless).

Regístrate en [app.scrapeless.com](https://app.scrapeless.com/passport/login/?utm_source=website&utm_medium=blog&utm_campaign=scraperapi&utm_term=amazon-asin-lookup-api) para obtener créditos gratuitos de Scraper API y adapta el look-up anterior a los ASINs, tiendas y regiones que necesite tu catálogo.

---

## FAQ

**Q: ¿Qué es un ASIN y dónde lo encuentro?**
Un ASIN es el Número de Identificación Estándar de diez caracteres de Amazon para un producto. Aparece en la URL del producto después de `/dp/` (por ejemplo, `B07ZPKBL9V` en `amazon.com/dp/B07ZPKBL9V`) y en la sección "Información del producto" del listado. La API de Scraper de Amazon lee el ASIN directamente de la `url` que pasas.

**Q: ¿Envio el ASIN o la URL completa?**
Envías la URL completa del producto con el ASIN en el segmento `/dp/`, y estableces `input.type` a `product`. El actor analiza el ASIN del camino y te lo devuelve como `input_asin` (lo que enviaste) y `asin` (lo que la página resolvió).

**Q: ¿Es legal raspar datos de productos de Amazon por ASIN?**
Los datos de listados de productos públicos son generalmente accesibles, pero la legalidad depende de tu jurisdicción, los datos que recopilas y los términos de servicio de Amazon. Revisa los términos aplicables y consulta con un abogado para tu caso de uso específico. Scrapeless accede solo a datos públicamente disponibles.

**Q: ¿Necesito fijar un país de proxy?**
Para precios y disponibilidad consistentes, sí. Amazon localiza precios, la Buy Box y el stock por región, así que establece `proxy.country` a la tienda que desees (por ejemplo, `US` para `amazon.com`). Sin ello, la región de egreso puede variar y distorsionar los precios que lees.

**Q: ¿Por qué algunos campos están vacíos en la respuesta?**
El analizador de productos devuelve cada campo en su esquema y deja vacíos aquellos que no aplican a un listado en lugar de omitirlos. Un teléfono renovado no llevará `ingredients`; un libro no llevará `item_weight`. Trata los campos vacíos como anulables y ramifica en presencia en tu código.

**Q: ¿Puedo buscar muchos ASINs a la vez?**
El endpoint resuelve un ASIN por solicitud, así que itera sobre tu lista de ASINs y llama por cada ítem. Mantén la concurrencia moderada: unos pocos trabajadores a la vez, para mantener limpio el egreso de cada tienda mientras enriqueces un catálogo.

**Q: ¿Cómo encuentro ASINs para buscar en primer lugar?**
Utiliza el mismo actor con `input.type` configurado en `keywords` y una URL de búsqueda (`amazon.com/s?k=<query>`). Devuelve un arreglo paginado `result` de listados con sus ASINs, que luego alimentas en la búsqueda de `type: product` para obtener registros completos.

En Scrapeless, solo accedemos a datos disponibles públicamente y cumplimos estrictamente con las leyes, regulaciones y políticas de privacidad del sitio web aplicables. El contenido de este blog es sólo para fines de demostración y no implica ninguna actividad ilegal o infractora. No ofrecemos garantías y renunciamos a toda responsabilidad por el uso de la información de este blog o enlaces de terceros. Antes de realizar cualquier actividad de scraping, consulte a su asesor legal y revise los términos de servicio del sitio web de destino u obtenga los permisos necesarios.

Artículos más populares

Catalogar