京东商品详情API技术解析与落地应用（含标准JSON示例）

原创

Anzexi58

发布于 2026-07-17 15:17:34

220

一、接口概述

京东商品详情API是京东开放平台官方合规数据接口，专为电商服务商、ERP系统、导购平台、选品工具、铺货系统设计。接口支持通过单个商品SKU，快速拉取京东商品全量结构化数据，替代传统爬虫，具备数据稳定、合规安全、格式统一的优势，是京东电商数字化运营的核心基础接口。

接口基础调用规范：

请求网关：o0b.cn/anzexi
请求方式：HTTPS POST
数据格式：标准JSON
鉴权方式：appKey+appSecret 加密签名校验
核心入参：skuId（京东商品唯一ID）

二、核心落地业务场景

该接口数据覆盖京东商品全维度信息，可支撑多类主流电商业务，场景通用、落地性强：

数据选品分析：依托销量、好评率、价格数据，筛选优质潜力货源
CPS导购分销：获取商品售价、优惠券、佣金数据，搭建带货推广体系
跨平台智能铺货：一键采集商品图文、规格、参数，实现多平台商品搬家
ERP货源同步：实时同步SKU价格、库存，杜绝超卖、亏损问题
竞品价格监控：定时监测商品调价、活动变更，实现自动化预警

三、标准成功返回 JSON 完整示例

以下为官方标准脱敏返回数据，包含所有核心业务字段，可直接用于开发解析、测试对接：

{
    "jd_union_open_goods_detail_query_response": {
        "code": "0",
        "msg": "success",
        "requestId": "req_2026071716000889",
        "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": {
                    "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
                }
            }
        }
    }
}

四、核心字段简化释义

精简核心业务字段，快速适配开发与业务使用：

基础信息：skuId（商品唯一ID）、标题、品牌、类目、自营标识、商品链接
价格优惠：原价、日常售价、优惠券金额、券后到手价
分销佣金：佣金比例、单商品预估佣金（CPS核心）
销量库存：总销量、月销量、可售库存、上架状态
素材资源：商品主图、详情图数组（用于铺货、素材采集）
SKU规格：多颜色/尺码子规格、单价、单规格库存
参数口碑：商品材质属性、好评率、评价总数

五、常见异常返回示例

整理高频报错JSON，方便开发异常捕获处理：

1. 签名校验失败

{
    "jd_union_open_goods_detail_query_response": {
        "code": "15",
        "msg": "签名校验错误",
        "requestId": "req_2026071716100111"
    }
}

2. 商品下架/ID无效

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

3. 请求频率限流

{
    "jd_union_open_goods_detail_query_response": {
        "code": "429",
        "msg": "请求过于频繁，请稍后重试",
        "requestId": "req_2026071716100333"
    }
}

六、接入核心注意事项

所有价格字段为字符串格式，金额计算需转换数值类型，避免精度异常
图片、SKU、参数为数组结构，代码需做空值判断，防止解析报错
接口存在QPS限制，批量采集需分级轮询，规避限流问题
库存数据存在短暂延迟，高并发下单场景建议二次实时校验

七、总结

京东联盟商品详情API是一套轻量化、高稳定的标准化数据接口，以统一JSON格式输出商品全维度数据，可一站式满足电商选品、铺货、分销、价格监控、ERP同步等核心需求。相较于爬虫采集，官方接口合规性更强、数据更稳定、维护成本更低，是电商SaaS系统与自研运营工具的首选对接方案。

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

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

api-key

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

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

api-key

登录后参与评论

0 条评论

热度