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ámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista 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_limit | Opcional | Má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.
- Prepare una o más URL compatibles de productos de Amazon y elija un results_limit de 1 a 2,000.
- Envíe la solicitud por POST a /v1/amazon/reviews y guarde el task_id devuelto.
- Consulte GET /v1/tasks/{task_id} hasta que la tarea se complete con éxito o devuelva un error.
- 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 trueCasos 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.
APIs relacionadas
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.