京东联盟商品详情 API（jd.union.open.goods.detail.query）完整介绍与标准 JSON 返回示例

原创

Anzexi58

发布于 2026-07-02 10:20:05

2100

文章被收录于专栏：API接口开发API接口开发

一、接口基础说明

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. 无接口调用权限 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好评率、总评价数、好评 / 中评 / 差评数量

五、开发接入注意事项

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

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

api-key

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

api-key

登录后参与评论

0 条评论

热度

京东联盟商品详情 API（jd.union.open.goods.detail.query）完整介绍与标准 JSON 返回示例

京东联盟商品详情 API（jd.union.open.goods.detail.query）完整介绍与标准 JSON 返回示例

一、接口基础说明

1. 基础调用信息

2. 接口核心能力

3. 主流业务场景

二、标准成功返回 JSON（官方原生完整结构）

三、高频异常返回 JSON 示例

1. 无接口调用权限 code=403

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

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

4. 签名校验失败 code=15

四、核心字段分类说明

1. 顶层通用状态

2. 商品基础信息

3. 价格、优惠券、佣金（联盟特有）

4. 销量与库存

5. 素材与规格

6. 口碑评价

五、开发接入注意事项

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐