一、接口实战前置说明
该接口为京东商品评论数据调取接口，支持获取商品全部用户评价、晒图、追评、星级评分、规格选购信息等，统一返回标准 JSON 格式，可用于竞品数据分析、舆情监控、评论内容采集、电商数据分析、商品口碑测评等开发场景，支持分页拉取、星级筛选、时间筛选。
二、完整 JSON 响应整体结构
标准返回模板
json
{
"code": 200,
"msg": "请求成功", 咨询V：18179018113
"data": {
"commentStat": {},
"pageData": {},
"commentList": []
}
}外层状态字段实战释义
- code：状态码，200 = 接口请求正常，401 = 权限失效，403 = 访问受限，500 = 接口异常
- msg：请求结果提示文案，用于程序异常判断打印日志
- data：核心业务数据容器，所有评论统计、分页、评论详情均在此层级
三、commentStat 评论统计字段（实战常用）
用于快速判断商品整体口碑，无需遍历评论即可获取汇总数据
表格
| 字段名 | 字段作用 | 实战用途 |
|---|---|---|
| totalComment | 评论总数量 | 判定商品热度、销量口碑 |
| goodCommentNum | 好评数量 | 计算好评率 |
| midCommentNum | 中评数量 | 中性口碑统计 |
| badCommentNum | 差评数量 | 负面舆情预警 |
| imageCommentNum | 晒图评论数 | 真实种草评价占比 |
| avgScore | 商品综合评分 | 1-5 分区间口碑评级 |
四、pageData 分页结构字段（批量采集必备）
爬取多页评论核心参数，控制循环翻页逻辑
- page：当前请求页码
- pageSize：单页返回评论条数
- totalPage：评论总页数
- totalNum：全量评论总数实战技巧：循环遍历 1~totalPage 页码，即可抓取全部评论数据
五、commentList 单条评论核心 JSON 字段（重点解析）
数组内每一条对象为独立用户评论，开发提取高频字段
json
{
"userId": "用户标识",
"userName": "用户昵称",
"userHeadImg": "用户头像链接",
"commentScore": 5,
"commentContent": "商品真实评价文案",
"createTime": "评论发布时间",
"skuName": "选购商品规格/颜色/版本",
"imgUrlList": ["晒图1链接","晒图2链接"],
"isAppend": false,
"appendContent": "",
"praiseNum": 评论点赞数,
"replyNum": 评论回复数
}核心字段解析
- commentScore：评论星级，1 差评 / 3 中评 / 5 好评，快速划分评价等级
- commentContent：核心评论正文，情感分析、关键词提取主力字段
- createTime：评论时间，可筛选近 7 天 / 近 30 天最新评价
- skuName：用户下单规格，分析哪个款式口碑最好
- imgUrlList：晒图评论图片数组，直接抓取原图地址
- isAppend：布尔值，true = 追评，false = 首次评价
- appendContent：用户追加评论内容
六、三大实战解析技巧
技巧 1：层级快速取值技巧
遵循外层状态→统计数据→分页数据→评论列表逐层解析，优先判断 code 状态，成功后再读取评论数组，避免空数据报错。
技巧 2：数据过滤精简解析
无需全字段解析，业务按需提取：
- 口碑分析：只取 avgScore、好坏评数量
- 内容采集：只取评论内容、时间、星级、晒图链接
- 竞品调研：额外抓取用户选购 sku 规格
技巧 3：异常数据兼容处理
- 无晒图评论：imgUrlList 为空数组，代码做空值判断
- 无追评评论：appendContent 为空字符串，直接跳过
- 评论内容为空：过滤无效空评数据
- 接口限流：根据返回错误码做延时休眠请求
七、实战开发适配
- Python：使用 json.loads 直接序列化，列表遍历提取字段，存入 Excel / 数据库
- Java：JSONObject 分层解析，实体类映射 JSON 字段快速赋值
- 爬虫场景：搭配分页参数，全自动批量采集全量商品评论数据