https://api.nexscope.ai/mp/ozon/productTrendEjecutar 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/mp/ozon/productTrend |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
productId | integer | obligatorio | Producto Ozon SKU |
startDate | string | opcional | Fecha de inicio de las estadísticas, `YYYY-MM-DD`; retardo de datos T-1, el último día puede ser seleccionado |
endDate | string | opcional | Fecha de finalización de las estadísticas, `YYYY-MM-DD`; retardo de datos T-1, la última disponible es ayer |
includeFbs | boolean | opcional | Indica si se deben incluir datos de FBS |
includeSearchStats | boolean | opcional | Si viene con posición de búsqueda/visibilidad; algunas pistas no lo soportan |
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 |
|---|---|---|---|
code | string | opcional | Código de retorno (cadena), `"200"` indica éxito |
errcode | integer | opcional | Código de retorno (entero), `200` indica éxito |
total | integer | opcional | Número de puntos de datos por día (número de días de ventana) |
data | array | opcional | Lista de puntos de datos diarios |
columns | array | opcional | Definición de la columna de render |
costTime | integer | opcional | Tiempo de interfaz (millisegundos) |
costToken | integer | opcional | Cantidad de token consumido |
type | string | opcional | tipo de respuesta |
date | string | opcional | Fecha, `YYYY-MM-DD` |
hasData | boolean | opcional | Si hay datos en ese día; `false` indica el día que falta, que es diferente de `sales=0` |
price | number | opcional | Precio de venta en el día |
oldPrice | number | opcional | Precio original antes del descuento en el día |
ozonCardPrice | number | opcional | Precio de la tarjeta Ozon (precio de descuento de la tarjeta bancaria oficial Ozon) |
discount | integer | opcional | Descuento, porcentaje entero 0-100 |
currency | string | opcional | Signatura de la moneda (como `₽` / `$` / `€`) |
sales | integer | opcional | Volumen de ventas en el día (piezas) |
balance | integer | opcional | Inventario de almacén de FBO en el día (piezas) |
rating | number | opcional | Valoración, valor 0-5 |
comments | integer | opcional | Número de comentarios |
isBestseller | boolean | opcional | Si hay una marca de "mejor venta" en ese día |
isNew | boolean | opcional | Si hay una marca de "nuevo producto" en ese día |
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.