京东商品详情 API完整介绍与标准 JSON 返回示例

一、接口基础说明

1. 基础调用信息

  • 接口名称：jd.union.open.goods.detail.query（京东联盟标准商品详情接口，对外数据采集通用）
  • 网关地址：o0b.cn/anzexi
  • 请求方式：POST
  • 返回格式：固定 JSON
  • 鉴权规则：appKey + appSecret生成 HMAC-SHA256 签名，传入 timestamp、nonce 防重放
  • 核心入参：skuId（商品唯一 ID，必填），支持单商品查询；批量查商品使用配套批量接口
  • 权限：需京东联盟开发者认证，开通接口调用权限

2. 接口核心能力

传入商品 SKU 编号，一次性拉取商品基础标题、品牌类目、自营标识、原价 / 促销价 / 券后价、优惠券、佣金、销量、实时库存、主图详情图、多规格 SKU、商品参数、评价口碑、商品链接全套结构化数据，是比价、选品、带货、竞品监控的核心合规接口。

3. 主流业务场景

  1. 竞品价格监控：定时抓取同行售价、活动优惠券，设置降价预警
  2. 导购 / 带货系统：获取佣金、商品素材、种草文案搭建好物推荐页面
  3. 跨境 / 多平台铺货：批量提取商品参数、图片，同步至自有商城
  4. 商家 ERP 数据同步：拉取库存、规格，同步进销存系统
  5. 选品数据分析：依托月销、好评率筛选爆款潜力商品

二、标准成功返回 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

{ "jd_union_open_goods_detail_query_response": { "code": "403", "msg": "接口权限未开通，请前往京东联盟后台申请", "requestId": "req_202607021022006689" } }

2. 请求频率超限限流 code=429

{ "jd_union_open_goods_detail_query_response": { "code": "429", "msg": "请求过于频繁，限制访问，请间隔3秒重试", "requestId": "req_202607021023001122" } }

3. SKU 无效 / 商品下架 code=400

{ "jd_union_open_goods_detail_query_response": { "code": "400", "msg": "skuId不存在或商品已下架", "requestId": "req_202607021024009911" } }

4. 签名校验失败 code=15

{ "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好评率、总评价数、好评 / 中评 / 差评数量

五、开发接入注意事项

  1. 所有价格字段为字符串格式，业务计算金额需转为浮点型；
  2. skuList、detailImgList、productParams为数组，代码必须做空值判断，避免解析报错；
  3. 接口存在 QPS 限制，批量采集商品需增加延时，防止触发 429 限流；
  4. 签名参数需按字母升序拼接，漏参、顺序错误会直接报 15 签名失败；
  5. 库存数据存在短暂延迟，不可作为实时精准备货依据；
  6. 仅可用于合规选品、比价、带货数据分析，禁止批量抓取倒卖商品数据。