https://api.nexscope.ai/mercado/marketResearchEjecutar 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/mercado/marketResearch |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
toolName: search_categories
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
arguments | object | obligatorio | Argumentos para la operación seleccionada |
arguments.limit | integer | opcional | Número máximo de registros Predeterminado: 100 Mínimo: 1 Máximo: 100 |
arguments.market_code | string | opcional | Código de mercado: MLM, MLB, MLA, MLC o MCO Permitidos: MLM, MLB, MLA, MLC, MCO Predeterminado: MLM |
arguments.query | string | opcional | Consulta de búsqueda de categorías |
toolName | string | obligatorio | Operación de investigación Mercado Constante: search_categories |
toolName: industry_overview
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
arguments | object | obligatorio | Argumentos para la operación seleccionada |
arguments.category_id | string | obligatorio | ID de categoría de Mercado Longitud mínima: 1 |
arguments.market_code | string | opcional | Código de mercado: MLM, MLB, MLA, MLC o MCO Permitidos: MLM, MLB, MLA, MLC, MCO Predeterminado: MLM |
toolName | string | obligatorio | Operación de investigación Mercado Constante: industry_overview |
toolName: search_product_snapshots
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
arguments | object | obligatorio | Argumentos para la operación seleccionada |
arguments.category_id | string | opcional | ID de categoría de Mercado |
arguments.historical_total_sales_max | integer | opcional | Valor de Historical total sales max usado por esta operación de API. Mínimo: 0 |
arguments.historical_total_sales_min | integer | opcional | Valor de Historical total sales min usado por esta operación de API. Mínimo: 0 |
arguments.keyword | string | opcional | Palabras clave de búsqueda de productos |
arguments.limit | integer | opcional | Número máximo de registros Predeterminado: 100 Mínimo: 1 Máximo: 100 |
arguments.listing_date_max | string | opcional | Valor de Listing date max usado por esta operación de API. Patrón: ^\d{8}$|^\d{4}-\d{2}-\d{2}$ |
arguments.listing_date_min | string | opcional | Valor de Listing date min usado por esta operación de API. Patrón: ^\d{8}$|^\d{4}-\d{2}-\d{2}$ |
arguments.market_code | string | opcional | Código de mercado: MLM, MLB, MLA, MLC o MCO Permitidos: MLM, MLB, MLA, MLC, MCO Predeterminado: MLM |
arguments.page | integer | opcional | Número de página, a partir de 1 Predeterminado: 1 Mínimo: 1 |
arguments.price_max | number | opcional | Valor de Price max usado por esta operación de API. Mínimo: 0 |
arguments.price_min | number | opcional | Valor de Price min usado por esta operación de API. Mínimo: 0 |
arguments.product_status | string | integer | opcional | Valor de Product status usado por esta operación de API. |
arguments.product_url | string | opcional | Producto comercializado URL Formato: uri Patrón: ^https?:// |
arguments.rating_max | number | opcional | Valor de Rating max usado por esta operación de API. Mínimo: 0 Máximo: 5 |
arguments.rating_min | number | opcional | Valor de Rating min usado por esta operación de API. Mínimo: 0 Máximo: 5 |
arguments.review_count_max | integer | opcional | Valor de Review count max usado por esta operación de API. Mínimo: 0 |
arguments.review_count_min | integer | opcional | Valor de Review count min usado por esta operación de API. Mínimo: 0 |
arguments.sales_30d_max | integer | opcional | Valor de Sales 30d max usado por esta operación de API. Mínimo: 0 |
arguments.sales_30d_min | integer | opcional | Valor de Sales 30d min usado por esta operación de API. Mínimo: 0 |
arguments.shop_id | string | opcional | ID de la tienda del Mercado |
arguments.shop_query | string | opcional | Consulta de búsqueda de la tienda |
arguments.shop_type | string | opcional | Valor de Shop type usado por esta operación de API. Permitidos: cross_border, local |
arguments.sku_id | string | opcional | Producto comercializado SKU ID |
arguments.sort_by | string | opcional | Campo de clasificación de resultados de instantánea Permitidos: sales_30d, historical_total_sales, price, listing_date, rating, review_count, title Predeterminado: sales_30d |
arguments.sort_order | string | opcional | Dirección de clasificación: asc o desc Permitidos: asc, desc Predeterminado: desc |
arguments.stock_type | string | opcional | Valor de Stock type usado por esta operación de API. |
toolName | string | obligatorio | Operación de investigación Mercado Constante: search_product_snapshots |
Opción 1 de cualquier alternativa — requiere keyword
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
arguments | any | obligatorio | Argumentos para la operación seleccionada |
Opción 2 de cualquier alternativa — requiere category_id
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
arguments | any | obligatorio | Argumentos para la operación seleccionada |
Opción 3 de cualquier alternativa — requiere sku_id
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
arguments | any | obligatorio | Argumentos para la operación seleccionada |
Opción 4 de cualquier alternativa — requiere product_url
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
arguments | any | obligatorio | Argumentos para la operación seleccionada |
Opción 5 de cualquier alternativa — requiere shop_id
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
arguments | any | obligatorio | Argumentos para la operación seleccionada |
Opción 6 de cualquier alternativa — requiere shop_query
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
arguments | any | obligatorio | Argumentos para la operación seleccionada |
toolName: product_sales_trend
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
arguments | object | obligatorio | Argumentos para la operación seleccionada |
arguments.days | integer | opcional | Días de búsqueda de tendencia a las ventas Predeterminado: 730 Mínimo: 1 Máximo: 731 |
arguments.market_code | string | opcional | Código de mercado: MLM, MLB, MLA, MLC o MCO Permitidos: MLM, MLB, MLA, MLC, MCO Predeterminado: MLM |
arguments.sku_id | string | obligatorio | Producto comercializado SKU ID Longitud mínima: 1 |
toolName | string | obligatorio | Operación de investigación Mercado Constante: product_sales_trend |
toolName: image_search_products
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
arguments | object | obligatorio | Argumentos para la operación seleccionada |
arguments.image_base64 | string | opcional | Base64 entrada de imagen para la búsqueda de imágenes Longitud mínima: 1 |
arguments.image_url | string | opcional | Imagen pública URL para la búsqueda de imágenes Formato: uri Patrón: ^https?:// |
arguments.limit | integer | opcional | Número máximo de registros Predeterminado: 50 Mínimo: 1 |
arguments.market_code | string | opcional | Código de mercado: MLM, MLB, MLA, MLC o MCO Permitidos: MLM, MLB, MLA, MLC, MCO Predeterminado: MLM |
arguments.page | integer | opcional | Número de página, a partir de 1 Predeterminado: 1 Mínimo: 1 |
toolName | string | obligatorio | Operación de investigación Mercado Constante: image_search_products |
Opción 1 de cualquier alternativa — requiere image_url
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
arguments | any | obligatorio | Argumentos para la operación seleccionada |
Opción 2 de cualquier alternativa — requiere image_base64
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
arguments | any | obligatorio | Argumentos para la operación seleccionada |
toolName: review_search
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
arguments | object | obligatorio | Argumentos para la operación seleccionada |
arguments.limit | integer | opcional | Número máximo de registros Predeterminado: 20 Mínimo: 1 Máximo: 100 |
arguments.market_code | string | opcional | Código de mercado: MLM, MLB, MLA, MLC o MCO Permitidos: MLM, MLB, MLA, MLC, MCO Predeterminado: MLM |
arguments.page | integer | opcional | Número de página, a partir de 1 Predeterminado: 1 Mínimo: 1 |
arguments.sku_id | string | obligatorio | Producto comercializado SKU ID Longitud mínima: 1 |
toolName | string | obligatorio | Operación de investigación Mercado Constante: review_search |
Respuesta de ejemplo
Estructura de respuesta de la plataforma. code 0 indica éxito o aceptación; data contiene el resultado de negocio.
{
"code": 0,
"cost": "-1",
"data": {
"data": {
"record_count": 1,
"records": [
{
"taxonomy_code": "MLM1055",
"taxonomy_name": "Cell Phones"
}
]
},
"operation": "search_categories",
"total": 1
},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
}Campos de respuesta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | integer | obligatorio | 0 significa aceptado o exitoso; no cero es un error de plataforma. |
cost | string | obligatorio | Se pasó milisegundos, nunca créditos; -1 peticiones externas de la web. |
data | any | obligatorio | Valor de Data usado por esta operación de API. |
msg | string | null | obligatorio | Valor de Msg usado por esta operación de API. |
time | string | obligatorio | Hora local del servidor: aaaa-mm-dd HH:mm:ss. |
traceId | string | null | obligatorio | Valor de Trace id usado por esta operación de API. |
ts | string | obligatorio | Epoch milisegundos. |
Opción 1 de cualquier alternativa — requiere operation, data
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | object | obligatorio | Valor de Data usado por esta operación de API. |
data.charged | boolean | opcional | Valor de Charged usado por esta operación de API. |
data.data | object | obligatorio | Valor de Data usado por esta operación de API. |
data.operation | string | obligatorio | Valor de Operation usado por esta operación de API. Permitidos: search_categories, industry_overview, search_product_snapshots, product_sales_trend, image_search_products, review_search |
data.total | integer | opcional | Valor de Total usado por esta operación de API. Mínimo: 0 |
Opción 2 de cualquier alternativa
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
data | null | obligatorio | Valor de Data usado por esta operación de API. |
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.