https://api.nexscope.ai/amazon/opportunity/searchByMetricsEjecutar 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/opportunity/searchByMetrics |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
amazonDomain | string | opcional | Código del sitio Amazon (enumeración cerrada), actualmente sólo soporta `US`; si no se especifica, sólo el sitio de EE.UU. será comprobado por defecto. |
limit | integer | opcional | Devuelve el límite superior del número de elementos; sin la `page` parámetro, los elementos N más recientes se devuelven en orden inverso del tiempo de recogida. |
keyword | string | opcional | Buscar fragmentos de texto de palabras clave (like fuzzy emparejamiento). |
nicheName | string | opcional | Rastrear el fragmento de nombre normalizado (LIKE, snake_case minúscula), adecuado para la comparación de tiempos de la pista. |
nicheRevenue360dMinUsdAtLeastGte | number | opcional | El valor mínimo de los ingresos del mercado de 360 días más bajos consolidados (USD). |
nicheRevenue360dMinUsdAtLeastLte | number | opcional | El valor máximo de los ingresos del mercado de 360 días más bajos consolidados (USD). |
nicheRevenue360dMaxUsdAtLeastGte | number | opcional | El valor mínimo de los ingresos del mercado de 360 días superior consolidado (USD). |
nicheRevenue360dMaxUsdAtLeastLte | number | opcional | El valor máximo de los ingresos del mercado de 360 días superior consolidado (USD). |
nichePeakSearchVolumeAtLeastGte | integer | opcional | Encuadernación inferior para volumen máximo de búsqueda mensual. |
nichePeakSearchVolumeAtLeastLte | integer | opcional | El límite superior del volumen máximo de búsqueda mensual. |
nicheSearchVolumeYoyChangePctAtLeastGte | number | opcional | El límite inferior de la tasa de cambio interanual del volumen de búsqueda (%, firmado). |
nicheSearchVolumeYoyChangePctAtLeastLte | number | opcional | El límite superior de la tasa de cambio interanual del volumen de búsqueda (%, firmado). |
nichePeakMonthGte | integer | opcional | Buscar máximo mes límite inferior. |
nichePeakMonthLte | integer | opcional | Busca la tapa del mes pico. |
nicheBrandCountGte | integer | opcional | Número mínimo de marcas activas. |
nicheBrandCountLte | integer | opcional | Número máximo de marcas activas. |
nicheBrandCountYoyChangePctAtLeastGte | number | opcional | El límite inferior de la tasa de cambio interanual del número de marcas (%, con signo). |
nicheBrandCountYoyChangePctAtLeastLte | number | opcional | El límite superior de la tasa de cambio interanual del número de marcas (%, con signo). |
nicheTop5ProductClickSharePctAtLeastGte | number | opcional | El límite inferior para la cuota de clic de los 5 productos más importantes. |
nicheTop5ProductClickSharePctAtLeastLte | number | opcional | El límite superior de la cuota de clic de los 5 productos superiores. |
featureTop5BrandSharePctAtLeastGte | number | opcional | El límite inferior de la cuota total de las 5 marcas principales. |
featureTop5BrandSharePctAtLeastLte | number | opcional | El límite superior de la cuota total de las 5 marcas principales. |
featureTopBrandsContains | string | opcional | Top 3 fragmentos de marca (texto original como, sensible a la caja). |
priceMinUsdGte | number | opcional | El precio más bajo del producto límite en la pista (USD). |
priceMinUsdLte | number | opcional | El límite mínimo de precio del producto de la pista (USD). |
priceMaxUsdGte | number | opcional | El límite máximo de precio del producto de la pista (USD). |
priceMaxUsdLte | number | opcional | El límite máximo de precio del producto de la pista (USD). |
priceSweetSpotMinUsdGte | number | opcional | El límite inferior del límite inferior de Sweet Spot (USD). |
priceSweetSpotMinUsdLte | number | opcional | El límite superior del límite inferior de Sweet Spot (USD). |
priceSweetSpotMaxUsdGte | number | opcional | Límite inferior del límite superior de Sweet Spot (USD). |
priceSweetSpotMaxUsdLte | number | opcional | El límite superior del límite de Sweet Spot (USD). |
priceEntryClickSharePctAtLeastGte | number | opcional | mínimo de clic compartido para los usuarios de nivel de entrada. |
priceEntryClickSharePctAtLeastLte | number | opcional | El nivel de entrada de clic límite de compartir. |
priceMidClickSharePctAtLeastGte | number | opcional | Mediana gama de clics en el piso compartido. |
priceMidClickSharePctAtLeastLte | number | opcional | Tapa de intercambio de clics de rango medio. |
priceHighClickSharePctAtLeastGte | number | opcional | El límite inferior de cuota de clic para productos de gama alta. |
priceHighClickSharePctAtLeastLte | number | opcional | Límite de cuota de clic de gama alta. |
demoPrimaryAgeMinGte | integer | opcional | El valor mínimo del límite inferior de la edad de la población principal. |
demoPrimaryAgeMinLte | integer | opcional | El valor máximo del límite inferior de la edad del grupo de acogida. |
demoPrimaryAgeMaxGte | integer | opcional | El valor mínimo del límite superior de la edad de la población principal. |
demoPrimaryAgeMaxLte | integer | opcional | El valor máximo del límite superior de la edad del grupo de acogida. |
demoGenderDominant | string | opcional | El sexo dominante (enumeración cerrada): `female` / `male` / `mixed` / `unspecified`. |
demoPrimaryIncomeTier | string | opcional | Archivo de ingresos (enumeración cerrada): `low` / `middle_low` / `middle` / `middle_upper` / `upper_middle` / `high`. |
demoLifeStageTagsContains | string | opcional | Fragmento de la etiqueta de la etapa de vida (snake_case, como por ejemplo `parent`, `student`, `retiree`, `athlete`. |
featureNewAvgReviewCountAtLeastGte | integer | opcional | El límite inferior para el número medio de revisiones de nuevos productos. |
featureNewAvgReviewCountAtLeastLte | integer | opcional | El límite superior del número medio de revisiones de nuevos productos. |
featureEstablishedAvgReviewCountAtLeastGte | integer | opcional | El límite inferior del número medio de comentarios para productos maduros y antiguos. |
featureEstablishedAvgReviewCountAtLeastLte | integer | opcional | El límite superior del número medio de comentarios para productos maduros y antiguos. |
featureEmergingTrendTagsContains | string | opcional | Fragmentos de etiquetas de tendencia emergente (snake_case, como por ejemplo `cordless`, `portable`, `smart`. |
featureUncommonFeatureTagsContains | string | opcional | Raras características diferenciación de los fragmentos de la etiqueta (snake_case, como por ejemplo `hema_free`, `medical_grade_silicone`. |
searchTopCategory1Label | string | opcional | Buscar tráfico primer tipo de meta tag fragmento (snake_case, como por ejemplo `core_product_terms`, `set_kit_configurations`. |
reviewPositiveTop1Topic | string | opcional | Como fragmentos de tema #1 (snake_case, como por ejemplo `comfort`, `quality_overall_generic`. |
reviewPositiveTop1PctAtLeastGte | number | opcional | El límite inferior de la proporción de temas positivos #1 (la proporción de comentarios positivos). |
reviewPositiveTop1PctAtLeastLte | number | opcional | El límite superior de la proporción de temas positivos #1. |
reviewNegativeTop1Topic | string | opcional | Revisión negativa #1 tema fragmento (snake_case, como por ejemplo `size`, `quality`, `durability`. |
reviewNegativeTop1PctAtLeastGte | number | opcional | El límite inferior de la revisión negativa #1 proporción del tema (proporción de las revisiones negativas). |
reviewNegativeTop1PctAtLeastLte | number | opcional | El límite superior para la proporción de los temas de revisión negativa #1. |
reviewNegativeTop2Topic | string | opcional | Revisión negativa #2 tema fragmento (snake_case, lik). |
reviewStrategicInsightTagsContains | string | opcional | Política de comentarios sugiere fragmentos de etiquetas (snake_case, como por ejemplo `sizing_clarity`, `material_transparency`. |
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 (17 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | string | opcional | Código de respuesta, `200` tiene éxito. |
msg | string | opcional | Información rápida, el éxito es `ok`, el fallo es la descripción del error. |
data | array | opcional | Array de registro de indicadores de palabras clave, cada uno correspondiente a una combinación (sitio, palabra clave), unos 37 campos, en orden inverso del tiempo de recolección. |
amazonDomain | string | opcional | Código del sitio, actualmente fijado a `US`. |
keyword | string | opcional | Palabra clave de búsqueda original. |
nicheName | string | opcional | Nombre normalizado de la pista (snake_case). |
nichePeakSearchVolumeAtLeast | integer | opcional | Volumen máximo de búsqueda mensual. |
nichePeakMonth | integer | opcional | Meses de búsqueda máximos (1-12). |
nicheSearchVolumeYoyChangePctAtLeast | number | opcional | Tasa de cambio de volumen de búsqueda año tras año (%, firmado). |
nicheTop5ProductClickSharePctAtLeast | number | opcional | Top5 producto cuota de clic (0-100). |
featureTop5BrandSharePctAtLeast | number | opcional | Cuota total de las 5 principales marcas (0-100). |
featureTopBrands | array | opcional | Lista de nombres de marca Top3 (texto original). |
demoGenderDominant | string | opcional | Género Dominante (`female` / `male` / `mixed` / `unspecified`). |
demoPrimaryIncomeTier | string | opcional | Cuadro de ingresos de la población básica. |
demoLifeStageTags | array | opcional | Lista de etiquetas de la etapa de vida. |
searchTopCategory1Label | string | opcional | Etiqueta normalizada de la primera categoría de tráfico. |
reviewStrategicInsightTags | array | opcional | Comentar etiquetas de sugerencias políticas. |
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.