淘宝商品评论API接口技术文档（完整JSON返回样例）
一、接口简介
淘宝商品评论核心接口
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、晒图、追评、用户行为全维度数据。通过标准化结构化清洗后，可直接支撑舆情监控、产品迭代、竞品分析、数据报表等企业级业务，是合规、稳定、可长期复用的电商数据解决方案。
