https://api.nexscope.ai/aba/intelligentQueryEjecutar 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/aba/intelligentQuery |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
analysisDescription | string | obligatorio | Lenguaje natural que describe con precisión la intención de la consulta. |
region | string | opcional | Código del sitio de Amazon. Valores opcionales: `US`, `DE`, `BR`, `CA`, `AU`, `JP`, `AE`, `ES`, `FR`, `IT`, `SA`, `TR`, `MX`, `SE`, `NL`. Ejemplo: US |
createDownloadUrl | boolean | opcional | Si se debe generar un enlace de descarga CSV; establecer a `true` cuando se requiera explícitamente descargar, exportar o generar archivos. Ejemplo: false |
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 (21 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
success | boolean | opcional | Si la consulta tiene éxito. |
tables | array | opcional | Resultado de la matriz de datos; cada elemento contiene `data` (fila de datos), `columns` (definición de la columna), y `name` (nombre de la hoja). |
total | integer | opcional | Número total de resultados. |
downloadUrl | string | opcional | La dirección del archivo CSV devolvió cuando `createDownloadUrl` es `true`. |
msg | string | opcional | Mensaje adicional. |
downloadNote | string | opcional | Consejos para descargar. |
code | string | opcional | Código de retorno. |
costTime | integer | opcional | Tiempo en milisegundos. |
costToken | integer | opcional | El token consumido por esta llamada. |
data | array | opcional | Las filas de datos de los resultados de la consulta. Las columnas reales variarán dependiendo de las condiciones de la consulta. |
columns | array | opcional | Definición de columna de resultados. |
name | string | opcional | Nombre de la hoja. |
searchTerm | string | opcional | Palabras clave de búsqueda del consumidor. |
reportStartDate | string | opcional | La fecha de inicio de la semana de recolección de datos. |
region | string | opcional | Código del sitio del Amazonas. |
searchFrequencyRank | integer | opcional | Clasificación de popularidad de búsqueda; cuanto más pequeño es el valor, mayor es la popularidad de búsqueda, y 1 es el más popular. |
clickedAsin | string | opcional | Los ASIN del producto clicado. |
clickedItemName | string | opcional | El nombre del producto hecho clic. |
clickShareRank | integer | opcional | El ranking de compartir clic de esto ASIN bajo este término de búsqueda. |
clickShare | number | opcional | El clic compartido recibido por este ASIN, que van de 0 a 1. |
conversionShare | number | opcional | La cuota de conversión obtenida por este ASIN, que van de 0 a 1. |
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.