首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >京东商品评论API接口解析(附JSON样例)

京东商品评论API接口解析(附JSON样例)

原创
作者头像
用户1597063760
发布2026-09-12 13:50:09
发布2026-09-12 13:50:09
10
举报
文章被收录于专栏:经验经验

摘要

在电商竞品口碑分析、差评预警、用户痛点挖掘场景中,京东商品评论、追评、晒单内容是核心数据源。很多项目一开始选择网页爬虫抓取评论数据,但是京东页面动态渲染、反爬策略严格、分页逻辑复杂,爬虫维护成本高,还存在合规风险。本文基于京东宙斯 JOS 开放平台商品评论接口,讲解接口基础规范、请求入参、返回字段,附带标准 JSON 返回样例,梳理字段解析要点、边界处理、开发踩坑与业务落地场景,提供合规稳定的官方接口方案。

1. 接口基础信息

jd .item.reviews.get为京东平台商品评论接口,是电商口碑数据的核心数据源。商品详情接口只能拿到商品基础信息,真实用户评价、追评、晒图、差评痛点全部依赖本接口获取。

接口名称:jd.item_review(taobaoapi2014 前往体验)

接口版本:v3(稳定正式版)

接口地址:o0b.cn/opandy (HTTPS,支持 GET/POST)

请求方式:GET / POST(推荐 POST,参数放 body 避免 URL 超长)

返回格式:标准 JSON

业务用途:根据商品 ID,全量获取商品评论基础评论信息、评论日期、图片、视频、评论者ID、追评、追评内容、视频图文等完整商品评论内容数据。

核心业务适用场景

舆情与差评预警:定时监控自有或竞品 SKU,识别差评、负面关键词,实现告警推送,感知批量质量、售后问题。

竞品口碑调研:批量统计竞品好评率、差评高频问题,挖掘用户痛点,辅助选品与产品迭代。

NLP 情感分析:把结构化评论文本送入 AI 模型,自动做情感倾向归类、观点提取、标签统计。

选品决策辅助:结合晒单、追评数据,评估商品真实市场反馈,过滤刷单类无效评价。

商家回复效果分析:采集商家回复内容,统计回复率、回复时效,优化客服运营策略。

说明:京东评论接口支持按 SKU 查询评价,可分页拉取,可获取好评 / 中评 / 差评,部分接口支持读取晒单图片,用于用户口碑分析。

2. 请求入参说明

参数名

是否必传

说明

app_key

京东开放平台应用密钥

method

评论接口方法名

timestamp

13 位毫秒时间戳

v

协议版本,一般 2.0

sign_method

签名算法:sha256

sign

参数排序后加密生成的签名串

access_token

授权令牌,部分接口需要

skuId

商品 SKU 编号

page

页码,从 1 开始

pageSize

单页评论条数,受接口配额限制

sortType

排序类型,如最新、推荐

推荐入参组合:skuId,page,pageSize,sortType

3. 返回核心字段说明

外层根节点:code、message、result,评论数组在result.commentList

字段

数据类型

说明

开发注意事项

commentId

string

评价唯一 ID

数据主键,用于去重

skuId

string

商品 SKU 编号

关联商品详情数据

content

string

评价正文内容

用户原始评价文字

score

int

评价星级

1~5 星,1 最差 5 最好

creationTime

string

评价创建时间

yyyy-MM-dd HH:mm:ss

nickName

string

用户昵称

平台自动脱敏

images

array

晒单图片数组

无晒图时为空数组,图片带防盗链

video

object

评价视频

无视频晒单时为 null

afterCommentContent

string

追评内容

无追评则为空字符串

afterCommentTime

string

追评时间

无追评为空

productAttr

string

购买规格

如:黑色 16G 版本

usefulVoteCount

int

评论点赞数

其他用户觉得有用的数量

4. JSON 返回样例

代码语言:javascript
复制
{
    "code": 0,
    "message": "success",
    "result": {
        "totalCount": 1562,
        "commentList": [
            {
                "commentId": "C202609120001",
                "skuId": "100089765432",
                "content": "音质不错,降噪效果符合预期,续航时间长",
                "score": 5,
                "creationTime": "2026-08-25 09:30:15",
                "nickName": "j***k",
                "images": [
                    "https://img10.360buyimg.com/n1/review1.jpg",
                    "https://img10.360buyimg.com/n1/review2.jpg"
                ],
                "video": null,
                "afterCommentContent": "",
                "afterCommentTime": "",
                "productAttr": "黑色|标准版",
                "usefulVoteCount": 26
            },
            {
                "commentId": "C202609120002",
                "skuId": "100089765432",
                "content": "连接偶尔断连,性价比一般",
                "score": 3,
                "creationTime": "2026-08-26 16:12:40",
                "nickName": "l***7",
                "images": [],
                "video": null,
                "afterCommentContent": "使用一周,断连情况变多了",
                "afterCommentTime": "2026-09-02 10:05:22",
                "productAttr": "白色|顶配版",
                "usefulVoteCount": 42
            }
        ]
    }
}

5. 调用流程简述

  1. 在京东宙斯开放平台创建应用,申请商品评论接口权限,获取 appKey、appSecret;
  2. 组装公共参数、业务参数,参数按规则排序,SHA256 生成 sign 签名;
  3. 传入 skuId、分页参数,发起 POST 请求;
  4. 循环分页读取commentList,以 commentId 做唯一标识,完成数据去重;
  5. 数据入库,可联合商品详情接口,构建完整的商品口碑数据集;
  6. 业务侧:差评监控、高频问题挖掘、竞品口碑分析。

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

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

目录
  • 摘要
  • 1. 接口基础信息
  • 2. 请求入参说明
  • 3. 返回核心字段说明
  • 4. JSON 返回样例
  • 5. 调用流程简述
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档