京东商品详情 API完整介绍与标准 JSON 返回示例
一、接口基础说明
1. 基础调用信息
接口名称：
jd.union.open.goods.detail.query（京东联盟标准商品详情接口，对外数据采集通用）网关地址：o0b.cn/anzexi
请求方式：POST
返回格式：固定 JSON
鉴权规则：
appKey + appSecret生成 HMAC-SHA256 签名，传入 timestamp、nonce 防重放核心入参：
skuId（商品唯一 ID，必填），支持单商品查询；批量查商品使用配套批量接口权限：需京东联盟开发者认证，开通接口调用权限
2. 接口核心能力
3. 主流业务场景
竞品价格监控：定时抓取同行售价、活动优惠券，设置降价预警
导购 / 带货系统：获取佣金、商品素材、种草文案搭建好物推荐页面
跨境 / 多平台铺货：批量提取商品参数、图片，同步至自有商城
商家 ERP 数据同步：拉取库存、规格，同步进销存系统
选品数据分析：依托月销、好评率筛选爆款潜力商品
二、标准成功返回 JSON（官方原生完整结构）
json
{
"jd_union_open_goods_detail_query_response": {
"code": "0",
"msg": "success",
"requestId": "req_202607021020001256",
"result": {
"goodsInfo": {
"skuId": "100065474274",
"title": "夏季纯棉宽松短袖女 纯色百搭基础T恤",
"brandName": "简禾",
"categoryName": "女装 > T恤",
"shopName": "简禾官方旗舰店",
"shopType": "third",
"isJdSelf": false,
"itemUrl": "https://item.jd.com/100065474274.html",
"priceInfo": {
"originalPrice": "79.90",
"discountPrice": "59.00"
},
"couponInfo": {
"couponId": "cp12345678",
"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,
"goodCount": 1370,
"generalCount": 35,
"poorCount": 15
}
}
}
}}三、高频异常返回 JSON 示例
1. 无接口调用权限 code=403
json
{
"jd_union_open_goods_detail_query_response": {
"code": "403",
"msg": "接口权限未开通，请前往京东联盟后台申请",
"requestId": "req_202607021022006689"
}}2. 请求频率超限限流 code=429
json
{
"jd_union_open_goods_detail_query_response": {
"code": "429",
"msg": "请求过于频繁，限制访问，请间隔3秒重试",
"requestId": "req_202607021023001122"
}}3. SKU 无效 / 商品下架 code=400
json
{
"jd_union_open_goods_detail_query_response": {
"code": "400",
"msg": "skuId不存在或商品已下架",
"requestId": "req_202607021024009911"
}}4. 签名校验失败 code=15
json
{
"jd_union_open_goods_detail_query_response": {
"code": "15",
"msg": "签名校验错误，请核对appSecret与参数排序",
"requestId": "req_202607021025003344"
}}四、核心字段分类说明
1. 顶层通用状态
jd_union_open_goods_detail_query_response：联盟接口统一外层包裹对象code="0"：正常返回；非 0 为业务错误码requestId：请求流水号，用于日志排查问题result.goodsInfo：商品主体数据容器
2. 商品基础信息
skuId：商品唯一主键，查询核心参数title：商品标题；brandName品牌；categoryName类目路径isJdSelf：是否京东自营；shopName店铺名称itemUrl：商品京东详情页链接
3. 价格、优惠券、佣金（联盟特有）
originalPrice原价、discountPrice当前售价couponInfo优惠券面额、券后到手价commissionInfo佣金比例、预估佣金金额，带货业务核心
4. 销量与库存
salesInfo.totalSales累计销量、monthSales近 30 天销量stockInfo.totalStock总可售库存、isSale商品是否上架售卖
5. 素材与规格
imageInfo主图 + 详情图片数组skuList多颜色 / 尺码子规格 SKU，包含子 skuId、规格名称、单价、库存productParams商品材质、尺寸、功能等属性参数数组
6. 口碑评价
commentSummary好评率、总评价数、好评 / 中评 / 差评数量
五、开发接入注意事项
所有价格字段为字符串格式，业务计算金额需转为浮点型；
skuList、detailImgList、productParams为数组，代码必须做空值判断，避免解析报错；接口存在 QPS 限制，批量采集商品需增加延时，防止触发 429 限流；
签名参数需按字母升序拼接，漏参、顺序错误会直接报 15 签名失败；
库存数据存在短暂延迟，不可作为实时精准备货依据；
仅可用于合规选品、比价、带货数据分析，禁止批量抓取倒卖商品数据。
