Nexscope

Ozon Product Detail

Retrieve full details for up to 100 Ozon SKUs. Call the Ozon Product Detail API via REST or MCP from 17 credits per call.

CostRecent Avg. 25 · Range 10–25 credits / call
Try online
POST · https://api.nexscope.ai/mp/ozon/productDetailMCP · nexscope_ozon_product_detail

Choose an integration method

Ozon Intelligence MP

What this API does

Retrieve full details for up to 100 Ozon SKUs. The request accepts productId, startDate, endDate, includeFbs. Its documented result includes balance, brand, currency, dailySalesRevenue, dailySalesRevenueWithStock, dataSnapshotMonth, deliveryScheme, discount.

Ozon Product Detail API use cases

Inspect a candidate product

To inspect a candidate product, a marketplace analyst submits productId and startDate to Ozon Product Detail. The returned balance, brand, currency help inspect the documented attributes of the candidate product.

Compare listing details

A marketplace analyst uses Ozon Product Detail with productId and startDate to compare listing details. The returned balance, brand, currency help compare product details with another shortlisted listing.

Prepare product evidence for a sourcing review

For this workflow, a marketplace analyst calls Ozon Product Detail with productId and startDate to prepare product evidence for a sourcing review. The result helps record product facts before a sourcing discussion.

Ozon Product Detail API FAQ

What does the Ozon Product Detail API return?

Retrieve full details for up to 100 Ozon SKUs. The documented output includes balance, brand, currency, dailySalesRevenue, dailySalesRevenueWithStock, dataSnapshotMonth, deliveryScheme, discount. It corresponds to the supplied productId, startDate, endDate, includeFbs. Optional fields can be absent; a missing value should not be interpreted as a measured zero. Example values illustrate the response shape, rather than live account results.

How many credits does the Ozon Product Detail API cost?

The current documented cost is Recent Avg. 25 · Range 10–25 credits / call. This is the same cost shown at the top of this page. If a range or estimate is displayed, the final charge depends on the request. Review your available credits and the pricing page before calling the API, and check API usage records for the actual charge.

How do I call the Ozon Product Detail API from my app or an MCP client?

Send a POST request to https://api.nexscope.ai/mp/ozon/productDetail with your API key as a Bearer token and the JSON inputs shown in API integration. In a compatible MCP client such as Claude or Cursor, connect Nexscope and call nexscope_ozon_product_detail. Use the MCP arguments shown in the MCP guide, or switch Online test to MCP to review its request before adding it to your app.

View plans and creditsConnect this API with MCP

Try this API
Endpoint
https://api.nexscope.ai/mp/ozon/productDetail
MCP method
nexscope_ozon_product_detail

Step 1 of 3 · Authenticate

Authentication

All run endpoints require a user API key. Send it as a bearer token in the Authorization header.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx
Missing or invalid API keys return an authentication error. Manage keys from .

Step 2 of 3 · Send a request

POSThttps://api.nexscope.ai/mp/ozon/productDetail

Run an API

Send a JSON request body using the parameters described below.

Example request

Replace YOUR_API_KEY, then run this command in your terminal.

curl -X POST 'https://api.nexscope.ai/mp/ozon/productDetail' \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "endDate": "2025-03-31",
  "includeFbs": true,
  "productId": 1786874757,
  "startDate": "2025-03-01"
}'

Step 3 of 3 · Inspect the result

Check the response

Read code for the request status and data for the result. Open the parameter and response reference for the full field definitions.

HTTP status codes

CodeDescription
200Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result.
429Execution admission rate limit; honor Retry-After when present.
503Execution admission is temporarily unavailable; honor Retry-After when present.
Opt-inX-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.
All categories/ Ozon Intelligence MP
POSThttps://api.nexscope.ai/mp/ozon/productDetail

Run this API

Send a JSON request to execute this API and receive the documented response payload.

Endpoint

MethodPOST
Pathhttps://api.nexscope.ai/mp/ozon/productDetail
AuthBearer API key
Content-Typeapplication/json

Request parameters

NameTypeRequiredDescription
productIdinteger|stringrequired
Single Ozon product ID (SKU); arrays/lists not accepted
startDatestringoptional
Statistics start date, format `YYYY-MM-DD`; yesterday can be selected as the latest
endDatestringoptional
Statistics end date, format `YYYY-MM-DD`; yesterday can be selected at the latest
includeFbsbooleanoptional
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

NameTypeRequiredDescription
codeintegerrequired
0 means accepted or successful; nonzero is a platform error.
coststringrequired
Elapsed milliseconds, never credits; -1 outside web requests.
dataanyrequired
Data value used by this API operation.
msgstring | nullrequired
Msg value used by this API operation.
timestringrequired
Server local time: yyyy-MM-dd HH:mm:ss.
traceIdstring | nullrequired
Trace id value used by this API operation.
tsstringrequired
Epoch milliseconds.

Any of option 1

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.balanceanyoptional
Balance value used by this API operation.
data.brandanyoptional
Brand value used by this API operation.
data.columnsanyoptional
Columns value used by this API operation.
data.costTimeanyoptional
Cost time value used by this API operation.
data.costTokenanyoptional
Cost token value used by this API operation.
data.currencyanyoptional
Currency value used by this API operation.
data.dailySalesRevenueanyoptional
Daily sales revenue value used by this API operation.
data.dailySalesRevenueWithStockanyoptional
Daily sales revenue with stock value used by this API operation.
data.dataSnapshotMonthanyoptional
Data snapshot month value used by this API operation.
data.deliverySchemeanyoptional
Delivery scheme value used by this API operation.
data.discountanyoptional
Discount value used by this API operation.
data.failedCountanyoptional
Failed count value used by this API operation.
data.failuresanyoptional
Failures value used by this API operation.
data.firstDateanyoptional
First date value used by this API operation.
data.imageCountanyoptional
Image count value used by this API operation.
data.imageUrlanyoptional
Image url value used by this API operation.
data.lostProfitanyoptional
Lost profit value used by this API operation.
data.lostProfitPercentanyoptional
Lost profit percent value used by this API operation.
data.monthlySalesRevenueanyoptional
Monthly sales revenue value used by this API operation.
data.monthlySalesUnitsanyoptional
Monthly sales units value used by this API operation.
data.nicheIdanyoptional
Niche id value used by this API operation.
data.nicheNameanyoptional
Niche name value used by this API operation.
data.noteanyoptional
Note value used by this API operation.
data.oldPriceanyoptional
Old price value used by this API operation.
data.ozonCardPriceanyoptional
Ozon card price value used by this API operation.
data.pageanyoptional
Page value used by this API operation.
data.pageItemCountanyoptional
Page item count value used by this API operation.
data.pageSizeanyoptional
Page size value used by this API operation.
data.previousRevenueanyoptional
Previous revenue value used by this API operation.
data.previousSalesUnitsanyoptional
Previous sales units value used by this API operation.
data.priceanyoptional
Price value used by this API operation.
data.productIdanyoptional
Product id value used by this API operation.
data.productImageUrlsanyoptional
Product image urls value used by this API operation.
data.productPageUrlanyoptional
Product page url value used by this API operation.
data.productsanyoptional
Products value used by this API operation.
data.ratinganyoptional
Rating value used by this API operation.
data.revenuePotentialanyoptional
Revenue potential value used by this API operation.
data.reviewCountanyoptional
Review count value used by this API operation.
data.salesPerDayanyoptional
Sales per day value used by this API operation.
data.salesPerDayWithStockanyoptional
Sales per day with stock value used by this API operation.
data.sellerIdanyoptional
Seller id value used by this API operation.
data.sellerIsBestSelleranyoptional
Seller is best seller value used by this API operation.
data.sellerNameanyoptional
Seller name value used by this API operation.
data.sourceToolanyoptional
Source tool value used by this API operation.
data.sourceTypeanyoptional
Source type value used by this API operation.
data.successCountanyoptional
Success count value used by this API operation.
data.titleanyoptional
Title value used by this API operation.
data.totalanyoptional
Total value used by this API operation.
data.totalPageanyoptional
Total page value used by this API operation.
data.typeanyoptional
Type value used by this API operation.
data.updatedanyoptional
Updated value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.balanceintegeroptional
Current inventory (pieces)
Example: null

Any of option 2

NameTypeRequiredDescription
data.balancenulloptional
Balance value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.brandstringoptional
brand
Example: null

Any of option 2

NameTypeRequiredDescription
data.brandnulloptional
Brand value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.columnsarrayoptional
Render column definition
Example: null

Any of option 2

NameTypeRequiredDescription
data.columnsnulloptional
Columns value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.costTimeintegeroptional
Interface time (milliseconds)
Example: null

Any of option 2

NameTypeRequiredDescription
data.costTimenulloptional
Cost time value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.costTokenintegeroptional
Amount of Token consumed
Example: null

Any of option 2

NameTypeRequiredDescription
data.costTokennulloptional
Cost token value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.currencystringoptional
Currency symbol (`₽` / `$` / `€`)
Example: null

Any of option 2

NameTypeRequiredDescription
data.currencynulloptional
Currency value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.dailySalesRevenuenumberoptional
average daily sales
Example: null

Any of option 2

NameTypeRequiredDescription
data.dailySalesRevenuenulloptional
Daily sales revenue value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.dailySalesRevenueWithStocknumberoptional
Average daily sales in stock
Example: null

Any of option 2

NameTypeRequiredDescription
data.dailySalesRevenueWithStocknulloptional
Daily sales revenue with stock value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
data.dataSnapshotMonthnulloptional
Data snapshot month value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.deliverySchemestringoptional
Delivery plan; `FBO`=Ozon warehouse delivery, `FBS`=Seller’s own delivery
Example: null

Any of option 2

NameTypeRequiredDescription
data.deliverySchemenulloptional
Delivery scheme value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.discountintegeroptional
Discount, percentage integer 0-100
Example: null

Any of option 2

NameTypeRequiredDescription
data.discountnulloptional
Discount value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.failedCountintegeroptional
Number of failed SKUs (usually 0 or 1)
Example: null

Any of option 2

NameTypeRequiredDescription
data.failedCountnulloptional
Failed count value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.failuresarrayoptional
Detailed list of failed SKUs (usually up to 1 item, each containing the failed `productId` and error message)
Example: null

Any of option 2

NameTypeRequiredDescription
data.failuresnulloptional
Failures value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.firstDatestringoptional
Release date (`yyyy-MM-dd`)
Example: null

Any of option 2

NameTypeRequiredDescription
data.firstDatenulloptional
First date value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.imageCountintegeroptional
Total number of pictures
Example: null

Any of option 2

NameTypeRequiredDescription
data.imageCountnulloptional
Image count value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.imageUrlstringoptional
Main image URL (first large image)
Example: null

Any of option 2

NameTypeRequiredDescription
data.imageUrlnulloptional
Image url value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.lostProfitnumberoptional
Lost sales (caused by stockouts, etc.)
Example: null

Any of option 2

NameTypeRequiredDescription
data.lostProfitnulloptional
Lost profit value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.lostProfitPercentnumberoptional
Proportion of lost sales (%)
Example: null

Any of option 2

NameTypeRequiredDescription
data.lostProfitPercentnulloptional
Lost profit percent value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.monthlySalesRevenuenumberoptional
Sales during the statistical period
Example: null

Any of option 2

NameTypeRequiredDescription
data.monthlySalesRevenuenulloptional
Monthly sales revenue value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.monthlySalesUnitsintegeroptional
Sales volume during the statistical period (pieces)
Example: null

Any of option 2

NameTypeRequiredDescription
data.monthlySalesUnitsnulloptional
Monthly sales units value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.nicheIdintegeroptional
Track ID
Example: null

Any of option 2

NameTypeRequiredDescription
data.nicheIdnulloptional
Niche id value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.nicheNamestringoptional
Track path (Russian, `/` delimited)
Example: null

Any of option 2

NameTypeRequiredDescription
data.nicheNamenulloptional
Niche name value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.notestringoptional
Remarks
Example: null

Any of option 2

NameTypeRequiredDescription
data.notenulloptional
Note value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.oldPricenumberoptional
Original price before discount
Example: null

Any of option 2

NameTypeRequiredDescription
data.oldPricenulloptional
Old price value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.ozonCardPricenumberoptional
Ozon Card price (bank card discount price)
Example: null

Any of option 2

NameTypeRequiredDescription
data.ozonCardPricenulloptional
Ozon card price value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.pageintegeroptional
Current page returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
data.pagenulloptional
Page value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
data.pageItemCountnulloptional
Page item count value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.pageSizeintegeroptional
Page size returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
data.pageSizenulloptional
Page size value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.previousRevenuenumberoptional
Last period sales
Example: null

Any of option 2

NameTypeRequiredDescription
data.previousRevenuenulloptional
Previous revenue value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.previousSalesUnitsintegeroptional
Sales volume in the previous period (the previous period with the same length as this statistical period)
Example: null

Any of option 2

NameTypeRequiredDescription
data.previousSalesUnitsnulloptional
Previous sales units value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.pricenumberoptional
Current selling price
Example: null

Any of option 2

NameTypeRequiredDescription
data.pricenulloptional
Price value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.productIdintegeroptional
SKU ID
Example: null

Any of option 2

NameTypeRequiredDescription
data.productIdnulloptional
Product id value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.productImageUrlsstringoptional
Other large image URLs except the main image
Example: null

Any of option 2

NameTypeRequiredDescription
data.productImageUrlsnulloptional
Product image urls value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.productPageUrlstringoptional
Product page URL
Example: null

Any of option 2

NameTypeRequiredDescription
data.productPageUrlnulloptional
Product page url value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.productsarrayoptional
Product card list
Example: null

Any of option 2

NameTypeRequiredDescription
data.productsnulloptional
Products value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.ratingnumberoptional
Rating, 0-5
Example: null

Any of option 2

NameTypeRequiredDescription
data.ratingnulloptional
Rating value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.revenuePotentialnumberoptional
Potential sales (estimated based on inventory for the entire period)
Example: null

Any of option 2

NameTypeRequiredDescription
data.revenuePotentialnulloptional
Revenue potential value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.reviewCountintegeroptional
Number of comments
Example: null

Any of option 2

NameTypeRequiredDescription
data.reviewCountnulloptional
Review count value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.salesPerDaynumberoptional
Average daily sales volume (pieces/day)
Example: null

Any of option 2

NameTypeRequiredDescription
data.salesPerDaynulloptional
Sales per day value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.salesPerDayWithStocknumberoptional
Average daily sales volume in stock (only counting days in stock)
Example: null

Any of option 2

NameTypeRequiredDescription
data.salesPerDayWithStocknulloptional
Sales per day with stock value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.sellerIdintegeroptional
Seller ID
Example: null

Any of option 2

NameTypeRequiredDescription
data.sellerIdnulloptional
Seller id value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.sellerIsBestSellerbooleanoptional
Is the seller a best-selling seller?
Example: null

Any of option 2

NameTypeRequiredDescription
data.sellerIsBestSellernulloptional
Seller is best seller value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.sellerNamestringoptional
Seller name
Example: null

Any of option 2

NameTypeRequiredDescription
data.sellerNamenulloptional
Seller name value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.sourceToolstringoptional
Provider-specific source tool name.
Example: null

Any of option 2

NameTypeRequiredDescription
data.sourceToolnulloptional
Source tool value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.sourceTypestringoptional
Provider-specific source platform type.
Example: null

Any of option 2

NameTypeRequiredDescription
data.sourceTypenulloptional
Source type value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.successCountintegeroptional
The SKU number of the card returned successfully (usually 0 or 1)
Example: null

Any of option 2

NameTypeRequiredDescription
data.successCountnulloptional
Success count value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.titlestringoptional
Product name (Russian)
Example: null

Any of option 2

NameTypeRequiredDescription
data.titlenulloptional
Title value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.totalintegeroptional
Number of SKUs returned (usually 0 or 1, equal to `successCount + failedCount`)
Example: null

Any of option 2

NameTypeRequiredDescription
data.totalnulloptional
Total value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.totalPageintegeroptional
Total page count returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
data.totalPagenulloptional
Total page value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.typestringoptional
response type
Example: null

Any of option 2

NameTypeRequiredDescription
data.typenulloptional
Type value used by this API operation.

Any of option 1

NameTypeRequiredDescription
data.updatedstringoptional
Data update time (`yyyy-MM-dd HH:mm:ss`)
Example: null

Any of option 2

NameTypeRequiredDescription
data.updatednulloptional
Updated value used by this API operation.

Any of option 2

NameTypeRequiredDescription
datanullrequired
Data value used by this API operation.

Responses

CodeDescription
200Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result.
429Execution admission rate limit; honor Retry-After when present.
503Execution admission is temporarily unavailable; honor Retry-After when present.
Opt-inX-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.

Step 1 of 2 · Connect your MCP client

MCP

V2 recommended

Connect remote agents through the standard MCP 2025-11-25 Streamable HTTP endpoint. Use OAuth 2.1 Authorization Code with PKCE, or an API key for compatibility.

POST https://api.nexscope.ai/mcp
MCP-Protocol-Version: 2025-11-25
Content-Type: application/json
Authentication

OAuth clients request the mcp:tools scope. The endpoint's 401 response advertises protected-resource metadata for authorization discovery.

Step 2 of 2 · Call the tool

Call a tool

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_ozon_product_detail",
    "arguments": {
      "endDate": "2025-03-31",
      "includeFbs": false,
      "productId": 1786874757,
      "startDate": "2025-03-01"
    }
  }
}

Legacy MCP v1

Existing API-key clients can continue using the compatibility endpoint. New integrations should use MCP v2.

GET / POST /mcp/legacy

Online test

Execute the current API with your API key and JSON payload. Online tests use this site's configured API environment; the Endpoint and copyable examples use the public integration address.

17 credits / callAPI usage records

Try it

Send a real request with the same contract shown in the reference.

Endpoint
/mp/ozon/productDetail
MCP method
nexscope_ozon_product_detail
cURL
curl -X POST \
  https://api.nexscope.ai/mp/ozon/productDetail \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "endDate": "2025-03-31", "includeFbs": true, "productId": 1786874757, "startDate": "2025-03-01" }'
Response
No response yet. Run the request to see the response here.

Related APIs