https://api.nexscope.ai/amazon/reviews/listEjecutar esta API
Envía una solicitud JSON para ejecutar esta API y recibir los datos de respuesta documentados.
Endpoint
| Método | POST |
| Ruta | https://api.nexscope.ai/amazon/reviews/list |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
asin | string | obligatorio | Producto Amazon ASIN; sólo uno ASIN está soportado por solicitud. |
domainCode | string | opcional | Código del sitio: `com`, `ca`, `co.uk`, `in`, `de`, `fr`, `it`, `es`, `co.jp`, `com.au`, `com.br`, `nl`, `se`, `com.mx`, `ae`. Ejemplo: com |
star1Num | integer | opcional | Número de reseñas de 1 estrella, máximo 100. Ejemplo: 10 |
star2Num | integer | opcional | Número de críticas de 2 estrellas, máximo 100. Ejemplo: 10 |
star3Num | integer | opcional | Número de comentarios de 3 estrellas, máximo 100. Ejemplo: 10 |
star4Num | integer | opcional | Número de críticas de 4 estrellas, máximo 100. Ejemplo: 10 |
star5Num | integer | opcional | Número de críticas de 5 estrellas, máximo 100. Ejemplo: 10 |
filterByKeyword | string | opcional | Filtrar comentarios por palabra clave, longitud máxima 1000 caracteres. |
sortBy | string | opcional | Ordenar por: `recent` (comentario más reciente) o `helpful` (comentario más útil). Ejemplo: recent |
reviewerType | string | opcional | Tipo de revisor: `all_reviews` (todas las revisiones) o `avp_only_reviews` (solo compras certificadas). Ejemplo: all_reviews |
mediaType | string | opcional | Tipo de medio: `all_contents` (todo el contenido) o `media_reviews_only` (comentarios con medios de comunicación solamente). Ejemplo: all_contents |
formatType | string | opcional | Tipo de formato: `all_formats` (todos los formatos) o `current_format` (formato actual). Ejemplo: all_formats |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
No hay un ejemplo de respuesta publicado para esta API. Consulta los campos de respuesta siguientes.
Campos de respuesta
Referencia de campos de respuesta (32 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Número total de observaciones. |
data | array | opcional | Lista de comentarios. |
columns | array | opcional | Columnas renderizadas. |
costToken | integer | opcional | Consumo total de tokens. |
type | string | opcional | Estilo de representación. |
reviewId | string | opcional | Comment ID. |
asin | string | opcional | Producto ASIN. |
title | string | opcional | Título de la observación. |
text | string | opcional | Contenido de las observaciones. |
rating | string | opcional | Puntuación. |
date | string | opcional | Fecha de revisión. |
userName | string | opcional | Nombre del comentarista. |
verified | boolean | opcional | ¿Se ha verificado la compra? |
vine | boolean | opcional | Críticas de Voz Vinícola o no. |
numberOfHelpful | integer | opcional | Cantidad útil. |
imageUrlList | array | opcional | Comentarios en la lista de imágenes. |
videoUrlList | array | opcional | Comentar la lista de vídeos. |
domainCode | string | opcional | Código del país. |
productTitle | string | opcional | Título del producto. |
productRating | string | opcional | Calificaciones de productos. |
countRatings | integer | opcional | Número de valoraciones del producto. |
countReviews | integer | opcional | Número de comentarios sobre productos. |
variationId | string | opcional | Variante ID. |
variationList | array | opcional | Lista de variaciones. |
profilePath | string | opcional | Ruta de perfil de comentarista. |
currentPage | integer | opcional | Número actual de página. |
sortStrategy | string | opcional | Estrategia de clasificación. |
statusCode | integer | opcional | código de estado. |
statusMessage | string | opcional | mensaje de estado. |
locale | object | opcional | Información regional. |
reviewSummary | object | opcional | Revisar los datos resumidos. |
filters | object | opcional | Filtros aplicados. |
Respuestas
| Código | Descripción |
|---|---|
| 200 | Respuesta HTTP predeterminada tanto para el éxito como para muchos errores de negocio. Solo el código JSON externo 0 indica éxito o aceptación asíncrona; consulta data para obtener el resultado. |
| 429 | Límite de admisión de ejecuciones; respeta Retry-After cuando esté presente. |
| 503 | La admisión de ejecuciones no está disponible temporalmente; respeta Retry-After cuando esté presente. |
| Opcional | X-Nexscope-Http-Status: semantic asigna estados HTTP a los errores de negocio gestionados por el controlador en las rutas de ejecución y tareas. Los fallos previos a la autenticación, como la ausencia de una clave API (code 11209), pueden seguir devolviendo HTTP 200 antes de esta asignación. Comprueba siempre el código JSON externo; las solicitudes malformadas y los fallos de infraestructura también pueden devolver respuestas HTTP distintas de 200. |
Fuente de datos, vigencia y limitaciones
La fuente, la vigencia, la cobertura, los límites de frecuencia y las notas de estimación no se especifican en esta definición de API salvo que aparezcan en la documentación de campos de solicitud o respuesta anterior. No supongas datos oficiales del mercado ni actualización en tiempo real cuando no estén documentados explícitamente.