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

一、接口基础介绍Ozon 是俄罗斯头部跨境电商平台/v2/product/info/list是卖家侧标准商品详情批量查询接口采用 POST 请求、Bearer Token 鉴权支持批量传入product_id一次性返回商品标题、价格、库存、类目、规格属性、图片视频、评分销量、活动优惠全套结构化数据。 配套补充接口/v3/products/info/attributes可获取完整商品参数二者组合可拿到完整商品卡片数据适用于跨境 ERP 同步、竞品价格监控、选品数据分析、多平台铺货素材采集等场景。鉴权方式请求头携带Client-IdApi-Key二、核心业务应用场景跨境 ERP 商品同步自动拉取 Ozon 商品价格、库存、图文同步至自有进销存系统竞品价格监控定时抓取同行售价、折扣活动制定动态调价策略海外选品分析统计类目商品销量、评分、用户评价筛选潜力爆款多平台铺货素材采集提取商品标题、描述、主图视频快速制作独立站 / 速卖通素材店铺商品巡检批量校验商品上架状态、库存余量、合规属性及时下架缺货商品三、标准成功返回 JSONv2/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_idOzon 平台商品唯一 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接口补充获取。