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

知名用户180079054732个月前未分类147

前言

在电商竞品分析、口碑舆情监控及产品迭代调研中,用户评论是极具价值的一手数据源。相较于人工采集或前端逆向抓取,京东开放平台提供的 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
vString是API版本,通常 2.0
signString是签名值 (MD5/SHA256)

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

表格
参数名类型必填默认值描述
skuIdString‌是‌-目标商品的SKU ID
pageIndexInteger‌是‌1页码,从1开始
pageSizeInteger‌是‌10每页条数,最大支持 ‌100‌
scoreInteger否0评分筛选:0-全部, 1-差评, 2-中评, 3-好评, 4-晒单, 5-视频
isImageInteger否0是否仅返回带图/视频评价:0-否, 1-是
needAfterReviewInteger否0‌关键参数‌:是否返回追评数据。0-不返回, 1-返回(开发易遗漏)
sort_typeInteger否0排序方式: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
  }}


相关文章

Python 实现亚马逊商品详情 API 数据准确性校验(极简可用 + JSON 参考)

前言专门给程序员用的标准校验代码,适合亚马逊商品采集、数据分析、比价、铺货场景,确保数据准确、字段完整、格式合法。一、校验核心(必查项)校验 API 返回结构是否正常ASIN 商品 ID 必须存在且合...

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

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

淘宝详情API接口有哪些使用限制和要求

使用淘宝详情API接口时,需关注以下核心限制与要求,涵盖法律、技术、数据安全及运营等多个维度:一、法律与合规限制权限申请与数据使用范围接口权限控制:淘宝对商品详情API(如taobao.item.ge...

技术实战:淘宝商品详情接口技术解析与标准JSON返回参考

前言淘宝开放平台(TOP, Taobao Open Platform)的商品详情接口(taobao.item.get)是电商ERP、选品工具、多平台同步系统最核心的基础接口之一。该接口能够实时获取淘宝...

京东商品详情 API完整介绍与标准 JSON 返回示例

一、接口基础说明1. 基础调用信息接口名称:jd.union.open.goods.detail.query(京东联盟标准商品详情接口,对外数据采集通用)网关地址:o0b.cn/anzexi请求方式:...

淘宝/天猫获得淘宝商品评论 API 返回值说明

item_review-获得淘宝商品评论 [查看演示]  taobao.item_review公共参数请求地址: https://api-gw.onebound.cn/taobao...

发表评论    

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