京东商品评论 API 实战:业务场景与完整 JSON 返回参考
一、接口简介
jd.union.open.goods.review.list.get,基于宙斯开放平台,采用 HTTPS+OAuth2.0 鉴权,支持分页查询商品评价、晒图、追评、商家回复、评论标签与口碑统计,是合规获取京东用户口碑数据的标准接口。二、主流实战业务场景
店铺口碑监控
实时抓取本店差评、晒单负面评价,关键词预警,客服及时介入处理,降低售后纠纷。
竞品调研分析
批量采集竞品评论,提取用户痛点、好评卖点,对比好评率、高频标签,制定产品差异化策略。
产品迭代优化
汇总评论里材质、尺寸、功能相关反馈,给研发、品控提供真实用户数据,优化商品做工与规格。
运营素材提取
收集优质晒图、好评文案、真实使用感受,用作商品详情、短视频带货素材。
数据报表统计
自动计算好评率、晒单率、追评占比,生成每日商品口碑看板。
三、完整 JSON 返回示例
1. 请求成功返回(脱敏完整版)
json
{
"code": "0",
"msg": "success",
"result": {
"skuId": "100065474274",
"total": 1568,
"page": 1,
"pageSize": 10,
"productCommentSummary": {
"goodRateShow": 96.8,
"commentCount": 1568,
"goodCount": 1518,
"generalCount": 30,
"poorCount": 20
},
"hotCommentTagStatistics": [
{"name": "物流快", "count": 860},
{"name": "质量好", "count": 720},
{"name": "性价比高", "count": 610}
],
"comments": [
{
"id": 12345678901,
"nickname": "jd_小***柚",
"score": 5,
"content": "做工扎实,京东物流次日达,包装完整没有破损,推荐购买",
"creationTime": "2026-05-20 15:30:22",
"skuName": "黑色 XL",
"images": [
"https://img.jd.com/imgextra/xxx1.jpg",
"https://img.jd.com/imgextra/xxx2.jpg"
],
"usefulVoteCount": 36,
"isAppend": true,
"afterContent": "使用半个月,没有掉色变形,很满意",
"replyContent": "感谢您的认可,我们会持续把控品质!"
},
{
"id": 12345678902,
"nickname": "j***9",
"score": 3,
"content": "尺码偏大,面料偏薄,日常穿勉强够用",
"creationTime": "2026-05-22 10:11:10",
"skuName": "白色 L",
"images": [],
"usefulVoteCount": 12,
"isAppend": false,
"afterContent": "",
"replyContent": ""
}
]
}}2. 接口异常返回(限流 / 权限错误)
json
// 权限不足{
"code": "403",
"msg": "接口权限未开通,请在开放平台申请权限"}// 调用超限限流{
"code": "429",
"msg": "请求频率过高,请间隔一段时间重试"}四、核心字段简要说明
汇总统计层
goodRateShow:商品好评率commentCount:商品总评论数量hotCommentTagStatistics:高频评价标签,用于用户痛点统计
单条评论核心
id:评论唯一 ID,用于数据去重score:星级 1-5,1/2 差评、3 中评、4/5 好评content:用户原始评价文字creationTime:评论发布时间skuName:下单规格(颜色 / 尺寸)images:晒图地址数组isAppend:是否存在追评afterContent:追加评论内容replyContent:商家回复内容
五、简单开发提示
分页依靠
page、pageSize,单页最大 50 条;解析时判断
images、afterContent空值,避免程序报错;接口存在 QPS 限制,批量采集需增加间隔;
数据仅可自用分析,禁止倒卖用户评论隐私。