Ozon商品详情API技术解析与落地应用（含标准 JSON 示例）

原创

用户1597063760

发布于 2026-09-04 09:12:33

750

文章被收录于专栏：经验经验

摘要：Ozon 作为俄罗斯头部跨境电商平台，在跨境 ERP 开发、竞品情报监控、选品数据分析、货源采集、跨平台刊登场景，需要获取商品完整结构化数据。依靠网页手动复制素材效率低下，变体解析、俄语文本处理、多仓库库存统计都会消耗大量研发人力。本文站在工程实战角度，解析 Ozon 商品详情 API，讲解接口能力、参数规范、返回字段、完整业务流程、Python 调用示例以及俄罗斯跨境项目高频踩坑。

一、业务背景

开发 Ozon 相关跨境系统时，普遍面临这些业务痛点：

商品大量存在多变体 SKU，每个规格独立价格、图片、库存，人工整理极易发生 SKU 错乱、规格丢失；
平台主体语言为俄语，标题、描述、属性全部为俄文，采集后做跨平台铺货需要文本预处理；
库存分为 FBO 平台仓、FBS 自发货仓库，多仓库分开统计，需要区分可售、锁定占用库存；
做竞品监控需要定时抓取价格、销量、评分，生成历史快照，人工浏览页面无法完成常态化巡检；
采集拿到的原始数据不能直接用于刊登，需要类目映射、单位换算、素材清洗，否则发布审核失败。

Ozon 商品详情 API，传入product_id商品编号，返回商品标题、图集、属性参数、价格、多仓库存、变体 SKU、评分销量、描述等全套结构化数据，是 Ozon 跨境系统重要底层数据源。

二、接口基础信息

接口标识：ozon.item_get（ozon商品详情 API，taobaoapi2014移步获取）
请求网关： c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）
请求方式：GET / POST
入参：product_id商品 ID。
返回内容：商品基础信息、图片视频、价格促销、多仓库库存、类目、品牌、规格参数、变体 SKU 数组、评分评论、商品描述、包装尺寸重量。
适用场景：跨境 ERP 素材采集、竞品价格监控、俄罗斯市场选品分析、跨平台刊登铺货、商品情报归档。

三、整体业务落地流程

数据源录入：录入目标product_id商品编号；
调用商品详情接口，拉取完整结构化返回；
数据清洗归一化
- 图片防盗链处理，图片转存对象存储；
- 俄语文本处理，标题、描述、属性清洗；
- 解析 variants 变体数组，拆分各个子 SKU；
- 区分 FBO/FBS 多仓库库存，提取真实可售库存；
- 尺寸重量单位归一化；
持久化存储：商品基础信息入库，保存价格、库存快照；
业务分支 1‑ERP 刊登：提取标题、图片、属性、描述，预处理生成刊登草稿；
业务分支 2‑竞品监控：定时任务轮询，对比历史快照，价格异动触发告警；
异常处理：商品下架、接口限流、参数错误，记录日志并告警。

四、核心返回字段说明

顶层响应结构

字段	类型	说明
code	int	200 成功；400 参数错误；403 鉴权失败；429 限流；500 服务异常
msg	string	返回提示文本，success 代表正常
request_id	string	请求唯一 ID，排查问题使用
data	object	商品业务主体对象

data 主体字段

字段	类型	说明
product_id	string	Ozon 商品唯一 ID，业务主键
offer_id	string	商家自定义 SKU 货号
title	string	商品俄语标题
short_description	string	商品简短卖点
description	string	商品长描述，支持 HTML
brand	string	品牌名称
primary_image	string	主图地址，防盗链
images	array[string]	全部商品图片数组
video_urls	array[string]	商品视频地址数组
price	string	当前售卖价格，货币卢布 RUB
old_price	string	划线原价
promo_price	string	活动促销价
currency	string	货币编码 RUB
category_id	string	类目 ID，刊登类目映射使用
category_path	array[string]	类目层级路径数组
attributes	array[object]	商品规格参数数组
rating	string	商品平均评分
review_count	int	评论总数量
sales_30d	int	近 30 天销量
sales_total	int	累计销量
stock_info	object	多仓库库存对象，区分 FBO/FBS
width/height/depth/weight	number	商品包装长宽高重量
visibility	string	商品状态 VISIBLE上架 / INVISIBLE下架审核中
variants	array[object]	变体 SKU 数组，多变体商品核心数据

variants 变体子项字段

字段	类型	说明
variant_id	string	变体唯一编号
spec_text	string	规格文本（颜色、尺寸）
price	string	变体独立售价
stock_info	object	该变体库存信息
pic_url	string	变体对应图片地址

五、标准 JSON 返回示例

{
    "code": 200,
    "msg": "success",
    "request_id": "req‑20260904092211",
    "data": {
        "product_id": "1589623471",
        "offer_id": "SKU‑HEAD‑001",
        "title": "Беспроводные наушники с шумоподавлением",
        "short_description": "Активное шумоподавление, 30 часов работы",
        "description": "<div>Полное описание товара на русском языке</div>",
        "brand": "SoundMax",
        "primary_image": "https://cdn1.ozone.ru/s3/multimedia‑f/6190456071.jpg",
        "images": [
            "https://cdn1.ozone.ru/s3/multimedia‑f/6190456071.jpg",
            "https://cdn1.ozone.ru/s3/multimedia‑7/6190456099.jpg"
        ],
        "video_urls": [],
        "price": "2990.00",
        "old_price": "3990.00",
        "promo_price": "2490.00",
        "currency": "RUB",
        "category_id": "17038062",
        "category_path": ["Электроника","Аудио","Наушники"],
        "attributes": [
            {"name":"Цвет","value":"Черный"},
            {"name":"Время работы","value":"30 часов"}
        ],
        "rating": "4.6",
        "review_count": 9520,
        "sales_30d": 2100,
        "sales_total": 28600,
        "stock_info": {
            "fbo_stock":120,
            "fbs_stock":50,
            "available_stock":170
        },
        "width":120,
        "height":180,
        "depth":60,
        "weight":220,
        "visibility":"VISIBLE",
        "variants": [
            {
                "variant_id":"1589623471‑01",
                "spec_text":"Черный",
                "price":"2990.00",
                "stock_info":{"fbo_stock":80,"fbs_stock":30,"available_stock":110},
                "pic_url":"https://cdn1.ozone.ru/s3/multimedia‑f/v1.jpg"
            },
            {
                "variant_id":"1589623471‑02",
                "spec_text":"Белый",
                "price":"2990.00",
                "stock_info":{"fbo_stock":0,"fbs_stock":10,"available_stock":10},
                "pic_url":"https://cdn1.ozone.ru/s3/multimedia‑f/v2.jpg"
            }
        ]
    }
}

六、Python 伪代码调用示例

import requests
import time

API_KEY = "your_key"
API_SECRET = "your_secret"
API_URL = "https://api‑gw.onebound.cn/ozon.item_get"

def fetch_ozon_item(product_id):
    params = {
        "key": API_KEY,
        "secret": API_SECRET,
        "product_id": product_id
    }
    resp = requests.get(API_URL, params=params, timeout=15)
    return resp.json()

def parse_ozon_product(product_id):
    res = fetch_ozon_item(product_id)
    if res.get("code") != 200:
        print(f"接口调用失败 product_id={product_id}, msg={res.get('msg')}")
        return None
    item = res["data"]
    print(f"商品标题：{item['title']}")
    print(f"售价：{item['price']} {item['currency']}")
    print(f"可售总库存：{item['stock_info']['available_stock']}")
    #遍历变体SKU
    for var in item.get("variants", []):
        print(f"变体规格:{var['spec_text']} 价格:{var['price']} 可售库存:{var['stock_info']['available_stock']}")
    # db.save_product_snapshot(item)
    return item

if __name__ == "__main__":
    parse_ozon_product("1589623471")
    time.sleep(1)

七、开发实战踩坑记录

变体处理是高频故障点 外层 price 仅页面展示价格，每个子变体拥有独立价格、图片、库存；ERP 刊登、竞品监控业务，必须遍历 variants 数组，禁止直接读取外层 price 作为 SKU 价格。
区分 FBO/FBS 双仓库库存 Ozon 分为平台仓 FBO、自发货 FBS，接口会分开返回库存；业务需要读取available_stock真实可售库存，注意区分锁定预留库存，避免误判现货情况。
图片防盗链 返回图片 URL 带防盗链，不可直接前端展示、不可直接提交刊登；业务代码需要下载图片转存自有对象存储，使用转存后的 URL。
俄语字符编码问题 返回标题、描述全部为俄文，请求响应强制使用UTF‑8编码，否则会出现乱码，影响后续翻译、刊登业务。
商品下架不会返回错误码 商品下架、审核中时接口 code 依旧返回 200；依靠visibility字段判断商品有效性，不能只依赖接口返回码。
接口 429 限流风险 Ozon 接口 QPS 存在限制，大批量商品采集必须使用 Redis 任务队列，设置请求间隔、指数退避重试，禁止高并发循环调用。
空值兼容处理 部分商品没有视频、没有促销价、属性为空；代码必须做安全取值，防止定时采集任务空指针崩溃。
原始采集数据不能直接刊登 源商品类目 ID 不能直接复用，需要做类目映射；俄语标题描述需要做格式校验，Ozon 对标题字符长度、字符集有严格审核规则Ozon ...。
快照数据特性 价格、库存为调用瞬间快照，大促期间变动速度快，监控仅作为参考，关键业务建议二次复核。

八、业务落地场景

跨境 ERP 素材采集：拉取 Ozon 商品全套素材，预处理后用于 Temu、Coupang、美客多等平台跨平台刊登。
竞品监控系统：定时抓取竞品价格、评分、库存，价格变动、库存清空触发告警，辅助定价决策。
俄罗斯选品分析：结合评分、评论数量、30 天销量、FBO/FBS 库存，评估赛道竞争热度。
商品情报归档：保存商品历史快照，复盘俄罗斯市场价格走势，做类目调研。

九、小结

Ozon 商品详情 API 是俄罗斯跨境系统重要的数据来源，开发难点集中在变体解析、FBO/FBS 多仓库存处理、俄语文本编码、图片防盗链、类目映射、接口限流管控。接口返回原始数据只能作为素材来源，不能直接提交刊登，生产环境搭配任务队列、快照存储、异常日志，就可以稳定支撑 ERP、竞品监控、选品分析业务。

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

开发经验