Búsqueda de ASIN de Amazon: Convierte un ASIN en un registro de producto con la API de Scraper.
Web Data Collection Specialist
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.amazondevuelve 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/requestcon un encabezadox-api-token, unactordescraper.amazon, y un objetoinputque lleva laurly untypedeproduct. - 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) yresult(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
proxycon uncountrydeUSenruta 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
typeakeywordsconvierte al actor en un lector de resultados de búsqueda (página, palabra clave y un arrayresultde 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: productdevuelve 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
resultlleva los campos estructurados; la clavehtmllleva 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.countryenruta 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: keywordsy 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.
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 | sí | El identificador del servicio de raspado — scraper.amazon para Amazon. |
input |
object | sí | 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
# 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
{
"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
{
// 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:
asinvsinput_asinvsparent_asin.input_asines el ASIN que envió;asines la lista a la que se resolvió la página;parent_asines 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_pricees"$174.00", no un número: analice el valor numérico usted mismo si necesita aritmética, y consulteprices_breakdownpara los precios desglosados. is_availablees el booleano en el que bifurcar.availabilityes la cadena comprensible ("Solo quedan 4 en stock");is_availablees el indicador de máquina.reviews_countes 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
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)
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.



