https://api.nexscope.ai/jm/getNicheInfoByAsinEjecutar 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/getNicheInfoByAsin |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
asin | string | obligatorio | Producto ASIN (requerido). La herramienta busca segmentos de mercado que compartan el mismo nicho que el ASIN |
countryCode | string | opcional | Código del país, valores opcionales: `US` (Estados Unidos), `JP` (Japón), `DE` (Alemania) Ejemplo: US |
count | integer | opcional | Número de segmentos devueltos Ejemplo: 10 |
productCountMin | integer | opcional | Cantidad de producto (actual) mínimo |
productCountMax | integer | opcional | Cantidad de producto (corriente) máxima |
avgPriceMin | number | opcional | Precio medio (actual) mínimo |
avgPriceMax | number | opcional | Precio medio (actual) |
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) |
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) |
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, 0.1 representa una tasa de conversión del 10% |
clickConversionRateT7Max | number | opcional | Tasa de conversión máxima del clic (7 días) el rango de valor es 0-1, 0.1 representa una tasa de conversión del 10% |
brandCountMin | integer | opcional | Número mínimo de marcas |
brandCountMax | integer | opcional | Número máximo de marcas |
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. 0.1 representa el 10% de la cuota de clics. |
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. 0.1 representa el 10% de la cuota de clics. |
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) |
top5ProductsClickShareMin | number | opcional | La cuota mínima (corriente) de clics de los 5 productos principales, el rango de valor es 0-1, 0.1 representa el 10% de la cuota de clics |
top5ProductsClickShareMax | number | opcional | La cuota máxima de clics (actual) de los 5 productos superiores, el rango de valor es 0-1, 0.1 representa el 10% de la cuota de clics |
sponsoredProductsPercentageMin | number | opcional | El valor mínimo de la proporción de publicidad SP, el rango de valor es 0-1, 0,1 significa la proporción del 10% |
sponsoredProductsPercentageMax | number | opcional | La proporción máxima de publicidad SP, el rango de valor es 0-1, 0,1 significa 10% de la proporción |
cpcMediumMin | number | opcional | CPC (actual) mínimo |
cpcMediumMax | number | opcional | CPC (corriente) máximo |
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, 0.1 representa una tasa de éxito del 10% |
launchRateT180Max | number | opcional | El índice de éxito máximo de liberación del producto (estadísticas de 180 días), el rango de valor es 0-1, 0.1 representa un índice de éxito del 10% |
returnRateT360Min | number | opcional | La tasa de retorno mínima (360 días estadísticas), el rango de valor es 0-1, 0.1 representa una tasa de retorno del 10% |
returnRateT360Max | number | opcional | La tasa máxima de retorno (360 días estadísticas), el rango de valor es 0-1, 0.1 representa una tasa de retorno del 10% |
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 (38 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
errcode | integer | opcional | Código de estado de negocio, 200 indica éxito |
costToken | integer | opcional | Consumir token |
nicheInfoVoList | array | opcional | Lista de información sobre segmentos (ver campos de objetos de segmento más abajo) |
nicheId | string | opcional | ID del segmento |
nicheTitle | string | opcional | Segmento de mercado |
translationZh | string | opcional | Título del segmento del mercado (chino) |
demand | integer | opcional | puntuación de segmento |
productCount | integer | opcional | Cantidad del producto |
avgPrice | number | opcional | Precio medio del producto |
minimumPrice | number | opcional | Producto precio más bajo |
maximumPrice | number | opcional | Precio más alto del producto |
searchVolumeWeekly | integer | opcional | Volumen de búsqueda (datos semanales) |
searchVolumeQuarterly | integer | opcional | Volumen de búsqueda (datos trimestrales) |
searchVolumeGrowthWeekly | number | opcional | Tasa de crecimiento del volumen de búsqueda (datos semanales) |
searchVolumeGrowthQuarterly | number | opcional | Tasa de crecimiento del volumen de búsqueda (datos trimestrales) |
unitsSoldWeekly | integer | opcional | Cantidad de ventas (datos semanales) |
unitsSoldQuarterly | integer | opcional | Volumen de ventas (datos trimestrales) |
clickCountWeekly | integer | opcional | Clicks (datos semanales) |
clickCountQuarterly | integer | opcional | Clicks (datos trimestrales) |
clickToSaleConversionWeekly | number | opcional | Tasa de conversión de clic (datos semanales) |
clickConversionRateQuarterly | number | opcional | Tasa de conversión de clics (datos trimestrales) |
searchConversionRateWeekly | number | opcional | Tasa de conversión de búsqueda (datos semanales) |
searchConversionRateQuarterly | number | opcional | Tasa de conversión de búsqueda (datos trimestrales) |
brandCount | integer | opcional | Número de marcas |
top5BrandsClickShare | number | opcional | Cuota de mercado ocupada por las 5 mejores marcas |
top5ProductsClickShare | number | opcional | Haga clic en la parte de los 5 productos más importantes |
avgBrandAgeNow | number | opcional | Edad media de la marca (actual) |
avgBrandAgeQuarterly | number | opcional | Edad media de la marca (datos trimestrales) |
newProductsLaunchedSemiannual | integer | opcional | Número de nuevos productos lanzados (datos semestrales) |
successfulLaunchedSemiannual | integer | opcional | Número de productos liberados con éxito (datos de medio año) |
launchRateSemiannual | number | opcional | Tasa de éxito en la liberación del producto (datos semestrales) |
returnRateAnnual | number | opcional | Tasa de retorno (datos de año completo) |
acos | number | opcional | (ACOS) Costo de publicidad de la relación de ventas |
profitMarginGt50PctSkuRatio | number | opcional | Proporción de productos con margen de beneficio superior al 50% |
breakEvenRatio | number | opcional | Proporción natural de la fracción de equilibrio |
cpc | object | opcional | Datos de la CPC: `{ high (highest price), medium (middle price), low (lowest price) }` |
categorieList | array | opcional | Lista de categorías de productos |
referenceAsinImageUrl | string | opcional | Dirección de referencia del segmento del mercado |
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.