京东商品评论API接口概述，json数据返回
京东商品评论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） |