Nexscope
Start free

Ozon Marketplace

Ozon Product Detail MCP Tool

MPSTATS Ozon Russia SKU full detail query for one product ID per call, returning price, discount, Ozon Card price, rating, review count, stock, sales, revenue, revenue potential/lost revenue, listing date, images, and the complete product card.

MCP tool name
nexscope_ozon_product_detail
Equivalent REST API path
https://api.nexscope.ai/api/skill-api/v1/skills/ozon-product-detail/run
JSON-RPC method
tools/call

Authentication

Send the user API key as a bearer token on every MCP JSON-RPC request.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication is missing or invalid, ask the user to open API Access and copy a valid key before calling this tool.

Call this MCP tool

Use tools/call with the MCP tool name below. The arguments object should match the table on this page.

{
  "jsonrpc": "2.0",
  "id": "ozon-product-detail-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_ozon_product_detail",
    "arguments": {
      "startDate": "2025-03-01",
      "productIds": [
        1786874757
      ],
      "endDate": "2025-03-31",
      "includeFbs": false
    }
  }
}
REST API equivalent
POST https://api.nexscope.ai/api/skill-api/v1/skills/ozon-product-detail/run
Canonical detail URL
https://www.nexscope.ai/mcp-map/ozon-product-detail

Arguments

NameTypeRequiredMeaning
productIdsarrayrequired
Exactly one Ozon product ID (integer or string); multiple IDs are currently unsupported
Example: [ 1786874757 ]
startDatestringoptional
Statistics start date, format YYYY-MM-DD; latest is yesterday
Example: 2025-03-01
endDatestringoptional
Statistics end date, format YYYY-MM-DD; latest is yesterday
Example: 2025-03-31
includeFbsbooleanoptional
Whether to include FBS data for the requested SKU
Example: false

Response fields

Treat structuredContent as the programmatic API response payload.

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

Any of option 1

NameTypeRequiredDescription
dataobjectrequired
Data value used by this API operation.
data.products[].msg/errmsgstringoptional
Message; ok for success
Example: null
data.totalintegeroptional
Number of SKUs returned (= successCount + failedCount)
Example: 1
data.successCountintegeroptional
Number of SKUs for which cards were successfully returned
Example: 1
data.failedCountintegeroptional
Number of SKUs that failed
Example: 0
data.failuresarrayoptional
List of failed SKU details (each item contains the failed productId and error info)
Example: []
data.productsarrayoptional
Product card list (see details below)
Example: []
data.columnsarrayoptional
Rendered column definitions
Example: []
data.costTimeintegeroptional
API latency (milliseconds)
Example: 1
data.costTokenintegeroptional
Tokens consumed
Example: 1
data.typestringoptional
Response type
Example: null
data.products[].productIdintegeroptional
SKU ID
Example: 1786874757
data.products[].titlestringoptional
Product name (Russian)
Example: null
data.products[].brandstringoptional
Brand
Example: null
data.products[].sellerNamestringoptional
Seller name
Example: null
data.products[].sellerIdintegeroptional
Seller ID
Example: 1
data.products[].sellerIsBestSellerbooleanoptional
Whether the seller is a best seller
Example: false
data.products[].nicheNamestringoptional
Niche path (Russian, / separated)
Example: null
data.products[].nicheIdintegeroptional
Niche ID
Example: 1
data.products[].firstDatestringoptional
Listing date (yyyy-MM-dd)
Example: 2025-03-01
data.products[].updatedstringoptional
Data update time (yyyy-MM-dd HH:mm:ss)
Example: 2025-03-31 12:00:00
data.products[].notestringoptional
Notes
Example: null
data.products[].sourceTool/sourceTypestringoptional
Source tool / data source identifier
Example: null
data.products[].imageUrlstringoptional
Main image URL (first large image)
Example: https://example.com/image.jpg
data.products[].imageCountintegeroptional
Total image count
Example: 1
data.products[].productImageUrlsarrayoptional
Remaining large image URLs besides the main image
Example: []
data.products[].productPageUrlstringoptional
Product page URL
Example: https://example.com/image.jpg
data.products[].pricenumberoptional
Current selling price
Example: 1
data.products[].oldPricenumberoptional
Original price before discount
Example: 1
data.products[].ozonCardPricenumberoptional
Ozon Card price (bank card discount price)
Example: 1
data.products[].discountintegeroptional
Discount, integer percentage 0-100
Example: 1
data.products[].currencystringoptional
Currency symbol (₽ / $ / €)
Example: null
data.products[].ratingnumberoptional
Rating, 0-5
Example: 1
data.products[].reviewCountintegeroptional
Number of reviews
Example: 1
data.products[].balanceintegeroptional
Current stock (units)
Example: 1
data.products[].deliverySchemestringoptional
Delivery scheme; FBO = Ozon fulfillment, FBS = seller self-delivery
Example: null
data.products[].salesPerDaynumberoptional
Average daily sales (units/day)
Example: 1
data.products[].salesPerDayWithStocknumberoptional
Average daily sales counting only days with stock
Example: 1
data.products[].dailySalesRevenuenumberoptional
Average daily sales revenue
Example: 1
data.products[].dailySalesRevenueWithStocknumberoptional
Average daily sales revenue counting only days with stock
Example: 1
data.products[].monthlySalesUnitsintegeroptional
Sales volume during the statistics period (units)
Example: 1
data.products[].monthlySalesRevenuenumberoptional
Sales revenue during the statistics period
Example: 1
data.products[].previousSalesUnitsintegeroptional
Prior period sales volume (the same-length period before the current statistics period)
Example: 1
data.products[].previousRevenuenumberoptional
Prior period sales revenue
Example: 1
data.products[].revenuePotentialnumberoptional
Potential revenue (estimated based on full-period stock availability)
Example: 1
data.products[].lostProfitnumberoptional
Lost revenue (due to stockouts, etc.)
Example: 1
data.products[].lostProfitPercentnumberoptional
Lost revenue percentage (%)
Example: 1
data.titlestringoptional
Provider-specific response title.
Example: null
data.sourceTypestringoptional
Provider-specific source platform type.
Example: null
data.sourceToolstringoptional
Provider-specific source tool name.
Example: null
data.pageintegeroptional
Current page returned by the upstream provider.
Example: null
data.pageSizeintegeroptional
Page size returned by the upstream provider.
Example: null
data.pageItemCountintegeroptional
Item count on the current page returned by the upstream provider.
Example: null
data.totalPageintegeroptional
Total page count returned by the upstream provider.
Example: null
data.dataSnapshotMonthstringoptional
Data snapshot month returned by the upstream provider.
Example: null

Any of option 2

NameTypeRequiredDescription
datanullrequired
Data value used by this API operation.

Examples

Example arguments

{
  "startDate": "2025-03-01",
  "productIds": [
    1786874757
  ],
  "endDate": "2025-03-31",
  "includeFbs": false
}

Example structuredContent

{
  "data": {
    "total": 1,
    "successCount": 1,
    "failedCount": 0,
    "failures": [],
    "products": [
      {
        "productId": 1786874757,
        "sellerId": 1,
        "sellerIsBestSeller": false,
        "nicheId": 1,
        "firstDate": "2025-03-01",
        "updated": "2025-03-31 12:00:00",
        "imageUrl": "https://example.com/image.jpg",
        "imageCount": 1,
        "productImageUrls": [],
        "productPageUrl": "https://example.com/image.jpg",
        "price": 1,
        "oldPrice": 1,
        "ozonCardPrice": 1,
        "discount": 1,
        "rating": 1,
        "reviewCount": 1,
        "balance": 1,
        "salesPerDay": 1,
        "salesPerDayWithStock": 1,
        "dailySalesRevenue": 1,
        "dailySalesRevenueWithStock": 1,
        "monthlySalesUnits": 1,
        "monthlySalesRevenue": 1,
        "previousSalesUnits": 1,
        "previousRevenue": 1,
        "revenuePotential": 1,
        "lostProfit": 1,
        "lostProfitPercent": 1
      }
    ],
    "columns": [],
    "costTime": 1,
    "costToken": 1
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}