京东商品详情API接口详解：获取商品标题、价格、库存等核心数据

京东商品详情 API 是获取商品标题、价格、库存、SKU、主图、参数等核心数据的官方合规入口，分京东开放平台（JOS）与京东联盟两大体系，适合卖家做商品监控、比价、选品、店铺数据同步。下面从接口选型、参数、返回字段、接入流程、实战场景做完整详解。

一、核心接口选型（官方合规）

京东有两套详情接口体系，按业务场景选择：

1. 京东开放平台（JOS）：面向商家 / 服务商

核心接口：jingdong.item.read.get（旧版item.jd.get）

适用：店铺自有商品、服务商 ERP / 商品管理、批量数据同步

优势：数据最全，含库存、SKU、参数、售后、店铺信息

权限：需企业认证、店铺授权、接口权限申请

2. 京东联盟：面向推广 / 选品 / 比价

核心接口：jd.union.open.goods.detail.query

适用：CPS 推广、选品分析、价格监控、比价工具

优势：接入门槛低、含佣金 / 优惠券、无需店铺授权

限制：库存多为有货 / 无货状态，真实库存需额外申请

3. 补充接口（组合使用更精准）

价格专用：price.get / jd.union.open.price.query：实时售价、促销价、会员价

库存专用：stock.get：全国 / 区域库存、预售、锁定库存

SKU 专用：jd.union.open.goods.skuid.query：按 SKU ID 查规格与价格

二、核心接口参数（以联盟jd.union.open.goods.detail.query为例）

1. 公共参数（必填）

表格

参数名	类型	说明
app_key	String	应用唯一标识（开放平台创建应用获取）
method	String	接口名：jd.union.open.goods.detail.query
timestamp	Long	毫秒级时间戳
sign	String	HMAC-SHA256 签名（核心）
access_token	String	联盟授权令牌（短期有效）
format	String	固定json
v	String	版本号（如1.0）

2. 业务参数（必填）

json

{
  "goodsReq": {
    "skuId": "100012345678" // 商品ID（URL中item.jd.com/xxxx.html的xxxx）
  }
}

三、核心返回字段（标题 / 价格 / 库存等）

1. 商品基础信息（必用）

表格

字段	说明	示例
skuId	商品 ID	100012345678
title	商品标题	华为 Mate 60 Pro 12GB+512GB 雅川青
subTitle	副标题	旗舰芯片 卫星通信
brandName	品牌	华为
shopName	店铺名	华为京东自营旗舰店
isSelf	是否自营	1（是）/0（否）
imageUrl	主图 URL	https://img14.360buyimg.com/xxx.jpg

2. 价格体系（核心）

表格

字段	说明
price	京东价（原价）
lowPrice	到手价（促销后）
couponPrice	券后价
commissionRate	佣金率（联盟）
promotionList	促销活动列表（满减 / 折扣）

3. 库存与状态（关键）

表格

字段	说明
stockState	库存状态（1 = 有货，0 = 无货）
isPreSale	是否预售（1 = 是）
preSaleEndTime	预售结束时间
stockNum	可售库存（开放平台接口）
lockStock	锁定库存（开放平台接口）

4. 规格与扩展（运营必备）

表格

字段	说明
skuList	SKU 列表（颜色 / 尺码 / 配置）
specInfo	规格参数（材质 / 尺寸 / 功能）
category	分类路径（一级 / 二级 / 三级）
commentCount	评论数
goodRate	好评率

四、接入全流程（联盟版，最快落地）

1. 注册与认证

访问 京东联盟 注册并完成个人 / 企业实名认证

进入 京东开放平台 创建应用，获取 App Key / App Secret

2. 申请权限

在联盟开放平台申请：jd.union.open.goods.detail.query 权限

基础权限默认开放，真实库存 / 销量需企业认证 + 额外申请

3. 签名生成（HMAC-SHA256）

所有参数按字典序排序

拼接为key1=value1&key2=value2...

用AppSecret做 HMAC-SHA256 加密，转大写得到sign

4. 发起请求（POST）

URL：https://api.jd.com/routerjson

Content-Type：application/json

示例请求体：

json

{
  "method": "jd.union.open.goods.detail.query",
  "app_key": "your_app_key",
  "timestamp": 1740900000000,
  "sign": "your_sign",
  "access_token": "your_token",
  "format": "json",
  "v": "1.0",
  "goodsReq": {
    "skuId": "100012345678"
  }
}

5. 解析响应

返回 JSON，提取result中的商品数据：

json

{
  "code": 0,
  "result": {
    "skuId": "100012345678",
    "title": "华为Mate 60 Pro...",
    "price": 6999,
    "lowPrice": 6799,
    "stockState": 1,
    "isSelf": 1,
    "skuList": [...]
  }
}

五、实战场景与价值

1. 商品监控（卖家必备）

价格监控：实时获取到手价 / 券后价，自动调价 / 设置价格预警

库存监控：监控自营 / 竞品库存，避免断货 / 超卖，及时补货

差评预警：结合评论接口，监控商品差评，快速响应

2. 选品与竞品分析

竞品数据采集：批量获取竞品标题、价格、销量、好评率，对比优劣势

价格带分析：分析类目价格分布，优化自身定价策略

爆款挖掘：通过价格 / 销量 / 好评率筛选潜力爆款

3. 店铺运营优化

Listing 优化：提取竞品高转化关键词，优化标题 / 详情页

SKU 管理：同步商品规格与库存，ERP 系统自动更新

推广素材：自动获取主图 / 标题 / 价格，生成广告 / 社媒素材

4. 联盟推广变现

高佣商品筛选：按佣金率 / 优惠券 / 销量排序，锁定推广品

推广链接生成：自动拼接推广链接，追踪 CPS 转化

数据报表：生成商品推广数据报表，优化推广策略

六、权限与限制（重要）

调用频率：个人 100 次 / 分钟，企业 500 次 / 分钟（联盟）

数据范围：基础信息免费，真实库存 / 销量 / 历史价格需企业认证 + 付费

合规要求：严禁数据倒卖、高频恶意请求、违规使用

七、快速落地建议

优先用京东联盟接口，接入快、门槛低，适合选品 / 比价 / 推广

组合使用：detail.query + price.query + stock.get，数据更精准

聚焦核心场景：价格监控、竞品分析、库存预警，快速见效

配合 Python/Java SDK，简化签名与调用

审核编辑 黄宇