京東商品詳情 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. 公共參數（必填）

表格

2. 業務參數（必填）

json

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

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

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

表格

2. 價格體系（核心）

表格

3. 庫存與狀態（關鍵）

表格

4. 規格與擴展（運營必備）

表格

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

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，簡化簽名與調用

審核編輯 黃宇