前言
一、接口核心功能
京东商品评论API接口是京东开放平台提供的核心数据服务,支持开发者通过HTTP请求获取指定商品的完整用户评价数据,主要功能包括:
多维数据获取
用户评价内容(文字、图片、视频)
评分(1-5星)及用户等级(如钻石会员)
评价时间戳、购买信息(商品颜色/尺寸)、地理位置(省份)
商家回复内容及追评数据
智能筛选与排序
按评分筛选(好评/中评/差评)
按时间范围(如最近30天)或评价类型(首评/追评)过滤
支持推荐排序(默认)或时间排序(最新优先)
统计指标输出
总评论数、好评率、差评率
评分分布(各星级数量)
热门评价标签(如“物流快”“质量好”)
二、接口调用流程
资质准备
在京东开放平台注册开发者账号,创建应用并获取
AppKey
和AppSecret
。申请“商品评论查询”接口权限(部分高级接口需企业资质审核)。
请求构造
基础参数:
method
(接口名称)、app_key
、timestamp
(时间戳)、sign
(签名)。业务参数:
json{"skuId": "100012345678", // 商品SKU ID"page": 1, // 页码"pageSize": 10, // 每页数量(最大50)"score": 0, // 评分筛选(0=全部,1-5=指定评分)"sortType": 5, // 排序方式(5=推荐,6=时间降序)"isShadowSku": 0 // 是否查询子SKU评论}
签名生成
使用
AppSecret
对参数按字典序排序后加密(MD5算法),确保请求合法性。数据返回
返回JSON格式数据,包含评论总数、评分汇总及评论列表。
三、JSON数据返回结构示例
json{"code": "0","message": "成功","data": {"commentCount": 10000, // 总评论数"scoreSummary": { // 评分汇总"goodRate": 98.5, // 好评率(%)"goodCount": 9850, // 好评数"generalCount": 100, // 中评数"poorCount": 50 // 差评数},"comments": [ // 评论列表{"content": "商品质量很好,物流很快...", // 评论内容"creationTime": "2025-06-19 10:30:00", // 评价时间"score": 5, // 评分"userLevelName": "钻石会员", // 用户等级"userProvince": "北京", // 所在省份"hasImage": true, // 是否有图片"images": ["http://img.jd.com/1.jpg"], // 图片链接"replies": [ // 商家回复{"replyContent": "感谢您的支持,我们会继续努力!","replyTime": "2025-06-20 09:00:00"}],"afterSaleReview": { // 追评内容"content": "使用后效果很好,推荐购买!","createTime": "2025-06-25 15:00:00"}},// 更多评论...]}}
四、关键字段说明
字段 | 类型 | 说明 |
---|---|---|
commentCount | Integer | 商品总评论数,用于分页计算总页数。 |
scoreSummary.goodRate | Float | 好评率(百分比),支持可视化展示(如柱状图)。 |
comments.content | String | 用户原始评价内容,可能包含HTML标签(需清洗)。 |
comments.score | Integer | 用户评分(1-5星),5星为好评。 |
comments.images | Array | 用户上传的图片URL列表,需检查链接有效性。 |
comments.replies | Array | 商家回复内容,可用于分析客服响应质量。 |
comments.afterSaleReview | Object | 追评数据,反映用户长期使用体验。 |
五、应用场景与价值
品牌舆情监测
实时分析新品市场反馈,预警负面评价(如差评率突增)。
通过情感分析技术(如NLP)对评论内容进行正向/负向分类。
竞品对比分析
横向对比同类商品的好评率、差评关键词,识别竞争优势点(如“性价比高”)。
用户体验优化
挖掘高频关键词(如“续航差”“屏幕清晰”),指导产品改进。
按用户等级(钻石会员/普通用户)或地区分组,分析差异化需求。
学术研究
支持电商用户行为、消费趋势的大规模数据分析(如评论情感随时间变化)。
六、注意事项
接口限制
单IP高频请求可能触发验证码或封禁,建议每页请求间隔1-3秒。
部分接口需登录后访问,需携带
AccessToken
。数据完整性
默认返回折叠后的评论(相同内容可能合并),需设置
fold=0
获取完整数据。单接口单次最多获取50条评论,高评论量商品需分页循环请求。
合规性
确保采集行为符合京东《开放平台开发者协议》,不得用于非法用途(如恶意营销)。
接口参数或权限可能变更,需定期查看官方文档更新。