Volver a las API
Datos públicos de comercio de Amazon

Amazon Public Data API

Busque productos públicos de Amazon y obtenga registros normalizados de detalles de productos, Best Sellers, reseñas, perfiles de vendedores y tiendas de creadores de los marketplaces compatibles.

API de Amazon disponibles

Use Product Search, Product Detail, Best Sellers, Reviews, Seller Info y Storefront según el flujo público de Amazon que necesite.

¿Qué datos de Amazon se pueden obtener?

SocQ devuelve registros normalizados de productos, reseñas, vendedores y tiendas de creadores a partir de entradas públicas de Amazon compatibles, y conserva los campos nulos cuando la fuente no expone un valor utilizable.

Identidad y contenido del producto

Obtenga los ID de producto, títulos, descripciones, URL públicas, etiquetas de plataforma y de recurso, y las marcas de tiempo de recolección disponibles.

Contexto de vendedor y precio

Conserve los objetos de vendedor normalizados y los valores de precio junto con cada producto descubierto, cuando estén disponibles.

Señales de reputación visibles

Use las calificaciones, los conteos de reseñas y los conteos de ventas disponibles como observaciones públicas de un momento dado, sin tratar los valores ausentes como cero.

Contenido multimedia del producto

Reciba objetos multimedia normalizados que sirven para catálogos de productos, colas de auditoría y procesamiento visual posterior.

Tiendas de creadores

Lea el perfil, las cuentas sociales vinculadas, las listas de ideas con su número de artículos, los posts curados y los productos en tendencia con precio de la tienda de un creador de Amazon.

SocQ vs procesamiento directo de páginas

SocQ ofrece flujos de tareas autenticados y esquemas de resultados estándar para los datos públicos de Amazon compatibles. Con el procesamiento directo de páginas, la orquestación de solicitudes, el análisis, el almacenamiento, la paginación y el mantenimiento del esquema quedan a cargo de su aplicación.

FuncionalidadSocQProcesamiento directo de páginas
Entrada inicialTérminos de búsqueda o URL públicas de Amazon compatiblesURL de páginas y lógica de obtención propia de la aplicación
Modelo de ejecuciónTarea asíncrona con consulta de estadoDefinido y operado por su aplicación
Forma del productoRegistros de productos normalizadosMarcado propio de cada página y análisis personalizado
Acceso a resultados almacenadosElementos paginados por cursorAlmacenamiento y paginación a cargo de la aplicación

Cómo funciona la API de Amazon

Los endpoints de Amazon usan una tarea asíncrona seguida de la recuperación de resultados paginada por cursor.

  1. 1. Enviar la entrada de un endpoint

    Envíe los términos de búsqueda, las URL de productos, las URL de categorías, las URL de vendedores o la URL de la tienda que requiera el endpoint elegido y guarde el task_id.

  2. 2. Dar seguimiento al procesamiento

    Consulte /v1/tasks/{task_id} hasta que el procesamiento termine con éxito o la tarea informe un error.

  3. 3. Obtener los productos

    Lea data.results.items y siga next_cursor mientras has_more sea true para obtener todos los registros guardados.

Obtener productos de una página de Best Sellers

Autentíquese con una clave de API de SocQ, envíe la URL pública de una lista de categoría y siga la tarea asíncrona hasta sus resultados de productos.

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-Electronics/zgbs/electronics"],"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 frecuentes de la API de Amazon

Investigación del surtido por categoría

Cree instantáneas acotadas de los productos visibles en páginas de Best Sellers seleccionadas para un conjunto definido de categorías en estudio.

Enriquecimiento de listas de productos

Agregue títulos, descripciones, contexto de vendedor, precios, contenido multimedia y enlaces públicos a los productos descubiertos en las páginas de categoría elegidas.

Comparación de señales comerciales

Compare los precios, calificaciones, conteos de reseñas y conteos de ventas disponibles entre productos normalizados, conservando la hora de recolección.

Investigación de creadores afiliados

Compare tiendas de creadores por estado de top creator, listas de ideas, número de artículos y productos en tendencia para preseleccionar socios de afiliación.

Límites y política de datos públicos

Los resultados de Amazon son registros de un momento dado, tomados de páginas públicas compatibles. La API no accede a cuentas de clientes, datos privados, carritos, pedidos, sistemas de inventario ni funciones de administración de vendedores.

  • Los hosts compatibles son amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in y amazon.co.jp, incluidos sus subdominios.
  • Use páginas públicas de Best Sellers o listas de categoría. La validación del host no garantiza que una página de Amazon no relacionada contenga una lista de productos compatible.
  • results_limit tiene un valor predeterminado de 100, acepta de 1 a 2,000 y limita el total de resultados únicos guardados entre todas las URL de una tarea.
  • La respuesta estable no incluye un campo de posición en Best Sellers.
  • Los ID de producto, el contenido, el vendedor, el precio, la calificación, los conteos, el contenido multimedia, las URL y las fechas de publicación pueden ser null cuando no hay un valor público utilizable.

Preguntas frecuentes sobre la API de Amazon

¿Qué es la API de Amazon?

Las API de Amazon buscan productos y obtienen registros normalizados de productos, reseñas, vendedores y tiendas de creadores a partir de entradas públicas de Amazon compatibles.

¿Qué endpoints de Amazon están disponibles?

Product Search, Product Detail, Best Sellers, Reviews, Seller Info y Storefront están disponibles mediante el mismo flujo de tareas asíncronas.

¿Se puede enviar más de una URL de categoría?

Sí. Envíe varias URL en una misma tarea, pero tenga presente que results_limit es un único tope total compartido por la tarea y no un límite por URL.

¿SocQ devuelve la posición del producto?

No. La posición no forma parte del esquema estable de productos; use los campos disponibles de identidad, vendedor, precio, reputación, conteo de ventas, contenido multimedia, fuente y marca de tiempo.

¿Pueden faltar campos en un producto de Amazon?

Sí. Los campos estándar del producto admiten valores nulos y deben quedar ausentes cuando el registro público no expone un valor utilizable.

¿Cómo se factura el endpoint Best Sellers?

Cada producto estándar devuelto con éxito cuesta 0.15 créditos. Los resultados vacíos no tienen cargo, y los créditos precargados que no se usan se reembolsan cuando la tarea se liquida.

Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.

Apple App Store API

Obtenga detalles públicos de apps de Apple App Store, clasificaciones por categoría y reseñas a partir de URL conocidas de la tienda, como registros normalizados de apps y reseñas.

SEO API

Consulte resultados orgánicos de Google en vivo, compare la demanda de palabras clave y la dificultad de posicionamiento, amplíe términos semilla, descubra las palabras clave y las páginas que impulsan la visibilidad de un sitio en las búsquedas, clasifique la intención de búsqueda y recopile resultados de Google News, Google Images, Google Autocomplete, Bing y YouTube. Todos los endpoints usan la misma clave de API de SocQ, el mismo flujo de tareas asíncronas y el mismo formato de resultados normalizado.

Telegram API

Lea canales públicos de Telegram a partir de sus enlaces t.me: perfiles de canal con suscriptores, publicaciones con vistas y reacciones, publicaciones sueltas, comentarios de grupos de discusión, canales similares y búsqueda en todo el historial.

Link in Bio API

Convierta el único enlace de la bio de Instagram, TikTok o YouTube de un creador en datos estructurados: nombre visible, bio, avatar, correo de contacto indicado, perfiles sociales vinculados y cada botón de la página con su título y destino.

Creator API

Parta de un perfil de Instagram, TikTok, YouTube, X, Facebook o Threads para encontrar los correos comerciales públicos de un creador, sus cuentas en otras redes o una estimación de edad y género a partir de su foto de perfil.

Google Hotels API

Busque hoteles por destino, abra la ficha completa de cualquier hotel en Google Hotels y obtenga su calendario de precios por noche, todo conectado por un mismo ID de hotel.