POST
https://api.nexscope.ai/mp/ozon/productDetailRun this API
Send a JSON request to execute this API and receive the documented response payload.
Endpoint
| Method | POST |
| Path | https://api.nexscope.ai/mp/ozon/productDetail |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
productId | integer|string | required | Single Ozon product ID (SKU); arrays/lists not accepted |
startDate | string | optional | Statistics start date, format `YYYY-MM-DD`; yesterday can be selected as the latest |
endDate | string | optional | Statistics end date, format `YYYY-MM-DD`; yesterday can be selected at the latest |
includeFbs | boolean | optional | Whether to include FBS data |
Code example
{
"endDate": "2025-03-31",
"includeFbs": true,
"productId": 1786874757,
"startDate": "2025-03-01"
}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 (46 fields)
| Name | Type | Required | Description |
|---|---|---|---|
code | string | optional | Return code (string), `"200"` indicates success |
errcode | integer | optional | Return code (integer), `200` indicates success |
total | integer | optional | Number of SKUs returned (usually 0 or 1, equal to `successCount + failedCount`) |
successCount | integer | optional | The SKU number of the card returned successfully (usually 0 or 1) |
failedCount | integer | optional | Number of failed SKUs (usually 0 or 1) |
failures | array | optional | Detailed list of failed SKUs (usually up to 1 item, each containing the failed `productId` and error message) |
products | array | optional | Product card list |
columns | array | optional | Render column definition |
costTime | integer | optional | Interface time (milliseconds) |
costToken | integer | optional | Amount of Token consumed |
type | string | optional | response type |
productId | integer | optional | SKU ID |
title | string | optional | Product name (Russian) |
brand | string | optional | brand |
sellerName | string | optional | Seller name |
sellerId | integer | optional | Seller ID |
sellerIsBestSeller | boolean | optional | Is the seller a best-selling seller? |
nicheName | string | optional | Track path (Russian, `/` delimited) |
nicheId | integer | optional | Track ID |
firstDate | string | optional | Release date (`yyyy-MM-dd`) |
updated | string | optional | Data update time (`yyyy-MM-dd HH:mm:ss`) |
note | string | optional | Remarks |
imageUrl | string | optional | Main image URL (first large image) |
imageCount | integer | optional | Total number of pictures |
productImageUrls | array<string> | optional | Other large image URLs except the main image |
productPageUrl | string | optional | Product page URL |
price | number | optional | Current selling price |
oldPrice | number | optional | Original price before discount |
ozonCardPrice | number | optional | Ozon Card price (bank card discount price) |
discount | integer | optional | Discount, percentage integer 0-100 |
currency | string | optional | Currency symbol (`₽` / `$` / `€`) |
rating | number | optional | Rating, 0-5 |
reviewCount | integer | optional | Number of comments |
balance | integer | optional | Current inventory (pieces) |
deliveryScheme | string | optional | Delivery plan; `FBO`=Ozon warehouse delivery, `FBS`=Seller’s own delivery |
salesPerDay | number | optional | Average daily sales volume (pieces/day) |
salesPerDayWithStock | number | optional | Average daily sales volume in stock (only counting days in stock) |
dailySalesRevenue | number | optional | average daily sales |
dailySalesRevenueWithStock | number | optional | Average daily sales in stock |
monthlySalesUnits | integer | optional | Sales volume during the statistical period (pieces) |
monthlySalesRevenue | number | optional | Sales during the statistical period |
previousSalesUnits | integer | optional | Sales volume in the previous period (the previous period with the same length as this statistical period) |
previousRevenue | number | optional | Last period sales |
revenuePotential | number | optional | Potential sales (estimated based on inventory for the entire period) |
lostProfit | number | optional | Lost sales (caused by stockouts, etc.) |
lostProfitPercent | number | optional | Proportion of lost sales (%) |
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.