京东商品详情 API 介绍、业务场景与完整 JSON 返回参考
一、接口简介
京东商品详情 API（联盟接口
jd.union.open.goods.detail.query、商家接口jingdong.item.read.get），通过 SKU 编号查询商品完整信息，HTTPS 签名鉴权，返回标准 JSON，可获取价格、库存、SKU 规格、图片、店铺、销量、参数等全量商品数据，是合规获取京东商品数据的核心接口。二、主流业务实战场景
竞品价格监控
定时抓取同行商品原价、促销价、优惠券，设置降价预警，及时调整自身定价与活动。
导购 / 比价工具开发
同步商品图片、售价、佣金链接，搭建好物推荐、全网比价小程序。
商家 ERP 商品同步
店铺后台批量拉取商品参数、规格、库存，自动同步到进销存系统。
市场选品分析
依据销量、好评率、规格库存，筛选潜力爆款，辅助采购与上新。
内容带货素材采集
提取商品主图、卖点、参数，用于短视频、图文带货内容制作。
三、完整 JSON 返回示例
成功返回数据
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"
}}异常错误返回
json
// 接口权限未开通{
"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 限制，批量采集需增加请求间隔；
库存数据存在轻微延迟，不能作为精准实时备货依据。
