淘宝商品评论API接口技术文档（完整JSON返回样例）

原创

Anzexi58

发布于 2026-06-05 16:03:20

590

文章被收录于专栏：API接口开发API接口开发

前言

一、接口简介

淘宝商品评论核心接口 taobao.item.reviews.get 是淘宝开放平台（TOP）官方评论数据接口，用于获取商品全部用户评价、晒图、追评、评分、SKU规格、用户信息。

广泛用于：差评监控、舆情分析、竞品口碑采集、商品质量分析、用户反馈挖掘等场景。相比爬虫，官方API具备合规、稳定、字段标准、更新实时的优势。

二、接口基础信息

接口名称：taobao.item.reviews.get
请求方式：HTTPS POST/GET
接口网关：o0b.cn/anzexi
分页规则：page_no / page_size（最大100条/页，最多100页）
鉴权方式：TOP标准签名机制（AppKey + AppSecret + Sign）
数据包含：主评、追评、晒图、SKU规格、评分、评价时间、脱敏用户信息、有用数

三、通用请求参数

核心业务请求参数（最简可用）：

num_iid：淘宝商品ID（必填）
page_no：页码
page_size：每页数量
fields：指定返回字段，优化性能

四、官方原始完整返回 JSON（真实可复用）

以下为淘宝评论API完整原生返回JSON样例，包含：主评论、晒图、SKU规格、用户信息、追评、点赞有用数、评价时间等全量字段。

{
    "item_reviews_get_response": {
        "total_results": 2860,
        "reviews": [
            {
                "review_id": "1456789923456789012",
                "user_nick": "tb***9876",
                "display_user_nick": "tb***9876",
                "content": "面料非常舒服，纯棉材质，上身很宽松，性价比超高，已经推荐朋友购买了！",
                "score": 5,
                "created": "2026-05-20 10:22:16",
                "auction_sku": "颜色:黑色;尺码:XL",
                "useful_count": 36,
                "pic_urls": [
                    "https://img.taobao.com/imgextra/i1/xxx1.jpg",
                    "https://img.taobao.com/imgextra/i1/xxx2.jpg"
                ],
                "user_level": "V4",
                "is_append": false,
                "append_content": "",
                "append_time": "",
                "num_iid": "6801234567890"
            },
            {
                "review_id": "1456789923456789013",
                "user_nick": "小***猫",
                "display_user_nick": "小***猫",
                "content": "尺码偏大，洗了一次轻微掉色，整体还行",
                "score": 3,
                "created": "2026-05-18 16:35:10",
                "auction_sku": "颜色:白色;尺码:L",
                "useful_count": 12,
                "pic_urls": [],
                "user_level": "V3",
                "is_append": true,
                "append_content": "穿了一周，没有变形，日常穿完全没问题",
                "append_time": "2026-05-22 09:12:00",
                "num_iid": "6801234567890"
            }
        ]
    }
}

五、核心字段详细说明

字段	说明
total_results	商品总评价数
review_id	评论唯一ID（去重主键）
content	用户主评论内容
score	评分 1~5星（1差评、5好评）
created	评论创建时间
auction_sku	用户购买的规格型号
pic_urls	晒图数组，无图为空数组
useful_count	评论被点击“有用”次数
is_append	是否包含追评
append_content	追评内容
append_time	追评时间
display_user_nick	脱敏展示昵称（合规字段）

六、标准化结构化JSON（开发落地模型）

原生JSON嵌套深、字段杂乱，业务开发需清洗为扁平化标准结构，可直接入库、做统计、舆情分析：

{
    "num_iid": "6801234567890",
    "total_review": 2860,
    "review_list": [
        {
            "review_id": "1456789923456789012",
            "user_nick": "tb***9876",
            "score": 5,
            "score_type": "好评",
            "content": "面料非常舒服，纯棉材质，上身很宽松，性价比超高，已经推荐朋友购买了！",
            "sku_spec": "颜色:黑色;尺码:XL",
            "create_time": "2026-05-20 10:22:16",
            "useful_count": 36,
            "pic_list": [
                "https://img.taobao.com/imgextra/i1/xxx1.jpg",
                "https://img.taobao.com/imgextra/i1/xxx2.jpg"
            ],
            "has_append": false,
            "append_content": "",
            "append_time": ""
        },
        {
            "review_id": "1456789923456789013",
            "user_nick": "小***猫",
            "score": 3,
            "score_type": "中评",
            "content": "尺码偏大，洗了一次轻微掉色，整体还行",
            "sku_spec": "颜色:白色;尺码:L",
            "create_time": "2026-05-18 16:35:10",
            "useful_count": 12,
            "pic_list": [],
            "has_append": true,
            "append_content": "穿了一周，没有变形，日常穿完全没问题",
            "append_time": "2026-05-22 09:12:00"
        }
    ]
}

七、接口错误返回JSON（异常处理）

{
    "error_response": {
        "code": 15,
        "msg": "Invalid signature",
        "sub_msg": "签名错误"
    }
}

{
    "error_response": {
        "code": 22,
        "msg": "Insufficient permissions",
        "sub_msg": "接口权限不足"
    }
}

{
    "error_response": {
        "code": 429,
        "msg": "Too many requests",
        "sub_msg": "调用频率超限"
    }
}

八、技术开发要点

去重逻辑：以review_id 作为唯一主键，防止重复入库
评分归类：1-2星=差评、3星=中评、4-5星=好评，用于口碑统计
追评识别：通过 is_append 区分主评/追评数据
增量更新：按评论时间分页拉取，减少API调用量
合规处理：用户昵称自动脱敏，禁止存储隐私信息

九、适用业务场景

商品差评实时监控与预警
竞品口碑、用户痛点数据挖掘
评论情感分析、好评率统计
SKU规格用户反馈分析（哪个尺码/颜色问题最多）
晒图质量、买家秀素材采集

十、总结

淘宝商品评论API是电商数据开发的核心接口，原生JSON覆盖评价内容、评分、SKU、晒图、追评、用户行为全维度数据。通过标准化结构化清洗后，可直接支撑舆情监控、产品迭代、竞品分析、数据报表等企业级业务，是合规、稳定、可长期复用的电商数据解决方案。

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

api-key

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

api-key

登录后参与评论

0 条评论

热度