京东商品详情API技术解析与落地应用（含标准JSON示例）
一、接口概述
京东商品详情API）是京东开放平台官方合规数据接口，专为电商服务商、ERP系统、导购平台、选品工具、铺货系统设计。接口支持通过单个商品SKU，快速拉取京东商品全量结构化数据，替代传统爬虫，具备数据稳定、合规安全、格式统一的优势，是京东电商数字化运营的核心基础接口。
接口基础调用规范：
请求网关：o0b.cn/anzexi
请求方式：HTTPS POST
数据格式：标准JSON
鉴权方式：appKey+appSecret 加密签名校验
核心入参：skuId（京东商品唯一ID）
二、核心落地业务场景
该接口数据覆盖京东商品全维度信息，可支撑多类主流电商业务，场景通用、落地性强：
数据选品分析：依托销量、好评率、价格数据，筛选优质潜力货源
CPS导购分销：获取商品售价、优惠券、佣金数据，搭建带货推广体系
跨平台智能铺货：一键采集商品图文、规格、参数，实现多平台商品搬家
ERP货源同步：实时同步SKU价格、库存，杜绝超卖、亏损问题
竞品价格监控：定时监测商品调价、活动变更，实现自动化预警
三、标准成功返回 JSON 完整示例
以下为官方标准脱敏返回数据，包含所有核心业务字段，可直接用于开发解析、测试对接：
{
"jd_union_open_goods_detail_query_response": {
"code": "0",
"msg": "success",
"requestId": "req_2026071716000889",
"result": {
"goodsInfo": {
"skuId": "100065474274",
"title": "夏季纯棉宽松短袖女 纯色百搭基础T恤多色可选",
"brandName": "简禾",
"categoryName": "女装 > T恤",
"shopName": "简禾官方旗舰店",
"isJdSelf": false,
"itemUrl": "https://item.jd.com/100065474274.html",
"priceInfo": {
"originalPrice": "79.90",
"discountPrice": "59.00"
},
"couponInfo": {
"couponDiscount": "10.00",
"finalPrice": "49.00",
"couponDesc": "满59减10店铺优惠券"
},
"commissionInfo": {
"commissionRate": "12.50",
"commissionMoney": "6.13"
},
"salesInfo": {
"totalSales": 9650,
"monthSales": 2360
},
"stockInfo": {
"totalStock": 460,
"isSale": true
},
"imageInfo": {
"mainImg": "https://img.jd.com/imgextra/i1/main.jpg",
"detailImgList": [
"https://img.jd.com/imgextra/i1/detail_01.jpg",
"https://img.jd.com/imgextra/i1/detail_02.jpg"
]
},
"skuList": [
{
"skuId": "10006547427401",
"specText": "白色 M",
"skuPrice": "59.00",
"skuStock": 180
},
{
"skuId": "10006547427402",
"specText": "黑色 XL",
"skuPrice": "59.00",
"skuStock": 125
}
],
"productParams": [
{"name": "面料", "value": "100%纯棉"},
{"name": "版型", "value": "宽松常规"},
{"name": "适用季节", "value": "夏季"}
],
"commentSummary": {
"goodRateShow": "96.5",
"commentCount": 1420
}
}
}
}
}四、核心字段简化释义
精简核心业务字段，快速适配开发与业务使用：
基础信息：skuId（商品唯一ID）、标题、品牌、类目、自营标识、商品链接
价格优惠：原价、日常售价、优惠券金额、券后到手价
分销佣金：佣金比例、单商品预估佣金（CPS核心）
销量库存：总销量、月销量、可售库存、上架状态
素材资源：商品主图、详情图数组（用于铺货、素材采集）
SKU规格：多颜色/尺码子规格、单价、单规格库存
参数口碑：商品材质属性、好评率、评价总数
五、常见异常返回示例
整理高频报错JSON，方便开发异常捕获处理：
1. 签名校验失败
{
"jd_union_open_goods_detail_query_response": {
"code": "15",
"msg": "签名校验错误",
"requestId": "req_2026071716100111"
}
}2. 商品下架/ID无效
{
"jd_union_open_goods_detail_query_response": {
"code": "400",
"msg": "skuId不存在或商品已下架",
"requestId": "req_2026071716100222"
}
}3. 请求频率限流
{
"jd_union_open_goods_detail_query_response": {
"code": "429",
"msg": "请求过于频繁，请稍后重试",
"requestId": "req_2026071716100333"
}
}六、接入核心注意事项
所有价格字段为字符串格式，金额计算需转换数值类型，避免精度异常
图片、SKU、参数为数组结构，代码需做空值判断，防止解析报错
接口存在QPS限制，批量采集需分级轮询，规避限流问题
库存数据存在短暂延迟，高并发下单场景建议二次实时校验
七、总结
京东联盟商品详情API是一套轻量化、高稳定的标准化数据接口，以统一JSON格式输出商品全维度数据，可一站式满足电商选品、铺货、分销、价格监控、ERP同步等核心需求。相较于爬虫采集，官方接口合规性更强、数据更稳定、维护成本更低，是电商SaaS系统与自研运营工具的首选对接方案。
