Ozon Marketplace

Ozon Category Search

Nexscope Ozon category product search: fetches the product list for a given Ozon category ID, returning category-level aggregates (total sales, total revenue, average price, average rating, seasonality) and per-product sales, price, rating, review count, brand, seller, and fulfillment method. Use for category selection analysis, category bestseller mining, category capacity and price band analysis, seasonality assessment. Trigger when the user mentions Ozon category products, Ozon category analysis, Ozon category selection, Ozon category bestsellers, Ozon category total sales, Ozon category average price, Ozon category search, Ozon category products, category best-sellers, category analysis. Also trigger when the intent is to view products and category-level summary data within an Ozon category, even without explicitly mentioning Nexscope.

post/api/skill-api/v1/skills/ozon-category-search/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/ozon-category-search/run
  • Auth: HTTP bearer

Headers

X-Nexscope-Http-Status'legacy' | 'semantic'

Use semantic for HTTP error statuses on run and task-result requests. Without this header v1 retains legacy status behavior. The JSON envelope is unchanged; code 0 means success or acceptance, not asynchronous completion.

Request body

categoryIdstring required

Ozon category ID, obtained from Ozon category documentation or other Nexscope Ozon tools. Format like 15621032_15621049_115951147 (multi-level categories joined by _)

datestring

Query historical month, format yyyy-MM (e.g., 2026-02); defaults to last 30 days if omitted

fulfillmentstring

Fulfillment method filter, fixed options: FBO, FBS, RFBS, FBP, OZON; queries all if omitted. Note: single string, not an array

uIdstring

User ID (max 1000)

memberIdstring

Member ID (a unique member identifier; a user can belong to multiple teams; data is attributed to memberId, max 1000)

Example request

{
  "page": {
    "page": 1,
    "pageSize": 10
  },
  "categoryId": "15621042_17028650_97011",
  "date": "2026-01"
}

Response

Successful response.

codeinteger required

0 means accepted or successful; nonzero is a platform error.

msgstring nullable required
tsstring required

Epoch milliseconds.

timestring required

Server local time: yyyy-MM-dd HH:mm:ss.

coststring required

Elapsed milliseconds, never credits; -1 outside web requests.

traceIdstring nullable required

Example response

{
  "data": {
    "id": "example-id",
    "total": 1,
    "totalSales": 1,
    "totalRevenue": 1,
    "avgPrice": 1,
    "rating": 1,
    "startDate": "2026-01-01",
    "endDate": "2026-01-01",
    "sellerType": {},
    "categoryInfo": {},
    "data": [],
    "products": [],
    "costTime": 1,
    "costToken": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.