京东商品评论 API 字段详解：评分标签、用户口碑数据提取方案

摘要

在电商竞品分析、用户口碑挖掘、NLP 情感分析项目中，商品评论是核心数据源。相比于网页逆向爬虫，使用京东开放平台商品评论 API 更加稳定合规。本文围绕京东评论接口返回结构，拆解核心字段，重点讲解评分标签、星级分布、晒图视频、追评、用户评价文本等口碑相关字段，给出一套可落地的数据清洗、结构化提取方案，附带 JSON 片段与处理思路，以及开发过程中的限流、分页、数据一致性踩坑经验。

一、接口基础说明

接口标识参考：jd.item_review 适用场景：竞品口碑调研、差评监控、用户痛点挖掘、NLP 语料采集、选品数据分析

前置条件：开放平台应用授权、签名生成、配额管理，接口本身有调用频次限制，不可高频刷取

二、核心返回字段分类详解

1. 基础评论主体字段

2. 重点：评分标签字段（高频用于口碑画像）

京东评论自带标签体系，是快速提炼产品优缺点的关键，一般返回结构类似 tags[] 数组：

• tagName：标签名称，例如：发货快、质量好、性价比高、包装破损、色差大
• tagType：标签类型（正面 / 中性 / 负面）
• tagCount：该标签出现频次

业务价值：不用大模型逐句解析，直接聚合标签，快速生成竞品口碑看板。

注意：标签是京东算法预生成，存在标签缺失、标签归类不准的情况，只能作为辅助指标，不能完全替代原文 NLP 分析。

3. 晒图 & 多媒体字段

• imageInfoList：评价图片数组，包含图片 url
• videoInfoList：评价短视频信息 用途：图文评价筛选，判断真实度，做视觉质检、虚假评论过滤

4. 追评 & 追加评价字段

• appendCommentContent：追评内容
• appendCommentTime：追评时间 很多商品售后问题、长期使用反馈集中在追评，做长期口碑监控必须读取该字段。

5. 附加统计字段（聚合指标）

• goodCount：好评总数
• generalCount：中评总数
• poorCount：差评总数
• totalCount：评论总量
• hasImageCount：带图评价数量 适合直接生成指标：好评率、带图评价占比、差评占比，用于竞品打分。

三、用户口碑数据提取落地方案

步骤 1：分页循环拉取

该接口支持分页参数 pageNo、pageSize，注意平台有单页上限，不要一次性请求过大页数；每次保存 commentId 做断点续拉，防止重复采集。

步骤 2：分层提取逻辑

1. 星级分层：score≥4 好评，score=3 中评，≤2 差评
2. 标签聚合：按 tagName 分组统计频次，生成热词排行
3. 正文文本抽取：commentContent + appendCommentContent 合并为完整评价文本
4. 多媒体标记：区分纯文字评价、图评、视频评价
5. 时间切片：按周 / 月聚合，观察口碑随时间变化趋势

步骤 3：数据清洗规则（工程重点）

• 过滤空内容、无意义默认好评文本
• 过滤重复 commentId，去重
• 特殊符号、表情、广告话术清洗
• 标签与原文交叉校验：标签和正文冲突时，以原文作为 NLP 输入

步骤 4：下游业务对接

• 竞品分析看板：好评率、负面标签 TOP5
• NLP 情感模型：清洗后的评论文本作为训练语料
• 差评告警：实时抓取低分评价 + 负面标签，推送预警

四、简化 JSON 返回样例（脱敏模拟）

{
  "code": 200,
  "data": {
    "totalCount": 1268,
    "goodCount": 1052,
    "generalCount": 130,
    "poorCount": 86,
    "commentList": [
      {
        "commentId": "C100001",
        "skuId": "100012345678",
        "score": 5,
        "commentContent": "材质扎实，发货速度很快",
        "commentTime": "2026-09-15 08:22:10",
        "tags": [
          {
            "tagName": "发货快",
            "tagType": "positive",
            "tagCount": 326
          },
          {
            "tagName": "质量好",
            "tagType": "positive",
            "tagCount": 291
          }
        ],
        "imageInfoList": [],
        "appendCommentContent": "",
        "isTop": false
      }
    ]
  }
}

五、开发踩坑总结

1. 标签不是每条评论都有，很多短评无 tag 数组，程序需要做空值判断
2. 配额限流：短时间批量拉取容易返回 403 / 频次超限，需要增加退避重试
3. 数据延迟：新增评论不会实时出现在接口，存在一定同步延迟
4. 用户信息脱敏：不要尝试逆向解析用户隐私字段，合规采集只做数据分析
5. 部分自营 / 特殊类目商品，评论接口返回字段会有缩减，需要做兼容性判断

六、结尾

这套字段提取方案，适合快速搭建轻量级电商口碑分析系统。标签可以用来做粗统计，原始评论文本交给 NLP 模型做深度观点抽取，两者搭配可以兼顾开发效率和分析精度，相比爬虫方案稳定性、可维护性更高。