Ozon Marketplace

Ozon Product Report Search

Nexscope Ozon product report search: filters Ozon products by multi-dimensional metrics including sales, revenue, sales/revenue growth rate, cart conversion rate, order conversion rate, price, rating, review count, QA count, variant count, page views, gross margin, return/cancellation rate, ad spend share, weight/volume, listing time, brand, seller, fulfillment method, and labels. Returns each product's SKU, title, price (RUB), sales, revenue, lost revenue, conversion rate, rating, reviews, brand, seller, fulfillment method, listing days/months, and complete product report fields. Use for Ozon product selection, competitor product analysis, best-seller mining, price/conversion band filtering. Trigger when the user mentions Ozon product report, Ozon product selection, Ozon product filtering, Ozon product analysis, Ozon best-selling products, Ozon competitor product analysis, Ozon product report, Ozon product screener, filter Ozon products by sales, Ozon best-seller mining, Nexscope Ozon product report. Also trigger when the intent is to filter Ozon products by multiple metrics and view product-level reports, even without explicitly mentioning Nexscope.

post/api/skill-api/v1/skills/ozon-product-report-search/run

Request

  • Base URL: https://api.nexscope.ai
  • URL: https://api.nexscope.ai/api/skill-api/v1/skills/ozon-product-report-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

pageobject required

Nonempty pagination and sorting object: {page, pageSize, orders[]}. Omitted nested defaults are not inserted. Ranges accept optional finite bounds and require min <= max; numeric strings and optional null remain backend compatibility extensions.

page.pageinteger

Page number, starting from 1, default 1

page.pageSizeinteger

Items per page, default 20

brandobject

Brand filter: {brandName: array<string>, type: integer}; type takes 0 include brand, 1 exclude brand, 2 unbranded

creationDateinteger

Listing time filter (months), fixed options: 1 last 30 days, 3 last 90 days, 6 last 180 days, 12 last year, 24 last two years; no filtering if omitted

variationsMergeinteger

Whether to merge variants: 0 do not merge, 1 merge

searchDatestring

Query date yyyy-MM-dd (e.g., 2026-04-01); defaults to last 30 days if omitted; passing 2026-04-01 queries March 2026 data

tagstring

Tag word

uIdstring

User ID

memberIdstring

Member ID (a unique member identifier; data is attributed to memberId)

monthlySalesobject

Monthly sales range: {min, max}; either bound may be omitted

monthlySalesRateobject

Sales growth-rate range: {min, max}; either bound may be omitted

monthlyRevenueobject

Monthly revenue range in RUB: {min, max}; either bound may be omitted

priceobject

Price range in RUB: {min, max}; either bound may be omitted

convToCartPdpobject

Cart conversion-rate range: {min, max}; either bound may be omitted

reviewRatingobject

Rating range from 0 to 5: {min, max}; either bound may be omitted

reviewCountobject

Review-count range: {min, max}; either bound may be omitted

questionsAndAnswersobject

Question-and-answer count range: {min, max}; either bound may be omitted

variantsobject

Variant-count range: {min, max}; either bound may be omitted

drrobject

Advertising cost-share range: {min, max}; either bound may be omitted

grossMarginobject

Gross-margin range: {min, max}; either bound may be omitted

returnCancellationRateobject

Return and cancellation-rate range: {min, max}; either bound may be omitted

weightobject

Weight range in grams: {min, max}; either bound may be omitted

volumeobject

Volume range in liters: {min, max}; either bound may be omitted

Example request

{
  "page": {
    "page": 1,
    "pageSize": 10
  },
  "page.page": 1,
  "page.pageSize": 20,
  "page.orders": [
    {
      "direction": "DESC",
      "field": "sales"
    }
  ],
  "skus": [
    "1664362124"
  ],
  "keywords": [],
  "categoryIds": [],
  "sellerName": [],
  "brand": {},
  "fulfillment": [],
  "labels": [
    2
  ],
  "creationDate": 1,
  "variationsMerge": 1,
  "searchDate": "2026-01-01",
  "uId": "example-id",
  "memberId": "example-id",
  "monthlySales": {
    "min": 5000
  },
  "monthlySalesRate": {
    "min": 10
  },
  "monthlyRevenue": {
    "min": 100000
  },
  "price": {
    "max": 500
  },
  "convToCartPdp": {
    "min": 20
  },
  "reviewRating": {
    "min": 4
  },
  "reviewCount": {
    "min": 100
  },
  "questionsAndAnswers": {
    "min": 1
  },
  "variants": {
    "min": 1
  },
  "drr": {
    "max": 20
  },
  "grossMargin": {
    "min": 10
  },
  "returnCancellationRate": {
    "max": 10
  },
  "weight": {
    "max": 1000
  },
  "volume": {
    "max": 10
  }
}

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": {
    "total": 1,
    "data": [],
    "products": [],
    "costTime": 1,
    "costToken": 1
  }
}

Changes

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