nexscope-ai/nexscope-ecommerce-skills / ecommerce-ozon-product-detail
ecommerce.ozon-product-detail
VerifiedNexscope Ozon Russia SKU full detail query for one product ID per call, returning price, discount, Ozon Card price, rating, review count, stock, sales, revenue, revenue potential/lost revenue, listing date, images, and the complete product card. Trigger for Ozon product or SKU detail, price/rating/sales/stock checks, competitor Ozon cards, Nexscope Ozon detail, or Russian marketplace product detail by a known SKU.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.7 KB |
| manifest.json | config | 311 B |
| references/api.md | markdown | 8.2 KB |
| scripts/ozon_product_detail.py | script | 6.8 KB |
references/api.md
View on GitHub# Nexscope Ozon Product Detail API Reference
## API Specification
- **Endpoint**: `${NEXSCOPE_PROXY_BASE}/api/v1/tools/research/mpstats/ozon/productDetail`
- **HTTP Method**: POST, Content-Type: application/json
- **Authentication**: Header `Authorization: <api_key>`, api_key is read from the environment variable `NEXSCOPE_API_KEY` (if not configured, follow the **## Resolving Authentication and Credit Issues** section in SKILL.md)
## Request Parameters
POST Body (JSON). The following fields follow the currently registered Ozon Product Detail input schema.
| Parameter | Type | Required | Description |
|------|------|------|------|
| productId | integer or string | Yes | One Ozon SKU ID, for example `1786874757`; arrays are not accepted |
| startDate | string | No | Statistics start date, format `YYYY-MM-DD`; latest is yesterday |
| endDate | string | No | Statistics end date, format `YYYY-MM-DD`; latest is yesterday |
| includeFbs | boolean | No | Whether to include FBS data for the requested SKU |
> `productIds` is deprecated. Send one `productId` per call; a separate request is needed for each additional SKU and consumes credits.
## Nexscope response envelope
These research endpoints return a platform object with numeric `code`, nullable `msg`, and business `data`. Only outer `code: 0` means success; `200`, string codes, missing codes, and HTTP 200 alone do not. A nonzero code is a platform error: show `msg` and do not interpret the payload as a successful result.
`msg` preserves the upstream message when available; Chinese messages are translated to English by Nexscope. A successful response without a message has `msg: null`. Do not infer success or retry behavior from the message text. On both success and failure, the direct fields `code`, `errcode`, `errorCode`, `msg`, `errmsg`, `message`, and `errorMsg` are removed from public `data`. Read the message only from outer `msg`; deeper business fields are preserved, including nested `code` and `status`.
Business field tables and abbreviated business examples below describe `data`, unless explicitly labeled as a complete platform response. For example, a business `products` field is at HTTP `data.products`, and a business `data` array is at HTTP `data.data`. The research endpoints already had this outer envelope; no additional wrapper is added.
```json
{"code":0,"msg":null,"data":{}}
```
Metadata includes string `ts` (epoch milliseconds), string `cost` (elapsed milliseconds, not credits), `time`, and nullable `traceId`. Handle network/HTTP failures before the platform code; gateway failures may not be platform JSON. Keep the existing billing-header guidance separate from elapsed time.
## Response Structure
| Field | Type | Description |
|------|------|------|
| total | integer | Number of SKUs returned (= `successCount` + `failedCount`) |
| successCount | integer | Number of SKUs for which cards were successfully returned |
| failedCount | integer | Number of SKUs that failed |
| failures | array | List of failed SKU details (each item contains the failed `productId` and error info) |
| products | array | Product card list (see details below) |
| columns | array | Rendered column definitions |
| costTime | integer | API latency (milliseconds) |
| costToken | integer | Tokens consumed |
| type | string | Response type |
### products[*] Product Detail Fields (36 fields)
Per official outputSchema definition (`_mpstats_ozon_productDetail`, sync date 2026-05-06). **The detail field set differs from brand/category/seller**: detail has unique deep fields such as `previous*` / `revenuePotential` / `deliveryScheme` / `productImageUrls`, but does not return `brandId` / `country` / `category` / `minPrice/maxPrice/averagePrice` / `balanceFbs` / `frozenStocks` / `warehousesCount` / `daysInSite/daysInStock/turnoverDays` / `position/categoryPosition/revenueSharePercent` / `isFbs`.
**Identity & Basic Information**
| Field | Type | Description |
|------|------|------|
| productId | integer | SKU ID |
| title | string | Product name (Russian) |
| brand | string | Brand |
| sellerName | string | Seller name |
| sellerId | integer | Seller ID |
| sellerIsBestSeller | boolean | Whether the seller is a best seller |
| nicheName | string | Niche path (Russian, `/` separated) |
| nicheId | integer | Niche ID |
| firstDate | string | Listing date (`yyyy-MM-dd`) |
| updated | string | Data update time (`yyyy-MM-dd HH:mm:ss`) |
| note | string | Notes |
| sourceTool / sourceType | string | Source tool / data source identifier |
**Images**
| Field | Type | Description |
|------|------|------|
| imageUrl | string | Main image URL (first large image) |
| imageCount | integer | Total image count |
| productImageUrls | array<string> | Remaining large image URLs besides the main image |
| productPageUrl | string | Product page URL |
**Price & Discount**
| Field | Type | Description |
|------|------|------|
| price | number | Current selling price |
| oldPrice | number | Original price before discount |
| ozonCardPrice | number | Ozon Card price (bank card discount price) |
| discount | integer | Discount, integer percentage 0-100 |
| currency | string | Currency symbol (`₽` / `$` / `€`) |
**Ratings**
| Field | Type | Description |
|------|------|------|
| rating | number | Rating, 0-5 |
| reviewCount | integer | Number of reviews |
**Inventory & Delivery**
| Field | Type | Description |
|------|------|------|
| balance | integer | Current stock (units) |
| deliveryScheme | string | Delivery scheme; `FBO` = Ozon fulfillment, `FBS` = seller self-delivery |
**Sales & Revenue (Current Period + Prior Period Comparison)**
| Field | Type | Description |
|------|------|------|
| salesPerDay | number | Average daily sales (units/day) |
| salesPerDayWithStock | number | Average daily sales counting only days with stock |
| dailySalesRevenue | number | Average daily sales revenue |
| dailySalesRevenueWithStock | number | Average daily sales revenue counting only days with stock |
| monthlySalesUnits | integer | Sales volume during the statistics period (units) |
| monthlySalesRevenue | number | Sales revenue during the statistics period |
| previousSalesUnits | integer | Prior period sales volume (the same-length period before the current statistics period) |
| previousRevenue | number | Prior period sales revenue |
| revenuePotential | number | Potential revenue (estimated based on full-period stock availability) |
| lostProfit | number | Lost revenue (due to stockouts, etc.) |
| lostProfitPercent | number | Lost revenue percentage (%) |
## Error Codes
HTTP 200 does not prove business success. Read only the numeric outer platform `code`: `0` succeeds and any other value fails. Show outer `msg`; never test removed provider codes or nested business `code` as the platform status. Authentication, permissions, balance, and validation failures may be platform errors even with HTTP 200; also handle non-2xx HTTP and non-JSON responses.
### Recovery guidance
| Condition | Action |
|---|---|
| Authentication failed | HTTP 401 or authorized error: Follow the **## Resolving Authentication and Credit Issues** section in SKILL.md. |
| Insufficient credits or balance | HTTP 402: Follow the **## Resolving Authentication and Credit Issues** section in SKILL.md. |
## curl Example
```bash
curl -X POST ${NEXSCOPE_PROXY_BASE}/api/v1/tools/research/mpstats/ozon/productDetail \
-H "Authorization: Bearer ${NEXSCOPE_API_KEY}" \
-H "Content-Type: application/json" \
-d '{
"productId": 1786874757,
"startDate": "2025-03-01",
"endDate": "2025-03-31",
"includeFbs": true
}'
```
---
## API Key request rate and retries
All API Keys of one Nexscope user share the public API execution request-rate allowance, measured in any rolling 1-second window. The allowed RPS depends on that user's entitlements; it is not a universal 1 RPS. One Skill operation may issue multiple public API requests, each of which uses the allowance.
HTTP 429 with Nexscope outer code `13012` means request-rate exhaustion: honor the response's `Retry-After`. Outer code `13013` means concurrent-request exhaustion, not rate exhaustion; honor `Retry-After` when supplied. Check the HTTP status and outer JSON code separately. Do not automatically replay writes or requests with uncertain outcomes; first reconcile the operation's state.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |