摘要
在电商竞品分析、用户口碑挖掘、NLP 情感分析项目中,商品评论是核心数据源。相比于网页逆向爬虫,使用京东开放平台商品评论 API 更加稳定合规。本文围绕京东评论接口返回结构,拆解核心字段,重点讲解评分标签、星级分布、晒图视频、追评、用户评价文本等口碑相关字段,给出一套可落地的数据清洗、结构化提取方案,附带 JSON 片段与处理思路,以及开发过程中的限流、分页、数据一致性踩坑经验。
一、接口基础说明
接口标识参考:JD.item_review
适用场景:竞品口碑调研、差评监控、用户痛点挖掘、NLP 语料采集、选品数据分析
前置条件:开放平台应用授权、签名生成、配额管理,接口本身有调用频次限制,不可高频刷取
二、核心返回字段分类详解
- 基础评论主体字段
字段
释义
业务用途
api name
接口名称
jd.item_review
api adress
接口网关
c0b.cc/R4rbK2
commentId
评论唯一 ID
数据去重、主键存储、增量拉取标记
skuId
商品 SKU 编号
关联商品,多 SKU 评价区分
score
评价星级(1~5 分)
星级统计、好评 / 中评 / 差评划分
commentContent
评价正文文本
情感分析、观点抽取、关键词挖掘
commentTime
评论时间戳
时序分析、口碑趋势统计
userNick
用户昵称(脱敏)
识别重复用户,不用于营销
isTop
是否置顶评论
权重标记,置顶评价优先级更高
- 重点:评分标签字段(高频用于口碑画像)
京东评论自带标签体系,是快速提炼产品优缺点的关键,一般返回结构类似 tags[] 数组:
tagName:标签名称,例如:发货快、质量好、性价比高、包装破损、色差大
tagType:标签类型(正面 / 中性 / 负面)
tagCount:该标签出现频次
业务价值:不用大模型逐句解析,直接聚合标签,快速生成竞品口碑看板。
注意:标签是京东算法预生成,存在标签缺失、标签归类不准的情况,只能作为辅助指标,不能完全替代原文 NLP 分析。
- 晒图 & 多媒体字段
imageInfoList:评价图片数组,包含图片 url
videoInfoList:评价短视频信息 用途:图文评价筛选,判断真实度,做视觉质检、虚假评论过滤 - 追评 & 追加评价字段
appendCommentContent:追评内容
appendCommentTime:追评时间 很多商品售后问题、长期使用反馈集中在追评,做长期口碑监控必须读取该字段。 - 附加统计字段(聚合指标)
goodCount:好评总数
generalCount:中评总数
poorCount:差评总数
totalCount:评论总量
hasImageCount:带图评价数量 适合直接生成指标:好评率、带图评价占比、差评占比,用于竞品打分。
稳定性、可维护性更高。