淘宝评论Api 实用场景json 数据返回

| 参数 | 说明 | |------|------| | num_iid | 商品 ID（必填） | | page_no | 页码，默认 1 | | page_size | 每页条数，最大 20 | | rate_type | 评价类型：1 好评 / 0 中评 /-1 差评 | | sort | create_time:desc 最新 /helpful:desc 最热 |

权限：企业认证应用，仅可拉取公开评价，用户昵称、ID 脱敏

二、全量标准返回 JSON 示例（可直接解析）

json

 

{
    "item_reviews_get_response": {
        "total_results": 2860,
        "page_no": 1,
        "page_size": 20,
        "reviews": [
            {
                "review_id": "7295689452365896235",
                "num_iid": "6801234567890",
                "tid": "245896325896325896",
                "user_nick": "小***柚",
                "display_user_nick": "小***柚",
                "is_anonymous": false,
                "user_level": "V4",
                "user_vip": true,
                "content": "面料柔软，尺码标准，做工精细，性价比很高，物流次日达",
                "score": 5,
                "rate_type": 1,
                "rate_text": "好评",
                "created": "2026-04-12 09:22:36",
                "auction_sku": "颜色:黑色;尺码:XL",
                "useful_count": 36,
                "pic_urls": [
                    "https://img.alicdn.com/imgextra/i1/O1CN01xxxxxx1.jpg",
                    "https://img.alicdn.com/imgextra/i1/O1CN01xxxxxx2.jpg"
                ],
                "has_image": true,
                "is_append": true,
                "append_content": "穿洗两周不起球，没有掉色，已经回购两件",
                "append_time": "2026-04-26 16:10:22",
                "reply": {
                    "reply_content": "感谢认可，我们会持续把控面料品质~",
                    "reply_time": "2026-04-12 10:05:12"
                }
            },
            {
                "review_id": "7295689452365896236",
                "num_iid": "6801234567890",
                "tid": "245896325896325897",
                "user_nick": "猫***9",
                "display_user_nick": "猫***9",
                "is_anonymous": false,
                "user_level": "V2",
                "user_vip": false,
                "content": "尺码整体偏大，洗一次轻微掉色，线头较多，不值这个价",
                "score": 2,
                "rate_type": -1,
                "rate_text": "差评",
                "created": "2026-04-15 14:08:12",
                "auction_sku": "颜色:白色;尺码:L",
                "useful_count": 18,
                "pic_urls": [],
                "has_image": false,
                "is_append": false,
                "append_content": "",
                "append_time": "",
                "reply": {
                    "reply_content": "非常抱歉给您不好体验，联系客服可补发运费退换",
                    "reply_time": "2026-04-15 15:20:40"
                }
            }
        ]
    }
}

 

三、关键字段释义（业务解析必备）

外层分页统计

total_results：商品全部评价总数

page_no/page_size：当前页码、每页条数，用于分页循环抓取

单条评价核心字段

标识类

review_id：评价唯一 ID，去重主键

num_iid：商品 ID

tid：订单交易 ID

用户脱敏信息

user_nick/display_user_nick：脱敏昵称（无法获取完整用户名）

user_level：淘宝 V 等级 V1~V6

user_vip：是否 88VIP

is_anonymous：是否匿名评价

评分 & 文本

score：星级 1~5

rate_type：1 好评 / 0 中评 /-1 差评

content：初次评价正文

append_content：追评内容

规格与素材

auction_sku：下单规格（颜色 / 尺码 / 容量），SKU 痛点分析核心

pic_urls：买家晒图 URL 数组，空则无图

has_image：布尔值，快速筛选带图评价

互动时间

created：初次评价时间

append_time：追评时间

useful_count：其他买家点 “有用” 数量

商家回复

reply.reply_content：商家回复文案

reply.reply_time：回复时间

四、五大实用落地场景 + 对应数据用法

场景 1：商家售后差评实时监控预警

需求：实时抓取 1/2 星差评，关键词（掉色、破损、漏发、异味）触发企微 / 短信告警 用到字段 score <=2、rate_type=-1、content、auction_sku、created 逻辑：定时拉取最新页评论，文本关键词匹配，记录对应 SKU 方便针对性处理。

场景 2：竞品口碑 & 用户痛点分析（电商选品 / 产品迭代）

需求：批量抓取竞品全量评价，统计差评高频词、各 SKU 问题分布、好评卖点 用到字段 content/append_content、score、auction_sku、pic_urls、useful_count 落地

分词提取高频负面词：尺码不准、续航短、包装差；

按 SKU 分组统计差评占比，判断哪个规格缺陷最多；

高useful_count评价代表真实普遍痛点，权重加高。

场景 3：商品详情营销素材提取（买家秀 / 好评文案）

需求：自动筛选 5 星带图好评，提取优质文案用于主图、详情、直通车 筛选条件 score=5 && has_image=true && useful_count>10 用到：content、pic_urls、auction_sku，可下载图片作为官方素材。

场景 4：SKU 库存与规格优化决策

需求：分析不同颜色 / 尺码用户反馈，淘汰差评多规格、加大好评规格备货 核心分组字段：auction_sku 示例统计维度：

XL 黑色好评率 92%，白色 L 好评率 65% → 减少白色 L 库存

场景 5：情感分析 & 口碑看板可视化

需求：搭建后台数据大盘：每日好评率、差评趋势、追评率、晒图率 统计指标

好评率 = 5/4 星评价数 /total_results

晒图率 = has_image=true条数 / 总评价

追评率 = is_append=true条数 / 总评价

日评价趋势：按created日期聚合数量

五、异常返回 JSON（错误示例）

无权限 / 参数错误、调用超限返回：

json

 

{
    "error_response": {
        "code": "52",
        "msg": "缺少Appkey参数",
        "sub_code": "isv.missing-appkey",
        "sub_msg": "请求必须传入app_key"
    }
}


审核编辑 黄宇