https://api.nexscope.ai/sr/ozon/keywordBackSearchRun 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/keywordBackSearch |
| Auth | Bearer API key |
| Content-Type | application/json |
Request parameters
| Name | Type | Required | Description |
|---|---|---|---|
skuIds | integer[] | required | Check the SKU list, up to 20. |
hasVariant | integer | required | Whether to eliminate variants: `0` is not eliminated, `1` is eliminated. |
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`. |
matchType | integer | optional | Keyword matching mode: `0` precise, `1` fuzzy. |
type | string[] | optional | Search term type: `0` natural search term, `1` advertising search term. |
historyDate | string | optional | Historical month, format `yyyy-MM`, such as `2026-02`. |
includeKeywords | string[] | optional | Contains an array of keywords, up to 1000. |
excludeKeywords | string[] | optional | Array of excluded keywords, up to 1000. |
searchVolume | object | optional | Monthly search popularity range. |
searchChange30 | object | optional | 30-day search range. |
wordCount | object | optional | Keyword word range. |
productViews | object | optional | Product view range. |
products | object | optional | Product number range. |
sellers | object | optional | Number of sellers range. |
marketSpace | object | optional | Market space scope. |
conversionSharing | object | optional | Conversion concentration range. |
uniqQueriesWCa | object | optional | The range of additional purchases. |
ca | object | optional | Add-on conversion rate range. |
conversion | object | optional | Conversion rate range. |
titleDensity | object | optional | Title density range. |
adRivalCount | object | optional | The range of the number of advertising competing products. |
adRank | object | optional | Ad rank range. |
naturalRank | object | optional | Natural ranking range. |
exposure | object | optional | exposure range. |
uId | string | optional | User ID. |
memberId | string | optional | Member ID; the data is attributed to this member. |
Code example
{
"hasVariant": 0,
"page": {
"orders": [
{
"direction": "DESC",
"field": "searchVolume"
}
],
"page": 1,
"pageSize": 5
},
"skuIds": [
4380710124
]
}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 (50 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 | Keyword reverse query 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 | number | 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. |
titleDensity | number | optional | Title Density. |
wordCount | integer | optional | word count. |
categories | array | optional | Array of category IDs. |
dimension | object | optional | Check back the exclusive dimension indicators. The structure is shown in the table below. |
products | array | optional | Top product data, element fields are shown in the table below. |
id | string | optional | Record ID. |
type | integer | optional | Search term channels: `0` natural search term, `1` advertising search term. |
naturalRank | integer | optional | Check the natural ranking of the SKU under this term. |
exposure | number | optional | Exposure, range 0–1. |
conversion | number | optional | Conversion rate, range 0–1. |
x | array | optional | Position/pagination indication, semantically opaque. |
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.