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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista 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_limit | Opcional | Entero 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.
- Prepare una o más URL públicas de Amazon Best Sellers o de listas de categorías en un host de marketplace compatible.
- Envíe urls y un results_limit opcional de 1 a 2,000 a /v1/amazon/best-sellers y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o devuelva un error.
- 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 trueCasos 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.
APIs relacionadas
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.