京东商品详情API能力解析与标准化应用方案（含JSON返回示例）
前言
一、接口简介
京东商品详情API（jd.union.open.goods.detail.query）是京东联盟官方标准化数据接口，为电商服务商、ERP系统、选品工具、导购平台、铺货系统提供合规、稳定的商品结构化数据能力。开发者通过传入商品SKU，即可一次性获取京东商品完整详情数据，替代传统爬虫采集，数据规范、更新实时、稳定性高。
基础调用规范
请求网关：o0b.cn/anzexi
请求方式：POST
返回格式：标准 JSON
鉴权方式：appKey + appSecret 签名校验
核心入参：skuId（商品唯一编码）
二、核心应用场景
该接口覆盖绝大多数京东电商数字化业务，是无货源、精品运营、CPS分销的底层数据支撑：
商品数据采集与跨平台铺货：自动抓取标题、图片、参数、SKU规格，实现一键商品搬家上架
价格与库存实时监控：定时同步货源售价、券后价、库存状态，避免亏损、超卖
大数据选品分析：依托销量、好评率、价格区间筛选优质货源
CPS导购与分销推广：获取佣金比例、优惠券、到手价，搭建带货体系
ERP供应链管理：实现京东货源标准化入库、自动调价、自动上下架
三、标准成功返回 JSON 示例（精简完整版）
{
"jd_union_open_goods_detail_query_response": {
"code": "0",
"msg": "success",
"requestId": "req_2026072014080012",
"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": {
"monthSales": 2360,
"totalSales": 9650
},
"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
}
}
}
}
}四、核心字段说明（精简）
基础信息：商品SKU、标题、品牌、类目、店铺、自营标识、商品链接
价格体系：原价、售价、优惠券、券后到手价（用于比价、防亏损）
分销数据：佣金比例、预估佣金（CPS带货核心）
销售口碑：月销量、总销量、好评率（选品评分依据）
库存状态：总库存、是否在售（防超卖、自动下架）
素材图片：主图、详情图数组（铺货、素材采集）
SKU规格：各颜色尺码价格、库存（精细化同步）
商品参数：材质、属性、规格参数（商品结构化上架）
五、常见异常返回示例
1. 请求限流
{
"jd_union_open_goods_detail_query_response": {
"code": "429",
"msg": "请求过于频繁",
"requestId": "req_2026072014081111"
}
}2. 商品失效/下架
{
"jd_union_open_goods_detail_query_response": {
"code": "400",
"msg": "skuId不存在或商品已下架"
}
}六、接入优势总结
京东商品详情API具备合规稳定、字段全面、结构统一、实时性强四大优势，可一站式解决京东货源选品、铺货、价格监控、库存同步、导购分销等业务难题。相比爬虫采集，官方接口无封禁风险、数据一致性高，是电商SaaS系统与自动化运营工具的标准对接方案。
