一、接口接入流程

1. 注册与认证
   • 访问京东开放平台，注册企业/个人开发者账号，完成实名认证。
   • 创建应用并提交“数据服务”类目审核，获取 AppKey和 AppSecret（用于签名和身份验证）。
2. 权限申请
   • 在控制台申请“商品评论”API权限（如 jd.item_review、 jingdong.comments.list）。部分高级接口（如评论图片/视频）需额外审核。
3. 获取AccessToken
   • 通过OAuth 2.0认证流程获取临时授权码（code），再兑换为长期有效的 AccessToken（有效期通常2小时，需定时刷新）。

二、API调用核心参数与示例

• 接口地址： https://api.jd.com/routerjson（以官方文档为准）。
• 请求方式：HTTP GET/POST（根据接口文档选择）。
• 关键参数：
  • skuId：商品唯一标识符（必填）。
  • page/ pageSize：分页页码及每页评论数（最大50条/页）。
  • sortType：排序方式（1=时间倒序，2=评分降序）。
  • score：评分筛选（0=全部，1-5=指定评分）。
  • timestamp：请求时间戳（格式 YYYY-MM-DD HH:MM:SS）。
  • sign：签名（按字典序排序参数+ AppSecret加密生成，如MD5/HMAC-SHA256）。

Python示例代码：

pythonimport requestsimport hashlibapp_key = "YOUR_APP_KEY"app_secret = "YOUR_APP_SECRET"sku_id = "123456789"params = {    "method": "jd.item_review",    "sku_id": sku_id,    "page": 1,    "page_size": 10,    "sort_type": "1",    "timestamp": "2025-05-28 12:00:00"}# 生成签名sorted_params = sorted(params.items(), key=lambda x: x[0])sign_str = app_secret + "".join(f"{k}{v}" for k, v in sorted_params) + app_secretparams["sign"] = hashlib.md5(sign_str.encode()).hexdigest().upper()response = requests.get("https://api.jd.com/routerjson", params=params)print(response.json())

三、响应数据结构与解析

• 成功响应（JSON格式）：

  json{  "code": "0",  "message": "成功",  "data": {    "commentCount": 10000,    "scoreSummary": {      "goodRate": 98.5,      "goodCount": 9850,      "generalCount": 100,      "poorCount": 50    },    "comments": [      {        "rate_content": "质量很好，物流快！",        "rate_date": "2025-05-20 10:30:00",        "display_user_nick": "用户****",        "score": 5,        "hasImage": true,        "images": ["http://img.jd.com/1.jpg"]      }    ]  }}

• 数据清洗与解析：
  • 去除评论中的HTML标签（如正则表达式清洗）。
  • 提取评分分布、用户地域、购买时间等维度进行分析。
  • 利用 scoreSummary生成好评率柱状图（通过 matplotlib库可视化）。

四、注意事项与合规要求

1. 频率限制：
   • 企业账号：每分钟≤200次，单日≤10万次。
   • 个人账号：权限更低，需严格遵守限制，避免触发封禁。
2. 数据合规：
   • 禁止爬取用户隐私数据（如完整昵称、联系方式），需脱敏处理。
   • 商业用途需签署授权协议，遵守《个人信息保护法》。
3. 反爬策略：
   • 请求头模拟浏览器环境（添加 User-Agent、 Referer等字段）。
   • 通过 time.sleep()控制请求间隔，避免高频访问。
4. 接口变更与维护：
   • 定期关注京东开放平台的接口变更通知，确保代码稳定性。
   • 添加错误处理机制（如捕获网络异常、解析JSON错误）。

五、扩展工具与场景

• 第三方工具：如 gooseeker爬虫、载图助手等，支持批量抓取评论图与评语，但需遵守京东的评论页数限制（最多100页）。
• 应用场景：
  • 商品优化：分析用户反馈关键词（如“续航”“屏幕”），优化产品描述。
  • 竞品监控：对比同类商品评分分布与用户评价。
  • 情感分析：使用NLP工具（如 jieba+ TextBlob）进行情感分类。

官方文档参考：

• 京东开放API文档
• 开发者论坛（如CSDN、阿里云社区）提供实战案例与代码示例。

通过以上指南，开发者可高效获取京东商品评论数据，并结合业务需求进行深度分析，如产品优化、用户画像构建等。需注意合规性与接口稳定性，确保数据获取的合法性与可持续性。