做电商运营、数据开发的朋友，一定绕不开「商品评论数据」—— 竞品口碑分析、用户需求挖掘、店铺舆情监控，都离不开它。
而京东开放平台的 JD.item_review 接口，正是获取京东商品评论数据的官方核心渠道，能直接抓取商品评价、晒图、评分、追评等关键信息，无需手动爬取，高效又合规。
今天就给大家整理了一份「保姆级接口指南」，从前期准备、参数配置，到调用流程、避坑技巧，新手跟着走也能快速对接，收藏起来直接用！
一、先搞懂：JD.item_review 接口到底能做什么？
JD.item_review 是京东开放平台专为「商品评论数据」设计的API接口，覆盖京东全品类商品，核心能力如下：
- ✅ 获取核心数据：用户评价内容、评分（1-5星）、晒图链接、追评内容、评价时间
- ✅ 多维筛选：支持按商品ID、评分等级（好评/中评/差评）、是否带图、时间排序筛选
- ✅ 分页采集：可控制页码、每页评论条数，满足大批量数据采集需求
适用场景也很广：电商竞品分析、自有店铺评论复盘、用户画像建模、舆情监控，甚至是电商工具开发，都能用到它。
二、前期准备：3步搞定接口接入权限
接口调用前，必须先完成开发者账号准备和权限申请，步骤很简单，跟着来就行：
- 注册并认证京东开发者账号
登录「京东开放平台」，注册个人或企业开发者账号（企业账号权限更高，建议运营/开发优先选企业认证），完成实名认证后，进入开发者后台。 - 创建应用，获取密钥
在后台「应用管理」中，新建应用，选择「数据服务」相关类目，提交应用信息等待审核（审核通常1-2个工作日）。
审核通过后，即可获取 AppKey、AppSecret 两个核心密钥，这是接口调用的“通行证”，务必妥善保存。 - 申请接口权限
在应用后台，找到「接口权限」模块，搜索「jd.item_review」，申请开通该接口权限。部分高级筛选权限（如批量商品查询）需提交业务说明，按要求填写即可。
三、核心重点：接口请求参数详解
调用接口时，需携带指定参数，以下是必传+常用参数，一目了然，直接对照配置：
参数名
类型
是否必传
核心说明
access_token
string
是
授权访问令牌，需通过OAuth2.0换取
productId
string
是
京东商品唯一ID（SKU编号），必填项
pageNum
int
否
页码，默认1，用于分页采集
pageSize
int
否
每页评论条数，最大限制50条
sort_type
int
否
排序：0推荐、1时间、2高分、3低分
score
int
否
评分筛选：0全部、1好评、2中评、3差评
has_image
int
否
是否晒图：0全部、1仅带图评论
💡 提示：参数需严格按照京东要求填写，格式错误会导致接口调用失败哦~
四、实操流程：5步完成接口调用
参数搞懂后，直接按以下步骤调用，新手也能快速上手：
- 用前期获取的 AppKey、AppSecret，通过 OAuth2.0 授权流程，获取授权Code；
- 用授权Code，兑换有效期内的 access_token（令牌有有效期，需定时刷新）；
- 按京东官方签名规则，生成请求签名，拼接所有请求参数；
- 发起接口请求，接收京东返回的 JSON 格式响应数据；
- 解析数据，提取评论内容、评分、晒图链接等所需字段，完成分页采集（如需大批量数据，可循环分页调用）。
五、避坑指南：常见报错及解决方法
很多新手调用接口时会踩坑，整理了4个最常见的报错，对应解决方法直接拿：
- ❌ 签名错误：检查 AppKey、AppSecret 是否正确，参数排序、URL编码是否符合京东规则；
- ❌ 权限不足：未开通 jd.item_review 接口权限，或应用审核未通过，重新申请权限即可；
- ❌ 请求频率超限：京东接口有调用频次限制，建议控制频率，采用重试机制，避免账号封禁；
- ❌ 数据为空：核对 productId 是否正确，或筛选参数设置过严（比如只选带图差评，可能无数据）。
六、最后：接口应用场景参考
学会调用接口后，这些场景能直接用起来，提升工作效率： - 📊 竞品分析：抓取同行商品好评、差评，挖掘用户痛点，优化自有商品；
- 📈 店铺运营：批量采集自有店铺评论，监控舆情，梳理用户需求；
- 🔧 工具开发：对接接口，开发电商数据后台、评论监控工具；
- 📝 数据分析：基于评论数据，做用户画像、商品评分建模。
以上就是 JD.item_review 接口的全流程指南，从准备到调用，再到避坑，覆盖所有核心要点。
