POSThttps://api.nexscope.ai/api/skill-api/v1/skills/ozon-keyword-mining/run

Run this API

Send a JSON request to execute this API and receive the documented response payload.

Endpoint

Method	`POST`
Path	`https://api.nexscope.ai/api/skill-api/v1/skills/ozon-keyword-mining/run`
Auth	`Bearer API key`
Content-Type	`application/json`

Request parameters

Name	Type	Required	Description
`keyword`	`string`	required	Seed keyword, mining expands around this term (maxLength 1000) Example: phone case
`page`	`object`	required	Pagination & sorting: {page, pageSize, orders[]} Example: { "pageSize": 10, "page": 1 }
`page.page`	`integer`	optional	Page number, starting from 1, default 1 Example: 1
`page.pageSize`	`integer`	optional	Items per page, default 20 Example: 1
`page.orders`

Code example

{
  "matchType": 1,
  "uId": "example-id",
  "page": {
    "pageSize": 10,
    "page": 1
  },
  "includeKeywords": [],
  "keyword": "phone case",
  "excludeKeywords": []
}

Response example

Platform response envelope. code 0 indicates success or acceptance; data contains the business result.

{
  "data": {
    "total": 1,
    "data": [
      {
        "query": "phone case",
        "queryCn": "phone case",
        "platform": 1,
        "searchVolume": 1,
        "count30GrowthRate": 1,
        "productCount": 1,
        "competingProducts": 1,
        "sellers": 1,
        "avgPrice": 1,
        "itemsViews": 1,
        "viewSharing": 1,
        "conversionSharing": 1,
        "marketSpace": 1,
        "returnCancellationRate": 1,
        "uniqQueriesWCa": 1,
        "ca": 1,
        "relevancy": 1,
        "titleDensity": 1,
        "wordCount": 1,
        "categories": [],
        "categoryInfos": [
          {
            "id": "example-id",
            "crossBorderSellable": false
          }
        ],
        "products": [
          {
            "ozonId": 1,
            "sku": 1,
            "imageUrl": "https://example.com/image.jpg",
            "advert": 1
          }
        ],
        "id": "example-id"
      }
    ],
    "columns": [],
    "costTime": 1,
    "costToken": 1
  },
  "code": 0,
  "msg": null,
  "ts": "0",
  "time": "2026-01-01 00:00:00",
  "cost": "-1",
  "traceId": null
}

Response fields

Name	Type	Required	Description
`data`	`any`	required	Data value used by this API operation.
`code`	`integer`	required	0 means accepted or successful; nonzero is a platform error.
`msg`	`string \| null`	required	Msg value used by this API operation.
`ts`	`string`	required	Epoch milliseconds.
`time`	`string`	required	Server local time: yyyy-MM-dd HH:mm:ss.
`cost`

Responses

Code	Description
200	HTTP request completed. Check JSON code; only 0 indicates business success or acceptance.
400	Request JSON or required API parameters are invalid.
401	API key is missing, invalid, or cannot be matched to a user.
5xx	API execution or upstream service failed.

Data source, freshness, and limitations

Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.

Name

Type

Required

Description

data

object

required

Data value used by this API operation.

data.total

integer

optional

Total record count

Example: 1

data.data

array

optional

Keyword mining data (see details below)

Example: []

data.data[]

object

required

Item in data data.

data.data[].query

string

optional

Keyword (original Russian)

Example: phone case

data.data[].queryCn

string

optional

Keyword Chinese translation

Example: phone case

data.data[].platform

integer

optional

Platform: 0 Ozon, 1 Wildberries

Example: 1

data.data[].searchVolume

integer

optional

Monthly search volume

Example: 1

data.data[].count30GrowthRate

number

optional

Monthly search growth (%, can be negative)

Example: 1

data.data[].productCount

integer

optional

Product count (may be missing in some rows)

Example: 1

data.data[].competingProducts

integer

optional

Competing product count

Example: 1

data.data[].sellers

integer

optional

Seller count

Example: 1

data.data[].avgPrice

number

optional

Average price

Example: 1

data.data[].itemsViews

number

optional

Product visibility

Example: 1

data.data[].viewSharing

number

optional

View concentration (%)

Example: 1

data.data[].conversionSharing

number

optional

Conversion concentration (%)

Example: 1

data.data[].marketSpace

number

optional

Market space

Example: 1

data.data[].returnCancellationRate

number

optional

Return/cancellation rate (%)

Example: 1

data.data[].uniqQueriesWCa

integer

optional

Add-to-cart count

Example: 1

data.data[].ca

number

optional

Add-to-cart conversion rate (%)

Example: 1

data.data[].relevancy

number

optional

Relevance (degree of relevance to the seed keyword)

Example: 1

data.data[].titleDensity

number

optional

Title density

Example: 1

data.data[].wordCount

integer

optional

Word count

Example: 1

data.data[].categories

array

optional

Category ID array

Example: []

data.data[].categoryInfos

array

optional

Category information (see below)

Example: []

data.data[].categoryInfos[]

object

required

Item in data data[] categoryInfos.

data.data[].categoryInfos[].titleCn

string

optional

Category Chinese name

Example: null

data.data[].categoryInfos[].titleEn

string

optional

Category English name

Example: null

data.data[].categoryInfos[].titleRu

string

optional

Category Russian name

Example: null

data.data[].categoryInfos[].cnTitlePath

string

optional

Chinese category path

Example: null

data.data[].categoryInfos[].enTitlePath

string

optional

English category path

Example: null

data.data[].categoryInfos[].titlePath

string

optional

Russian category path

Example: null

data.data[].categoryInfos[].id

string

optional

Category ID

Example: example-id

data.data[].categoryInfos[].crossBorderSellable

boolean

optional

Whether cross-border sales are allowed

Example: false

data.data[].products

array

optional

Ozon Keyword Mining

What this API does

Ozon Keyword Mining

What this API does

Authentication

Run an API

Example request

Check the response

HTTP status codes

Run this API

Endpoint

Request parameters

Code example

Response example

Response fields

Responses

Data source, freshness, and limitations

MCP

Call a tool

Legacy MCP v1

Online test

Try it

Related APIs

Any of option 1

Any of option 2