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

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

前言

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


相关文章

Taobao & 1688 Product Review API: Enterprise Technical Overview & JSON Response Example

Theme: A practical technical guide to accessing Taobao and 1688 product review data via official API...

1688商品详情API返回的JSON数据

1688商品详情API返回的JSON数据结构复杂且信息丰富,通常包含以下核心字段和层级:一、顶层结构json{  "request_id": &quo...

1688 商品详情 API 接口全解析(调用、字段、异常、实战)

你关注的 1688 商品详情 API 接口(核心为alibaba.item.get)是获取 1688 批发商品结构化数据的官方通道,以下从接口基础信息、核心字段、调用规则、实战代码、常见问题五个维度,...

淘宝商品评论 API(taobao.item.reviews.get)完整介绍与标准 JSON 返回示例

一、接口基础说明1. 接口基础信息接口名称:taobao.item.reviews.get所属平台:淘宝开放平台 TOP(Taobao Open Platform)请求方式:HTTP POST/GET...

淘宝API:功能解析、使用指南与电商应用实践

一、淘宝API核心功能体系淘宝API(Application Programming Interface)作为阿里巴巴开放平台的核心组件,构建了连接淘宝生态与外部应用的数字化桥梁。其功能体系覆盖电商全...

小红书笔记评论 API 接口深度解析(带全套 JSON 示例・技术实战版)

一、接口基础说明1. 接口基础信息接口路径:/api/v1/note/comment/list(小红书开放平台标准评论接口)请求方式:POST鉴权规则:Header 携带Authorization:...

发表评论    

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