1. 背景与合规前提
淘宝、天猫评论页反爬严重，翻页接口带动态签名、风控频控，爬虫方案不具生产可行性。合规且稳定的唯一官方通道是淘宝开放平台（TOP）。整体接入链路：注册开放平台账号 → 创建应用 → 申请评论接口权限 → 用 TOP SDK 签名鉴权调用。
2. 官方核心接口
表格
| 接口 | 用途 | 关键限制 |
|---|---|---|
taobao.item.reviews.get |
按商品 ID 获取评分 / 文字 / 晒图 / 追评 / 卖家回复，支持分页与筛选 | 标准接口，老单条接口已下线 |
taobao.traderates.get |
按订单查交易评价（商家视角） | 仅限 180 天内；需授权；只能查卖家给出 / 得到 |
tmall.traderate.feeds.get |
天猫订单评价 + 追评 + 语义标签 | 需授权 |
请求地址：正式环境 https://gw.api.taobao.com/router/rest，HTTPS https://eco.taobao.com/router/rest。
3. 接口调用（Python 示例）
from top.api import ItemReviewsGetRequest
from top import appinfo
req = ItemReviewsGetRequest(url="https://eco.taobao.com/router/rest")
req.set_app_info(appinfo(appkey="APP_KEY", secret="APP_SECRET"))
req.num_iid = "商品ID" # 商品数字ID
req.page_size = 20
req.page_no = 1
# 可按评分、是否有图、时间等维度筛选
resp = req.getResponse()
reviews = resp["item_reviews_get_response"]["reviews"]["review"]
for r in reviews:
print(r.get("content"), r.get("rate"), r.get("rate_date"))
签名鉴权：请求参数按 key 排序 + 拼接 secret 生成签名，TOP SDK 已封装，业务侧无需手写。
4. 常见返回字段
单条评论：content(正文)、rate(好评 / 中评 / 差评)、rate_date(时间)、has_pic(是否有图)、append_content(追评)、reply(卖家回复)、sku(规格)、nick(脱敏昵称)。
5. 两条技术路线的取舍
- 官方 API：合规性最高、官方背书；代价是要过账号 + 权限审核，且
traderates受限 180 天、按商品 / 订单维度拆分，批量或多平台场景不够灵活。 - 自研接口：在我们自己的服务端封装官方调用，做多平台统一、历史数据扩充、分页与字段归一化，对外暴露统一接口；适合竞品分析、舆情、选品这类批量需求。核心仍是合规数据源 + 自研聚合层。
6. 需要注意的限制
traderates超过 180 天查不到，需走千牛后台；- 部分评价需买卖双方互评后才可见；
- 返回字段以官方现网文档为准；
- 频控存在，避免对单商品高频请求。
