jd.item.review（京东商品评论 API）全业务场景落地手册

文档定位：生产级落地手册，包含接口基础、接入流程、参数、JSON 样例、七大业务场景、架构方案、踩坑清单、合规约束，面向电商后台、舆情监控、竞品分析、差评预警系统开发。

目录

1. 接口基础总览
2. 接入准备、权限申请、鉴权流程
3. 请求参数完整说明
4. 标准请求 JSON 示例 & 返回完整 JSON 示例
5. 7 大业务场景落地方案（含业务逻辑、数据库表设计要点）
6. 生产架构设计（采集任务、去重、重试、限流、AI 分析链路）
7. 常见错误码与排错手册
8. Python 极简调用骨架代码

1、接口基础总览

可获取核心字段：评论 ID、评论文本、1‑5 星评分、评价时间、购买 SKU 规格、晒图 URL 数组、追评内容与时间、商家回复、点赞有用数、评论标签统计、好评 / 中评 / 差评汇总统计。

不可获取：用户手机号、真实姓名、完整未脱敏昵称、订单号。

2、接入准备、权限申请、鉴权流程

2.1 账号与应用

1. 京东开放平台注册开发者账号，完成实名认证；商用必须企业资质，提交营业执照。
2. 创建自研 / 联盟应用，拿到 app key 和secret。
3. OAuth2.0 换取 token，有效期通常 24 小时，系统必须做 token 自动刷新任务。

2.2 接口权限申请

1. 在应用权限管理，申请评论读取权限；评价原文需要单独审批。
2. 权限分级：

• 基础权限：仅评价摘要、标签统计；无法拿到完整 content 正文；QPS=5
• 企业进阶权限：完整评论正文、晒图链接；QPS=20（商用系统必备）
• 高级联盟权限：更高 QPS，需要提交数据用途承诺书

拒绝：不要使用第三方破解 API、网页抓包接口，会导致 IP 封禁、账号作废。

2.3 签名规则简述

1. 将所有公共参数（除 sign）按 ASCII 字典序升序排序；
2. key+value 拼接，末尾拼接 app_secret；
3. MD5 32 位大写，作为 sign 参数传入；
4. param_json 为业务入参 JSON 字符串，做 URL 编码。

3、请求参数完整说明

公共请求参数（网关层必传）

param_json 内部业务参数

4、标准 JSON 示例

4.1 param_json 业务入参示例

json

{
  "skuId":"100012345678",
  "pageIndex":1,
  "pageSize":10,
  "score":0,
  "isImage":0,
  "needAfterReview":1,
  "sort_type":1
}

4.2 API 返回完整 JSON 样例

json

{
  "code":"0",
  "msg":"success",
  "data":{
    "productCommentSummary":{
      "commentCount":2460,
      "goodCount":2310,
      "generalCount":95,
      "poorCount":55,
      "goodRateShow":93.9
    },
    "hotCommentTagStatistics":[
      {"name":"物流快","count":1120},
      {"name":"做工不错","count":860},
      {"name":"包装差","count":132}
    ],
    "comments":[
      {
        "id":98765432101,
        "nickname":"jd_张***明",
        "score":2,
        "content":"外壳容易刮花，包装简陋，物流速度一般",
        "creationTime":"2026‑07‑22 09:12:45",
        "skuAttr":"颜色:银灰色;规格:标准版",
        "images":["https://img.jd.com/imgextra/a1.jpg"],
        "usefulVoteCount":12,
        "reply":"商家回复：非常抱歉给您不好体验，联系客服处理",
        "afterSaleReview":{
          "content":"使用半个月，故障出现，售后处理慢",
          "creationTime":"2026‑07‑30 16:20:11"
        }
      },
      {
        "id":98765432102,
        "nickname":"jd_李***华",
        "score":5,
        "content":"质量超出预期，物流快，性价比很高",
        "creationTime":"2026‑07‑25 11:05:33",
        "skuAttr":"颜色:黑色;规格:Pro版",
        "images":[],
        "usefulVoteCount":45,
        "reply":"",
        "afterSaleReview":null
      }
    ]
  }
}
 

5、七大业务场景落地方案

场景 1：商品舆情 & 差评实时预警系统（高频商用）

业务目标：监控自有 / 竞品商品，出现差评、负面关键词，推送钉钉 / 企业微信告警，提前介入客诉。

• 采集策略：定时轮询，增量采集，按 skuId 任务分组；优先拉取sort =1时间倒序，只处理新增评论；
• 过滤规则：score≤2（中评 + 差评），匹配关键词库：破损、故障、质量差、假货、售后慢、做工差；
• 输出：告警消息、评论原文、sku 规格、晒图链接；
• 数据库要点：表主键 comment_id，建立 skuId、score、creationTime 索引；以 comment_id 做唯一键防止重复入库。
• 业务价值：降低售后风险，提前发现批量质量问题。

场景 2：竞品评论分析系统

业务目标：批量采集多个竞品 SKU，统计好评率、差评 TOP 问题、高频标签，输出竞品优劣报告。

• 采集：批量任务，控制 QPS，多 sku 轮询；
• 分析维度：好评率、差评占比、高频痛点词、用户关心规格；
• 输出：竞品对比看板，导出 Excel 报表；

场景 3：产品迭代痛点挖掘

业务目标：从评论提取用户真实反馈，给产品、供应链、品控提供依据。

• 技术链路：API 原始数据 → 文本清洗（去除 html、表情、特殊符号） → jieba 分词 / LLM 大模型抽取维度：做工、包装、物流、续航、尺寸、材质；
• 统计：各维度负面占比，高频吐槽词；
• 案例：家电评论发现大量反馈容量不足，指导产品升级规格。

场景 4：运营素材提取（好评文案、晒图素材）

• 筛选条件：score=5、isImage=1；过滤灌水无意义好评；
• 用途：商品详情文案、短视频带货脚本、卖点提炼；
• 合规提醒：图片、用户评价不能直接商用对外宣传，需要做脱敏处理。

场景 5：选品决策支撑

• 指标：好评率阈值（例如低于 90% 标记风险款）、差评集中问题、晒单率；
• 跨境铺货场景：Temu/Ozon 选品，通过京东评论判断货源风险，避开大量质量投诉的货源。

场景 6：评论数据 BI 报表看板

• 指标：每日评论增量、好评率变化曲线、晒单率、追评占比、差评关键词 TOP；
• 定时任务每日生成统计快照，用于后台可视化。

场景 7：AI 用户画像构建

• 提取：高频选购 sku 规格、用户关注点，构建商品维度用户画像；
• 输入大模型，做商品卖点生成、问答知识库。

6.1任务调度

• 增量任务：每 15‑30 分钟，拉取最新评论，只新增未入库 comment_id；
• 全量任务：每日凌晨低峰执行，不要高峰大批量拉取；
• 任务隔离：不同 sku 任务分开，支持暂停、失败重试。

6.2限流策略

• 严格遵守 QPS，请求之间 sleep；超限 429 响应，指数退避：1s，2s，4s，8s；最多重试 3 次。

6.3去重机制

• 核心：作为唯一主键；接口返回重复数据直接跳过，避免数据库重复。

6.4数据清洗

• content：去除转义字符、html 标签；过滤 “此用户没有填写评价” 这类空内容；
• images：URL 校验，过滤无效链接；
• 时间字段统一转为标准 datetime 入库。

6.5AI 分析链路（可选） 原始评论文本 → 清洗 → 调用大模型做情感分类（正向 / 中性 / 负向）、抽取问题维度、提取关键词。

7、常见错误码排错手册

8、Python 极简调用骨架（伪代码，生产需要补签名、token 刷新、重试）

python

import requests
import json

GATEWAY = "https://api.jd.com/routerjson"
APP_KEY = "xxx"
APP_SECRET = "xxx"
ACCESS_TOKEN = "xxx"

biz_param = {
    "skuId":"100012345678",
    "pageIndex":1,
    "pageSize":10,
    "score":0,
    "needAfterReview":1
}

public_params = {
    "method":"jingdong.comments.list",
    "app_key":APP_KEY,
    "access_token":ACCESS_TOKEN,
    "timestamp":"2026‑08‑06 10:20:00",
    "v":"2.0",
    "format":"json",
    "sign_method":"md5",
    "param_json":json.dumps(biz_param,ensure_ascii=False)
}
# 此处省略MD5签名生成逻辑，生成sign填入public_params["sign"]

resp = requests.post(GATEWAY, data=public_params, timeout=15)
res_data = resp.json()
if res_data.get("code") == "0":
    comments = res_data["data"]["comments"]
    for item in comments:
        print(item["id"], item["score"], item["content"])