京东评论接口实战指南:从官方 API 接入到评论数据深度分析
一、为什么需要京东评论接口?
在电商运营中,商品评论是用户真实反馈的黄金数据源。一条差评可能在数小时内影响数百人的购买决策,而逐条手动翻页查看评论不仅效率极低,更无法做到规模化分析。通过京东评论接口,可以程序化获取商品评价数据,实现:
- 口碑监控:实时追踪自家商品和竞品的用户反馈
- 产品迭代:从海量评论中提取用户痛点,指导产品改进
- 竞品分析:对比同类商品的好评率、差评集中点
- 舆情预警:自动识别负面关键词,分钟级响应危机
京东评论接口主要分为两类:京东开放平台官方 API(合规、稳定、推荐)和前端评论接口(需爬虫,存在反爬风险)。本文重点讲解官方 API 的接入与实战。
二、接入准备:账号、权限与密钥
2.1 注册与认证
- 访问 京东开放平台,注册开发者账号
- 完成实名认证(企业用户需提交营业执照 + 近 3 个月经营流水)
- 创建应用,选择「自研应用」或「联盟应用」类型
2.2 申请接口权限
2026 年京东开放平台实行权限分级新规,评论接口权限如下:
表格
| 权限等级 | 适用人群 | 可获取数据 | QPS 限制 | 申请要求 |
|---|---|---|---|---|
| 基础权限 | 个人开发者 | 商品名称、价格、主图、基础销量、评价摘要 | 5 | 实名认证 |
| 进阶权限 | 企业用户 | + 促销详情、评价原文、店铺评分、优惠券 | 20 | 企业营业执照 |
| 高级权限 | 联盟合作伙伴 | + 实时销量、商品成长指数、点击转化率 | 60 | 数据用途承诺书 |
⚠️ 注意:评价原文需单独申请权限,评论数据默认仅返回近 180 天 的用户评价。
2.3 获取密钥
审核通过后,在应用管理后台获取:
App Key:应用标识App Secret:签名密钥Access Token:OAuth2.0 访问令牌
三、接口详解与核心参数
3.1 接口基础信息
表格
| 项目 | 说明 |
|---|---|
| 接口方法 | jd.union.open.goods.comment.query(联盟版)/ jd.item.review(通用版) |
| 网关地址 | https://api.jd.com/routerjson |
| 传输协议 | HTTPS,推荐 POST(参数量大防截断) |
| 返回格式 | JSON |
| 鉴权方式 | AppKey + AppSecret MD5 签名 + AccessToken OAuth2.0 双鉴权 |
| 单页上限 | 50-100 条/页 |
| 总量限制 | 通常限制 1000 条/商品 |
| 数据时效 | 近 180 天 |
3.2 公共请求参数(所有 JOS 接口通用)
表格
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
method | String | 是 | 接口方法名,如 jd.union.open.goods.comment.query |
app_key | String | 是 | 应用分配的 App Key |
access_token | String | 是 | OAuth 授权令牌 |
timestamp | String | 是 | 请求时间戳,格式 yyyy-MM-dd HH:mm:ss |
format | String | 否 | 返回格式,固定 json |
v | String | 否 | 接口版本,固定 2.0 |
sign_method | String | 否 | 签名方法,固定 md5 |
param_json | String | 是 | 业务入参 JSON 字符串 |
sign | String | 是 | 参数字典序 MD5 签名 |
3.3 业务参数(param_json 内)
表格
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
skuId | String | 是 | 京东商品 SKU 编号 |
pageIndex | Int | 是 | 页码,从 1 开始 |
pageSize | Int | 是 | 每页条数,最大 100 |
score | Int | 否 | 评分筛选:0-全部,1-差评,2-中评,3-好评,4-晒单,5-视频评价 |
isImage | Int | 否 | 是否只查带图评论:0-全部,1-带图 |
needAfterReview | Int | 否 | 是否需要追评:0-不需要,1-需要 |
3.4 核心返回字段
JSON
{
"commentId": "评论唯一ID",
"content": "评论正文",
"rating": 5,
"creationTime": "2026-07-15 14:30:00",
"skuAttr": "颜色:黑色;尺码:XL",
"pictures": ["图片URL1", "图片URL2"],
"afterSaleReview": {
"content": "追评内容",
"creationTime": "2026-07-20 10:00:00"
},
"userNickName": "匿名用户",
"userLevel": "PLUS会员"}四、Python 实战:从接口调用到全量采集
4.1 MD5 签名生成(核心且易踩坑)点击测试获取key
京东 API 的签名规则是:AppSecret 放首尾,中间按参数名字典序拼接 key+value,最后整体 MD5 加密转大写。这是新手最容易出错的地方。
Python
import hashlibimport jsonimport timeimport requests
APP_KEY = "你的AppKey"APP_SECRET = "你的AppSecret"ACCESS_TOKEN = "你的AccessToken"API_URL = "https://api.jd.com/routerjson"def generate_sign(params: dict, app_secret: str) -> str:
"""
京东 API MD5 签名生成
规则:app_secret + 按key排序后的keyvalue拼接 + app_secret,整体MD5转大写
"""
# 过滤空值,按key字典序排序
sorted_items = sorted(
[(k, v) for k, v in params.items() if v is not None and v != ""],
key=lambda x: x[0]
)
# 拼接签名字符串
sign_str = app_secret for k, v in sorted_items:
sign_str += f"{k}{v}"
sign_str += app_secret
# MD5加密并转大写
return hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper()def fetch_comments_page(sku_id: str, page: int = 1, page_size: int = 20, score: int = 0):
"""
单页评论采集
"""
# 业务参数
biz_params = {
"skuId": sku_id,
"pageIndex": page,
"pageSize": page_size,
"score": score,
"isImage": 0,
"needAfterReview": 1
}
# 公共参数
common_params = {
"app_key": APP_KEY,
"method": "jd.union.open.goods.comment.query",
"timestamp": time.strftime("%Y-%m-%d %H:%M:%S"),
"format": "json",
"v": "2.0",
"sign_method": "md5",
"access_token": ACCESS_TOKEN,
"param_json": json.dumps(biz_params, separators=(",", ":"))
}
# 生成签名(注意:签名时不包含 sign 字段本身)
common_params["sign"] = generate_sign(common_params, APP_SECRET)
try:
response = requests.get(API_URL, params=common_params, timeout=15)
data = response.json()
# 解析响应
result = data.get("jd_union_open_goods_comment_query_res", {}).get("result", {})
comments = result.get("comments", [])
return {
"comments": comments,
"total": result.get("totalCount", 0),
"good_rate": result.get("goodRate", 0)
}
except Exception as e:
print(f"请求失败:{e}")
return {"comments": [], "total": 0, "good_rate": 0}4.2 全量评论采集(自动分页 + 流控)
Python
import pandas as pdfrom time import sleepdef crawl_all_comments(sku_id: str, max_pages: int = 50, score: int = 0):
"""
全量采集商品评论,自动分页,带流控和容错
"""
all_comments = []
page = 1
print(f"开始采集商品 {sku_id} 的评论...")
while page <= max_pages:
result = fetch_comments_page(sku_id, page=page, score=score)
comments = result.get("comments", [])
if not comments:
print(f"第 {page} 页无数据,采集结束")
break
for c in comments:
after = c.get("afterSaleReview") or {}
row = {
"comment_id": c.get("commentId"),
"sku_id": sku_id,
"star": c.get("rating", 5),
"content": c.get("content", ""),
"after_comment": after.get("content", ""),
"spec": c.get("skuAttr", ""),
"create_time": c.get("creationTime"),
"has_img": 1 if c.get("pictures") else 0,
"user_nick": c.get("userNickName", ""),
"user_level": c.get("userLevel", "")
}
all_comments.append(row)
print(f"第 {page} 页采集完成,本页 {len(comments)} 条,累计 {len(all_comments)} 条")
# 流控:避免触发限流,每页间隔 0.5-1 秒
sleep(0.6)
page += 1
df = pd.DataFrame(all_comments)
df.to_csv(f"jd_comments_{sku_id}.csv", index=False, encoding="utf-8-sig")
print(f"采集完成!共 {len(df)} 条评论,已保存至 jd_comments_{sku_id}.csv")
return dfif __name__ == "__main__":
# 示例:采集 iPhone 16 的评论(替换为真实 SKU)
df = crawl_all_comments(sku_id="100012043978", max_pages=20)五、数据清洗与 NLP 深度分析
采集到原始评论后,需要进行清洗和结构化分析,才能产生业务价值。
5.1 数据清洗
Python
import reimport jieba# 停用词表STOPWORDS = set(["的", "了", "很", "非常", "还是", "但是", "觉得",
"这个", "那个", "一个", "有点", "感觉", "就是"])def clean_comment(text: str) -> str:
"""评论文本清洗"""
if not isinstance(text, str):
return ""
# 去除HTML标签
text = re.sub(r'<[^>]+>', '', text)
# 去除特殊符号,保留中文、英文、数字
text = re.sub(r'[^\u4e00-\u9fa5a-zA-Z0-9]', ' ', text)
# 去除多余空格
text = re.sub(r'\s+', ' ', text).strip()
return textdef tokenize(text: str) -> list:
"""分词并过滤停用词"""
words = jieba.lcut(text)
return [w for w in words if len(w) >= 2 and w not in STOPWORDS]5.2 情感分析(SnowNLP 快速版)
Python
from snownlp import SnowNLPdef analyze_sentiment(text: str):
"""
情感分析:>0.6 好评,0.3-0.6 中评,<0.3 差评
"""
if not text or len(text) < 3:
return 0.5, "中性"
try:
score = SnowNLP(text).sentiments if score > 0.6:
label = "好评"
elif score >= 0.3:
label = "中评"
else:
label = "差评"
return round(score, 3), label except:
return 0.5, "未知"# 批量分析df["clean_content"] = df["content"].apply(clean_comment)df[["sentiment_score", "sentiment_label"]] = df["clean_content"].apply(
lambda x: pd.Series(analyze_sentiment(x)))5.3 差评关键词提取(定位产品痛点)
Python
import jieba.analyse# 提取差评文本bad_comments = df[df["sentiment_label"] == "差评"]["clean_content"].tolist()bad_text = " ".join(bad_comments)# TF-IDF 提取关键词keywords = jieba.analyse.extract_tags(
bad_text,
topK=30,
withWeight=True,
allowPOS=("n", "v", "a") # 只保留名词、动词、形容词)print("差评高频痛点 TOP10:")for word, weight in keywords[:10]:
print(f" {word}: {weight:.4f}")5.4 可视化:情感分布 + 差评词云
Python
import matplotlib.pyplot as pltfrom wordcloud import WordCloud
plt.rcParams["font.sans-serif"] = ["SimHei"]plt.rcParams["axes.unicode_minus"] = False# 1. 情感分布饼图sent_counts = df["sentiment_label"].value_counts()colors = {"好评": "#52c41a", "中评": "#faad14", "差评": "#f5222d"}plt.figure(figsize=(6, 6))plt.pie(
sent_counts.values,
labels=sent_counts.index,
autopct="%1.1f%%",
colors=[colors.get(l, "#999") for l in sent_counts.index])plt.title("评论情感分布", fontsize=14, fontweight="bold")plt.savefig("sentiment_pie.png", dpi=150)plt.close()# 2. 差评词云if bad_text:
wc = WordCloud(
font_path="C:/Windows/Fonts/simhei.ttf", # Linux/Mac 请替换路径
width=900,
height=500,
background_color="white",
colormap="Reds"
)
wc.generate(bad_text)
wc.to_file("bad_wordcloud.png")六、避坑指南与合规红线
6.1 常见错误码与解决方案
表格
| 错误码 | 含义 | 解决方案 |
|---|---|---|
10001 | 入参异常 | 检查 app_key 是否为空,请求体是否超过 3M |
4001 | 签名错误 | 检查密钥、参数排序、编码是否合规,注意大小写 |
403 | 权限不足 | 确认接口权限是否已开通,Token 是否过期 |
429 | 频率限制 | 采用指数退避重试,降低 QPS |
6.2 合规红线(务必遵守)
- 仅使用官方开放 API 获取数据,禁止抓包逆向前端匿名接口、代理爬虫批量爬取
- 调用频次严格遵循平台 QPS 限流规则,基础权限 QPS 为 5,超限可能导致 IP 被封禁
- 数据用途合规:仅限企业竞品调研、市场分析自用,禁止倒卖用户评论隐私数据
- 评论隐私保护:评价原文需单独申请权限,禁止泄露用户个人信息
- 数据延迟认知:库存、价格数据可能存在 5-10 分钟延迟,评论数据仅保留近 180 天
七、典型应用场景
场景 1:品牌口碑监控系统
定时采集自家商品和核心竞品的评论,通过关键词预警(如"质量问题""假货""破损")触发钉钉/企业微信告警,自动生成周报统计好评率和差评 TOP 问题。
场景 2:产品迭代决策支持
批量提取差评中的高频关键词,定位用户集中吐槽点(如"物流慢""包装差""尺寸不准"),为产品改进和供应链优化提供数据依据。
场景 3:竞品评论对比分析
同时采集 3-5 款竞品商品的评论,对比好评率、差评集中属性、用户关注维度,输出竞品口碑雷达图,辅助制定差异化营销策略。