Ozon Seller 商品详情 API（v2/product/info/list）接口详解与标准 JSON 返回示例

一、接口基础介绍

Ozon 是俄罗斯头部跨境电商平台，/v2/product/info/list 是卖家侧标准商品详情批量查询接口，采用 POST 请求、Bearer Token 鉴权，支持批量传入product_id，一次性返回商品标题、价格、库存、类目、规格属性、图片视频、评分销量、活动优惠全套结构化数据。配套补充接口/v3/products/info/attributes可获取完整商品参数，二者组合可拿到完整商品卡片数据，适用于跨境 ERP 同步、竞品价格监控、选品数据分析、多平台铺货素材采集等场景。鉴权方式：请求头携带 Client-Id + Api-Key

二、核心业务应用场景

跨境 ERP 商品同步：自动拉取 Ozon 商品价格、库存、图文，同步至自有进销存系统
竞品价格监控：定时抓取同行售价、折扣活动，制定动态调价策略
海外选品分析：统计类目商品销量、评分、用户评价，筛选潜力爆款
多平台铺货素材采集：提取商品标题、描述、主图视频，快速制作独立站 / 速卖通素材
店铺商品巡检：批量校验商品上架状态、库存余量、合规属性，及时下架缺货商品

三、标准成功返回 JSON（v2/product/info/list 完整版）

复制代码

{
  "result": [
    {
      "product_id": 168954723,
      "offer_id": "EARPHONE-BLK-001",
      "product_status": "visible",
      "visibility": "VISIBLE",
      "name": "Беспроводные открытые наушники Bluetooth 5.3 черные",
      "short_description": "Легкие беспроводные наушники без закупорки уха, до 24 часов работы батареи",
      "description": "Открытые беспроводные наушники с Bluetooth 5.3, мягкая силиконовая подкладка, защита от пота IPX4, поддержка быстрой зарядки, стереозвук высокого качества.<br>Комплект: наушники, кейс зарядки, кабель Type-C.",
      "brand": "SoundAir",
      "category_id": 12845,
      "category_name": "Электроника > Аудио > Беспроводные наушники",
      "price": "2499.00",
      "old_price": "3299.00",
      "currency_code": "RUB",
      "visibility_price": "2499.00",
      "stock": {
        "present": 136,
        "reserved": 12,
        "total": 148
      },
      "images": [
        "https://cdn.ozon.ru/product/168954723_main_1.jpg",
        "https://cdn.ozon.ru/product/168954723_detail_2.jpg",
        "https://cdn.ozon.ru/product/168954723_box_3.jpg"
      ],
      "videos": [
        {
          "url": "https://video.ozon.ru/preview/168954723.mp4"
        }
      ],
      "rating": {
        "value": 4.7,
        "count": 216
      },
      "sales": {
        "sales_30d": 986,
        "sales_total": 4230
      },
      "attributes": [
        {
          "id": 9632,
          "name": "Цвет",
          "value": "Черный",
          "type": "SELECT"
        },
        {
          "id": 8741,
          "name": "Bluetooth версия",
          "value": "5.3",
          "type": "TEXT"
        },
        {
          "id": 7532,
          "name": "Водозащита",
          "value": "IPX4",
          "type": "SELECT"
        }
      ],
      "dimensions": {
        "width": 82,
        "height": 45,
        "depth": 32,
        "weight": 28
      }
    }
  ]
}

四、高频异常返回 JSON 示例

1. 鉴权失败（Client-Id/Api-Key 错误）

复制代码

{
  "code": 401,
  "message": "Invalid Client-Id or Api-Key",
  "details": []
}

2. 请求限流超限

复制代码

{
  "code": 429,
  "message": "Request limit exceeded, retry after 60 seconds",
  "details": []
}

3. product_id 不存在 / 商品已归档

复制代码

{
  "result": [],
  "code": 0,
  "message": "success"
}

4. 请求参数缺失

复制代码

{
  "code": 400,
  "message": "product_id array cannot be empty",
  "details": []
}

五、核心字段释义（精简版）

1. 商品基础标识

product_id：Ozon 平台商品唯一 ID，查询主键
offer_id：商家自定义货号，自有系统关联字段
product_status/visibility：商品上架状态（VISIBLE 正常 / ARCHIVED 下架）
name/short_description/description：商品标题、短卖点、长详情（俄语为主）

2. 价格与库存

price：当前售价；old_price：原价（用于计算折扣）；currency_code货币单位 RUB 卢布
stock.present：可售库存；reserved：已下单未发货占用库存

3. 素材媒体

images：商品主图 / 详情图数组；videos商品宣传视频地址

4. 运营数据

rating.value/count：商品平均评分、评价总数
sales_30d近 30 天销量，sales_total 累计总销量

5. 属性规格

attributes：材质、颜色、型号、防水等级等商品参数，用于筛选与详情展示

6. 物流包装

dimensions商品长宽高 + 净重，用于头程物流核算

六、开发接入注意事项

Ozon 接口价格、库存字段均为字符串类型，金额计算需转换浮点；
result为空数组代表商品不存在 / 已归档，业务代码必须做空数组判断；
批量查询单次最多传入 100 个product_id，高频采集需增加延时避免 429 限流；
商品描述、属性默认俄语，无中文翻译字段，多语言站点需自行二次翻译；
仅可用于合规店铺运营、数据分析，禁止批量爬取第三方店铺数据用于倒卖；
完整规格参数需额外调用/v3/products/info/attributes接口补充获取。