一、接口简介
淘宝开放平台(Taobao Open Platform)提供了丰富的API接口,用于获取商品数据,其中商品评论接口(taobao.item.reviews.get)允许开发者获取指定商品的用户评价信息,包括评分、评论内容、用户昵称等。本接口适用于数据分析、口碑监控、商品推荐等场景。
二、准备工作
注册开发者账号
访问淘宝开放平台,注册账号并完成实名认证。
创建应用
在控制台创建应用,获取 App Key 和 App Secret(用于API鉴权)。
申请接口权限
为应用申请 商品评论接口 权限,需通过审核后方可调用。
三、接口文档核心参数
请求地址:https://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 = "https://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)技术分析用户情感,优化选品策略。建议参考淘宝开放平台官方文档获取最新接口变动。