Ozon Intelligence SR

Ozon Category Search

Analyze products in an Ozon category by category ID. Call the Ozon Category Search API via REST or MCP from 17 credits per call.

MCP tool name

nexscope_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": "ozon-category-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_ozon_category_search",
    "arguments": {
      "categoryId": "15621042_17028650_97011",
      "date": "2026-01",
      "page": {
        "page": 1,
        "pageSize": 10
      }
    }
  }
}

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 Ozon category documentation or other Nexscope Ozon tools. Format like 15621032_15621049_115951147 (multi-level categories joined by _) Example: 15621042_17028650_97011
`page`	`object`	required	Pagination & sorting: {page, pageSize, orders[]} Example: { "page": 1, "pageSize": 10 }
`page.page`	`integer`	optional	Page number, starting from 1, default 1 Example: 1
`page.pageSize`	`integer`	optional	Items per page, default 20, maximum 20 (exceeding returns errcode 1002) Example: 1
`page.orders`	`array`	optional	Sort rules, elements {field, direction} (both required); direction takes DESC (descending) / ASC (ascending). Common sort fields: sales, price, revenue, reviewRating Example: []
`date`	`string`	optional	Query historical month, format yyyy-MM (e.g., 2026-02); defaults to last 30 days if omitted Example: 2026-01
`fulfillment`	`string`	optional	Fulfillment method filter, fixed options: FBO, FBS, RFBS, FBP, OZON; queries all if omitted. Note: single string, not an array Example: {}
`uId`	`string`	optional	User ID (max 1000) Example: example-id
`memberId`	`string`	optional	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.

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": "15621042_17028650_97011",
  "date": "2026-01",
  "page": {
    "page": 1,
    "pageSize": 10
  }
}

Example structuredContent

{}