京东商品评论 API 实战:业务场景与完整 JSON 返回参考

前言

一、接口简介

京东商品评论核心接口 jd.union.open.goods.review.list.get,基于宙斯开放平台,采用 HTTPS+OAuth2.0 鉴权,支持分页查询商品评价、晒图、追评、商家回复、评论标签与口碑统计,是合规获取京东用户口碑数据的标准接口。

二、主流实战业务场景

  1. 店铺口碑监控 实时抓取本店差评、晒单负面评价,关键词预警,客服及时介入处理,降低售后纠纷。
  2. 竞品调研分析 批量采集竞品评论,提取用户痛点、好评卖点,对比好评率、高频标签,制定产品差异化策略。
  3. 产品迭代优化 汇总评论里材质、尺寸、功能相关反馈,给研发、品控提供真实用户数据,优化商品做工与规格。
  4. 运营素材提取 收集优质晒图、好评文案、真实使用感受,用作商品详情、短视频带货素材。
  5. 数据报表统计 自动计算好评率、晒单率、追评占比,生成每日商品口碑看板。

三、完整 JSON 返回示例

1. 请求成功返回(脱敏完整版)

复制代码
{
    "code": "0",
    "msg": "success",
    "result": {
        "skuId": "100065474274",
        "total": 1568,
        "page": 1,
        "pageSize": 10,
        "productCommentSummary": {
            "goodRateShow": 96.8,
            "commentCount": 1568,
            "goodCount": 1518,
            "generalCount": 30,
            "poorCount": 20
        },
        "hotCommentTagStatistics": [
            {"name": "物流快", "count": 860},
            {"name": "质量好", "count": 720},
            {"name": "性价比高", "count": 610}
        ],
        "comments": [
            {
                "id": 12345678901,
                "nickname": "jd_小***柚",
                "score": 5,
                "content": "做工扎实,京东物流次日达,包装完整没有破损,推荐购买",
                "creationTime": "2026-05-20 15:30:22",
                "skuName": "黑色 XL",
                "images": [
                    "https://img.jd.com/imgextra/xxx1.jpg",
                    "https://img.jd.com/imgextra/xxx2.jpg"
                ],
                "usefulVoteCount": 36,
                "isAppend": true,
                "afterContent": "使用半个月,没有掉色变形,很满意",
                "replyContent": "感谢您的认可,我们会持续把控品质!"
            },
            {
                "id": 12345678902,
                "nickname": "j***9",
                "score": 3,
                "content": "尺码偏大,面料偏薄,日常穿勉强够用",
                "creationTime": "2026-05-22 10:11:10",
                "skuName": "白色 L",
                "images": [],
                "usefulVoteCount": 12,
                "isAppend": false,
                "afterContent": "",
                "replyContent": ""
            }
        ]
    }
}

2. 接口异常返回(限流 / 权限错误)

复制代码
// 权限不足
{
    "code": "403",
    "msg": "接口权限未开通,请在开放平台申请权限"
}

// 调用超限限流
{
    "code": "429",
    "msg": "请求频率过高,请间隔一段时间重试"
}

四、核心字段简要说明

  1. 汇总统计层
  • goodRateShow:商品好评率
  • commentCount:商品总评论数量
  • hotCommentTagStatistics:高频评价标签,用于用户痛点统计
  1. 单条评论核心
  • id:评论唯一 ID,用于数据去重
  • score:星级 1-5,1/2 差评、3 中评、4/5 好评
  • content:用户原始评价文字
  • creationTime:评论发布时间
  • skuName:下单规格(颜色 / 尺寸)
  • images:晒图地址数组
  • isAppend:是否存在追评
  • afterContent:追加评论内容
  • replyContent:商家回复内容

五、简单开发提示

  1. 分页依靠 pagepageSize,单页最大 50 条;
  2. 解析时判断 imagesafterContent 空值,避免程序报错;
  3. 接口存在 QPS 限制,批量采集需增加间隔;
  4. 数据仅可自用分析,禁止倒卖用户评论隐私。