首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >技术实战:京东商品评论API (jd.item_review) 深度解析与标准JSON参考

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

原创
作者头像
Anzexi58
发布2026-09-10 17:35:38
发布2026-09-10 17:35:38
1050
举报
文章被收录于专栏:API接口开发API接口开发

前言

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

一、接口核心基础信息

表格

项目

说明

‌接口名称‌

获取商品评论列表 (jd.item.reviews.get / jd.item_review)

‌接口版本‌

v3 (稳定正式版)

‌请求协议‌

HTTPS POST (推荐,避免URL超长) / GET

‌返回格式‌

JSON

‌核心用途‌

获取指定SKU的全量评论、追评、晒图、视频及商家回复数据

‌数据范围‌

默认返回近180天内的用户评价(需申请进阶权限获取原文)

二、请求参数详解

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

1. 公共必选参数

参数名

类型

必填

描述

app_key

String

应用AppKey(密钥测试:o0b.cn/anzexi)

method

String

接口名,如 jd.item.reviews.get

access_token

String

用户授权令牌

timestamp

String

时间戳,格式 yyyy-MM-dd HH:mm:ss

v

String

API版本,通常 2.0

sign

String

签名值 (MD5/SHA256)

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

参数名

类型

必填

默认值

描述

skuId

String

‌是‌

-

目标商品的SKU ID

pageIndex

Integer

‌是‌

1

页码,从1开始

pageSize

Integer

‌是‌

10

每页条数,最大支持 ‌100‌

score

Integer

0

评分筛选:0-全部, 1-差评, 2-中评, 3-好评, 4-晒单, 5-视频

isImage

Integer

0

是否仅返回带图/视频评价:0-否, 1-是

needAfterReview

Integer

0

‌关键参数‌:是否返回追评数据。0-不返回, 1-返回(开发易遗漏)

sort_type

Integer

0

排序方式:0-推荐排序, 1-时间倒序, 2-高分优先, 3-低分优先

三、标准JSON返回参考示例

以下是经过清洗和标准化的成功响应结构,包含评论摘要统计、热门标签及详细评论列表。

代码语言:javascript
复制
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
  }
}

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 前言
    • 一、接口核心基础信息
    • 二、请求参数详解
      • 1. 公共必选参数
      • 2. 业务请求参数 (Body/param_json)
    • 三、标准JSON返回参考示例
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档