企业级淘宝评论 API最简说明，JSON 返回示例

下面直接给你企业级淘宝评论 API最简说明 + 可直接对标生产的 JSON 返回示例，只保留实战核心、无废话。

一、淘宝评论 API 简要说明（企业级）

1. 核心接口（TOP 开放平台）

接口名：（商品评论列表）
用途：按商品 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、限流、脏数据实时告警