一、接口简介
淘宝开放平台(Taobao Open Platform)提供了丰富的API接口,用于获取商品数据,其中商品评论接口(taobao.item.reviews.get)允许开发者获取指定商品的用户评价信息,包括评分、评论内容、用户昵称等。本接口适用于数据分析、口碑监控、商品推荐等场景。
二、准备工作
注册开发者账号
访问淘宝开放平台,注册账号并完成实名认证。
创建应用
在控制台创建应用,获取 App Key 和 App Secret(用于API鉴权)。
申请接口权限
为应用申请 商品评论接口 权限,需通过审核后方可调用。
三、接口文档核心参数
请求地址:api.open.taobao.com/router/rest 请求方式:HTTP GET/POST
参数名 必选 说明 method 是 接口方法名,如 taobao.item.reviews.get item_id 是 商品ID(如:商品链接中的 id=123456) fields 是 返回字段,如 rate_content,result,user_nick page_no 否 分页页码,默认1 page_size 否 每页条数,默认20,最大100 session 否 用户授权码(部分接口需要) 四、Python示例代码 python Copy Code import requests from urllib.parse import urlencode
配置参数
app_key = "YOUR_APP_KEY" app_secret = "YOUR_APP_SECRET" item_id = "商品ID" # 例如:商品URL中的 id=123456
构造请求参数
params = { "method": "taobao.item.reviews.get", "app_key": app_key, "sign_method": "md5", "timestamp": "2023-10-01 12:00:00", "format": "json", "v": "2.0", "item_id": item_id, "fields": "rate_content,result,user_nick", "page_no": 1, "page_size": 20 }
生成签名(需按淘宝规则生成,此处为示例,实际需按官方文档实现)
def generate_sign(params, app_secret): # 签名逻辑参考淘宝文档 return "SIGN_VALUE"
params["sign"] = generate_sign(params, app_secret)
发送请求
url = "api.open.taobao.com/router/rest?" + urlencode(params) response = requests.get(url)
处理响应
if response.status_code == 200: data = response.json() reviews = data.get("item_reviews_get_response", {}).get("reviews", []) for review in reviews: print(f"用户:{review['user_nick']}") print(f"评分:{review['result']}") print(f"评论:{review['rate_content']}\n") else: print("请求失败:", response.text)
五、返回数据结构示例 json Copy Code { "item_reviews_get_response": { "reviews": [ { "user_nick": "买家昵称***", "rate_content": "商品质量很好,物流很快!", "result": "5", // 评分(1-5分) "created": "2023-09-30 14:20:00" } ], "total_results": 100 // 总评论数 } }
六、注意事项 权限限制:需确保应用已通过接口权限审核。 调用频率:免费版接口通常有QPS限制(如每秒5次),超出需购买API套餐。 数据脱敏:用户昵称等字段可能返回脱敏值(如**用户)。 签名生成:需严格按照淘宝规则生成签名,否则会返回鉴权错误。 七、常见问题 Q:如何获取商品ID? A:从商品详情页的URL中提取 id= 后的数值。 Q:返回空数据怎么办? A:检查 item_id 是否正确,或商品可能暂无评论。 Q:如何翻页获取全部评论? A:循环调用接口,递增 page_no 直至数据为空。 八、结语
通过淘宝商品评论接口,开发者可快速集成评价数据,结合自然语言处理(NLP)技术分析用户情感,优化选品策略。建议参考淘宝开放平台官方文档获取最新接口变动。