Ozon Seller 商品详情 API（v2/product/info/list）接口详解与标准 JSON 返回示例
一、接口基础介绍
product_id，一次性返回商品标题、价格、库存、类目、规格属性、图片视频、评分销量、活动优惠全套结构化数据。配套补充接口/v3/products/info/attributes可获取完整商品参数，二者组合可拿到完整商品卡片数据，适用于跨境 ERP 同步、竞品价格监控、选品数据分析、多平台铺货素材采集等场景。请求域名：https://api-seller.ozon.ru鉴权方式：请求头携带 Client-Id + Api-Key
二、核心业务应用场景
跨境 ERP 商品同步：自动拉取 Ozon 商品价格、库存、图文，同步至自有进销存系统
竞品价格监控：定时抓取同行售价、折扣活动，制定动态调价策略
海外选品分析：统计类目商品销量、评分、用户评价，筛选潜力爆款
多平台铺货素材采集：提取商品标题、描述、主图视频，快速制作独立站 / 速卖通素材
店铺商品巡检：批量校验商品上架状态、库存余量、合规属性，及时下架缺货商品
三、标准成功返回 JSON（v2/product/info/list 完整版）
json
{
"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 错误）
json
{
"code": 401, "message": "Invalid Client-Id or Api-Key", "details": []}
2. 请求限流超限
json
"code": 429, "message": "Request limit exceeded, retry after 60 seconds", "details": []}
3. product_id 不存在 / 商品已归档
json
{
"result": [], "code": 0, "message": "success"}
4. 请求参数缺失
json
{
"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接口补充获取。
