https://api.nexscope.ai/sr/ozon/productReportSearchRun this API
Send a JSON request to execute this API and receive the documented response payload.
Endpoint
| Method | POST |
| Path | https://api.nexscope.ai/sr/ozon/productReportSearch |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
brand | object | optional | Brand filter: `{brandName: array<string>, type: integer}`; `type` is `0` included, `1` excluded, `2` unbranded. |
categoryIds | array | optional | SR Array of category IDs, not category names. |
categoryIds[] | string | required | SR Array of category IDs, not category names. |
creationDate | integer | optional | Shelf time filtering (months): `1`, `3`, `6`, `12`, `24`. |
fulfillment | array | optional | Shipping method array: `OZON`, `FBO`, `FBS`, `RFBS`, `FBP`. |
fulfillment[] | string | required | Shipping method array: `OZON`, `FBO`, `FBS`, `RFBS`, `FBP`. |
keywords | array | optional | Array of keywords filtered by product title. |
keywords[] | string | required | Array of keywords filtered by product title. |
labels | array | optional | Tag array: `0` New, `1` Authentic, `2` Best Seller. |
labels[] | integer | required | Tag array: `0` New, `1` Authentic, `2` Best Seller. |
memberId | string | optional | Member ID; the data is attributed to this member. |
page | object | required | Paging and sorting: `{page, pageSize, orders[]}`. |
page.orders | array | optional | 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 | required | 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 | optional | Page number, starting from 1. Default: 1 |
page.pageSize | integer | optional | Number of items per page. Default: 20 |
searchDate | string | optional | Query date, the format is `yyyy-MM-dd`; for example, `2026-04-01` is used to query data in March 2026. |
sellerName | array | optional | Array of seller names. |
sellerName[] | string | required | Array of seller names. |
skus | array | optional | SKU array, up to 10, used to accurately query specified products. Maximum items: 10 |
skus[] | integer | required | SKU array, up to 10, used to accurately query specified products. |
tag | string | optional | tag word. |
uId | string | optional | User ID. |
variationsMerge | integer | optional | Whether to merge variants: `0` is not merged, `1` is merged. |
Response example
Platform response envelope. code 0 indicates success or acceptance; data contains the business result.
No response example is published for this API. Refer to the response fields below.
Response fields
Response field reference (56 fields)
| Name | Type | Required | Description |
|---|---|---|---|
code | string | optional | Return code, `"200"` indicates success; returned when successful. |
errcode | integer | optional | Error code, `200` indicates success; only this field may be returned when there is a business error. |
msg | string | optional | Message; Success was `ok`. |
errmsg | string | optional | Error message; success is `ok`, business error is a reason description. |
total | integer | optional | 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 | optional | Product report data, element fields are shown in the multiple field tables below. |
products | array | optional | Product report data is completely consistent with the content of `data`. |
columns | array | optional | Column definition, elements containing `field`, `title`, `cellType`, `sortable`, `filterable`. |
type | string | optional | Response display type, such as `productWorkbenches`. |
costTime | integer | optional | The interface consumes time in milliseconds. |
costToken | integer | optional | The number of tokens consumed. |
sku | integer | optional | Product SKU. |
productId | integer | optional | Unified product ID, equal to `sku`. |
title | string | optional | Product title, original Russian text. |
imageUrl | string | optional | Product main image URL. |
productUrl | string | optional | Product link. |
productPageUrl | string | optional | Unified product page URL, equal to `productUrl`. |
currency | string | optional | Currency, fixed to `₽`. |
sourceType | string | optional | Data source, fixed to `ozon`. |
sales | integer | optional | Monthly sales volume. |
monthlySalesUnits | integer | optional | The unified monthly sales volume is equal to `sales`. |
revenue | number | optional | Monthly sales in rubles. |
monthlySalesRevenue | number | optional | Unified monthly sales, equal to `revenue`. |
missedRevenue | number | optional | Lost sales in rubles. |
price | number | optional | Price in rubles. |
convToCartPdp | number | optional | Shopping cart conversion rate, percentage. |
orderConversionRate | number | optional | Order conversion rate, percentage. |
salesRate | number | optional | Sales growth rate, percentage. |
revenueRate | number | optional | Sales growth rate, percentage. |
drr | number | optional | Advertising cost share, ratio. |
grossMargin | number | optional | Gross profit margin, percentage. |
returnCancellationRate | number | optional | Return cancellation rate, percentage. |
views | integer | optional | Views. |
reviewRating | number | optional | Rating, 0–5. |
rating | number | optional | Unified rating, equal to `reviewRating`. |
reviewCount | integer | optional | Number of comments. |
questionsAndAnswers | integer | optional | QA quantity. |
variants | integer | optional | Number of variants. |
fulfillment | array<string> | optional | Delivery method: `OZON`, `FBO`, `FBS`, `RFBS`, `FBP`. |
weight | number | optional | Weight, unit g. |
volume | number | optional | Volume, unit L. |
upTime | integer | optional | Listing timestamp, milliseconds. |
upDays | integer | optional | Number of days on shelf. |
upMonths | integer | optional | Number of months on shelves. |
brandName | string | optional | Brand name. |
brand | string | optional | Unified brand, equal to `brandName`. |
brandId | integer | optional | Brand ID. |
brandUrl | string | optional | Brand link. |
sellerName | string | optional | Seller name. |
sellerId | integer | optional | Seller ID; Ozon self-operated may be negative. |
categoryInfo | object | optional | Category information and structure are shown in the table below. |
cnTitlePath | string | optional | Chinese category path. |
enTitlePath | string | optional | English category path. |
titlePath | string | optional | Russian category path. |
fullCategoryId | array<string> | optional | A hierarchical array of complete category IDs. |
category | object | optional | Category nodes, including `cnTitle`, `enTitle`, `title`, `level`, `id`, `pid`, `crossBorderSellable`, `disabled`. |
Responses
| Code | Description |
|---|---|
| 200 | Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result. |
| 429 | Execution admission rate limit; honor Retry-After when present. |
| 503 | Execution admission is temporarily unavailable; honor Retry-After when present. |
| Opt-in | X-Nexscope-Http-Status: semantic maps controller-handled business errors to HTTP status on run and task routes. Pre-authentication failures, such as a missing or invalid API key (code 11209, including an incomplete or corrupted copy) or an expired website login session (code 12001), may still return HTTP 200 before this mapping. Always check the outer JSON code; malformed requests and infrastructure failures may also return non-200 HTTP responses. |
Data source, freshness, and limitations
Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.