淘宝商品评论API接口使用流程
一、注册与权限获取
- 账号注册与实名认证
- 访问淘宝开放平台,使用淘宝账号登录,完成企业或个人实名认证。
- 企业认证:需提交营业执照、对公账户信息等,审核通过后可获得更高调用配额。
- 个人认证:需上传身份证,但调用频率受限(默认每日100次)。
- 创建应用
- 进入“开发者中心 > 应用管理”,点击“创建应用”。
- 填写应用信息:
- 应用名称:如“商品评论分析工具”。
- 应用类型:选择“网页应用”或“移动应用”。
- 回调地址:需HTTPS备案(若涉及OAuth授权)。
- 提交审核,等待1-3个工作日。
- 申请API权限
- 在应用详情页的“API权限管理”中,搜索并申请以下接口:
taobao.item.reviews.get(获取商品评论列表)。- 可选:
taobao.trade.receivestatus.get(辅助获取订单评论状态)。
- 填写申请理由(如“竞品分析需求”),等待1-3个工作日审核。
- 获取凭证
- 审核通过后,在应用详情页查看
App Key和App Secret,需妥善保管。
二、API调用步骤
- 生成签名(HMAC-SHA1/MD5)
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: sign_str += f"{k}{v}" sign_str += app_secret # 使用HMAC-SHA1加密(淘宝推荐) return hashlib.sha1(sign_str.encode()).hexdigest().upper()
- 构造请求参数
python params = { "method": "taobao.item.reviews.get", "app_key": "YOUR_APP_KEY", "num_iid": "123456789", # 商品ID(从URL提取) "page_no": 1, # 页码 "page_size": 20, # 每页条数(最大100) "rate_type": "1", # 1=好评,2=中评,3=差评 "timestamp": time.strftime("%Y-%m-%d %H:%M:%S"), "format": "json", "v": "2.0" } params["sign"] = generate_sign(params, "YOUR_APP_SECRET")
- 发送请求并解析响应
python import requests response = requests.get("https://eco.taobao.com/router/rest", params=params) data = response.json() if data["code"] == "200": for comment in data["item_reviews_get_response"]["reviews"]: print(f"用户: {comment['user_nick']}") # 昵称可能脱敏(如g**0) print(f"评分: {comment['result']}") print(f"评论: {comment['rate_content']}\n") else: print(f"错误码: {data['code']}, 消息: {data.get('msg', '未知错误')}")
三、关键参数说明
| 参数名 | 类型 | 必填 | 说明 |
num_iid |
String | 是 | 商品ID,从URL提取(如https://item.taobao.com/item.htm?id=123456789中的123456789)。 |
page_no |
Number | 否 | 页码,默认为1。 |
page_size |
Number | 否 | 每页条数,默认为20,最大100。 |
rate_type |
String | 否 | 评论类型:1(好评)、2(中评)、3(差评)。 |
has_image |
Boolean | 否 | 是否包含图片评论(需在fields中指定)。 |
四、注意事项
- 频率限制
- 个人开发者:每日100次。
- 企业开发者:默认10,000次/天,可申请提额至100,000次/天。
- 单IP限制:每秒不超过5次调用。
- 隐私保护
- 用户昵称、手机号等字段可能返回脱敏值(如
g**0)。 - 禁止存储用户敏感信息(如地址、联系方式)。
- 错误处理
- 40001:签名错误(检查参数排序和加密算法)。
- 30001:权限不足(确认API权限已审核通过)。
- 10001:参数错误(检查商品ID格式和必填字段)。
- 分页控制
- 通过
page_no和page_size分页获取数据,避免单次请求数据量过大。
五、应用场景案例
- 竞品分析工具
- 抓取竞品评论数据,统计差评高频词(如“尺寸不符”),针对性优化产品描述。
- 智能客服系统
- 实时监测差评并触发告警,自动分配工单至客服团队,缩短响应时间。
- 营销文案生成
- 提取高频好评关键词(如“性价比高”),自动生成商品标题与广告文案。