京东商品评论API接口指南-开发者社区

京东商品评论 API 是京东开放平台提供的标准化接口服务，允许授权开发者获取商品的用户评价数据，包括评论内容、评分、晒单图片、追评、商家回复等信息，支持多维筛选与分页查询。以下是完整接入指南：

一、接口概述

核心功能

多维数据获取：评论内容（文字 / 图片 / 视频）、用户评分（1-5 星）、时间戳、用户昵称（脱敏）、追评、商家回复、评论属性标签
智能筛选：按评分等级（好评 / 中评 / 差评）、评论类型（首评 / 追评）、时间范围筛选
分页与排序：支持页码 / 页大小设置（最大 100 条 / 页），按时间或推荐排序
统计分析：返回好评率、差评率、评论总数等摘要指标

主要接口列表

接口名称	功能描述	适用场景
jingdong.ware.comment.get	商品评价查询（基础版）	商家获取自有店铺商品评论
jd.item_review	商品评论列表（增强版）	支持更多筛选条件与数据字段
jd.union.open.comment.query	联盟商品评论查询	京东联盟推广者使用
jingdong.comments.list	评论详情查询	获取单条评论完整信息

基础信息

协议：HTTPS（强制）
请求方式：GET/POST（推荐 POST）
基础 URL：c0b.cc/R4rbK2（注册获取测试账号，Taobaoapi2014添加V）
返回格式：JSON
认证方式：AppKey + AppSecret + 签名机制 + access_token（部分接口）

二、接入准备流程

1. 开发者账号注册与认证

访问 c0b.cc/R4rbK2 注册账号
完成实名认证（个人 / 企业）
创建应用，获取AppKey与AppSecret
配置 IP 白名单（接口调用必须绑定）

2. 接口权限申请

基础权限：个人开发者可申请，限制单商品最多 50 条评论，QPS=3
进阶权限：需企业认证，支持 200 条 / 商品，QPS=10，含图片 / 视频字段
高级权限：品牌合作伙伴专属，无数量限制，支持完整数据维度
申请材料：应用场景说明（越具体通过率越高）、企业资质（如适用）

3. 签名机制（关键）

京东 API 采用MD5 签名，生成规则：

按参数名 ASCII 升序排列所有请求参数（包括公共参数与业务参数）
拼接为key1=value1&key2=value2&...格式
末尾拼接&app_secret=你的AppSecret
进行 MD5 加密（32 位大写）得到sign参数

注意：必须包含client_type参数（如 "pc" 或 "app"），否则签名验证失败

三、核心接口详解（以 jingdong.ware.comment.get 为例）

1. 公共请求参数（所有接口必传）

参数名	类型	必须	说明
method	String	是	接口名称，如`jingdong.ware.comment.get`
app_key	String	是	应用唯一标识
timestamp	String	是	时间戳（yyyy-MM-dd HH:mm:ss）
sign	String	是	签名结果
v	String	是	API 版本，默认 1.0
format	String	否	返回格式，默认 json
access_token	String	否	访问令牌（部分接口需要）

2. 业务请求参数

参数名	类型	必须	说明	示例
skuId	Long	是	商品 SKU 唯一标识	12345678901
page	Integer	是	页码，起始 1	1
pageSize	Integer	是	每页数量，1-100	20
score	Integer	否	评分筛选：0 = 全部，1 = 差评，2 = 中评，3 = 好评	0
sortType	Integer	否	排序方式：5 = 时间倒序，6 = 推荐排序	5
commentType	Integer	否	评论类型：0 = 全部，1 = 只看有图，2 = 只看追评	0
startTime	String	否	开始时间（yyyy-MM-dd HH:mm:ss）	2025-01-01 00:00:00
endTime	String	否	结束时间（yyyy-MM-dd HH:mm:ss）	2025-01-31 23:59:59

3. 调用示例（Python）

python

import requests import hashlib import time # 配置参数 API_URL = "c0b.cc/R4rbK2 wechatid:Taobaoapi2014 # 配置参数 app_key = "你的AppKey" app_secret = "你的AppSecret" method = "jingdong.ware.comment.get" sku_id = 12345678901 page = 1 page_size = 20 # 生成时间戳 timestamp = time.strftime("%Y-%m-%d %H:%M:%S") # 构造参数字典 params = { "method": method, "app_key": app_key, "timestamp": timestamp, "v": "1.0", "format": "json", "skuId": sku_id, "page": page, "pageSize": page_size, "client_type": "pc" # 必须包含此参数 } # 生成签名 sorted_params = sorted(params.items(), key=lambda x: x[0]) sign_str = "&".join([f"{k}={v}" for k, v in sorted_params]) + "&app_secret=" + app_secret sign = hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper() params["sign"] = sign # 发送请求 url = "https://api.jd.com/routerjson" response = requests.post(url, data=params) result = response.json() print(result)

4. 返回数据格式

json

{ "wareCommentResult": { "commentSummary": { "goodRate": 0.98, // 好评率 "generalRate": 0.01, // 中评率 "poorRate": 0.01, // 差评率 "commentCount": 1562 // 总评论数 }, "commentList": [ { "id": "1234567890123", // 评论ID "content": "商品质量很好，物流很快！", // 评论内容 "score": 5, // 评分 "creationTime": "2025-12-24 15:30:00", // 评论时间 "userNickname": "京东用户***", // 脱敏昵称 "isPlus": true, // 是否Plus会员 "imageUrls": ["https://img10.360buyimg.com/imagetools/jfs/t1/..."], // 晒图 "appendComment": { // 追评信息 "content": "用了几天，感觉非常不错！", "creationTime": "2025-12-26 10:15:00" }, "reply": { // 商家回复 "content": "感谢您的好评，我们会继续努力！", "creationTime": "2025-12-24 16:00:00" } } // 更多评论... ], "maxPage": 79, // 最大页码 "currentPage": 1, "pageSize": 20 } }

四、权限与配额说明

权限等级	适用对象	单商品评论上限	QPS 限制	可获取字段	申请难度
基础权限	个人开发者	50 条	3	基础文字 + 评分	低
进阶权限	企业开发者	200 条	10	含图片 + 追评	中
高级权限	品牌 / ISV	无限制	50+	完整数据 + 统计	高

注意：非自有店铺商品的评论数据获取需特殊权限，需提供合作证明与详细使用场景

五、注意事项与最佳实践

合规性要求
- 评论数据仅用于自身业务分析，不得转售或公开传播。
- 必须遵守京东开放平台《数据使用协议》。
- 用户昵称等隐私信息已脱敏，不得尝试破解。
接口调用优化
- 合理设置pageSize（建议 20-50 条 / 页），避免频繁调用。
- 缓存评论数据，减少重复请求。
- 处理接口限流（HTTP 429），实现自动重试机制。
常见问题排查
- 签名错误：检查参数排序、client_type 是否存在、AppSecret 是否正确。
- 权限不足：确认申请的接口权限与调用商品范围匹配。
- 数据为空：检查 SKU 是否正确、商品是否有评论、筛选条件是否过严。
版本更新
- 关注京东开放平台公告，及时适配接口变更。
- 定期更新 access_token（如使用），避免过期失效。