京东商品详情 API 介绍、业务场景与完整 JSON 返回参考

前言

一、接口简介

京东商品详情 API（联盟接口jd.union.open.goods.detail.query、商家接口jingdong.item.read.get），通过 SKU 编号查询商品完整信息，HTTPS 签名鉴权，返回标准 JSON，可获取价格、库存、SKU 规格、图片、店铺、销量、参数等全量商品数据，是合规获取京东商品数据的核心接口。

二、主流业务实战场景

竞品价格监控 定时抓取同行商品原价、促销价、优惠券，设置降价预警，及时调整自身定价与活动。
导购 / 比价工具开发 同步商品图片、售价、佣金链接，搭建好物推荐、全网比价小程序。
商家 ERP 商品同步 店铺后台批量拉取商品参数、规格、库存，自动同步到进销存系统。
市场选品分析 依据销量、好评率、规格库存，筛选潜力爆款，辅助采购与上新。
内容带货素材采集 提取商品主图、卖点、参数，用于短视频、图文带货内容制作。

三、完整 JSON 返回示例

成功返回数据

复制代码

{
    "code": "0",
    "msg": "success",
    "result": {
        "skuId": "100065474274",
        "title": "夏季纯棉宽松短袖女百搭纯色基础T恤",
        "brandName": "简禾",
        "categoryName": "女装>T恤",
        "shopName": "简禾官方旗舰店",
        "shopType": "第三方店铺",
        "originalPrice": "79.90",
        "discountPrice": "59.00",
        "promotionInfo": "满99减20，两件8折",
        "salesInfo": {
            "totalSales": 9650,
            "monthSales": 2360
        },
        "stockInfo": {
            "totalStock": 460,
            "isSale": true
        },
        "imageInfo": {
            "mainImg": "https://img.jd.com/imgextra/i1/xxx_main.jpg",
            "detailImgList": [
                "https://img.jd.com/imgextra/i1/xxx_1.jpg",
                "https://img.jd.com/imgextra/i1/xxx_2.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": "宽松常规"}
        ],
        "commentSummary": {
            "goodRate": "96.5%",
            "totalComment": 1420
        },
        "itemUrl": "https://item.jd.com/100065474274.html"
    }
}

异常错误返回

复制代码

// 接口权限未开通
{
    "code": "403",
    "msg": "暂无该接口调用权限，请前往开放平台申请"
}

// 调用频率超限限流
{
    "code": "429",
    "msg": "请求过于频繁，请间隔3秒后重试"
}

// SKU编号不存在
{
    "code": "400",
    "msg": "skuId无效，商品已下架或编号错误"
}

四、核心字段简单说明

基础信息 skuId：商品唯一标识；title商品标题；brandName品牌；shopName店铺名称
价格促销 originalPrice原价；discountPrice实时售价；promotionInfo活动说明
销量库存 totalSales总销量；totalStock总库存；isSale是否正常售卖
规格素材 skuList所有尺码颜色规格；mainImg主图；detailImgList详情多图
口碑数据 goodRate好评率；totalComment商品总评价数

五、简易开发注意事项

依靠skuId作为查询与数据去重唯一主键；
解析图片、SKU 数组时做好空值判断，防止程序报错；
接口存在 QPS 限制，批量采集需增加请求间隔；
库存数据存在轻微延迟，不能作为精准实时备货依据。