技术实战:京东商品评论API (jd.item_review) 深度解析与标准JSON参考

知名用户180079054732小时前未分类3

前言

在电商竞品分析、口碑舆情监控及产品迭代调研中,用户评论是极具价值的一手数据源。相较于人工采集或前端逆向抓取,京东开放平台提供的 jd.item_review 接口能输出标准化、结构化的评价数据,涵盖主评、追评、评分、晒图视频、用户标签及商家回复等全维度信息。该接口是搭建舆情预警系统、NLP情感分析模型及竞品口碑数据库的核心基础设施。

一、接口核心基础信息

表格
项目说明
接口名称获取商品评论列表 (jd.item.reviews.get / jd.item_review)
接口版本v3 (稳定正式版)
请求协议HTTPS POST (推荐,避免URL超长) / GET
返回格式JSON
核心用途获取指定SKU的全量评论、追评、晒图、视频及商家回复数据
数据范围默认返回近180天内的用户评价(需申请进阶权限获取原文)

二、请求参数详解

调用该接口需分为‌公共参数‌(网关鉴权用)和‌业务参数‌(封装在 param_json 或 Body 中)。

1. 公共必选参数

表格
参数名类型必填描述
app_keyString应用AppKey(密钥测试:o0b.cn/anzexi)
methodString接口名,如 jd.item.reviews.get
access_tokenString用户授权令牌
timestampString时间戳,格式 yyyy-MM-dd HH:mm:ss
vStringAPI版本,通常 2.0
signString签名值 (MD5/SHA256)

2. 业务请求参数 (Body/param_json)

表格
参数名类型必填默认值描述
skuIdString-目标商品的SKU ID
pageIndexInteger1页码,从1开始
pageSizeInteger10每页条数,最大支持 ‌100
scoreInteger0评分筛选:0-全部, 1-差评, 2-中评, 3-好评, 4-晒单, 5-视频
isImageInteger0是否仅返回带图/视频评价:0-否, 1-是
needAfterReviewInteger0关键参数‌:是否返回追评数据。0-不返回, 1-返回(开发易遗漏)
sort_typeInteger0排序方式:0-推荐排序, 1-时间倒序, 2-高分优先, 3-低分优先

三、标准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
  }}


相关文章

Ozon 商品详情 API 合规调用:数据使用规范与频率限制管控

根据Ozon平台API使用政策及数据安全规范,结合实际业务场景,制定以下合规调用方案,涵盖数据使用边界与请求频率管控两大核心模块:📜 数据使用规范1. 字段使用权限矩阵字段类别允许用途禁止行为商品基础...

1688 跨境寻源通 API 免费对接・五大落地成功案例(适配文章直接使用)

说明:所有案例前期均依托寻源通免费基础额度完成技术验证与业务跑通,放量后扩容配额;覆盖跨境 ERP SaaS、独立站、代采服务商、店群自研系统、跨境选品工具五大主流赛道,附带业务痛点、技术方案、落地成...

技术实战:TikTok Video API 视频详情接口技术解析与标准JSON返回参考

前言在短视频内容分析、热点趋势挖掘、达人运营数据监控的业务场景中,TikTok视频详情API是开发者和内容运营从业者最核心的结构化数据入口。它无需搭建复杂的海外反爬代理体系,就能稳定获取全维度的Tik...

Python 请求淘宝 API 商品详情:简单说明 + JSON 返回参考

一、能帮程序员高效解决什么?一键获取商品完整数据:标题、价格、图片、SKU、库存、详情、发货地、商家信息告别手工复制,代码直接调用,1 秒拿到数据自动入库 / 同步店铺 / 生成报表,全流程自动化稳定...

Ozon Seller 商品详情 API(v2/product/info/list)接口详解与标准 JSON 返回示例

一、接口基础介绍Ozon 是俄罗斯头部跨境电商平台,/v2/product/info/list 是卖家侧标准商品详情批量查询接口,采用 POST 请求、Bearer Token 鉴权,支持批量传入pr...

技术实战:YouTube Video API 视频详情接口技术解析与标准JSON返回参考

前言在短视频内容分析、竞品监控、达人运营数据评估的业务场景中,YouTube Data API v3 的视频详情接口(Videos: list)是开发者和内容运营从业者最核心的结构化数据入口。它无需搭...

发表评论    

◎欢迎参与讨论,请在这里发表您的看法、交流您的观点。