https://api.nexscope.ai/jm/getNicheReviewFromKeywordEjecutar 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/jm/getNicheReviewFromKeyword |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
keyword | string | obligatorio | Palabras clave (requerido, por favor utilice el idioma del sitio correspondiente, como Inglés para el sitio de los EE.UU. y Alemán para el sitio alemán), la longitud máxima es 1000 caracteres |
countryCode | string | opcional | Código del país, valores opcionales: `US` (Estados Unidos), `JP` (Japón), `DE` (Alemania) Ejemplo: US |
page | integer | opcional | Número de página (a partir de 1) Ejemplo: 1 |
pageSize | integer | opcional | Número de devoluciones por página (10-100) Ejemplo: 50 |
sortField | string | opcional | Campo de clasificación, ver opciones de clasificación abajo Ejemplo: unitsSoldT7 |
sortType | string | opcional | Método de clasificación, valores opcionales: `desc` (orden descendente), `asc` (Orden ascendente) Ejemplo: desc |
productCountMin | integer | opcional | Cantidad de producto (actual) mínimo |
productCountMax | integer | opcional | Cantidad de producto (corriente) máxima |
brandCountMin | integer | opcional | Número mínimo de marcas |
brandCountMax | integer | opcional | Número máximo de marcas |
avgPriceMin | number | opcional | Precio medio (actual) mínimo |
avgPriceMax | number | opcional | Precio medio (actual) |
unitsSoldT7Min | integer | opcional | Volumen de ventas (7 días de estadísticas) valor mínimo |
unitsSoldT7Max | integer | opcional | Volumen máximo de ventas (estadísticas de 7 días) |
searchVolumeT7Min | integer | opcional | Volumen de búsqueda (7 días de estadísticas) valor mínimo |
searchVolumeT7Max | integer | opcional | Volumen máximo de búsqueda (estadísticas de 7 días) |
clickCountT7Min | integer | opcional | Valor mínimo del volumen de clic (7 días) |
clickCountT7Max | integer | opcional | Número máximo de clics (estadísticas de 7 días) |
clickConversionRateT7Min | number | opcional | Tasa mínima de conversión de clics (7 días de estadísticas), el rango de valor es 0-1, que representa 0%-100% |
clickConversionRateT7Max | number | opcional | El valor máximo de la tasa de conversión de clics (7 días estadísticas), el rango de valor es 0-1, que representa 0%-100% |
top5BrandsClickShareMin | number | opcional | La cuota mínima de clics en el segmento de mercado ocupado por las 5 marcas principales. El rango de valor es 0-1, que representa 0%-100%. |
top5BrandsClickShareMax | number | opcional | La cuota máxima de clics en el segmento de mercado ocupado por las 5 marcas principales. El rango de valor es 0-1, que representa 0%-100%. |
top5ProductsClickShareMin | number | opcional | La cuota mínima de clic (corriente) de los 5 productos principales, el rango de valor es 0-1, que representa 0%-100% |
top5ProductsClickShareMax | number | opcional | La cuota máxima de clic (corriente) de los 5 productos principales, el rango de valor es 0-1, que representa 0%-100% |
sponsoredProductsPercentageMin | number | opcional | La proporción mínima de publicidad SP, el rango de valor es 0-1, que representa 0%-100% |
sponsoredProductsPercentageMax | number | opcional | La proporción máxima de publicidad SP, el rango de valor es 0-1, que representa 0%-100% |
avgBrandAgeMin | number | opcional | Promedio de edad de la marca (actual) mínimo |
avgBrandAgeMax | number | opcional | Edad media de la marca (actual) Max |
avgBrandAgeQoqMin | number | opcional | Edad media de la marca (estadísticas de 90 días) valor mínimo |
avgBrandAgeQoqMax | number | opcional | Edad media de la marca (estadísticas de 90 días) valor máximo |
avgBrandAgeYoyMin | number | opcional | Edad media de la marca (estadísticas de 360 días) valor mínimo |
avgBrandAgeYoyMax | number | opcional | Edad media máxima de la marca (estadísticas de 360 días) |
avgSellingPartnerAgeMin | number | opcional | Edad media mínima del socio de ventas |
avgSellingPartnerAgeMax | number | opcional | Edad media máxima de los socios comerciales |
avgSellingPartnerAgeQoqMin | number | opcional | Edad media de los socios de ventas (estadísticas de 90 días) mínima |
avgSellingPartnerAgeQoqMax | number | opcional | Edad media máxima de los socios comerciales (estadísticas de 90 días) |
avgSellingPartnerAgeYoyMin | number | opcional | Edad media de los socios de ventas (360 días) valor mínimo |
avgSellingPartnerAgeYoyMax | number | opcional | Edad media máxima de los socios de ventas (360 días) |
launchRateT180Min | number | opcional | La tasa mínima de éxito de la liberación del producto (estadísticas de 180 días), el rango de valor es 0-1, que representa 0%-100% |
launchRateT180Max | number | opcional | La tasa máxima de éxito de la liberación del producto (estadísticas de 180 días), el rango de valor es 0-1, representando 0%-100% |
newProductRateT180 | number | opcional | El valor mínimo de la proporción de nuevos productos (estadísticas de 180 días), el rango de valor es 0-1, que representa 0%-100% |
returnRateT360Min | number | opcional | La tasa de retorno mínima (360 días estadísticas), el rango de valor es 0-1, que representa 0%-100% |
returnRateT360Max | number | opcional | La tasa máxima de retorno (360 días estadísticas), el rango de valor es 0-1, que representa 0%-100% |
cpcMediumMin | number | opcional | CPC (actual) mínimo |
cpcMediumMax | number | opcional | CPC (corriente) máximo |
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 (13 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
total | integer | opcional | Total |
data | array | opcional | Lista de los comentarios del segmento del mercado (para más detalles, ver los campos de datos de los ítems más abajo) |
columns | array | opcional | Columnas renderizadas |
costToken | integer | opcional | Consumir token |
type | string | opcional | Estilo de representación |
title | string | opcional | Título |
nicheId | string | opcional | ID del segmento |
nicheName | string | opcional | Nombre del segmento del mercado |
keyword | string | opcional | palabras clave |
reviewType | string | opcional | Tipo de comentario (el rango de valor es [comentario positivo], [comentario negativo]) |
topic | string | opcional | Tema de comentarios |
percentOfMentions | number | opcional | Proporción (el rango de valor es 0-1, que representa 0%-100%) |
reviewExample | string | opcional | Muestra de comentarios |
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.