摘要
在电商竞品口碑分析、差评预警、用户痛点挖掘场景中,京东商品评论、追评、晒单内容是核心数据源。很多项目一开始选择网页爬虫抓取评论数据,但是京东页面动态渲染、反爬策略严格、分页逻辑复杂,爬虫维护成本高,还存在合规风险。本文基于京东宙斯 JOS 开放平台商品评论接口,讲解接口基础规范、请求入参、返回字段,附带标准 JSON 返回样例,梳理字段解析要点、边界处理、开发踩坑与业务落地场景,提供合规稳定的官方接口方案。
1. 接口基础信息
jd .item.reviews.get为京东平台商品评论接口,是电商口碑数据的核心数据源。商品详情接口只能拿到商品基础信息,真实用户评价、追评、晒图、差评痛点全部依赖本接口获取。
接口名称:jd.item_review(taobaoapi2014 前往体验)
接口地址:o0b.cn/opandy (HTTPS,支持 GET/POST)
接口版本:v3(稳定正式版)
请求方式:GET / POST(推荐 POST,参数放 body 避免 URL 超长)
返回格式:标准 JSON
业务用途:根据商品 ID,全量获取商品评论基础评论信息、评论日期、图片、视频、评论者ID、追评、追评内容、视频图文等完整商品评论内容数据。
核心业务适用场景
舆情与差评预警:定时监控自有或竞品 SKU,识别差评、负面关键词,实现告警推送,感知批量质量、售后问题。
竞品口碑调研:批量统计竞品好评率、差评高频问题,挖掘用户痛点,辅助选品与产品迭代。
NLP 情感分析:把结构化评论文本送入 AI 模型,自动做情感倾向归类、观点提取、标签统计。
选品决策辅助:结合晒单、追评数据,评估商品真实市场反馈,过滤刷单类无效评价。
商家回复效果分析:采集商家回复内容,统计回复率、回复时效,优化客服运营策略。
说明:京东评论接口支持按 SKU 查询评价,可分页拉取,可获取好评 / 中评 / 差评,部分接口支持读取晒单图片,用于用户口碑分析。
2. 请求入参说明
| 参数名 | 是否必传 | 说明 |
|---|---|---|
| app_key | 是 | 京东开放平台应用密钥 |
| method | 是 | 评论接口方法名 |
| timestamp | 是 | 13 位毫秒时间戳 |
| v | 是 | 协议版本,一般 2.0 |
| sign_method | 是 | 签名算法:sha256 |
| sign | 是 | 参数排序后加密生成的签名串 |
| access_token | 否 | 授权令牌,部分接口需要 |
| skuId | 是 | 商品 SKU 编号 |
| page | 否 | 页码,从 1 开始 |
| pageSize | 否 | 单页评论条数,受接口配额限制 |
| sortType | 否 | 排序类型,如最新、推荐 |
推荐入参组合:skuId,page,pageSize,sortType
3. 返回核心字段说明
外层根节点:code、message、result,评论数组在result.commentList
| 字段 | 数据类型 | 说明 | 开发注意事项 |
|---|---|---|---|
| commentId | string | 评价唯一 ID | 数据主键,用于去重 |
| skuId | string | 商品 SKU 编号 | 关联商品详情数据 |
| content | string | 评价正文内容 | 用户原始评价文字 |
| score | int | 评价星级 | 1~5 星,1 最差 5 最好 |
| creationTime | string | 评价创建时间 | yyyy-MM-dd HH:mm:ss |
| nickName | string | 用户昵称 | 平台自动脱敏 |
| images | array | 晒单图片数组 | 无晒图时为空数组,图片带防盗链 |
| video | object | 评价视频 | 无视频晒单时为 null |
| afterCommentContent | string | 追评内容 | 无追评则为空字符串 |
| afterCommentTime | string | 追评时间 | 无追评为空 |
| productAttr | string | 购买规格 | 如:黑色 16G 版本 |
| usefulVoteCount | int | 评论点赞数 | 其他用户觉得有用的数量 作者:用户1597063760 链接:https://juejin.cn/spost/7684122642484248610 来源:稀土掘金 著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。 |

