https://api.nexscope.ai/sr/ozon/marketKeywordSearchRun this API
Send a JSON request to execute this API and receive the documented response payload.
Endpoint
| Method | POST |
| Path | https://api.nexscope.ai/sr/ozon/marketKeywordSearch |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
page | object | required | Paging and sorting: `{page, pageSize, orders[]}`. |
page.page | integer | optional | Page number, starting from 1. Example: 1 |
page.pageSize | integer | optional | Number of items per page. Example: 20 |
page.orders | array | optional | Sorting rule, the element is `{field, direction}`; `direction` takes `DESC` or `ASC`. |
keywords | string[] | optional | Keyword array, up to 1000, used with `matchType`. |
matchType | integer | optional | Keyword matching mode: `0` precise, `1` fuzzy. |
searchDate | string | optional | Query date, the format is `yyyy-MM-dd`; for example, `2026-04-01` is used to query data in March 2026. |
categories | string[] | optional | Array of category IDs, up to 1000. |
searchVolume | object | optional | Search popularity range. |
searchChange30 | object | optional | 30-day search range. |
monthlySales | object | optional | Monthly sales range. |
monthlyRevenue | object | optional | Monthly sales range. |
price | object | optional | Price range. |
productViews | object | optional | Product view range. |
products | object | optional | Product number range. |
volume | object | optional | Volume range. |
marketSpace | object | optional | Market space scope. |
conversionSharing | object | optional | Conversion concentration range. |
reviews | object | optional | Comment range. |
ratings | object | optional | Rating range. |
sellers | object | optional | Number of sellers range. |
weight | object | optional | weight range. |
uId | string | optional | User ID. |
memberId | string | optional | Member ID; the data is attributed to this member. |
Code example
{
"page": {
"orders": [
{
"direction": "DESC",
"field": "searchVolume"
}
],
"page": 1,
"pageSize": 5
}
}Response example
Platform response envelope. code 0 indicates success or acceptance; data contains the business result.
{
"code": 0,
"cost": "-1",
"data": {},
"msg": null,
"time": "2026-01-01 00:00:00",
"traceId": null,
"ts": "0"
}Response fields
Response field reference (43 fields)
| Name | Type | Required | Description |
|---|---|---|---|
code | string | optional | Return code, `"200"` indicates success; returned when successful. |
errcode | integer | optional | Error code, `200` indicates success; only this field may be returned when there is a business error. |
msg | string | optional | Message; Success was `ok`. |
errmsg | string | optional | Error message; success is `ok`, business error is a reason description. |
total | integer | optional | Total number of records. |
data | array | optional | Market hot word data, element fields are shown in the table below. |
columns | array | optional | Column definition, elements containing `field`, `title`, `cellType`, `sortable`, `filterable`. |
costTime | integer | optional | The interface consumes time in milliseconds. |
costToken | integer | optional | The number of tokens consumed. |
type | string | optional | Response display type, such as `tableListWorkbenches`. |
query | string | optional | Keywords, original Russian text. |
queryCn | string | optional | Keywords Chinese translation. |
platform | integer | optional | Platform: `0` Ozon, `1` Wildberries. |
searchVolume | integer | optional | Monthly search popularity. |
count30GrowthRate | number | optional | Monthly search growth, percentage, can be negative. |
productCount | integer | optional | Number of items, some rows may be missing. |
competingProducts | integer | optional | Number of competing products. |
sellers | integer | optional | Number of sellers. |
avgPrice | number | optional | Average price. |
itemsViews | number | optional | Product visibility. |
viewSharing | number | optional | Browse concentration, percentage. |
conversionSharing | number | optional | Conversion concentration, percentage. |
marketSpace | integer | optional | market space. |
returnCancellationRate | number | optional | Return cancellation rate, percentage. |
uniqQueriesWCa | integer | optional | Number of additional purchases. |
ca | number | optional | Add-to-purchase conversion rate, percentage. |
categories | array | optional | Array of category IDs. |
categoryInfos | array | optional | Category information and element fields are shown in the table below. |
products | array | optional | Top product data, element fields are shown in the table below. |
id | string | optional | Record ID. |
ozonId | integer | optional | Ozon product ID. |
sku | integer | optional | SKU ID。 |
title | string | optional | Product title, Russian. |
imageUrl | string | optional | Main image URL. |
advert | integer | optional | Advertising logo: `0` / `1`. |
titleCn | string | optional | Category Chinese name. |
titleEn | string | optional | Category English name. |
titleRu | string | optional | Category Russian name. |
cnTitlePath | string | optional | Chinese category path. |
enTitlePath | string | optional | English category path. |
titlePath | string | optional | Russian category path. |
id | string | optional | Category ID. |
crossBorderSellable | boolean | optional | Whether it can be sold across borders. |
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.