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
| Name | Type | Required | Description |
|---|---|---|---|
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
data | any | required | Data value used by this API operation. |
msg | string | null | required | Msg value used by this API operation. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
traceId | string | null | required | Trace id value used by this API operation. |
ts | string | required | Epoch milliseconds. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.balance | any | optional | Balance value used by this API operation. |
data.brand | any | optional | Brand value used by this API operation. |
data.columns | any | optional | Columns value used by this API operation. |
data.costTime | any | optional | Cost time value used by this API operation. |
data.costToken | any | optional | Cost token value used by this API operation. |
data.currency | any | optional | Currency value used by this API operation. |
data.dailySalesRevenue | any | optional | Daily sales revenue value used by this API operation. |
data.dailySalesRevenueWithStock | any | optional | Daily sales revenue with stock value used by this API operation. |
data.dataSnapshotMonth | any | optional | Data snapshot month value used by this API operation. |
data.deliveryScheme | any | optional | Delivery scheme value used by this API operation. |
data.discount | any | optional | Discount value used by this API operation. |
data.failedCount | any | optional | Failed count value used by this API operation. |
data.failures | any | optional | Failures value used by this API operation. |
data.firstDate | any | optional | First date value used by this API operation. |
data.imageCount | any | optional | Image count value used by this API operation. |
data.imageUrl | any | optional | Image url value used by this API operation. |
data.lostProfit | any | optional | Lost profit value used by this API operation. |
data.lostProfitPercent | any | optional | Lost profit percent value used by this API operation. |
data.monthlySalesRevenue | any | optional | Monthly sales revenue value used by this API operation. |
data.monthlySalesUnits | any | optional | Monthly sales units value used by this API operation. |
data.nicheId | any | optional | Niche id value used by this API operation. |
data.nicheName | any | optional | Niche name value used by this API operation. |
data.note | any | optional | Note value used by this API operation. |
data.oldPrice | any | optional | Old price value used by this API operation. |
data.ozonCardPrice | any | optional | Ozon card price value used by this API operation. |
data.page | any | optional | Page value used by this API operation. |
data.pageItemCount | any | optional | Page item count value used by this API operation. |
data.pageSize | any | optional | Page size value used by this API operation. |
data.previousRevenue | any | optional | Previous revenue value used by this API operation. |
data.previousSalesUnits | any | optional | Previous sales units value used by this API operation. |
data.price | any | optional | Price value used by this API operation. |
data.productId | any | optional | Product id value used by this API operation. |
data.productImageUrls | any | optional | Product image urls value used by this API operation. |
data.productPageUrl | any | optional | Product page url value used by this API operation. |
data.products | any | optional | Products value used by this API operation. |
data.rating | any | optional | Rating value used by this API operation. |
data.revenuePotential | any | optional | Revenue potential value used by this API operation. |
data.reviewCount | any | optional | Review count value used by this API operation. |
data.salesPerDay | any | optional | Sales per day value used by this API operation. |
data.salesPerDayWithStock | any | optional | Sales per day with stock value used by this API operation. |
data.sellerId | any | optional | Seller id value used by this API operation. |
data.sellerIsBestSeller | any | optional | Seller is best seller value used by this API operation. |
data.sellerName | any | optional | Seller name value used by this API operation. |
data.sourceTool | any | optional | Source tool value used by this API operation. |
data.sourceType | any | optional | Source type value used by this API operation. |
data.successCount | any | optional | Success count value used by this API operation. |
data.title | any | optional | Title value used by this API operation. |
data.total | any | optional | Total value used by this API operation. |
data.totalPage | any | optional | Total page value used by this API operation. |
data.type | any | optional | Type value used by this API operation. |
data.updated | any | optional | Updated value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.balance | integer | optional | Current inventory (pieces) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.balance | null | optional | Balance value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.brand | string | optional | brand Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.brand | null | optional | Brand value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.columns | array | optional | Render column definition Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.columns | null | optional | Columns value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.costTime | integer | optional | Interface time (milliseconds) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.costTime | null | optional | Cost time value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.costToken | integer | optional | Amount of Token consumed Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.costToken | null | optional | Cost token value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.currency | string | optional | Currency symbol (`₽` / `$` / `€`) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.currency | null | optional | Currency value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.dailySalesRevenue | number | optional | average daily sales Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.dailySalesRevenue | null | optional | Daily sales revenue value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.dailySalesRevenueWithStock | number | optional | Average daily sales in stock Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.dailySalesRevenueWithStock | null | optional | Daily sales revenue with stock value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.dataSnapshotMonth | null | optional | Data snapshot month value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.deliveryScheme | string | optional | Delivery plan; `FBO`=Ozon warehouse delivery, `FBS`=Seller’s own delivery Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.deliveryScheme | null | optional | Delivery scheme value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.discount | integer | optional | Discount, percentage integer 0-100 Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.discount | null | optional | Discount value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.failedCount | integer | optional | Number of failed SKUs (usually 0 or 1) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.failedCount | null | optional | Failed count value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.failures | array | optional | Detailed list of failed SKUs (usually up to 1 item, each containing the failed `productId` and error message) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.failures | null | optional | Failures value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.firstDate | string | optional | Release date (`yyyy-MM-dd`) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.firstDate | null | optional | First date value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.imageCount | integer | optional | Total number of pictures Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.imageCount | null | optional | Image count value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.imageUrl | string | optional | Main image URL (first large image) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.imageUrl | null | optional | Image url value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.lostProfit | number | optional | Lost sales (caused by stockouts, etc.) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.lostProfit | null | optional | Lost profit value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.lostProfitPercent | number | optional | Proportion of lost sales (%) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.lostProfitPercent | null | optional | Lost profit percent value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.monthlySalesRevenue | number | optional | Sales during the statistical period Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.monthlySalesRevenue | null | optional | Monthly sales revenue value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.monthlySalesUnits | integer | optional | Sales volume during the statistical period (pieces) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.monthlySalesUnits | null | optional | Monthly sales units value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.nicheId | integer | optional | Track ID Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.nicheId | null | optional | Niche id value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.nicheName | string | optional | Track path (Russian, `/` delimited) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.nicheName | null | optional | Niche name value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.note | string | optional | Remarks Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.note | null | optional | Note value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.oldPrice | number | optional | Original price before discount Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.oldPrice | null | optional | Old price value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.ozonCardPrice | number | optional | Ozon Card price (bank card discount price) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.ozonCardPrice | null | optional | Ozon card price value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.page | null | optional | Page value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.pageItemCount | null | optional | Page item count value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.pageSize | null | optional | Page size value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.previousRevenue | number | optional | Last period sales Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.previousRevenue | null | optional | Previous revenue value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.previousSalesUnits | integer | optional | Sales volume in the previous period (the previous period with the same length as this statistical period) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.previousSalesUnits | null | optional | Previous sales units value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.price | number | optional | Current selling price Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.price | null | optional | Price value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.productId | integer | optional | SKU ID Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.productId | null | optional | Product id value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.productImageUrls | string | optional | Other large image URLs except the main image Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.productImageUrls | null | optional | Product image urls value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.productPageUrl | string | optional | Product page URL Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.productPageUrl | null | optional | Product page url value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.products | array | optional | Product card list Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.products | null | optional | Products value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.rating | number | optional | Rating, 0-5 Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.rating | null | optional | Rating value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.revenuePotential | number | optional | Potential sales (estimated based on inventory for the entire period) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.revenuePotential | null | optional | Revenue potential value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.reviewCount | integer | optional | Number of comments Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.reviewCount | null | optional | Review count value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.salesPerDay | number | optional | Average daily sales volume (pieces/day) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.salesPerDay | null | optional | Sales per day value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.salesPerDayWithStock | number | optional | Average daily sales volume in stock (only counting days in stock) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.salesPerDayWithStock | null | optional | Sales per day with stock value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sellerId | integer | optional | Seller ID Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sellerId | null | optional | Seller id value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sellerIsBestSeller | boolean | optional | Is the seller a best-selling seller? Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sellerIsBestSeller | null | optional | Seller is best seller value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sellerName | string | optional | Seller name Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sellerName | null | optional | Seller name value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceTool | null | optional | Source tool value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceType | null | optional | Source type value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.successCount | integer | optional | The SKU number of the card returned successfully (usually 0 or 1) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.successCount | null | optional | Success count value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.title | string | optional | Product name (Russian) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.title | null | optional | Title value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.total | integer | optional | Number of SKUs returned (usually 0 or 1, equal to `successCount + failedCount`) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.total | null | optional | Total value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.totalPage | null | optional | Total page value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.type | string | optional | response type Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.type | null | optional | Type value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.updated | string | optional | Data update time (`yyyy-MM-dd HH:mm:ss`) Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.updated | null | optional | Updated value used by this API operation. |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
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 API key (code 11209), 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.