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

知名用户180079054733小时前未分类5

前言

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


相关文章

Python 实现京东评论 API 数据准确性校验

Python 实现京东评论 API 数据准确性校验直接给你简洁可运行代码 + 标准 JSON 返回示例,用于校验京东商品评论 API 数据是否完整、合法、准确。一、校验逻辑(核心)校验 API 返回结...

如何使用 item_get 接口获取 1688 商品详情?(完整实操指南)

item_get 是 1688 商品详情 API 系列中最常用的第三方封装接口(基于阿里官方 alibaba.product.get 接口二次开发),特点是调用简洁、参数...

京东商品详情 API 介绍、业务场景与完整 JSON 返回参考

一、接口简介京东商品详情 API(联盟接口jd.union.open.goods.detail.query、商家接口jingdong.item.read.get),通过 SKU 编号查询商品完整信息,...

如何申请淘宝的详情API接口权限控制

要申请淘宝详情API接口(如taobao.item.get)的权限控制,需遵循以下流程并满足相应条件:一、申请条件主体资质企业认证:需提供营业执照、组织机构代码证、税务登记证等证件,确保企业合法合规经...

微店商品详情API接口系列,json数据返回

微店商品详情API接口使用指南(JSON数据返回)一、注册与权限获取账号注册访问微店开放平台,使用微店账号登录(若无账号需先注册)。完成实名认证(个人或企业),企业账号需提交营业执照,审核时间1-3个...

淘宝店铺所有商品 API 接口实战指南

主题极简上手:淘宝店铺商品 API 调用、频率与数据返回全解一、接口简介淘宝店铺商品 API 用于批量获取店铺在售 / 仓库商品,支持标题、价格、库存、主图、销量、SKU 等数据,常用于 ERP 同步...

发表评论    

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