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

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

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

1. 京東開放平臺(tái)（JOS）：面向商家 / 服務(wù)商

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

適用：店鋪?zhàn)杂猩唐?、服?wù)商 ERP / 商品管理、批量數(shù)據(jù)同步

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

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

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

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

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

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

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

3. 補(bǔ)充接口（組合使用更精準(zhǔn)）

價(jià)格專用：price.get / jd.union.open.price.query：實(shí)時(shí)售價(jià)、促銷價(jià)、會(huì)員價(jià)

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

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

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

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

表格

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

json

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

三、核心返回字段（標(biāo)題 / 價(jià)格 / 庫存等）

1. 商品基礎(chǔ)信息（必用）

表格

2. 價(jià)格體系（核心）

表格

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

表格

4. 規(guī)格與擴(kuò)展（運(yùn)營(yíng)必備）

表格

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

1. 注冊(cè)與認(rèn)證

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

進(jìn)入 京東開放平臺(tái) 創(chuàng)建應(yīng)用，獲取 App Key / App Secret

2. 申請(qǐng)權(quán)限

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

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

3. 簽名生成（HMAC-SHA256）

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

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

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

4. 發(fā)起請(qǐng)求（POST）

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

Content-Type：application/json

示例請(qǐng)求體：

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. 解析響應(yīng)

返回 JSON，提取result中的商品數(shù)據(jù)：

json

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

五、實(shí)戰(zhàn)場(chǎng)景與價(jià)值

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

價(jià)格監(jiān)控：實(shí)時(shí)獲取到手價(jià) / 券后價(jià)，自動(dòng)調(diào)價(jià) / 設(shè)置價(jià)格預(yù)警

庫存監(jiān)控：監(jiān)控自營(yíng) / 競(jìng)品庫存，避免斷貨 / 超賣，及時(shí)補(bǔ)貨

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

2. 選品與競(jìng)品分析

競(jìng)品數(shù)據(jù)采集：批量獲取競(jìng)品標(biāo)題、價(jià)格、銷量、好評(píng)率，對(duì)比優(yōu)劣勢(shì)

價(jià)格帶分析：分析類目?jī)r(jià)格分布，優(yōu)化自身定價(jià)策略

爆款挖掘：通過價(jià)格 / 銷量 / 好評(píng)率篩選潛力爆款

3. 店鋪運(yùn)營(yíng)優(yōu)化

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

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

推廣素材：自動(dòng)獲取主圖 / 標(biāo)題 / 價(jià)格，生成廣告 / 社媒素材

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

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

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

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

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

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

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

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

七、快速落地建議

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

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

聚焦核心場(chǎng)景：價(jià)格監(jiān)控、競(jìng)品分析、庫存預(yù)警，快速見效

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

審核編輯 黃宇