京東商品詳情 API 是獲取商品標題、價格、庫存、SKU、主圖、參數(shù)等核心數(shù)據(jù)的官方合規(guī)入口，分京東開放平臺（JOS）與京東聯(lián)盟兩大體系，適合賣家做商品監(jiān)控、比價、選品、店鋪數(shù)據(jù)同步。下面從接口選型、參數(shù)、返回字段、接入流程、實戰(zhàn)場景做完整詳解。

一、核心接口選型（官方合規(guī)）

京東有兩套詳情接口體系，按業(yè)務場景選擇：

1. 京東開放平臺（JOS）：面向商家 / 服務商

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

適用：店鋪自有商品、服務商 ERP / 商品管理、批量數(shù)據(jù)同步

優(yōu)勢：數(shù)據(jù)最全，含庫存、SKU、參數(shù)、售后、店鋪信息

權(quán)限：需企業(yè)認證、店鋪授權(quán)、接口權(quán)限申請

2. 京東聯(lián)盟：面向推廣 / 選品 / 比價

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

適用：CPS 推廣、選品分析、價格監(jiān)控、比價工具

優(yōu)勢：接入門檻低、含傭金 / 優(yōu)惠券、無需店鋪授權(quán)

限制：庫存多為有貨 / 無貨狀態(tài)，真實庫存需額外申請

3. 補充接口（組合使用更精準）

價格專用：price.get / jd.union.open.price.query：實時售價、促銷價、會員價

庫存專用：stock.get：全國 / 區(qū)域庫存、預售、鎖定庫存

SKU 專用：jd.union.open.goods.skuid.query：按 SKU ID 查規(guī)格與價格

二、核心接口參數(shù)（以聯(lián)盟jd.union.open.goods.detail.query為例）

1. 公共參數(shù)（必填）

表格

2. 業(yè)務參數(shù)（必填）

json

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

三、核心返回字段（標題 / 價格 / 庫存等）

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

表格

2. 價格體系（核心）

表格

3. 庫存與狀態(tài)（關鍵）

表格

4. 規(guī)格與擴展（運營必備）

表格

四、接入全流程（聯(lián)盟版，最快落地）

1. 注冊與認證

訪問 京東聯(lián)盟 注冊并完成個人 / 企業(yè)實名認證

進入 京東開放平臺 創(chuàng)建應用，獲取 App Key / App Secret

2. 申請權(quán)限

在聯(lián)盟開放平臺申請：jd.union.open.goods.detail.query 權(quán)限

基礎權(quán)限默認開放，真實庫存 / 銷量需企業(yè)認證 + 額外申請

3. 簽名生成（HMAC-SHA256）

所有參數(shù)按字典序排序

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

用AppSecret做 HMAC-SHA256 加密，轉(zhuǎn)大寫得到sign

4. 發(fā)起請求（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中的商品數(shù)據(jù)：

json

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

五、實戰(zhàn)場景與價值

1. 商品監(jiān)控（賣家必備）

價格監(jiān)控：實時獲取到手價 / 券后價，自動調(diào)價 / 設置價格預警

庫存監(jiān)控：監(jiān)控自營 / 競品庫存，避免斷貨 / 超賣，及時補貨

差評預警：結(jié)合評論接口，監(jiān)控商品差評，快速響應

2. 選品與競品分析

競品數(shù)據(jù)采集：批量獲取競品標題、價格、銷量、好評率，對比優(yōu)劣勢

價格帶分析：分析類目價格分布，優(yōu)化自身定價策略

爆款挖掘：通過價格 / 銷量 / 好評率篩選潛力爆款

3. 店鋪運營優(yōu)化

Listing 優(yōu)化：提取競品高轉(zhuǎn)化關鍵詞，優(yōu)化標題 / 詳情頁

SKU 管理：同步商品規(guī)格與庫存，ERP 系統(tǒng)自動更新

推廣素材：自動獲取主圖 / 標題 / 價格，生成廣告 / 社媒素材

4. 聯(lián)盟推廣變現(xiàn)

高傭商品篩選：按傭金率 / 優(yōu)惠券 / 銷量排序，鎖定推廣品

推廣鏈接生成：自動拼接推廣鏈接，追蹤 CPS 轉(zhuǎn)化

數(shù)據(jù)報表：生成商品推廣數(shù)據(jù)報表，優(yōu)化推廣策略

六、權(quán)限與限制（重要）

調(diào)用頻率：個人 100 次 / 分鐘，企業(yè) 500 次 / 分鐘（聯(lián)盟）

數(shù)據(jù)范圍：基礎信息免費，真實庫存 / 銷量 / 歷史價格需企業(yè)認證 + 付費

合規(guī)要求：嚴禁數(shù)據(jù)倒賣、高頻惡意請求、違規(guī)使用

七、快速落地建議

優(yōu)先用京東聯(lián)盟接口，接入快、門檻低，適合選品 / 比價 / 推廣

組合使用：detail.query + price.query + stock.get，數(shù)據(jù)更精準

聚焦核心場景：價格監(jiān)控、競品分析、庫存預警，快速見效

配合 Python/Java SDK，簡化簽名與調(diào)用

審核編輯 黃宇