技术实战:京东商品评论API (jd.item_review) 深度解析与标准JSON参考
前言
在电商竞品分析、口碑舆情监控及产品迭代调研中,用户评论是极具价值的一手数据源。相较于人工采集或前端逆向抓取,京东开放平台提供的 jd.item_review 接口能输出标准化、结构化的评价数据,涵盖主评、追评、评分、晒图视频、用户标签及商家回复等全维度信息。该接口是搭建舆情预警系统、NLP情感分析模型及竞品口碑数据库的核心基础设施。
一、接口核心基础信息
二、请求参数详解
调用该接口需分为公共参数(网关鉴权用)和业务参数(封装在 param_json 或 Body 中)。
1. 公共必选参数
2. 业务请求参数 (Body/param_json)
三、标准JSON返回参考示例
以下是经过清洗和标准化的成功响应结构,包含评论摘要统计、热门标签及详细评论列表。
json{
"code": "0",
"msg": "success",
"request_id": "10b3a8c7-9d2e-4f1a-b5c6-8e7d9f0a1b2c",
"data": {
"productCommentSummary": {
"skuId": "100012345678",
"commentCount": 2460,
"goodCount": 2310,
"generalCount": 95,
"poorCount": 55,
"goodRateShow": "93.9%",
"videoCount": 120,
"imageCount": 860
},
"hotCommentTagStatistics": [
{
"name": "做工不错",
"count": 860,
"type": "positive"
},
{
"name": "包装差",
"count": 132,
"type": "negative"
},
{
"name": "物流快",
"count": 540,
"type": "positive"
}
],
"comments": [
{
"id": 98765432101,
"guid": "com_98765432101",
"nickname": "jd_张***明",
"userLevel": "PLUS会员",
"score": 2,
"scoreDesc": "中评",
"content": "外壳容易刮花,包装简陋,物流速度一般。使用一周后感觉手感不如预期。",
"creationTime": "2026-07-22 09:12:45",
"replyTime": "2026-07-23 10:00:00",
"skuAttr": "颜色:银灰色;规格:标准版;内存:256GB",
"images": [
"https://img.jd.com/imgextra/a1.jpg",
"https://img.jd.com/imgextra/a2.jpg"
],
"videos": [],
"usefulVoteCount": 12,
"commentTags": ["包装简陋", "手感一般"],
"merchantReply": {
"content": "非常抱歉给您带来不好的体验,关于包装问题我们会反馈给物流部门改进。如有任何质量问题,支持7天无理由退换。",
"replyTime": "2026-07-23 10:00:00"
},
"afterReview": null
},
{
"id": 98765432102,
"guid": "com_98765432102",
"nickname": "jd_李***华",
"userLevel": "金牌会员",
"score": 5,
"scoreDesc": "好评",
"content": "屏幕显示效果非常棒,运行流畅,拍照清晰。",
"creationTime": "2026-08-01 14:20:10",
"replyTime": null,
"skuAttr": "颜色:黑色;规格:Pro版;内存:512GB",
"images": [],
"videos": [
{
"url": "https://video.jd.com/v1.mp4",
"cover": "https://img.jd.com/video_cover.jpg"
}
],
"usefulVoteCount": 45,
"commentTags": ["屏幕清晰", "运行流畅"],
"merchantReply": null,
"afterReview": {
"content": "用了一个月来追评,电池续航依然很强劲,满意!",
"creationTime": "2026-09-01 14:20:10",
"images": []
}
}
],
"hasNext": true,
"currentPage": 1,
"totalPages": 25
}}