amazon/
reviews

Recopile reseñas públicas de productos de Amazon a partir de URL compatibles y obtenga texto, calificaciones, datos del autor, referencias del producto, marcas de tiempo y contenido multimedia como registros normalizados.

Amazon Reviews API

Varias URL de productos
Texto y calificaciones de reseñas
Contexto del autor y del producto
Registros de reseñas 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 Reviews

Las reseñas de productos de Amazon son registros públicos de opiniones de clientes, con texto escrito, calificaciones, datos del autor, momentos de publicación, referencias del producto y contenido multimedia adjunto. Estos registros sirven para investigar la opinión sobre productos, comparar calificaciones, monitorear reseñas y enriquecer datos con enlaces a la fuente.

Funcionalidades de la Amazon Reviews API

  • Entrada de URL de varios productosEnvíe una o más URL compatibles de productos de Amazon en una sola tarea y aplique un único límite de resultados a las reseñas normalizadas que se almacenan.
  • Contenido de las reseñas y autoresCada registro puede conservar el texto público de la reseña, la calificación numérica, la identidad del autor, el momento de publicación y las imágenes o videos adjuntos.
  • Registros vinculados al productoLos resultados normalizados mantienen los identificadores y las URL del producto junto con la identidad de la reseña y los enlaces de origen, de modo que cada registro siga asociado al artículo reseñado.

Parámetros de la Amazon Reviews API

ParámetrosObligatorioDescripción
urlsObligatorioLista obligatoria de referencias no vacías de productos de Amazon. El nombre de host analizado de cada una debe pertenecer a un marketplace compatible o a un subdominio; se aceptan referencias con cualquier esquema que tenga un nombre de host y referencias relativas al protocolo. Cada elemento se convierte en una fila de entrada para el proveedor.
results_limitOpcionalMáximo de reseñas normalizadas almacenadas para toda la tarea; su valor predeterminado es 100 y acepta enteros de 1 a 2,000.

Cómo usar la Amazon Reviews API

Envíe URL de productos compatibles, siga la tarea asíncrona y lea los registros de reseñas normalizados con paginación por cursor.

  1. Prepare una o más URL compatibles de productos de Amazon y elija un results_limit de 1 a 2,000.
  2. Envíe la solicitud por POST a /v1/amazon/reviews y guarde el task_id devuelto.
  3. Consulte GET /v1/tasks/{task_id} hasta que la tarea se complete con éxito o devuelva un error.
  4. Lea data.results.items y solicite el next_cursor devuelto mientras has_more siga siendo true.
curl -X POST "https://api.socq.ai/v1/amazon/reviews" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.amazon.com/dp/B0CHHSFMRL"],"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 Reviews API

  • Investigación de opiniones sobre productos: Use el texto de las reseñas, las calificaciones, los autores y los momentos de publicación para examinar las opiniones públicas devueltas para productos conocidos.
  • Comparación de calificaciones entre productos: Envíe varias URL de productos y agrupe las calificaciones devueltas por subject_id o subject_url para comparar los registros de reseñas recopilados.
  • Enriquecimiento con evidencia de reseñas: Adjunte enlaces de origen, referencias del producto, datos del autor, marcas de tiempo y contenido multimedia de las reseñas a conjuntos de datos de productos o registros de monitoreo existentes.

Consejos de expertos para la Amazon Reviews API

  • Use referencias de productos cuyo nombre de host analizado pertenezca a un marketplace de Amazon compatible; los enlaces acortados en hosts no relacionados y los hosts regionales no compatibles no pasan la validación.
  • Defina results_limit con el total de reseñas que desea almacenar entre todas las URL enviadas y luego siga next_cursor hasta que has_more sea false para leer todas las páginas almacenadas.
  • Identifique los registros por el id de la reseña cuando exista y conserve subject_id o subject_url al agrupar las reseñas por producto.
  • Trate el texto, los campos del autor, las calificaciones, las marcas de tiempo, las referencias del producto y el contenido multimedia ausentes como desconocidos, sin inventar valores de reemplazo.

Además de la Amazon Reviews 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 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 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 Reviews API — FAQ

Amazon Reviews API es una interfaz programática para recopilar reseñas públicas de productos a partir de URL compatibles de productos de Amazon. Devuelve texto de reseñas, calificaciones, datos del autor, marcas de tiempo, referencias del producto, enlaces de origen y contenido multimedia, todo normalizado.

Envíe una lista urls no vacía cuyos nombres de host analizados sean amazon.com, amazon.co.uk, amazon.de, amazon.fr, amazon.es, amazon.it, amazon.ca, amazon.com.au, amazon.in, amazon.co.jp o sus subdominios. Se aceptan referencias con cualquier esquema que tenga un nombre de host y referencias relativas al protocolo.

results_limit es el máximo de reseñas normalizadas almacenadas para toda la tarea, no una cantidad garantizada para cada URL. La tarea puede terminar con menos registros cuando se devuelven menos reseñas públicas o se eliminan registros duplicados.

Una vez que la tarea se complete con éxito, lea data.results.items y pase next_cursor al endpoint de la tarea mientras has_more sea true. El endpoint de resultados de la tarea acepta un límite de página de 1 a 500.

Cada reseña almacenada con éxito cuesta 0.15 créditos de SocQ. La solicitud se reserva a partir de results_limit y luego se liquida según la cantidad real de resultados; un resultado vacío no genera cargo por resultado.