Ozon Intelligence SR

Ozon Intelligence SR: ozon/category Search API

Ozon Intelligence SR: ozon/category Search API.

MCP tool name

nexscope_data_sr_ozon_category_search

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "data-sr-ozon-category-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_data_sr_ozon_category_search",
    "arguments": {
      "categoryId": "15621032_15621049_115951147",
      "page": {
        "orders": [
          {
            "direction": "DESC",
            "field": "sales"
          }
        ],
        "page": 1,
        "pageSize": 5
      }
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`categoryId`	`string`	required	Ozon category ID, obtained from the Ozon category document or other SR Ozon tools; multi-level categories are connected with `_`. Example: {}
`page`	`object`	required	Paging and sorting: `{page, pageSize, orders[]}`. Example: {}
`page.page`	`integer`	optional	Page number, starting from 1. Example: 1
`page.pageSize`	`integer`	optional	The maximum number of items per page is 20. If exceeded, `errcode 1002` will be returned. Example: 20
`page.orders`	`array`	optional	Sorting rule, the element is `{field, direction}`; `direction` takes `DESC` or `ASC`. Commonly used fields: `sales`, `price`, `revenue`, `reviewRating`. Example: {}
`date`	`string`	optional	Historical month, format `yyyy-MM`, such as `2026-02`. Example: {}
`fulfillment`	`string`	optional	Delivery method: `FBO`, `FBS`, `RFBS`, `FBP`, `OZON`; do not query all, it must be a single string instead of an array. Example: {}
`uId`	`string`	optional	User ID, up to 1000. Example: {}
`memberId`	`string`	optional	Member ID; a member's unique identifier, the data belongs to this member, the maximum number is 1000. Example: {}

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`code`	`string`	optional	Return code, `"200"` indicates success; returned when successful. Example: {}
`errcode`	`integer`	optional	Error code, `200` indicates success; only this field may be returned when there is a business error. Example: {}
`msg`	`string`	optional	Message; Success was `ok`. Example: {}
`errmsg`	`string`	optional	Error message; success is `ok`, business error is a reason description. Example: {}
`id`	`string`	optional	The category ID to be echoed. Example: {}
`total`	`integer`	optional	The number of records returned on this page is equal to the number of `data` items on the current page, not the total number of products in the category. Example: {}
`totalSales`	`integer`	optional	The total sales volume of the category within the statistical interval. Example: {}
`totalRevenue`	`number`	optional	Total category sales in rubles. Example: {}
`avgPrice`	`number`	optional	Average price of products in the category, in rubles. Example: {}
`rating`	`number`	optional	Average rating of category products. Example: {}
`seasonalityAmplitude`	`string`	optional	Seasonal strength, such as `STRONG_SEASONALITY`. Example: {}
`seasonalityCoef`	`string`	optional	Seasonal phases such as `OFF_SEASON`. Example: {}
`startDate`	`string`	optional	Statistics start date. Example: {}
`endDate`	`string`	optional	Statistics end date. Example: {}
`sellerType`	`object`	optional	The distribution of delivery methods, not the seller’s local/cross-border type; the key is the delivery method and the value is the number of products. Example: {}
`categoryInfo`	`object`	optional	Category meta information, the structure is shown in the `categoryInfo` table below. Example: {}
`data`	`array`	optional	Category product list, element fields are shown in the product object table below. Example: {}
`products`	`array`	optional	Category product list, content is exactly the same as `data`. Example: {}
`hasNextPage`	`boolean`	optional	Is there a next page? Example: {}
`columns`	`array`	optional	Column definition, elements containing `field`, `title`, `cellType`, `sortable`, `filterable`. Example: {}
`type`	`string`	optional	Responsive display type. Example: {}
`costTime`	`integer`	optional	The interface consumes time in milliseconds. Example: {}
`costToken`	`integer`	optional	The number of tokens consumed. Example: {}
`sku`	`integer`	optional	Product SKU. Example: {}
`productId`	`integer`	optional	Unified product ID, mapped from `sku`. Example: {}
`title`	`string`	optional	Product title. Example: {}
`price`	`number`	optional	Commodity price in rubles. Example: {}
`currency`	`string`	optional	Currency, fixed to `₽`. Example: {}
`sales`	`integer`	optional	Product sales. Example: {}
`monthlySalesUnits`	`integer`	optional	Unified monthly sales, mapped from `sales`. Example: {}
`revenue`	`number`	optional	Sales volume of goods in rubles. Example: {}
`monthlySalesRevenue`	`number`	optional	Unified monthly sales, mapped from `revenue`. Example: {}
`reviewRating`	`number`	optional	Product ratings. Example: {}
`rating`	`number`	optional	Unified scoring, mapped from `reviewRating`. Example: {}
`reviewCount`	`integer`	optional	Number of comments. Example: {}
`brandName`	`string`	optional	Brand name. Example: {}
`brand`	`string`	optional	Unified brand, mapped from `brandName`. Example: {}
`sellerName`	`string`	optional	Seller name. Example: {}
`fulfillment`	`array`	optional	Product shipping method, such as `["FBO"]`, may contain multiple values. Example: {}
`imageUrl`	`string`	optional	Product image link. Example: {}
`productUrl`	`string`	optional	Product link. Example: {}
`productPageUrl`	`string`	optional	Unified product page URL, mapped from `productUrl`. Example: {}
`categoryInfo`	`object`	optional	Product category attribution information, the structure is shown in the `categoryInfo` table below. Example: {}
`sourceType`	`string`	optional	Data source, fixed to `ozon`. Example: {}
`cnTitlePath`	`string`	optional	Chinese category path. Example: {}
`enTitlePath`	`string`	optional	English category path. Example: {}
`titlePath`	`string`	optional	Russian (frontend) category path. Example: {}
`fullCategoryId`	`array`	optional	Array of category IDs at all levels. Example: {}
`category`	`object`	optional	The bottom-level category object contains fields such as title, level, cross-border sales, parent, deactivation status, and ID. Example: {}

Examples

Example arguments

{
  "categoryId": "15621032_15621049_115951147",
  "page": {
    "orders": [
      {
        "direction": "DESC",
        "field": "sales"
      }
    ],
    "page": 1,
    "pageSize": 5
  }
}

Example structuredContent

{
  "code": 0,
  "cost": "-1",
  "data": {},
  "msg": null,
  "time": "2026-01-01 00:00:00",
  "traceId": null,
  "ts": "0"
}