淘宝商品评论API接口概述及JSON数据返回解析
一、接口核心功能
淘宝商品评论API(如taobao.item.reviews.get
)是淘宝开放平台提供的核心数据服务,支持开发者通过HTTP请求获取指定商品的评论数据,覆盖文字、图片、视频等多媒体内容,并支持筛选、分页、统计等高级功能。其典型应用场景包括:
- 商品优化:分析好评/差评内容,定位产品缺陷(如“电池不耐用”)或服务问题(如“发货慢”)。
- 竞品分析:抓取竞品评论,对比评分分布与用户关注点差异(如竞品差评高频词“尺寸不符”)。
- 舆情监控:实时抓取差评(评分≤3)并触发告警,辅助快速响应负面反馈。
- 营销策划:提取高频好评关键词(如“性价比高”),优化商品标题与广告文案。
二、接口调用流程
- 注册与认证
- 在关注博主注册账号,完成企业/个人实名认证。
- 创建应用并申请
taobao.item.reviews.get
接口权限,说明使用场景(如数据分析)。
- 构造请求参数
- 必填参数:
method
:接口名称(如taobao.item.reviews.get
)。app_key
:应用的唯一标识。item_id
:商品ID(如123456789
)。timestamp
:请求时间戳(格式:YYYY-MM-DD HH:MM:SS
)。sign
:MD5/HMAC-SHA256签名(用于验证请求合法性)。
- 可选参数:
page_no
:页码(默认1)。page_size
:每页评论数(默认20,最大100)。rate_type
:评论类型(good
/neutral
/bad
)。fields
:指定返回字段(如content,rating,user_nick
)。
- 生成签名(Python示例)
python import hashlib import time def generate_sign(params, app_secret): sorted_params = sorted(params.items(), key=lambda x: x[0]) sign_str = app_secret for k, v in sorted_params: if k != 'sign': sign_str += f"{k}{v}" sign_str += app_secret return hashlib.md5(sign_str.encode('utf-8')).hexdigest().upper() params = { 'method': 'taobao.item.reviews.get', 'app_key': 'YOUR_APP_KEY', 'item_id': '123456789', 'page_no': '1', 'page_size': '20', 'timestamp': time.strftime('%Y-%m-%d %H:%M:%S') } params['sign'] = generate_sign(params, 'YOUR_APP_SECRET')
- 发送请求与响应解析
- 成功响应(JSON示例):
json { "item_reviews_get_response": { "total_results": "4605", "reviews": [ { "tid": "123456789", "user_nick": "买家昵称1", "content": "商品质量很好,物流也很快!", "score": "5", "created": "2025-03-25 10:00:00", "pictures": [ "http://example.com/image1.jpg" ], "reply": { "seller_nick": "卖家昵称", "content": "感谢您的支持!", "reply_time": "2025-03-25 12:00:00" } } ] } }
三、JSON数据字段详解
- 评论基础信息
tid
:评论唯一标识符。user_nick
:评论者昵称。content
:评论正文内容。score
:评分(1-5分)。created
:评论时间(格式:YYYY-MM-DD HH:MM:SS
)。
- 多媒体与交互数据
pictures
:评论图片URL列表(如["http://example.com/image1.jpg"]
)。reply
:卖家回复内容(包含seller_nick
、content
、reply_time
)。
- 分页与统计信息
total_results
:商品总评论数。page_no
:当前页码。page_size
:每页返回数量。