Amazon Product Details
Los productos de Amazon son artículos públicos de un catálogo, descritos mediante identificadores, títulos, descripciones, contexto del vendedor, precios, calificaciones, cantidades de reseñas, cantidades de unidades vendidas y contenido multimedia. Estos campos sirven para enriquecer catálogos, comparar artículos, verificar fuentes y elaborar informes de productos en un momento dado.
Funcionalidades de la Amazon Product Details API
- Consulta por lotes a partir de URL de productos conocidasEnvíe una o más URL de Amazon en una sola tarea y reciba, como máximo, tantos registros de productos normalizados como URL válidas haya enviado.
- Identidad, texto y contenido multimedia del productoCada registro puede incluir el identificador y la URL del producto, el título, la descripción, la marca de tiempo de la recopilación y las referencias disponibles de imágenes o videos.
- Vendedor, precio y señales visibles del productoLos objetos anidados de vendedor y precio acompañan a los campos de calificación, cantidad de reseñas y cantidad de unidades vendidas reportada, para un procesamiento uniforme campo por campo.
- Hosts de marketplaces de Amazon compatiblesEl validador de URL acepta los hosts de Amazon de Estados Unidos, Reino Unido, Alemania, Francia, España, Italia, Canadá, Australia, India y Japón, incluidos sus subdominios.
Parámetros de la Amazon Product Details API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria y no vacía de referencias conocidas de productos de Amazon. El nombre de host analizado debe ser amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp o un subdominio. Se aceptan referencias con cualquier esquema que tenga un nombre de host y referencias relativas al protocolo. |
Cómo usar la Amazon Product Details API
Envíe URL de productos conocidas, guarde el ID de la tarea asíncrona y lea los registros de productos normalizados cuando la tarea se complete con éxito.
- Envíe por POST una lista urls a /v1/amazon/product-detail con un token Bearer o una clave de API.
- Guarde el task_id devuelto y consulte GET /v1/tasks/{task_id} hasta que status sea succeeded o failed.
- Lea data.results.items tras el éxito; si has_more es true, solicite la siguiente página de resultados con next_cursor sin enviar otra tarea de productos.
curl -X POST "https://api.socq.ai/v1/amazon/product-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; follow next_cursor only while has_more is trueCasos de uso de la Amazon Product Details API
- Enriquecimiento de catálogo con artículos conocidos: Agregue títulos de productos, descripciones, contexto del vendedor, precios, contenido multimedia, calificaciones y cantidades a un conjunto existente de URL de Amazon.
- Comparación de productos en un momento dado: Compare los campos normalizados de precio, moneda, calificación, cantidad de reseñas, cantidad de unidades vendidas y vendedor entre los registros de productos seleccionados que se recopilaron al mismo tiempo.
- Verificación de la fuente del producto: Use identificadores, URL canónicas, títulos, descripciones, referencias multimedia y marcas de tiempo de recopilación para contrastar las referencias de catálogo almacenadas con las páginas públicas de los productos.
Consejos de expertos para la Amazon Product Details API
- Use referencias de productos cuyo nombre de host analizado pertenezca a un marketplace de Amazon compatible; un host válido por sí solo no garantiza que el destino corresponda a un registro público de producto.
- No envíe results_limit, porque este endpoint fija el límite de resultados del proveedor en la cantidad de URL enviadas.
- Trate los campos de vendedor, precio, calificación, cantidad de reseñas, cantidad de unidades vendidas, contenido multimedia, URL y momento de publicación como valores que pueden ser nulos, y conserve una tarea exitosa con cero elementos en lugar de crear datos de relleno.
- Use next_cursor solo al recorrer los resultados almacenados de la tarea; continúe con solicitudes GET de la misma tarea en lugar de repetir el POST de pago.
APIs relacionadas
Además de la Amazon Product Details API, use estas APIs cuando necesite otro tipo de datos públicos de Amazon.
- Amazon Best Sellers API — Recolecta productos desde URLs públicas de categorías de más vendidos de Amazon, con campos normalizados de vendedor, precio, reputación, cantidad vendida, contenido multimedia, origen y marca de tiempo.
- Amazon Product Search API — Busca en una tienda de Amazon compatible por frase de producto y devuelve, cuando están disponibles, campos normalizados de producto, vendedor, precio, calificación, reseñas, cantidad vendida, contenido multimedia y fuente.
- Amazon Reviews API — Recolecta reseñas públicas de productos desde URLs de Amazon compatibles, con texto, calificaciones, datos del autor, referencias al producto, marcas de tiempo y contenido multimedia.
- Amazon Seller Info API — Recolecta desde URLs conocidas de vendedores la identidad pública del perfil de vendedor de Amazon, descripción, sitio web, calificación, comentarios, ubicación, origen y campos de hora de recolección.
- Amazon Storefront API — Lee la tienda de un creador de Amazon a partir de su URL con perfil, cuentas sociales vinculadas, listas de ideas con número de artículos, posts curados y productos en tendencia con precio.