京东商品详情 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. 主流业务场景竞品价格监控定时抓取同行售价、活动优惠券设置降价预警导购 / 带货系统获取佣金、商品素材、种草文案搭建好物推荐页面跨境 / 多平台铺货批量提取商品参数、图片同步至自有商城商家 ERP 数据同步拉取库存、规格同步进销存系统选品数据分析依托月销、好评率筛选爆款潜力商品二、标准成功返回 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. 无接口调用权限 code403{ jd_union_open_goods_detail_query_response: { code: 403, msg: 接口权限未开通请前往京东联盟后台申请, requestId: req_202607021022006689 } }2. 请求频率超限限流 code429{ jd_union_open_goods_detail_query_response: { code: 429, msg: 请求过于频繁限制访问请间隔3秒重试, requestId: req_202607021023001122 } }3. SKU 无效 / 商品下架 code400{ jd_union_open_goods_detail_query_response: { code: 400, msg: skuId不存在或商品已下架, requestId: req_202607021024009911 } }4. 签名校验失败 code15{ jd_union_open_goods_detail_query_response: { code: 15, msg: 签名校验错误请核对appSecret与参数排序, requestId: req_202607021025003344 } }四、核心字段分类说明1. 顶层通用状态jd_union_open_goods_detail_query_response联盟接口统一外层包裹对象code0正常返回非 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 签名失败库存数据存在短暂延迟不可作为实时精准备货依据仅可用于合规选品、比价、带货数据分析禁止批量抓取倒卖商品数据。