POST
https://api.nexscope.ai/api/skill-api/v1/skills/ozon-product-detail-search/runRun 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-product-detail-search/run |
| Auth | Bearer API key |
| Content-Type | application/json |
Request body
| Name | Type | Required | Description |
|---|---|---|---|
sku | string | required | Product SKU (Ozon SKU, e.g., 175924376). This is the sku returned by other Seerfar Ozon tools Example: 1664362124 |
dateRange | string | optional | Sales/metrics statistics window, default past_30_days. Options: past_7_days / past_30_days / past_60_days / past_90_days / past_180_days / past_365_days Example: past_30_days |
uId | string | optional | User ID (max 1000) Example: example-id |
memberId | string | optional | Member ID (a unique member identifier; a user can belong to multiple teams; data is attributed to memberId, max 1000) Example: example-id |
Request example
{
"sku": "1664362124",
"dateRange": "past_30_days"
}Response body
| 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 | string | required | Elapsed milliseconds, never credits; -1 outside web requests. |
traceId | string | null | required | Trace id value used by this API operation. |
Any of option 1
| Name | Type | Required | Description |
|---|---|---|---|
data | object | required | Data value used by this API operation. |
data.total | integer | optional | Number of records returned (1 on hit, 0 on miss) Example: 1 |
data.totalSales | integer | optional | Total sales volume within the statistics window Example: 1 |
data.dailySales | number | optional | Average daily sales (approx totalSales / window days) Example: 1 |
data.totalRevenue | number | optional | Sales revenue within the statistics window (RUB) Example: 1 |
data.stock | integer | optional | Stock Example: 1 |
data.startDate | string | optional | Statistics window start date (e.g., 2026-06-01) Example: 2026-01-01 |
data.endDate | string | optional | Statistics window end date (e.g., 2026-06-30) Example: 2026-01-01 |
data.salesTrendVOList | array | optional | Daily sales data series (see below) Example: [] |
data.categoryRanks | array | optional | Product category ranking history (see below) Example: [] |
data.products | array | optional | Product detail list (1 record on single SKU hit, empty on miss) Example: [] |
data.data | array | optional | Returned data, content identical to products Example: [] |
data.columns | array | optional | Column definitions, elements contain {field, title, cellType, sortable, filterable} Example: [] |
data.type | string | optional | Response display type, e.g., productWorkbenches Example: null |
data.costTime | integer | optional | API latency (milliseconds) Example: 1 |
data.costToken | integer | optional | Tokens consumed Example: 1 |
data.products[].sku | integer | optional | Product SKU Example: 1 |
data.products[].productId | integer | optional | Unified product ID, mapped from sku Example: 1 |
data.products[].title | string | optional | Product title Example: null |
data.products[].price | number | optional | Product price (RUB) Example: 1 |
data.products[].currency | string | optional | Currency, always ₽ Example: null |
data.products[].reviewRating | number | optional | Product rating Example: 1 |
data.products[].rating | number | optional | Unified rating, mapped from reviewRating Example: 1 |
data.products[].reviewCount | integer | optional | Number of reviews Example: 1 |
data.products[].questionsAndAnswers | integer | optional | QA count Example: 1 |
data.products[].brandName | string | optional | Brand name Example: null |
data.products[].brand | string | optional | Unified brand, mapped from brandName Example: null |
data.products[].brandId | integer | optional | Brand ID Example: 1 |
data.products[].brandUrl | string | optional | Brand link Example: https://example.com/image.jpg |
data.products[].sellerName | string | optional | Seller name Example: null |
data.products[].sellerId | integer | optional | Seller ID (negative values indicate Ozon platform self-operated sellers, e.g., -4 Ozon Россия) Example: 1 |
data.products[].fulfillment | array | optional | Product fulfillment methods, e.g., ["FBO"], ["OZON"], may contain multiple values Example: [] |
data.products[].upTime | integer | optional | Listing time, millisecond timestamp Example: 1 |
data.products[].upDays | integer | optional | Days since listing Example: 1 |
data.products[].upMonths | integer | optional | Months since listing Example: 1 |
data.products[].imageUrl | string | optional | Unified main image URL, mapped from the first of imageUrls Example: https://example.com/image.jpg |
data.products[].imageUrls | array | optional | List of product image URLs Example: [] |
data.products[].productUrl | string | optional | Product URL Example: https://example.com/image.jpg |
data.products[].productPageUrl | string | optional | Unified product page URL, mapped from productUrl Example: https://example.com/image.jpg |
data.products[].categoryInfo | object | optional | Product category information (see below) Example: {} |
data.products[].monthlySalesUnits | integer | optional | Unified monthly sales, actual value equals totalSales of the current statistics window Example: 1 |
data.products[].monthlySalesRevenue | number | optional | Unified monthly revenue, actual value equals totalRevenue of the current statistics window Example: 1 |
data.products[].sourceType | string | optional | Data source, always ozon Example: null |
data.products[].sourceTool | string | optional | Source tool identifier for the Ozon competitor-detail endpoint Example: null |
data.products[].weight | number | optional | Product weight, in grams (digital/service products may not return this, see field differences) Example: 1 |
data.products[].grossMargin | number | optional | Gross margin (defined in schema, some products may not return this in practice, see field differences) Example: 1 |
data.salestrendvolist[].date | string | optional | Date (e.g., 2026-06-01) Example: 2026-01-01 |
data.salestrendvolist[].sales | integer | optional | Daily sales (may be 0) Example: 1 |
data.salestrendvolist[].revenue | number | optional | Daily revenue (RUB) Example: 1 |
data.salestrendvolist[].price | number | optional | Daily price (RUB) Example: 1 |
data.salestrendvolist[].stock | integer | optional | Daily stock Example: 1 |
data.salestrendvolist[].reviewCount | integer | optional | Cumulative review count as of this date Example: 1 |
data.salestrendvolist[].reviewRating | number | optional | Rating as of this date Example: 1 |
data.categoryranks[].date | string | optional | Month (e.g., 2026-02; current month shows as specific date 2026-07-01) Example: 2026-01-01 |
data.categoryranks[].rank | integer | optional | Category ranking Example: 1 |
data.categoryranks[].count | integer | optional | Statistics count (subject to actual gateway interpretation) Example: 1 |
data.columns[].cnTitlePath | string | optional | Chinese category path Example: null |
data.columns[].enTitlePath | string | optional | English category path Example: null |
data.columns[].titlePath | string | optional | Category path (original text) Example: null |
data.columns[].category | object | optional | Terminal category object (fields see below) Example: {} |
data.columns[].fullCategoryId | array | optional | Full category ID path (string array, root to terminal, e.g., ["99999999", "99999999_200001489", "99999999_200001489_970727001"]) Example: [] |
data.columns[].cnTitle | string | optional | Category Chinese name Example: null |
data.columns[].enTitle | string | optional | Category English name Example: null |
data.columns[].title | string | optional | Category original title Example: null |
data.columns[].level | integer | optional | Category level Example: 1 |
data.columns[].id | string | optional | Category ID Example: example-id |
data.columns[].pid | string | optional | Parent category ID Example: example-id |
data.columns[].crossBorderSellable | boolean | optional | Whether cross-border sales are supported Example: false |
data.columns[].disabled | boolean | optional | Whether disabled Example: false |
data.title | string | optional | Provider-specific response title. Example: null |
data.sourceType | string | optional | Provider-specific source platform type. Example: null |
data.sourceTool | string | optional | Provider-specific source tool name. Example: null |
data.page | integer | optional | Current page returned by the upstream provider. Example: null |
data.pageSize | integer | optional | Page size returned by the upstream provider. Example: null |
data.pageItemCount | integer | optional | Item count on the current page returned by the upstream provider. Example: null |
data.totalPage | integer | optional | Total page count returned by the upstream provider. Example: null |
data.dataSnapshotMonth | string | optional | Data snapshot month returned by the upstream provider. Example: null |
Any of option 2
| Name | Type | Required | Description |
|---|---|---|---|
data | null | required | Data value used by this API operation. |
Response example
Platform response envelope. code 0 indicates success or acceptance; data contains the business result.
{
"data": {
"total": 1,
"totalSales": 1,
"dailySales": 1,
"totalRevenue": 1,
"stock": 1,
"startDate": "2026-01-01",
"endDate": "2026-01-01",
"salesTrendVOList": [],
"categoryRanks": [],
"products": [
{
"sku": 1,
"productId": 1,
"price": 1,
"reviewRating": 1,
"rating": 1,
"reviewCount": 1,
"questionsAndAnswers": 1,
"brandId": 1,
"brandUrl": "https://example.com/image.jpg",
"sellerId": 1,
"fulfillment": [],
"upTime": 1,
"upDays": 1,
"upMonths": 1,
"imageUrl": "https://example.com/image.jpg",
"imageUrls": [],
"productUrl": "https://example.com/image.jpg",
"productPageUrl": "https://example.com/image.jpg",
"categoryInfo": {},
"monthlySalesUnits": 1,
"monthlySalesRevenue": 1,
"weight": 1,
"grossMargin": 1
}
],
"data": [],
"columns": [
{
"category": {},
"fullCategoryId": [],
"level": 1,
"id": "example-id",
"pid": "example-id",
"crossBorderSellable": false,
"disabled": false
}
],
"costTime": 1,
"costToken": 1,
"salestrendvolist": [
{
"date": "2026-01-01",
"sales": 1,
"revenue": 1,
"price": 1,
"stock": 1,
"reviewCount": 1,
"reviewRating": 1
}
],
"categoryranks": [
{
"date": "2026-01-01",
"rank": 1,
"count": 1
}
]
},
"code": 0,
"msg": null,
"ts": "0",
"time": "2026-01-01 00:00:00",
"cost": "-1",
"traceId": null
}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.