下面直接给你企业级淘宝评论 API最简说明 + 可直接对标生产的 JSON 返回示例，只保留实战核心、无废话。
一、淘宝评论 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/bad - has_pic：是否有图：
true/false
二、企业级 JSON 返回参考（精简标准结构）
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、限流、脏数据实时告警
