amazon/
product-detail

Recopile los detalles públicos de productos de Amazon a partir de URL conocidas y obtenga títulos, descripciones, vendedores, precios, calificaciones, cantidades de reseñas y de unidades vendidas, y contenido multimedia como registros normalizados.

Amazon Product Details API

URL de productos conocidas
Entrada de varios marketplaces
Registros de productos normalizados
0.15 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
urlsObligatorioLista 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.

  1. Envíe por POST una lista urls a /v1/amazon/product-detail con un token Bearer o una clave de API.
  2. Guarde el task_id devuelto y consulte GET /v1/tasks/{task_id} hasta que status sea succeeded o failed.
  3. 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 true

Casos 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.

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.

Explorar otras plataformas

Combine los datos de Amazon con datos públicos de otras plataformas sociales compatibles.

Amazon Product Details API — FAQ

Amazon Product Details API es una interfaz programática para recopilar detalles públicos de productos a partir de referencias conocidas de Amazon. Devuelve identificadores normalizados, títulos, descripciones, objetos de vendedor y precio, calificaciones, cantidades de reseñas y de unidades vendidas, contenido multimedia y metadatos de la recopilación.

Envíe una lista urls no vacía con URL de productos de Amazon. El entorno de ejecución acepta los hosts de Amazon de Estados Unidos, Reino Unido, Alemania, Francia, España, Italia, Canadá, Australia, India y Japón, incluidos sus subdominios.

Sí. Agregue varias URL conocidas a la lista urls. El límite de resultados del proveedor es igual a la cantidad de URL enviadas, y las filas no válidas, no disponibles o con error pueden dejar la cantidad de resultados exitosos por debajo de ese límite.

El esquema estable de producto incluye campos de identidad y de origen, título, descripción, objetos anidados de vendedor y precio, calificación, cantidad de reseñas, cantidad de unidades vendidas reportada, contenido multimedia y marcas de tiempo. Los valores opcionales de la fuente quedan en null cuando no están disponibles.

La paginación se aplica al leer los resultados almacenados cuando la tarea ya se completó con éxito, no al enviar las URL de productos. Siga next_cursor con GET /v1/tasks/{task_id} solo mientras has_more sea true.

La solicitud reserva una estimación de 0.15 créditos por cada URL enviada y se liquida a 0.15 créditos por cada registro de producto devuelto con éxito. Con una base de cero créditos y una política de resultados vacíos que cobra solo la base, una tarea sin registros devueltos se liquida en cero.