京东商品评论API接口概述及JSON数据返回解析
一、接口核心功能
京东商品评论API接口是京东开放平台提供的服务,允许开发者通过HTTP请求获取指定商品的评论数据,支持以下核心功能:
- 多维数据获取
- 评论内容(文字、图片、视频)
- 用户评分(1-5星)
- 评论时间戳、用户昵称(脱敏处理)
- 商家回复内容、追评信息
- 评论属性标签(如物流速度、产品质量等结构化维度)
- 智能筛选与排序
- 时间范围:支持按最近30天、自定义时间段筛选。
- 评论类型:可区分首评、追评、晒单评论。
- 评分等级:按好评(4-5星)、中评(3星)、差评(1-2星)分类。
- 排序方式:推荐排序(默认)、时间排序、有用投票数排序。
- 统计数据支持
- 返回总评论数、好评率、差评率等汇总指标。
- 提供热门标签统计(如“物流快”“质量好”的标签数量)。
二、接口调用流程
- 资质准备
- 在京东开放平台注册开发者账号,创建应用并获取
AppKey
和AppSecret
。 - 申请“商品评论查询”接口权限(部分接口需商务洽谈)。
- 在京东开放平台注册开发者账号,创建应用并获取
- 请求构造
- 基础参数:
{
"method": "jingdong.ware.productcomment.get",
"app_key": "YOUR_APP_KEY",
"timestamp": "20250903153000",
"format": "json",
"v": "2.0",
"sign_method": "md5"
}
- 业务参数:
{
"skuId": "100012014970", // 商品ID
"page": 1, // 页码(从1开始)
"pageSize": 10, // 每页数量(最大100)
"score": 0, // 评分筛选(0=全部,1=差评,2=中评,3=好评)
"sortType": 5 // 排序方式(5=推荐,6=时间)
}
- 基础参数:
- 签名生成
- 使用
AppSecret
对所有参数按字典序排序后加密(MD5),确保请求合法性。
- 使用
- 数据返回
- 返回JSON格式数据,包含评论列表、统计信息及分页参数。
三、JSON数据返回示例
1. 商品评论列表接口
接口地址:
请求方式:GET
返回结构:
{ |
"code": 200, |
"message": "success", |
"data": { |
"productCommentSummary": { |
"goodRateShow": 98, // 好评率(%) |
"commentCount": 50000, // 总评论数 |
"goodCount": 48000, // 好评数 |
"generalCount": 1500, // 中评数 |
"poorCount": 500 // 差评数 |
}, |
"hotCommentTagStatistics": [ // 热门标签 |
{ "id": 1, "name": "物流快", "count": 5000 }, |
{ "id": 2, "name": "质量好", "count": 3000 } |
], |
"comments": [ // 评论列表 |
{ |
"id": 123456789, |
"content": "东西很好,物流很快", |
"creationTime": "2023-01-01 12:00:00", |
"score": 5, |
"usefulVoteCount": 200, // 有用投票数 |
"nickname": "jd_123", // 用户昵称(脱敏) |
"productColor": "白色", |
"productSize": "XL", |
"images": [ // 评论图片 |
{ "id": 111, "imgUrl": "//img30.360buyimg.com/n1/s450x450_jfs/..." } |
], |
"afterUserComment": { // 追评 |
"content": "使用后效果很好,推荐购买!", |
"creationTime": "2023-01-10 10:00:00" |
} |
} |
] |
} |
} |
2. 商品评价统计接口
接口地址:
请求方式:GET
返回结构:
{ |
"CommentsCount": [ |
{ |
"SkuId": 100012014970, |
"ProductId": 100012014970, |
"CommentCount": 50000, // 总评论数 |
"GoodCount": 48000, // 好评数 |
"GeneralCount": 1500, // 中评数 |
"PoorCount": 500, // 差评数 |
"VideoCount": 200, // 视频评论数 |
"AfterCount": 300, // 追评数 |
"GoodRate": 0.98, // 好评率 |
"GeneralRate": 0.03, // 中评率 |
"PoorRate": 0.01 // 差评率 |
} |
] |
} |
四、关键字段说明
字段名 | 类型 | 描述 |
---|---|---|
goodRateShow |
Number | 好评率(百分比) |
commentCount |
Number | 总评论数 |
score |
Number | 用户评分(1-5星) |
creationTime |
String | 评论时间(格式:YYYY-MM-DD HH:mm:ss) |
usefulVoteCount |
Number | 有用投票数 |
images |
Array | 评论图片URL列表 |
afterUserComment |
Object | 追评内容(若无则为null ) |