Nexscope
Start free

Ozon Marketplace

Ozon Product Detail Search MCP Tool

Seerfar Ozon product detail query: fetches the complete detail of a single Ozon product by SKU, returning title, price (RUB), rating, review count, QA count, total and daily average sales within the stats window, revenue, stock, category ranking, daily sales trend, brand, seller, fulfillment method (FBO/FBS/OZON), weight, and listing time/days/months. Use for single product deep analysis, competitor product teardown, Ozon product selection assessment, listing diagnosis, sales trend and category ranking tracking. Also

MCP tool name
nexscope_ozon_product_detail_search
Legacy MCP endpoint
/api/skill-api/v1/mcp
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-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_ozon_product_detail_search",
    "arguments": {
      "sku": "1664362124",
      "dateRange": "past_30_days"
    }
  }
}
Legacy endpoint
POST /api/skill-api/v1/mcp
Canonical detail URL
https://www.nexscope.ai/mcp-map/ozon-product-detail-search

Arguments

NameTypeRequiredMeaning
skustringrequired
Product SKU (Ozon SKU, e.g., 175924376). This is the sku returned by other Seerfar Ozon tools
Example: 1664362124
dateRangestringoptional
Sales/metrics statistics window, default past_30_days. Options: past_7_days / past_30_days / past_60_days / past_90_days / past_180_days / past_365_days
Example: past_30_days
uIdstringoptional
User ID (max 1000)
Example: example-id
memberIdstringoptional
Member ID (a unique member identifier; a user can belong to multiple teams; data is attributed to memberId, max 1000)
Example: example-id

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.totalintegeroptional
Number of records returned (1 on hit, 0 on miss)
Example: 1
data.totalSalesintegeroptional
Total sales volume within the statistics window
Example: 1
data.dailySalesnumberoptional
Average daily sales (approx totalSales / window days)
Example: 1
data.totalRevenuenumberoptional
Sales revenue within the statistics window (RUB)
Example: 1
data.stockintegeroptional
Stock
Example: 1
data.startDatestringoptional
Statistics window start date (e.g., 2026-06-01)
Example: 2026-01-01
data.endDatestringoptional
Statistics window end date (e.g., 2026-06-30)
Example: 2026-01-01
data.salesTrendVOListarrayoptional
Daily sales data series (see below)
Example: []
data.categoryRanksarrayoptional
Product category ranking history (see below)
Example: []
data.productsarrayoptional
Product detail list (1 record on single SKU hit, empty on miss)
Example: []
data.dataarrayoptional
Returned data, content identical to products
Example: []
data.columnsarrayoptional
Column definitions, elements contain {field, title, cellType, sortable, filterable}
Example: []
data.typestringoptional
Response display type, e.g., productWorkbenches
Example: null
data.costTimeintegeroptional
API latency (milliseconds)
Example: 1
data.costTokenintegeroptional
Tokens consumed
Example: 1
data.products[].skuintegeroptional
Product SKU
Example: 1
data.products[].productIdintegeroptional
Unified product ID, mapped from sku
Example: 1
data.products[].titlestringoptional
Product title
Example: null
data.products[].pricenumberoptional
Product price (RUB)
Example: 1
data.products[].currencystringoptional
Currency, always ₽
Example: null
data.products[].reviewRatingnumberoptional
Product rating
Example: 1
data.products[].ratingnumberoptional
Unified rating, mapped from reviewRating
Example: 1
data.products[].reviewCountintegeroptional
Number of reviews
Example: 1
data.products[].questionsAndAnswersintegeroptional
QA count
Example: 1
data.products[].brandNamestringoptional
Brand name
Example: null
data.products[].brandstringoptional
Unified brand, mapped from brandName
Example: null
data.products[].brandIdintegeroptional
Brand ID
Example: 1
data.products[].brandUrlstringoptional
Brand link
Example: https://example.com/image.jpg
data.products[].sellerNamestringoptional
Seller name
Example: null
data.products[].sellerIdintegeroptional
Seller ID (negative values indicate Ozon platform self-operated sellers, e.g., -4 Ozon Россия)
Example: 1
data.products[].fulfillmentarrayoptional
Product fulfillment methods, e.g., ["FBO"], ["OZON"], may contain multiple values
Example: []
data.products[].upTimeintegeroptional
Listing time, millisecond timestamp
Example: 1
data.products[].upDaysintegeroptional
Days since listing
Example: 1
data.products[].upMonthsintegeroptional
Months since listing
Example: 1
data.products[].imageUrlstringoptional
Unified main image URL, mapped from the first of imageUrls
Example: https://example.com/image.jpg
data.products[].imageUrlsarrayoptional
List of product image URLs
Example: []
data.products[].productUrlstringoptional
Product URL
Example: https://example.com/image.jpg
data.products[].productPageUrlstringoptional
Unified product page URL, mapped from productUrl
Example: https://example.com/image.jpg
data.products[].categoryInfoobjectoptional
Product category information (see below)
Example: {}
data.products[].monthlySalesUnitsintegeroptional
Unified monthly sales, actual value equals totalSales of the current statistics window
Example: 1
data.products[].monthlySalesRevenuenumberoptional
Unified monthly revenue, actual value equals totalRevenue of the current statistics window
Example: 1
data.products[].sourceTypestringoptional
Data source, always ozon
Example: null
data.products[].sourceToolstringoptional
Source tool identifier for the Ozon competitor-detail endpoint
Example: null
data.products[].weightnumberoptional
Product weight, in grams (digital/service products may not return this, see field differences)
Example: 1
data.products[].grossMarginnumberoptional
Gross margin (defined in schema, some products may not return this in practice, see field differences)
Example: 1
data.salestrendvolist[].datestringoptional
Date (e.g., 2026-06-01)
Example: 2026-01-01
data.salestrendvolist[].salesintegeroptional
Daily sales (may be 0)
Example: 1
data.salestrendvolist[].revenuenumberoptional
Daily revenue (RUB)
Example: 1
data.salestrendvolist[].pricenumberoptional
Daily price (RUB)
Example: 1
data.salestrendvolist[].stockintegeroptional
Daily stock
Example: 1
data.salestrendvolist[].reviewCountintegeroptional
Cumulative review count as of this date
Example: 1
data.salestrendvolist[].reviewRatingnumberoptional
Rating as of this date
Example: 1
data.categoryranks[].datestringoptional
Month (e.g., 2026-02; current month shows as specific date 2026-07-01)
Example: 2026-01-01
data.categoryranks[].rankintegeroptional
Category ranking
Example: 1
data.categoryranks[].countintegeroptional
Statistics count (subject to actual gateway interpretation)
Example: 1
data.columns[].cnTitlePathstringoptional
Chinese category path
Example: null
data.columns[].enTitlePathstringoptional
English category path
Example: null
data.columns[].titlePathstringoptional
Category path (original text)
Example: null
data.columns[].categoryobjectoptional
Terminal category object (fields see below)
Example: {}
data.columns[].fullCategoryIdarrayoptional
Full category ID path (string array, root to terminal, e.g., ["99999999", "99999999_200001489", "99999999_200001489_970727001"])
Example: []
data.columns[].cnTitlestringoptional
Category Chinese name
Example: null
data.columns[].enTitlestringoptional
Category English name
Example: null
data.columns[].titlestringoptional
Category original title
Example: null
data.columns[].levelintegeroptional
Category level
Example: 1
data.columns[].idstringoptional
Category ID
Example: example-id
data.columns[].pidstringoptional
Parent category ID
Example: example-id
data.columns[].crossBorderSellablebooleanoptional
Whether cross-border sales are supported
Example: false
data.columns[].disabledbooleanoptional
Whether disabled
Example: false
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

{
  "sku": "1664362124",
  "dateRange": "past_30_days"
}

Example structuredContent

{
  "data": {
    "total": 1,
    "totalSales": 1,
    "dailySales": 1,
    "totalRevenue": 1,
    "stock": 1,
    "startDate": "2026-01-01",
    "endDate": "2026-01-01",
    "salesTrendVOList": [],
    "categoryRanks": [],
    "products": [
      {
        "sku": 1,
        "productId": 1,
        "price": 1,
        "reviewRating": 1,
        "rating": 1,
        "reviewCount": 1,
        "questionsAndAnswers": 1,
        "brandId": 1,
        "brandUrl": "https://example.com/image.jpg",
        "sellerId": 1,
        "fulfillment": [],
        "upTime": 1,
        "upDays": 1,
        "upMonths": 1,
        "imageUrl": "https://example.com/image.jpg",
        "imageUrls": [],
        "productUrl": "https://example.com/image.jpg",
        "productPageUrl": "https://example.com/image.jpg",
        "categoryInfo": {},
        "monthlySalesUnits": 1,
        "monthlySalesRevenue": 1,
        "weight": 1,
        "grossMargin": 1
      }
    ],
    "data": [],
    "columns": [
      {
        "category": {},
        "fullCategoryId": [],
        "level": 1,
        "id": "example-id",
        "pid": "example-id",
        "crossBorderSellable": false,
        "disabled": false
      }
    ],
    "costTime": 1,
    "costToken": 1,
    "salestrendvolist": [
      {
        "date": "2026-01-01",
        "sales": 1,
        "revenue": 1,
        "price": 1,
        "stock": 1,
        "reviewCount": 1,
        "reviewRating": 1
      }
    ],
    "categoryranks": [
      {
        "date": "2026-01-01",
        "rank": 1,
        "count": 1
      }
    ]
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}