https://api.nexscope.ai/sr/ozon/categorySearchEjecutar 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/sr/ozon/categorySearch |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
categoryId | string | obligatorio | Ozon category ID, obtained from the Ozon category document or other SR Ozon tools; multi-level categories are connected with `_`. |
date | string | opcional | Historical month, format `yyyy-MM`, such as `2026-02`. |
fulfillment | string | opcional | Delivery method: `FBO`, `FBS`, `RFBS`, `FBP`, `OZON`; do not query all, it must be a single string instead of an array. |
memberId | string | opcional | Member ID; a member's unique identifier, the data belongs to this member, the maximum number is 1000. |
page | object | obligatorio | Paging and sorting: `{page, pageSize, orders[]}`. |
page.orders | array | opcional | Sorting rule, the element is `{field, direction}`; `direction` takes `DESC` or `ASC`. Commonly used fields: `sales`, `price`, `revenue`, `reviewRating`. |
page.orders[] | object | obligatorio | Regla de clasificación, el elemento es `{field, direction}`; `direction` toma `DESC` o `ASC`. Campos de uso común: `sales`, `price`, `revenue`, `reviewRating`. |
page.page | integer | opcional | Page number, starting from 1. Predeterminado: 1 |
page.pageSize | integer | opcional | The maximum number of items per page is 20. If exceeded, `errcode 1002` will be returned. Predeterminado: 20 |
uId | string | opcional | User ID, up to 1000. |
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 (49 campos)
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
code | string | opcional | Return code, `"200"` indicates success; returned when successful. |
errcode | integer | opcional | Error code, `200` indicates success; only this field may be returned when there is a business error. |
msg | string | opcional | Message; Success was `ok`. |
errmsg | string | opcional | Error message; success is `ok`, business error is a reason description. |
id | string | opcional | The category ID to be echoed. |
total | integer | opcional | The number of records returned on this page is equal to the number of `data` items on the current page, not the total number of products in the category. |
totalSales | integer | opcional | The total sales volume of the category within the statistical interval. |
totalRevenue | number | opcional | Total category sales in rubles. |
avgPrice | number | opcional | Average price of products in the category, in rubles. |
rating | number | opcional | Average rating of category products. |
seasonalityAmplitude | string | opcional | Seasonal strength, such as `STRONG_SEASONALITY`. |
seasonalityCoef | string | opcional | Seasonal phases such as `OFF_SEASON`. |
startDate | string | opcional | Statistics start date. |
endDate | string | opcional | Statistics end date. |
sellerType | object | opcional | The distribution of delivery methods, not the seller’s local/cross-border type; the key is the delivery method and the value is the number of products. |
categoryInfo | object | opcional | Category meta information, the structure is shown in the `categoryInfo` table below. |
data | array | opcional | Category product list, element fields are shown in the product object table below. |
products | array | opcional | Category product list, content is exactly the same as `data`. |
hasNextPage | boolean | opcional | Is there a next page? |
columns | array | opcional | Column definition, elements containing `field`, `title`, `cellType`, `sortable`, `filterable`. |
type | string | opcional | Responsive display type. |
costTime | integer | opcional | The interface consumes time in milliseconds. |
costToken | integer | opcional | The number of tokens consumed. |
sku | integer | opcional | Product SKU. |
productId | integer | opcional | Unified product ID, mapped from `sku`. |
title | string | opcional | Título del producto |
price | number | opcional | Commodity price in rubles. |
currency | string | opcional | Currency, fixed to `₽`. |
sales | integer | opcional | Product sales. |
monthlySalesUnits | integer | opcional | Unified monthly sales, mapped from `sales`. |
revenue | number | opcional | Sales volume of goods in rubles. |
monthlySalesRevenue | number | opcional | Unified monthly sales, mapped from `revenue`. |
reviewRating | number | opcional | Valoración |
rating | number | opcional | Unified scoring, mapped from `reviewRating`. |
reviewCount | integer | opcional | Number of comments. |
brandName | string | opcional | Brand name. |
brand | string | opcional | Unified brand, mapped from `brandName`. |
sellerName | string | opcional | Seller name. |
fulfillment | array | opcional | Product shipping method, such as `["FBO"]`, may contain multiple values. |
imageUrl | string | opcional | Product image link. |
productUrl | string | opcional | Product link. |
productPageUrl | string | opcional | Unified product page URL, mapped from `productUrl`. |
categoryInfo | object | opcional | Product category attribution information, the structure is shown in the `categoryInfo` table below. |
sourceType | string | opcional | Data source, fixed to `ozon`. |
cnTitlePath | string | opcional | Chinese category path. |
enTitlePath | string | opcional | English category path. |
titlePath | string | opcional | Russian (frontend) category path. |
fullCategoryId | array | opcional | Array of category IDs at all levels. |
category | object | opcional | The bottom-level category object contains fields such as title, level, cross-border sales, parent, deactivation status, and ID. |
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 una clave API ausente o no válida (code 11209, incluida una copia incompleta o dañada) o una sesión web caducada (code 12001), 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.