淘宝商品评论API（taobao.item_review）

淘宝商品评论核心接口taobao.item_review.get（常简称为 taobao.item_review）的详细使用规则、调用细节和实操要点，这是阿里开放平台获取商品评论的核心接口。

一、接口核心信息（taobao.item_review.get）

1. 基础属性

2. 核心参数（补充高频参数）

除了基础必选参数外，该接口还有以下实用可选参数：

3. 典型返回数据结构（JSON）

json

{ "item_review_get_response": { "request_id": "123456", // 请求ID（用于排查问题） "total_results": 500, // 该商品总评论数 "reviews": { "review": [ { "id": "10086", // 评论ID "nick": "tbNick123", // 用户昵称（脱敏） "rate": 5, // 评分（1-5） "content": "商品质量很好，物流也快！", // 评论正文 "created": "2026-01-08 15:30:00", // 评论时间 "pic": "https://img.alicdn.com/xxx.jpg", // 晒图URL（多个用逗号分隔） "add_content": "用了一周，还是很好用", // 追评内容 "add_time": "2026-01-15 10:20:00", // 追评时间 "auction_sku": "颜色:白色;尺寸:XL" // 评论对应的商品规格 } ] } } }

二、完整可运行的 Python 调用示例（优化版）

该示例新增评分筛选、带图评论筛选功能，更贴合实际使用场景：

1. 环境准备

bash

pip install requests python-dotenv

2. 代码实现

python

运行

import requests import time import hashlib import json from dotenv import load_dotenv import os # 加载敏感配置（.env文件） load_dotenv() APP_KEY = os.getenv("TAOBAO_APP_KEY") APP_SECRET = os.getenv("TAOBAO_APP_SECRET") def generate_sign(params: dict, app_secret: str) -> str: """生成淘宝接口签名（严格遵循阿里规则）""" # 1. 按参数名ASCII升序排序 sorted_params = sorted(params.items(), key=lambda x: x[0]) # 2. 拼接签名字符串 sign_str = app_secret for key, value in sorted_params: if value is not None and value != "": sign_str += f"{key}{value}" sign_str += app_secret # 3. MD5加密并转大写 return hashlib.md5(sign_str.encode("utf-8")).hexdigest().upper() def call_taobao_item_review( num_iid: str, page_no: int = 1, page_size: int = 20, rate: int = None, # 筛选评分：1-5，None则不筛选 has_pic: bool = False # 是否只返回带图评论 ) -> dict | None: """ 调用taobao.item_review.get接口 :param num_iid: 商品ID :param page_no: 页码 :param page_size: 每页条数（1-20） :param rate: 评分筛选（1-5） :param has_pic: 是否只返回带图评论 :return: 评论数据字典，失败返回None """ # 1. 构造基础参数 params = { "method": "taobao.item.review.get", "app_key": APP_KEY, "timestamp": time.strftime("%Y-%m-%d %H:%M:%S", time.localtime()), "format": "json", "v": "2.0", "sign_method": "md5", "num_iid": num_iid, "page_no": page_no, "page_size": page_size } # 2. 添加可选筛选参数 if rate is not None and 1 <= rate <= 5: params["rate"] = rate if has_pic: params["has_pic"] = "true" # 接口要求字符串格式的true/false # 3. 生成签名 params["sign"] = generate_sign(params, APP_SECRET) # 4. 发送请求 url = "https://eco.taobao.com/router/rest" try: response = requests.post(url, params=params, timeout=10) response.raise_for_status() result = response.json() # 5. 处理错误响应 if "error_response" in result: err = result["error_response"] print(f"接口错误：[{err['code']}] {err['msg']}") return None return result["item_review_get_response"] except Exception as e: print(f"调用失败：{str(e)}") return None # -------------------------- 测试调用 -------------------------- if __name__ == "__main__": # 示例：获取商品1234567890的5星带图评论，第1页，每页10条 review_data = call_taobao_item_review( num_iid="1234567890", page_no=1, page_size=10, rate=5, has_pic=True ) if review_data: total = review_data.get("total_results", 0) print(f"找到{total}条符合条件的评论：") for idx, rev in enumerate(review_data["reviews"]["review"], 1): print(f"\n=== 评论{idx} ===") print(f"用户：{rev['nick']}") print(f"评分：{rev['rate']}星") print(f"内容：{rev['content']}") print(f"规格：{rev.get('auction_sku', '未知')}") print(f"晒图：{rev.get('pic', '无')}")

3. .env 文件配置示例

在项目根目录创建.env文件：

env

TAOBAO_APP_KEY=你的实际AppKey TAOBAO_APP_SECRET=你的实际AppSecret

三、常见问题与解决方案

四、进阶使用建议

1. 分页获取所有评论：通过total_results计算总页数，循环调用call_taobao_item_review并递增page_no，直到获取所有评论；
2. 数据存储：将评论数据存入 CSV/MySQL/MongoDB，方便后续分析（如情感分析、关键词提取）；
3. 异常重试：添加重试机制（如使用tenacity库），处理网络波动导致的临时失败；
4. 日志记录：记录每次调用的请求 ID、参数、响应结果，方便问题排查。

总结

1. taobao.item_review.get是获取淘宝商品评论的官方合规接口，核心是正确生成签名和申请接口权限；
2. 该接口支持评分、带图、追评等筛选条件，可精准获取目标评论数据；
3. 调用时需注意限流规则和数据合规性，敏感配置（AppKey/AppSecret）需避免硬编码。