taobao.item.reviews.get 淘宝天猫商品评论API解析、调用参数与 JSON 返回示例

摘要

在电商竞品分析、商品口碑监控、情感分析项目开发中，淘宝开放平台 TOP 接口 taobao.item.reviews.get 是获取商品评价数据的官方途径。本文从接口能力、入参说明、返回字段、完整 JSON 样例、调用限制与踩坑点做完整拆解，附带 Python 简易调用示例，帮助开发者快速接入淘宝天猫商品评论 API。

正文大纲

1. taobao.item.reviews.get 接口概述

taobao.item.reviews.get 是淘宝开放平台 TOP 提供的商品评论查询接口，可拉取淘宝、天猫商品的用户评价内容，包含评价文本、晒图、评分、SKU 信息、评价时间等结构化数据。

适用场景：竞品口碑采集、差评预警、用户画像、商品舆情分析。

2. 接口基础信息

接口名称：taobao.item_review（taobaoapi2014 前往体验）

接口版本：v3（稳定正式版）

接口地址：c0b.cc/R4rbK2 （HTTPS，支持 GET/POST）

请求方式：GET / POST（推荐 POST，参数放 body 避免 URL 超长）

返回格式：标准 JSON

业务用途：根据商品 ID，全量获取商品评论基础评论信息、评论日期、图片、视频、评论者ID、追评、追评内容、视频图文等完整商品评论内容数据。

接口能力覆盖

1. 基础评价：星级评分、主评文本、评价时间、脱敏用户昵称
2. 追加评价：追评内容、追评时间
3. 多媒体：晒图图片 URL 数组
4. 订单维度：下单对应的 SKU 规格名称
5. 互动数据：评论有用点赞数、是否匿名评价
6. 商家侧：卖家回复内容、卖家回复时间
7. 筛选能力：支持按好评 / 中评 / 差评、是否带图进行过滤查询

3. 核心请求入参详解

重点提醒：fields 必须显式指定，不支持直接返回全部字段，只获取业务需要字段可降低响应体积、提升调用效率。

4. JSON 返回示例（简化版）

{
    "item_reviews_get_response": {
        "total_results": 1268,
        "reviews": {
            "review": [
                {
                    "id": "1000001",
                    "item_id": "723456789123",
                    "nick": "t***8",
                    "content": "商品做工不错，物流速度很快，推荐购买",
                    "rate": 5,
                    "sku_info": "颜色:黑色;尺码:L",
                    "pics": {
                        "pic_url": ["https://xxx.taobao.com/xxx.jpg"]
                    },
                    "created": "2026-08-15 14:22:10",
                    "anony": true
                },
                {
                    "id": "1000002",
                    "item_id": "723456789123",
                    "nick": "b***2",
                    "content": "实物和图片有差距，包装破损",
                    "rate": 2,
                    "sku_info": "颜色:白色;尺码:M",
                    "pics": {
                        "pic_url": []
                    },
                    "created": "2026-08-10 09:15:30",
                    "anony": true
                }
            ]
        }
    }
}

5. 关键字段说明

• total_results：评论总数
• id：评价唯一 ID
• content：评价正文
• rate：评分（1~5 分）
• sku_info：评价对应的商品规格
• pics：评价晒图地址数组
• created：评价创建时间
• anony：是否匿名评价

6. 接入常见问题与踩坑记录

1. 权限不足报错：应用需要在开放平台申请对应接口权限，个人应用与企业应用权限范围不同，部分类目限制开放。
2. 签名 sign 校验失败：参数排序错误、时间戳格式不对、密钥 secret 错误是高频原因。
3. 分页拿不全数据：接口存在最大可查询页数限制，不能无限分页回溯历史评价。
4. 返回字段为空：fields 参数书写错误，或者该条评价用户删除 / 屏蔽。
5. QPS 限流：TOP 接口有调用频次限制，高并发场景需要做请求队列、休眠限流。

7. 业务落地场景

1. 竞品监控：定时拉取竞品评价，统计好评 / 差评占比
2. 差评预警：实时监测新增负面评价，及时推送告警
3. 文本情感分析：基于评论内容做 NLP 情感挖掘，提炼用户痛点
4. 用户画像：汇总评价里高频关注点，辅助产品迭代

8. 重要合规提示

使用 TOP 官方接口需严格遵守淘宝开放平台协议，禁止超出接口授权范围存储、分发数据，不可用于爬虫绕过平台限制采集，商业项目务必评估授权边界。