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
| Name | Type | Required | Description |
|---|---|---|---|
code | integer | required | 0 means accepted or successful; nonzero is a platform error. |
cost | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
data | any | required | Data value used by this API operation. |
msg | string | null | required | Msg value used by this API operation. |
time | string | required | Server local time: yyyy-MM-dd HH:mm:ss. |
traceId | string | null | required | Trace id value used by this API operation. |
ts | string | required | Epoch milliseconds. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.advert | any | optional | Advert value used by this API operation. |
data.avgPrice | any | optional | Avg price value used by this API operation. |
data.ca | any | optional | Ca value used by this API operation. |
data.categories | any | optional | Categories value used by this API operation. |
data.categoryInfos | any | optional | Category infos value used by this API operation. |
data.cnTitlePath | any | optional | Cn title path value used by this API operation. |
data.columns | any | optional | Columns value used by this API operation. |
data.competingProducts | any | optional | Competing products value used by this API operation. |
data.conversionSharing | any | optional | Conversion sharing value used by this API operation. |
data.costTime | any | optional | Cost time value used by this API operation. |
data.costToken | any | optional | Cost token value used by this API operation. |
data.count30GrowthRate | any | optional | Count30 growth rate value used by this API operation. |
data.crossBorderSellable | any | optional | Cross border sellable value used by this API operation. |
data.data | any | optional | Data value used by this API operation. |
data.dataSnapshotMonth | any | optional | Data snapshot month value used by this API operation. |
data.enTitlePath | any | optional | En title path value used by this API operation. |
data.id | any | optional | Id value used by this API operation. |
data.imageUrl | any | optional | Image url value used by this API operation. |
data.itemsViews | any | optional | Items views value used by this API operation. |
data.marketSpace | any | optional | Market space value used by this API operation. |
data.ozonId | any | optional | Ozon id value used by this API operation. |
data.page | any | optional | Page value used by this API operation. |
data.pageItemCount | any | optional | Page item count value used by this API operation. |
data.pageSize | any | optional | Page size value used by this API operation. |
data.platform | any | optional | Platform value used by this API operation. |
data.productCount | any | optional | Product count value used by this API operation. |
data.products | any | optional | Products value used by this API operation. |
data.query | any | optional | Query value used by this API operation. |
data.queryCn | any | optional | Query cn value used by this API operation. |
data.returnCancellationRate | any | optional | Return cancellation rate value used by this API operation. |
data.searchVolume | any | optional | Search volume value used by this API operation. |
data.sellers | any | optional | Sellers value used by this API operation. |
data.sku | any | optional | Sku value used by this API operation. |
data.sourceTool | any | optional | Source tool value used by this API operation. |
data.sourceType | any | optional | Source type value used by this API operation. |
data.title | any | optional | Title value used by this API operation. |
data.titleCn | any | optional | Title cn value used by this API operation. |
data.titleEn | any | optional | Title en value used by this API operation. |
data.titlePath | any | optional | Title path value used by this API operation. |
data.titleRu | any | optional | Title ru value used by this API operation. |
data.total | any | optional | Total value used by this API operation. |
data.totalPage | any | optional | Total page value used by this API operation. |
data.type | any | optional | Type value used by this API operation. |
data.uniqQueriesWCa | any | optional | Uniq queries wca value used by this API operation. |
data.viewSharing | any | optional | View sharing value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.advert | integer | optional | Advertising logo: `0` / `1`. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.advert | null | optional | Advert value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.avgPrice | number | optional | Average price. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.avgPrice | null | optional | Avg price value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.ca | number | optional | Add-to-purchase conversion rate, percentage. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.ca | null | optional | Ca value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.categories | array | optional | Array of category IDs. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.categories | null | optional | Categories value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.categoryInfos | array | optional | Category information and element fields are shown in the table below. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.categoryInfos | null | optional | Category infos value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.cnTitlePath | string | optional | Chinese category path. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.cnTitlePath | null | optional | Cn title path value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.columns | array | optional | Column definition, elements containing `field`, `title`, `cellType`, `sortable`, `filterable`. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.columns | null | optional | Columns value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.competingProducts | integer | optional | Number of competing products. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.competingProducts | null | optional | Competing products value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.conversionSharing | number | optional | Conversion concentration, percentage. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.conversionSharing | null | optional | Conversion sharing value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.costTime | integer | optional | The interface consumes time in milliseconds. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.costTime | null | optional | Cost time value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.costToken | integer | optional | The number of tokens consumed. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.costToken | null | optional | Cost token value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.count30GrowthRate | number | optional | Monthly search growth, percentage, can be negative. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.count30GrowthRate | null | optional | Count30 growth rate value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.crossBorderSellable | boolean | optional | Whether it can be sold across borders. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.crossBorderSellable | null | optional | Cross border sellable value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.data | array | optional | Market hot word data, element fields are shown in the table below. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.data | null | optional | Data value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.dataSnapshotMonth | null | optional | Data snapshot month value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.enTitlePath | string | optional | English category path. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.enTitlePath | null | optional | En title path value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.id | any | optional | Id value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.id | string | optional | Category ID. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.id | null | optional | Id value used by this API operation. |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.id | null | optional | Id value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.imageUrl | string | optional | Main image URL. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.imageUrl | null | optional | Image url value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.itemsViews | number | optional | Product visibility. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.itemsViews | null | optional | Items views value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.marketSpace | integer | optional | market space. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.marketSpace | null | optional | Market space value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.ozonId | integer | optional | Ozon product ID. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.ozonId | null | optional | Ozon id value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.page | null | optional | Page value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.pageItemCount | null | optional | Page item count value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.pageSize | null | optional | Page size value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.platform | integer | optional | Platform: `0` Ozon, `1` Wildberries. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.platform | null | optional | Platform value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.productCount | integer | optional | Number of items, some rows may be missing. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.productCount | null | optional | Product count value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.products | array | optional | Top product data, element fields are shown in the table below. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.products | null | optional | Products value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.query | string | optional | Keywords, original Russian text. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.query | null | optional | Query value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.queryCn | string | optional | Keywords Chinese translation. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.queryCn | null | optional | Query cn value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.returnCancellationRate | number | optional | Return cancellation rate, percentage. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.returnCancellationRate | null | optional | Return cancellation rate value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.searchVolume | integer | optional | Monthly search popularity. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.searchVolume | null | optional | Search volume value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sellers | integer | optional | Number of sellers. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sellers | null | optional | Sellers value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sku | integer | optional | SKU ID。 Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sku | null | optional | Sku value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceTool | null | optional | Source tool value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.sourceType | null | optional | Source type value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.title | string | optional | Product title, Russian. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.title | null | optional | Title value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.titleCn | string | optional | Category Chinese name. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.titleCn | null | optional | Title cn value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.titleEn | string | optional | Category English name. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.titleEn | null | optional | Title en value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.titlePath | string | optional | Russian category path. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.titlePath | null | optional | Title path value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.titleRu | string | optional | Category Russian name. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.titleRu | null | optional | Title ru value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.total | integer | optional | Total number of records. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.total | null | optional | Total value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.totalPage | null | optional | Total page value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.type | string | optional | Response display type, such as `tableListWorkbenches`. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.type | null | optional | Type value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.uniqQueriesWCa | integer | optional | Number of additional purchases. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.uniqQueriesWCa | null | optional | Uniq queries wca value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data.viewSharing | number | optional | Browse concentration, percentage. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data.viewSharing | null | optional | View sharing value used by this API operation. |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
Responses
| Code | Description |
|---|---|
| 200 | Default HTTP response for both success and many business errors. Only outer JSON code 0 indicates success or asynchronous acceptance; inspect data for the result. |
| 429 | Execution admission rate limit; honor Retry-After when present. |
| 503 | Execution admission is temporarily unavailable; honor Retry-After when present. |
| Opt-in | X-Nexscope-Http-Status: semantic maps controller-handled business errors to HTTP status on run and task routes. Pre-authentication failures, such as a missing API key (code 11209), may still return HTTP 200 before this mapping. Always check the outer JSON code; malformed requests and infrastructure failures may also return non-200 HTTP responses. |
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.