amazon/
best-sellers

Recopile productos a partir de URL públicas de Amazon Best Sellers y obtenga títulos, contexto del vendedor, precios, señales visibles de reputación y contenido multimedia como registros normalizados.

Amazon Best Sellers API

Entrada por URL de categoría
Registros de productos
0.15 créditos por resultado
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 Best Sellers

Las páginas de Amazon Best Sellers organizan los productos visibles públicamente en listas por categoría, con títulos, contexto del vendedor, precios, calificaciones, cantidad de reseñas, cantidad de unidades vendidas, contenido multimedia, enlaces de origen y momentos de observación cuando están disponibles. SocQ convierte las URL de las listas seleccionadas en registros de productos normalizados para investigar categorías, comparar surtidos y armar flujos de datos de comercio repetibles.

Funcionalidades de la Amazon Best Sellers API

  • Recopilación por URL de categoría regionalEnvíe una o más URL públicas de Best Sellers o de listas de categorías de los marketplaces de Amazon compatibles en una sola tarea asíncrona.
  • Identidad de producto normalizadaReciba registros de productos estables con los ID, títulos, descripciones y URL de origen disponibles, etiquetas de plataforma y de recurso, y marcas de tiempo de la recopilación.
  • Contexto comercial y de reputaciónConserve los datos disponibles del vendedor, los precios, las calificaciones, la cantidad de reseñas y la cantidad de unidades vendidas en campos explícitos, sin tener que analizar el marcado de la página.
  • Registros de productos con contenido multimediaUse objetos multimedia normalizados con cada producto para catálogos, colas de revisión, pipelines de enriquecimiento y análisis visual posterior.

Parámetros de la Amazon Best Sellers API

ParámetrosObligatorioDescripción
urlsObligatorioLista obligatoria de referencias de Amazon en hosts o subdominios de marketplaces compatibles. Cada ruta debe contener /zgbs/ o /gp/bestsellers/. Se aceptan referencias con cualquier esquema que tenga un nombre de host analizable y referencias relativas al protocolo.
results_limitOpcionalEntero opcional de 1 a 2,000. Su valor predeterminado es 100 y limita el total de registros de productos únicos guardados entre todas las URL enviadas.

Cómo usar la Amazon Best Sellers API

Envíe URL públicas conocidas de Best Sellers, supervise la tarea asíncrona y recorra por páginas los registros de productos normalizados.

  1. Prepare una o más URL públicas de Amazon Best Sellers o de listas de categorías en un host de marketplace compatible.
  2. Envíe urls y un results_limit opcional de 1 a 2,000 a /v1/amazon/best-sellers y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o devuelva un error.
  4. Lea data.results.items y solicite next_cursor mientras has_more siga siendo true.
curl -X POST "https://api.socq.ai/v1/amazon/best-sellers" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/Best-Sellers-Books/zgbs/books"],"results_limit":3}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Casos de uso de la Amazon Best Sellers API

  • Instantáneas del surtido por categoría: Convierta páginas seleccionadas de Best Sellers en un inventario de productos acotado, con enlaces de origen y momentos de recopilación, para un conjunto de datos de investigación definido.
  • Comparación de precios y reputación: Compare los precios, calificaciones, cantidades de reseñas y cantidades de unidades vendidas disponibles entre los productos devueltos, sin tener que extraer después un marcado de página inconsistente.
  • Enriquecimiento para descubrir productos: Agregue títulos, contexto del vendedor, descripciones, contenido multimedia y URL públicas de productos a las listas cortas descubiertas en páginas de categorías.

Consejos de expertos para la Amazon Best Sellers API

  • Use referencias de hosts regionales de Amazon compatibles cuyas rutas contengan /zgbs/ o /gp/bestsellers/. Las rutas de Amazon no relacionadas se rechazan antes de crear la tarea.
  • Defina results_limit para la tarea completa y no para cada URL enviada, y dimensiónelo según el lote combinado que necesite.
  • Siga next_cursor hasta que has_more sea false, porque los resultados de la tarea se devuelven mediante una vista de resultados aparte con paginación por cursor.
  • Trate los ID, descripciones, datos del vendedor, precios, calificaciones, cantidades, contenido multimedia, URL y momentos de publicación como valores que pueden ser nulos, en lugar de reemplazar los valores ausentes por cero o por un objeto vacío.
  • Guarde collected_at con cada registro y programe ejecuciones separadas cuando necesite comparaciones en momentos concretos; el endpoint no crea un flujo continuo.

Además de la Amazon Best Sellers API, use estas APIs cuando necesite otro tipo de datos públicos de Amazon.

  • Amazon Product Details API — Recolecta detalles de productos desde URLs conocidas de Amazon, con campos de título, descripción, vendedor, precio, calificación, cantidad de reseñas, cantidad vendida y contenido multimedia.
  • 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 Best Sellers API — FAQ

Amazon Best Sellers API es una interfaz programática para recopilar productos de URL públicas de Amazon Best Sellers o de listas de categorías como registros de productos normalizados de SocQ.

La lista urls acepta referencias cuyo nombre de host analizado sea un marketplace de Amazon compatible o uno de sus subdominios, y cuya ruta contenga /zgbs/ o /gp/bestsellers/. Se aceptan referencias con cualquier esquema que tenga un nombre de host y referencias relativas al protocolo.

Ningún campo de posición forma parte de la respuesta estable de productos. El registro normalizado se centra en la identidad del producto, el contenido, el vendedor, el precio, la calificación, las cantidades de reseñas y de unidades vendidas, el contenido multimedia, las URL y las marcas de tiempo cuando están disponibles.

results_limit tiene un valor predeterminado de 100, acepta enteros de 1 a 2,000 y limita el total de registros únicos guardados para la tarea entre todas las URL de entrada. No es un cupo independiente para cada URL.

Consulte /v1/tasks/{task_id}, lea data.results.items tras el éxito y siga solicitando el next_cursor devuelto mientras has_more sea true. El límite de la página de resultados controla la paginación de la consulta, no el volumen de la recopilación.

La disponibilidad pública, el contenido de la página, la salida del proveedor, la normalización, la deduplicación y el results_limit de toda la tarea pueden reducir la cantidad final de resultados. Una tarea exitosa también puede no contener ningún registro de producto.

Cada registro de producto estándar devuelto con éxito cuesta 0.15 créditos de SocQ. La tarea reserva créditos según results_limit, o 100 si se omite, luego liquida según la cantidad real devuelta y reembolsa los créditos reservados que no se usaron; un resultado vacío no genera cargo por resultado.