京東商品評(píng)論數(shù)據(jù)的獲取需通過京東開放平臺(tái)（JD Open Platform） 的官方 API 接口，主要適用于商家獲取自有店鋪商品評(píng)論或經(jīng)授權(quán)的競(jìng)品評(píng)論數(shù)據(jù)。以下是接口申請(qǐng)流程、調(diào)用說明及實(shí)戰(zhàn)示例，幫助開發(fā)者合規(guī)高效地獲取評(píng)論數(shù)據(jù)：
一、接口申請(qǐng)前提與準(zhǔn)備
1. 開發(fā)者資質(zhì)要求
- 賬號(hào)類型：需注冊(cè)京東開放平臺(tái)開發(fā)者賬號(hào)（官網(wǎng)入口），個(gè)人開發(fā)者僅能調(diào)用基礎(chǔ)接口，企業(yè)開發(fā)者可申請(qǐng)更高級(jí)權(quán)限。
- 認(rèn)證要求：完成企業(yè)實(shí)名認(rèn)證（需營(yíng)業(yè)執(zhí)照、法人信息等），未認(rèn)證賬號(hào)無法申請(qǐng)?jiān)u論相關(guān)接口。
- 應(yīng)用場(chǎng)景：需明確接口使用場(chǎng)景（如 “店鋪運(yùn)營(yíng)分析”“用戶反饋管理” 等），京東會(huì)審核場(chǎng)景合理性。
二、接口申請(qǐng)流程（詳細(xì)步驟）
1. 注冊(cè)與登錄
- 訪問京東開放平臺(tái)，注冊(cè)開發(fā)者賬號(hào)并登錄，進(jìn)入 “開發(fā)者中心”。
2. 創(chuàng)建應(yīng)用
- 點(diǎn)擊 “創(chuàng)建應(yīng)用”，選擇應(yīng)用類型（“自研應(yīng)用” 用于自身業(yè)務(wù)，“第三方應(yīng)用” 用于為其他商家提供服務(wù)）。
- 填寫應(yīng)用名稱、描述、圖標(biāo)等信息，提交審核（1-3 個(gè)工作日審核通過）。
3. 申請(qǐng)?jiān)u論接口權(quán)限
- 應(yīng)用創(chuàng)建后，在 “接口管理” 中搜索 **“商品評(píng)價(jià) API”**（核心接口為
jd.item_review，適用于聯(lián)盟場(chǎng)景；商家店鋪評(píng)論用item_review）。 - 點(diǎn)擊 “申請(qǐng)權(quán)限”，提交使用場(chǎng)景說明（需詳細(xì)描述用途，如 “獲取自有商品評(píng)論以優(yōu)化產(chǎn)品”），等待京東審核（3-5 個(gè)工作日）。
4. 獲取訪問憑證
- 審核通過后，在應(yīng)用詳情頁獲取
appKey和appSecret（用于接口簽名）。 - 調(diào)用接口前需通過
oauth2.0獲取access_token（有效期 24 小時(shí)，需定期刷新）。
三、核心評(píng)論接口詳解（以item_review為例）
1. 接口功能
獲取商家自有店鋪商品的評(píng)論列表，包含評(píng)論內(nèi)容、評(píng)分、曬圖、購(gòu)買屬性等信息。
2. 請(qǐng)求參數(shù)（核心）
| 參數(shù)名 | 類型 | 必須 | 說明 |
|---|---|---|---|
access_token | string | 是 | 訪問令牌（通過 oauth2.0 獲取） |
productId | string | 是 | 商品 ID（京東商品唯一標(biāo)識(shí)，如100012345678） |
pageNum | int | 是 | 頁碼（默認(rèn) 1，最多支持 50 頁） |
pageSize | int | 是 | 每頁條數(shù)（1-100，默認(rèn) 20） |
score | int | 否 | 評(píng)分篩選（0 = 全部，1=1 星，2=2 星，3=3 星，4=4 星，5=5 星） |
startTime | string | 否 | 開始時(shí)間（格式yyyy-MM-dd HH:mm:ss，查詢近 3 個(gè)月內(nèi)數(shù)據(jù)） |
3. 簽名生成規(guī)則
京東 API 采用HMAC-SHA256簽名算法，步驟如下：
- 按參數(shù)名 ASCII 升序排列所有請(qǐng)求參數(shù)（含
appKey、timestamp等公共參數(shù)）。 - 拼接為
key=value&key=value形式（如appKey=123&pageNum=1&...）。 - 用
appSecret對(duì)拼接字符串進(jìn)行 HMAC-SHA256 加密，轉(zhuǎn)為大寫即為sign。
四、接口調(diào)用示例（Python）
import requests
import time
import hmac
import hashlib
import urllib.parse
# 配置信息
app_key = "你的appKey"
app_secret = "你的appSecret"
access_token = "你的access_token"
product_id = "100012345678" # 目標(biāo)商品ID
# 公共參數(shù)
params = {
"app_key": app_key,
"access_token": access_token,
"method": "biz.product.review.list", # 接口方法名
"timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
"format": "json",
"v": "1.0",
"productId": product_id,
"pageNum": 1,
"pageSize": 20
}
# 生成簽名
sorted_params = sorted(params.items(), key=lambda x: x[0])
sign_str = "&".join([f"{k}={urllib.parse.quote_plus(str(v))}" for k, v in sorted_params])
signature = hmac.new(app_secret.encode(), sign_str.encode(), hashlib.sha256).hexdigest().upper()
params["sign"] = signature
# 發(fā)送請(qǐng)求
url = "https://api.jd.com/routerjson"
response = requests.post(url, data=params)
result = response.json()
# 解析結(jié)果
if result.get("code") == 0:
reviews = result["result"]["reviews"] # 評(píng)論列表
for review in reviews:
print(f"用戶昵稱: {review['nickname']}")
print(f"評(píng)分: {review['score']}星")
print(f"評(píng)論內(nèi)容: {review['content']}")
print(f"評(píng)論時(shí)間: {review['creationTime']}")
print(f"曬圖數(shù)量: {len(review.get('images', []))}")
print("---")
else:
print(f"調(diào)用失敗: {result.get('msg')}，錯(cuò)誤碼: {result.get('code')}")
五、返回值核心字段解析
| 字段名 | 說明 | 業(yè)務(wù)價(jià)值 |
|---|---|---|
score | 評(píng)分（1-5 星） | 統(tǒng)計(jì)商品平均評(píng)分，分析口碑 |
content | 評(píng)論內(nèi)容（純文本，無 HTML 標(biāo)簽） | 提取關(guān)鍵詞（如 “質(zhì)量好”“物流快”），優(yōu)化產(chǎn)品 / 服務(wù) |
creationTime | 評(píng)論時(shí)間（yyyy-MM-dd HH:mm:ss） | 分析評(píng)論時(shí)間分布，判斷近期產(chǎn)品問題 |
images | 曬圖 URL 數(shù)組（如["https://img10.360buyimg.com/...jpg"]） | 展示用戶真實(shí)使用場(chǎng)景，輔助選品 |
productAttr | 購(gòu)買屬性（如 “顏色：黑色；尺寸：XL”） | 分析不同規(guī)格的用戶評(píng)價(jià)差異 |
usefulVoteCount | 有用投票數(shù)（其他用戶認(rèn)為該評(píng)論有幫助的次數(shù)） | 篩選高價(jià)值評(píng)論，優(yōu)先參考 |
六、使用限制與合規(guī)說明
- 調(diào)用頻率限制：企業(yè)開發(fā)者默認(rèn)配額：100 次 / 分鐘，10000 次 / 天，超額返回429錯(cuò)誤。如需更高配額，可在開放平臺(tái)提交 “配額提升申請(qǐng)”，附業(yè)務(wù)場(chǎng)景說明。
- 數(shù)據(jù)范圍限制：僅能獲取自有店鋪商品的評(píng)論（京東嚴(yán)格限制跨店鋪數(shù)據(jù)訪問）。評(píng)論數(shù)據(jù)最長(zhǎng)可獲取近 3 個(gè)月，歷史數(shù)據(jù)無法追溯。
- 合規(guī)要求：數(shù)據(jù)僅可用于自身店鋪運(yùn)營(yíng)分析，不得轉(zhuǎn)售、公開或用于競(jìng)品攻擊。需在應(yīng)用中明確標(biāo)注 “數(shù)據(jù)來源：京東開放平臺(tái)”，遵守《京東開放平臺(tái)開發(fā)者協(xié)議》。
- 錯(cuò)誤處理：常見錯(cuò)誤碼：10001（權(quán)限不足）、20002（商品 ID 不存在）、40001（簽名錯(cuò)誤），需根據(jù)msg字段排查問題。
七、典型應(yīng)用場(chǎng)景
- 用戶反饋分析：通過評(píng)論關(guān)鍵詞提?。ㄈ?“卡頓”“掉漆”），定位產(chǎn)品缺陷，推動(dòng)迭代。
- 口碑監(jiān)控：實(shí)時(shí)跟蹤新商品的評(píng)分變化，當(dāng)平均評(píng)分低于 4.0 時(shí)觸發(fā)預(yù)警。
- 內(nèi)容運(yùn)營(yíng)：篩選優(yōu)質(zhì)曬圖評(píng)論，經(jīng)用戶授權(quán)后用于店鋪詳情頁 “買家秀” 板塊，提升轉(zhuǎn)化率。
- 通過官方 API 獲取京東商品評(píng)論，既能保證數(shù)據(jù)的合規(guī)性與穩(wěn)定性，又能精準(zhǔn)支撐店鋪運(yùn)營(yíng)決策。實(shí)際使用中需注意簽名正確性、頻率控制及數(shù)據(jù)安全，避免因違規(guī)導(dǎo)致權(quán)限封禁。
