×

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

访客 访客 发表于2025-09-01 17:51:57 浏览60 评论0

抢沙发发表评论

前言

一、接口核心功能

京东商品评论API接口是京东开放平台提供的核心数据服务,支持开发者通过HTTP请求获取指定商品的完整用户评价数据,主要功能包括:

  1. 多维数据获取

    • 用户评价内容(文字、图片、视频)

    • 评分(1-5星)及用户等级(如钻石会员)

    • 评价时间戳、购买信息(商品颜色/尺寸)、地理位置(省份)

    • 商家回复内容及追评数据

  2. 智能筛选与排序

    • 按评分筛选(好评/中评/差评)

    • 按时间范围(如最近30天)或评价类型(首评/追评)过滤

    • 支持推荐排序(默认)或时间排序(最新优先)

  3. 统计指标输出

    • 总评论数、好评率、差评率

    • 评分分布(各星级数量)

    • 热门评价标签(如“物流快”“质量好”)

二、接口调用流程

  1. 资质准备

    • 在京东开放平台注册开发者账号,创建应用并获取AppKeyAppSecret

    • 申请“商品评论查询”接口权限(部分高级接口需企业资质审核)。

  2. 请求构造

    • 基础参数method(接口名称)、app_keytimestamp(时间戳)、sign(签名)。

    • 业务参数

      json{"skuId": "100012345678",  // 商品SKU ID"page": 1,                // 页码"pageSize": 10,           // 每页数量(最大50)"score": 0,               // 评分筛选(0=全部,1-5=指定评分)"sortType": 5,            // 排序方式(5=推荐,6=时间降序)"isShadowSku": 0          // 是否查询子SKU评论}
  3. 签名生成

    • 使用AppSecret对参数按字典序排序后加密(MD5算法),确保请求合法性。

  4. 数据返回

    • 返回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"}},// 更多评论...]}}

四、关键字段说明


字段类型说明
commentCountInteger商品总评论数,用于分页计算总页数。
scoreSummary.goodRateFloat好评率(百分比),支持可视化展示(如柱状图)。
comments.contentString用户原始评价内容,可能包含HTML标签(需清洗)。
comments.scoreInteger用户评分(1-5星),5星为好评。
comments.imagesArray用户上传的图片URL列表,需检查链接有效性。
comments.repliesArray商家回复内容,可用于分析客服响应质量。
comments.afterSaleReviewObject追评数据,反映用户长期使用体验。


五、应用场景与价值

  1. 品牌舆情监测

    • 实时分析新品市场反馈,预警负面评价(如差评率突增)。

    • 通过情感分析技术(如NLP)对评论内容进行正向/负向分类。

  2. 竞品对比分析

    • 横向对比同类商品的好评率、差评关键词,识别竞争优势点(如“性价比高”)。

  3. 用户体验优化

    • 挖掘高频关键词(如“续航差”“屏幕清晰”),指导产品改进。

    • 按用户等级(钻石会员/普通用户)或地区分组,分析差异化需求。

  4. 学术研究

    • 支持电商用户行为、消费趋势的大规模数据分析(如评论情感随时间变化)。

六、注意事项

  1. 接口限制

    • 单IP高频请求可能触发验证码或封禁,建议每页请求间隔1-3秒。

    • 部分接口需登录后访问,需携带AccessToken

  2. 数据完整性

    • 默认返回折叠后的评论(相同内容可能合并),需设置fold=0获取完整数据。

    • 单接口单次最多获取50条评论,高评论量商品需分页循环请求。

  3. 合规性

    • 确保采集行为符合京东《开放平台开发者协议》,不得用于非法用途(如恶意营销)。

    • 接口参数或权限可能变更,需定期查看官方文档更新。


群贤毕至

访客