查询产品SKU变体分析 - Ozon 数据服务平台API

按单个产品ID（SKU）查询某天该商品卡下全部变体销售情况，含主图、品牌、评分、评论、类目路径、店铺、价格、当天销量/销售额及环比、月销量/销售额、发货模式、库存及上架日期。 updatePeriod 为 yyyy-MM-dd，不传取最新账期，最多可查看过去近30天；deliveryMode 默认 ALL，可选 FBS/FBO；默认按销量降序，pageSize 最大 15。返回字段 deliveryModes 为该变体实际支持的 FBO/FBS（由 is_fbo/is_fbs 判定），不含 ALL。

请求参数

Authorization

API Key

在 header 添加参数

Authorization

示例：

Authorization: ********************

Body 参数application/json必填

示例

{
    "pageNo": 1,
    "pageSize": 15,
    "itemId": 123456789,
    "updatePeriod": "2026-08-20",
    "deliveryMode": "ALL",
    "sortField": "SALES",
    "sortDirection": "ASC"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200

application/json

Bodyapplication/json

示例

{
    "success": true,
    "errorCode": "string",
    "errorMessage": "string",
    "data": [
        {
            "itemId": 0,
            "itemName": "string",
            "itemPhoto": "string",
            "brandName": "string",
            "itemRating": 123.45,
            "itemFeedbacks": 0,
            "skuCount": 0,
            "categoryPathZh": "string",
            "categoryPathRu": "string",
            "shopName": "string",
            "shopId": 0,
            "productType": "string",
            "price": 123.45,
            "sales": 0,
            "salesDynamics": "50.00%",
            "gmv": 123.45,
            "monthSales": 0,
            "monthGmv": 123.45,
            "deliveryModes": [
                "ALL"
            ],
            "stock": 0,
            "launchDate": "string",
            "updatePeriod": "string"
        }
    ],
    "total": 100,
    "pageNo": 1,
    "pageSize": 20
}

🟠400

🟠401

🟠403

🔴500