https://api.nexscope.ai/sr/ozon/productDetailSearchRun 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/productDetailSearch |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
sku | string | required | Product SKU, only one SKU can be queried at a time. |
dateRange | string | optional | Sales volume/metric statistics window: `past_7_days`, `past_30_days`, `past_60_days`, `past_90_days`, `past_180_days`, `past_365_days`. Example: past_30_days |
uId | string | optional | User ID, up to 1000. |
memberId | string | optional | Member ID; a member's unique identifier, the data belongs to this member, the maximum number is 1000. |
Code example
{
"dateRange": "past_30_days",
"sku": "175924376"
}Response example
Platform response envelope. code 0 indicates success or acceptance; data contains the business result.
{
"code": 0,
"cost": "-1",
"data": {},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
}Response fields
Response field reference (71 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 | Returns the number of records, 1 for a hit and 0 for a miss. |
totalSales | integer | optional | Total sales within the statistics window. |
dailySales | number | optional | Average sales per day. |
totalRevenue | number | optional | Sales volume within the statistical window, in rubles. |
stock | integer | optional | Inventory. |
startDate | string | optional | Statistics window start date. |
endDate | string | optional | Statistics window end date. |
salesTrendVOList | array | optional | Daily sales data series, the element fields are shown in the table below. |
categoryRanks | array | optional | Product category ranking history, element fields are shown in the table below. |
products | array | optional | List of product details; usually 1 on hit. |
data | array | optional | Return data, the content is exactly the same as `products`. |
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, mapped from `sku`. |
title | string | optional | Product title. |
price | number | optional | Commodity price in rubles. |
currency | string | optional | Currency, fixed to `₽`. |
reviewRating | number | optional | Product ratings. |
rating | number | optional | Unified scoring, mapped from `reviewRating`. |
reviewCount | integer | optional | Number of comments. |
questionsAndAnswers | integer | optional | QA quantity. |
brandName | string | optional | Brand name. |
brand | string | optional | Unified brand, mapped from `brandName`. |
brandId | integer | optional | Brand ID. |
brandUrl | string | optional | Brand link. |
sellerName | string | optional | Seller name. |
sellerId | integer | optional | Seller ID; a negative value indicates a self-operated seller on the Ozon platform. |
fulfillment | array | optional | Product shipping methods, such as `["FBO"]` or `["OZON"]`, may contain multiple values. |
upTime | integer | optional | Shelf time, millisecond timestamp. |
upDays | integer | optional | Number of days on shelf. |
upMonths | integer | optional | Number of months on shelves. |
imageUrl | string | optional | Unified main image URL, mapped from the first image of `imageUrls`. |
imageUrls | array | optional | List of product image URLs. |
productUrl | string | optional | Product URL. |
productPageUrl | string | optional | Unified product page URL, mapped from `productUrl`. |
categoryInfo | object | optional | Product category information and structure are shown in the table below. |
monthlySalesUnits | integer | optional | The unified monthly sales volume is actually equal to `totalSales` in the current statistical window. |
monthlySalesRevenue | number | optional | Unified monthly sales, actually equal to `totalRevenue` in the current statistical window. |
sourceType | string | optional | Data source, fixed to `ozon`. |
weight | number | optional | Product weight in grams; digital/service items may not be returned. |
grossMargin | number | optional | Gross profit margin; some items may not be returned. |
date | string | optional | date. |
sales | integer | optional | Sales volume on the day, `0` indicates no sales volume on the day. |
revenue | number | optional | Sales volume for the day, in rubles. |
price | number | optional | Today's price in rubles. |
stock | integer | optional | Inventory of the day. |
reviewCount | integer | optional | The number of comments as of that day, cumulative value. |
reviewRating | number | optional | Rating as of today. |
date | string | optional | Month or specific day of the month. |
rank | integer | optional | Category ranking. |
count | integer | optional | Statistical count, the caliber is subject to the actual return from the gateway. |
cnTitlePath | string | optional | Chinese category path. |
enTitlePath | string | optional | English category path. |
titlePath | string | optional | Category original path. |
category | object | optional | The final category object, the fields are shown in the table below. |
fullCategoryId | array | optional | Full category ID path, array of strings. |
cnTitle | string | optional | Category Chinese name. |
enTitle | string | optional | Category English name. |
title | string | optional | Category original title. |
level | integer | optional | Category level. |
id | string | optional | Category ID. |
pid | string | optional | Parent category ID. |
crossBorderSellable | boolean | optional | Whether to support cross-border sales. |
disabled | boolean | optional | Whether to deactivate. |
Responses
| Code | Description |
|---|---|
| 200 | HTTP request completed. Check JSON code; only 0 indicates business success or acceptance. |
| 400 | Request JSON or required API parameters are invalid. |
| 401 | API key is missing, invalid, or cannot be matched to a user. |
| 5xx | API execution or upstream service failed. |
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.