一、接口概述
通过京东开放平台的商品评论API,开发者可获取指定商品的用户评价数据。该接口采用HTTPS协议,返回格式为JSON,需通过OAuth2.0认证获取访问令牌。
二、核心参数说明
-
商品ID:
skuId(必填)- 格式:数字字符串,如
100000000001 - 获取方式:商品详情页URL中的数字标识
- 格式:数字字符串,如
-
分页参数:
params = { "page": 1, # 当前页码 "pageSize": 10 # 每页条数(最大值50) }
三、API调用示例(Python)
import requests
def get_jd_comments(sku_id, access_token):
url = "https://api.jd.com/routerjson"
params = {
"method": "jd.biz.product.getComment",
"sku_id": sku_id,
"access_token": access_token,
"page": 1,
"pageSize": 20
}
headers = {"Content-Type": "application/json"}
try:
response = requests.get(url, params=params, headers=headers)
data = response.json()
if data.get("code") == 0:
comments = data["result"]["comments"]
for comment in comments:
print(f"用户: {comment['nickname']}")
print(f"评分: {comment['score']}星")
print(f"内容: {comment['content']}\n")
else:
print(f"错误: {data['msg']}")
except Exception as e:
print(f"请求异常: {str(e)}")
# 调用示例
get_jd_comments("100000000001", "your_access_token_here")
四、返回数据结构解析
{
"code": 0,
"result": {
"comments": [
{
"id": 123456,
"content": "商品质量很好",
"score": 5,
"creationTime": "2023-06-01 10:30:00",
"nickname": "jd_******",
"productColor": "黑色",
"productSize": "L"
}
],
"total": 1280
}
}
五、注意事项
- 频率限制:单账号每分钟不超过100次请求
- 数据时效:接口返回最近180天内的评论
- 敏感字段:用户昵称自动脱敏处理
- 认证要求:需提前在京东开放平台创建应用获取
app_key和app_secret
提示:完整API文档请参考京东开放平台
ProductCommentAPI模块,建议使用官方SDK处理签名验证等复杂逻辑。
该技术帖提供了可直接运行的代码示例和关键参数说明,帮助开发者快速实现商品评论数据采集功能。实际使用时需注意遵守平台数据使用规范。