https://api.nexscope.ai/sr/ozon/productReportSearchEjecutar 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/productReportSearch |
| Autenticación | Bearer API key |
| Content-Type | application/json |
Parámetros de la solicitud
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
brand | object | opcional | Brand filter: `{brandName: array<string>, type: integer}`; `type` is `0` included, `1` excluded, `2` unbranded. |
categoryIds | array | opcional | SR Array of category IDs, not category names. |
categoryIds[] | string | obligatorio | SR Array of category IDs, not category names. |
creationDate | integer | opcional | Shelf time filtering (months): `1`, `3`, `6`, `12`, `24`. |
fulfillment | array | opcional | Shipping method array: `OZON`, `FBO`, `FBS`, `RFBS`, `FBP`. |
fulfillment[] | string | obligatorio | Shipping method array: `OZON`, `FBO`, `FBS`, `RFBS`, `FBP`. |
keywords | array | opcional | Array of keywords filtered by product title. |
keywords[] | string | obligatorio | Array of keywords filtered by product title. |
labels | array | opcional | Tag array: `0` New, `1` Authentic, `2` Best Seller. |
labels[] | integer | obligatorio | Tag array: `0` New, `1` Authentic, `2` Best Seller. |
memberId | string | opcional | Member ID; the data is attributed to this member. |
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`, `field` can be `sales`, `revenue`, `price`, `reviewRating`, `reviewCount`, `salesRate` and other response indicator fields. |
page.orders[] | object | obligatorio | Sorting rule, the element is `{field, direction}`; `direction` takes `DESC` or `ASC`, `field` can be `sales`, `revenue`, `price`, `reviewRating`, `reviewCount`, `salesRate` and other response indicator fields. |
page.page | integer | opcional | Page number, starting from 1. Predeterminado: 1 |
page.pageSize | integer | opcional | Number of items per page. Predeterminado: 20 |
searchDate | string | opcional | Query date, the format is `yyyy-MM-dd`; for example, `2026-04-01` is used to query data in March 2026. |
sellerName | array | opcional | Array of seller names. |
sellerName[] | string | obligatorio | Array of seller names. |
skus | array | opcional | SKU array, up to 10, used to accurately query specified products. Cantidad máxima de elementos: 10 |
skus[] | integer | obligatorio | SKU array, up to 10, used to accurately query specified products. |
tag | string | opcional | tag word. |
uId | string | opcional | User ID. |
variationsMerge | integer | opcional | Whether to merge variants: `0` is not merged, `1` is merged. |
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 (56 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. |
total | integer | opcional | The total number of matching records, not the number of entries on the current page; it may reach tens of millions without filtering. |
data | array | opcional | Product report data, element fields are shown in the multiple field tables below. |
products | array | opcional | Product report data is completely consistent with the content of `data`. |
columns | array | opcional | Column definition, elements containing `field`, `title`, `cellType`, `sortable`, `filterable`. |
type | string | opcional | Response display type, such as `productWorkbenches`. |
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, equal to `sku`. |
title | string | opcional | Product title, original Russian text. |
imageUrl | string | opcional | Product main image URL. |
productUrl | string | opcional | Product link. |
productPageUrl | string | opcional | Unified product page URL, equal to `productUrl`. |
currency | string | opcional | Currency, fixed to `₽`. |
sourceType | string | opcional | Data source, fixed to `ozon`. |
sales | integer | opcional | Monthly sales volume. |
monthlySalesUnits | integer | opcional | The unified monthly sales volume is equal to `sales`. |
revenue | number | opcional | Monthly sales in rubles. |
monthlySalesRevenue | number | opcional | Unified monthly sales, equal to `revenue`. |
missedRevenue | number | opcional | Lost sales in rubles. |
price | number | opcional | Price in rubles. |
convToCartPdp | number | opcional | Shopping cart conversion rate, percentage. |
orderConversionRate | number | opcional | Order conversion rate, percentage. |
salesRate | number | opcional | Sales growth rate, percentage. |
revenueRate | number | opcional | Sales growth rate, percentage. |
drr | number | opcional | Advertising cost share, ratio. |
grossMargin | number | opcional | Gross profit margin, percentage. |
returnCancellationRate | number | opcional | Return cancellation rate, percentage. |
views | integer | opcional | Views. |
reviewRating | number | opcional | Rating, 0–5. |
rating | number | opcional | Unified rating, equal to `reviewRating`. |
reviewCount | integer | opcional | Number of comments. |
questionsAndAnswers | integer | opcional | QA quantity. |
variants | integer | opcional | Number of variants. |
fulfillment | array<string> | opcional | Delivery method: `OZON`, `FBO`, `FBS`, `RFBS`, `FBP`. |
weight | number | opcional | Weight, unit g. |
volume | number | opcional | Volume, unit L. |
upTime | integer | opcional | Listing timestamp, milliseconds. |
upDays | integer | opcional | Number of days on shelf. |
upMonths | integer | opcional | Number of months on shelves. |
brandName | string | opcional | Brand name. |
brand | string | opcional | Unified brand, equal to `brandName`. |
brandId | integer | opcional | Brand ID. |
brandUrl | string | opcional | Brand link. |
sellerName | string | opcional | Seller name. |
sellerId | integer | opcional | Seller ID; Ozon self-operated may be negative. |
categoryInfo | object | opcional | Category information and structure are shown in the table below. |
cnTitlePath | string | opcional | Chinese category path. |
enTitlePath | string | opcional | English category path. |
titlePath | string | opcional | Russian category path. |
fullCategoryId | array<string> | opcional | A hierarchical array of complete category IDs. |
category | object | opcional | Category nodes, including `cnTitle`, `enTitle`, `title`, `level`, `id`, `pid`, `crossBorderSellable`, `disabled`. |
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.