2026/1/21 5:46:52
网站建设
项目流程
网站建设具备知识技能,广州推广排名,高端品牌网站建设,网站建设需要的语言京东商品评论 API 是京东开放平台提供的标准化接口服务#xff0c;允许授权开发者获取商品的用户评价数据#xff0c;包括评论内容、评分、晒单图片、追评、商家回复等信息#xff0c;支持多维筛选与分页查询。以下是完整接入指南#xff1a;一、接口概述核心功能多维数据获…京东商品评论 API 是京东开放平台提供的标准化接口服务允许授权开发者获取商品的用户评价数据包括评论内容、评分、晒单图片、追评、商家回复等信息支持多维筛选与分页查询。以下是完整接入指南一、接口概述核心功能多维数据获取评论内容文字 / 图片 / 视频、用户评分1-5 星、时间戳、用户昵称脱敏、追评、商家回复、评论属性标签智能筛选按评分等级好评 / 中评 / 差评、评论类型首评 / 追评、时间范围筛选分页与排序支持页码 / 页大小设置最大 100 条 / 页按时间或推荐排序统计分析返回好评率、差评率、评论总数等摘要指标主要接口列表接口名称功能描述适用场景jingdong.ware.comment.get商品评价查询基础版商家获取自有店铺商品评论jd.item_review商品评论列表增强版支持更多筛选条件与数据字段jd.union.open.comment.query联盟商品评论查询京东联盟推广者使用jingdong.comments.list评论详情查询获取单条评论完整信息基础信息协议HTTPS强制请求方式GET/POST推荐 POST基础 URLc0b.cc/R4rbK2注册获取测试账号Taobaoapi2014添加V返回格式JSON认证方式AppKey AppSecret 签名机制 access_token部分接口二、接入准备流程1. 开发者账号注册与认证访问 c0b.cc/R4rbK2 注册账号完成实名认证个人 / 企业创建应用获取AppKey与AppSecret配置 IP 白名单接口调用必须绑定2. 接口权限申请基础权限个人开发者可申请限制单商品最多 50 条评论QPS3进阶权限需企业认证支持 200 条 / 商品QPS10含图片 / 视频字段高级权限品牌合作伙伴专属无数量限制支持完整数据维度申请材料应用场景说明越具体通过率越高、企业资质如适用3. 签名机制关键京东 API 采用MD5 签名生成规则按参数名 ASCII 升序排列所有请求参数包括公共参数与业务参数拼接为key1value1key2value2...格式末尾拼接app_secret你的AppSecret进行 MD5 加密32 位大写得到sign参数注意必须包含client_type参数如 pc 或 app否则签名验证失败三、核心接口详解以 jingdong.ware.comment.get 为例1. 公共请求参数所有接口必传参数名类型必须说明methodString是接口名称如jingdong.ware.comment.getapp_keyString是应用唯一标识timestampString是时间戳yyyy-MM-dd HH:mm:sssignString是签名结果vString是API 版本默认 1.0formatString否返回格式默认 jsonaccess_tokenString否访问令牌部分接口需要2. 业务请求参数参数名类型必须说明示例skuIdLong是商品 SKU 唯一标识12345678901pageInteger是页码起始 11pageSizeInteger是每页数量1-10020scoreInteger否评分筛选0 全部1 差评2 中评3 好评0sortTypeInteger否排序方式5 时间倒序6 推荐排序5commentTypeInteger否评论类型0 全部1 只看有图2 只看追评0startTimeString否开始时间yyyy-MM-dd HH:mm:ss2025-01-01 00:00:00endTimeString否结束时间yyyy-MM-dd HH:mm:ss2025-01-31 23:59:593. 调用示例Pythonpythonimport requests import hashlib import time # 配置参数 API_URL c0b.cc/R4rbK2 wechatid:Taobaoapi2014 # 配置参数 app_key 你的AppKey app_secret 你的AppSecret method jingdong.ware.comment.get sku_id 12345678901 page 1 page_size 20 # 生成时间戳 timestamp time.strftime(%Y-%m-%d %H:%M:%S) # 构造参数字典 params { method: method, app_key: app_key, timestamp: timestamp, v: 1.0, format: json, skuId: sku_id, page: page, pageSize: page_size, client_type: pc # 必须包含此参数 } # 生成签名 sorted_params sorted(params.items(), keylambda x: x[0]) sign_str .join([f{k}{v} for k, v in sorted_params]) app_secret app_secret sign hashlib.md5(sign_str.encode(utf-8)).hexdigest().upper() params[sign] sign # 发送请求 url https://api.jd.com/routerjson response requests.post(url, dataparams) result response.json() print(result)4. 返回数据格式json{ wareCommentResult: { commentSummary: { goodRate: 0.98, // 好评率 generalRate: 0.01, // 中评率 poorRate: 0.01, // 差评率 commentCount: 1562 // 总评论数 }, commentList: [ { id: 1234567890123, // 评论ID content: 商品质量很好物流很快, // 评论内容 score: 5, // 评分 creationTime: 2025-12-24 15:30:00, // 评论时间 userNickname: 京东用户***, // 脱敏昵称 isPlus: true, // 是否Plus会员 imageUrls: [https://img10.360buyimg.com/imagetools/jfs/t1/...], // 晒图 appendComment: { // 追评信息 content: 用了几天感觉非常不错, creationTime: 2025-12-26 10:15:00 }, reply: { // 商家回复 content: 感谢您的好评我们会继续努力, creationTime: 2025-12-24 16:00:00 } } // 更多评论... ], maxPage: 79, // 最大页码 currentPage: 1, pageSize: 20 } }四、权限与配额说明权限等级适用对象单商品评论上限QPS 限制可获取字段申请难度基础权限个人开发者50 条3基础文字 评分低进阶权限企业开发者200 条10含图片 追评中高级权限品牌 / ISV无限制50完整数据 统计高注意非自有店铺商品的评论数据获取需特殊权限需提供合作证明与详细使用场景五、注意事项与最佳实践合规性要求评论数据仅用于自身业务分析不得转售或公开传播。必须遵守京东开放平台《数据使用协议》。用户昵称等隐私信息已脱敏不得尝试破解。接口调用优化合理设置pageSize建议 20-50 条 / 页避免频繁调用。缓存评论数据减少重复请求。处理接口限流HTTP 429实现自动重试机制。常见问题排查签名错误检查参数排序、client_type 是否存在、AppSecret 是否正确。权限不足确认申请的接口权限与调用商品范围匹配。数据为空检查 SKU 是否正确、商品是否有评论、筛选条件是否过严。版本更新关注京东开放平台公告及时适配接口变更。定期更新 access_token如使用避免过期失效。