京东商品评论API接口概述,json数据返回

发布于:2025-09-04 ⋅ 阅读:(15) ⋅ 点赞:(0)

京东商品评论API接口概述及JSON数据返回解析

一、接口核心功能

京东商品评论API接口是京东开放平台提供的服务,允许开发者通过HTTP请求获取指定商品的评论数据,支持以下核心功能:

  1. 多维数据获取
    • 评论内容(文字、图片、视频)
    • 用户评分(1-5星)
    • 评论时间戳、用户昵称(脱敏处理)
    • 商家回复内容、追评信息
    • 评论属性标签(如物流速度、产品质量等结构化维度)
  2. 智能筛选与排序
    • 时间范围:支持按最近30天、自定义时间段筛选。
    • 评论类型:可区分首评、追评、晒单评论。
    • 评分等级:按好评(4-5星)、中评(3星)、差评(1-2星)分类。
    • 排序方式:推荐排序(默认)、时间排序、有用投票数排序。
  3. 统计数据支持
    • 返回总评论数、好评率、差评率等汇总指标。
    • 提供热门标签统计(如“物流快”“质量好”的标签数量)。
二、接口调用流程
  1. 资质准备
    • 在京东开放平台注册开发者账号,创建应用并获取AppKeyAppSecret
    • 申请“商品评论查询”接口权限(部分接口需商务洽谈)。
  2. 请求构造
    • 基础参数
      {
      "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=时间)
      }
  3. 签名生成
    • 使用AppSecret对所有参数按字典序排序后加密(MD5),确保请求合法性。
  4. 数据返回
    • 返回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

网站公告

今日签到

点亮在社区的每一天
去签到