淘宝获取商品评论接口 item_review 使用指南
一、接口概述
item_review（或 taobao.item.reviews.get）是淘宝开放平台提供的API接口，用于获取指定商品的评论信息，包括评论内容、评分、评论时间、评论者昵称、评论图片等。该接口支持按好评、中评、差评筛选，或按时间区间筛选评论，数据以JSON格式返回。
二、使用前准备
- 注册淘宝开放平台账号 访问淘宝开放平台，注册开发者账号并完成实名认证。
- 创建应用并获取API密钥 在控制台创建应用，填写应用名称、简介等信息。 创建完成后，获取App Key和App Secret，用于身份验证。
- 申请接口权限 在应用的权限管理页面搜索item_review接口，提交申请。 审核通过后，即可正式调用该接口。
三、接口调用方法
- 请求参数 必填参数： item_id：商品ID（可从商品详情页URL中获取，如https://item.taobao.com/item.htm?id=6789012345中的6789012345）。 选填参数： page_no：页码（默认为1）。 page_size：每页返回的评论数量（默认为20，最大为100）。 rate_type：评论类型（1为好评，2为中评，3为差评）。 has_image：是否包含评论图片（true或false）。
- 生成签名 将所有参数按字典序排序，拼接成字符串。 在字符串首尾分别添加App Secret，生成MD5签名并转为大写。
- 发送请求 使用HTTP GET请求，将参数和签名发送至接口地址：https://gw.api.taobao.com/router/rest。
四、Python示例代码
python
import requests
import hashlib
import time
def generate_sign(params, app_secret):
params = sorted(params.items(), key=lambda d: d[0])
params_str = app_secret
for key, value in params:
params_str += f"{key}{value}"
params_str += app_secret
sign = hashlib.md5(params_str.encode()).hexdigest().upper()
return sign
def get_item_reviews(app_key, app_secret, item_id, page_no=1, page_size=20):
url = "https://gw.api.taobao.com/router/rest"
params = {
"method": "taobao.item.reviews.get",
"app_key": app_key,
"item_id": item_id,
"page_no": page_no,
"page_size": page_size,
"timestamp": time.strftime('%Y-%m-%d %H:%M:%S', time.localtime()),
"format": "json",
"v": "2.0"
}
params["sign"] = generate_sign(params, app_secret)
response = requests.get(url, params=params)
return response.json()
# 示例调用
app_key = "your_app_key"
app_secret = "your_app_secret"
item_id = "6789012345"
reviews = get_item_reviews(app_key, app_secret, item_id)
print(reviews)
五、返回数据解析
- total_results：符合条件的评论总数。
- reviews：评论列表，每个评论包含以下字段： content：评论内容。 reply_time：评论时间。 nick：评论者昵称。 pics：评论图片URL列表。 rating：用户评分（1-5分）。
- error_response：调用失败时返回，包含错误码和错误信息。
六、注意事项
- 频率限制 淘宝API有调用频率限制，避免频繁请求。
- 数据隐私 处理用户评论数据时，需遵守相关法律法规，尊重用户隐私。
- 错误处理 接口调用可能失败，需做好错误处理（如网络问题、参数错误等）。
- 分页处理 评论数据可能较多，需通过page_no和page_size参数分页获取。
- 接口变更 不同API版本或开放平台可能返回字段略有差异，需参考具体文档。
