一、淘宝评论 API 简要说明（企业级）
1. 核心接口（TOP 开放平台）
接口名：
shturl.cc/d87yKyMdfTi8j（商品评论列表）用途：按商品 ID（num_iid）获取评论、评分、晒图、追评、商家回复、SKU、点赞等
适用场景：评论监控、舆情分析、好评率统计、竞品分析、内容风控
权限：企业认证 + 应用审核；仅可查公开评论，非公开 / 匿名部分字段脱敏
调用地址：
shturl.cc/Sfx7YWxEInW53mrnuPAw4RKvzXC格式：JSON（默认）
鉴权：
AppKey + AppSecret + HMAC-SHA1/MD5 签名QPS / 额度：企业通常 5–20 QPS，日额度 1 万–10 万（视资质）
2. 常用请求参数（极简）
num_iid：商品 ID（必填，如
680123456789）page_no：页码，默认 1
page_size：每页条数，最大 50
sort：排序，
create_time:desc（最新）/helpful:desc（最有用）rate_type：评论类型：
good/neutral/badhas_pic：是否有图：
true/false
二、企业级 JSON 返回参考（精简标准结构）
"item_reviews_get_response": {
"total_results": 12580,
"page_no": 1,
"page_size": 20,
"reviews": [
{
"review_id": 100000123456789,
"tid": 220812345678901,
"user_nick": "***小 buyer",
"is_anonymous": true,
"user_level": "V4",
"content": "面料舒服，尺码标准，上身好看！物流超快，包装严实，已经回购两次了。",
"score": 5,
"created": "2026-05-17 14:22:36",
"modified": "2026-05-17 14:22:36",
"like_count": 128,
"sku_info": {
"sku_id": 12345678901,
"properties_name": "颜色:白色;尺码:L"
},
"pic_urls": [
"shturl.cc/AkrRMHJ1RH4lxvJOmzKdkYK4TFVgYTgL6",
"shturl.cc/nutl8xW8rDcqCp33XMfQIVkJXlY7i9Cwt"
],
"append_review": {
"content": "穿了一周没起球，质量很稳",
"created": "2026-05-20 09:15:11",
"pic_urls": []
},
"seller_reply": {
"content": "感谢亲的认可！我们坚持品质第一～",
"created": "2026-05-17 15:01:22"
}
},
{
"review_id": 100000123456790,
"tid": 220812345678902,
"user_nick": "买家12345",
"is_anonymous": false,
"user_level": "V2",
"content": "版型偏小，建议拍大一码，整体还行。",
"score": 3,
"created": "2026-05-16 08:33:10",
"like_count": 45,
"sku_info": {
"sku_id": 12345678902,
"properties_name": "颜色:黑色;尺码:M"
},
"pic_urls": [],
"append_review": null,
"seller_reply": null
}
],
"request_id": "top_req_260517142200123"
}}三、关键字段（企业必用）
review_id：评论唯一 ID（去重 / 关联）
user_nick / is_anonymous：昵称 / 是否匿名（脱敏展示）
content：评论正文（舆情分析核心）
score：评分 1–5（好评率统计）
created：评论时间（时序 / 增量同步）
sku_info：对应 SKU（规格分析）
pic_urls：晒图 URL（内容风控 / 展示）
append_review：追评（长期口碑）
seller_reply：商家回复（服务质量）
total_results：总评论数（分页控制）
request_id：全链路追踪（排错必备）
四、企业级稳定性要点（极简）
QPS 限流：按企业配额，令牌桶平滑，避免 429
分页控制：单页≤50，最多 100 页，防止超时 / 被封禁
超时 + 重试：5s 超时；5xx / 超时指数退避（1/2/4s，最多 3 次）
数据校验：score∈[1,5]、content 非空、URL 合法、时间格式正确
缓存策略：Redis 缓存（5–10min），空结果缓存 60s，降低压力
监控告警：成功率 <99%、耗时> 3s、限流、脏数据实时告警
