前言
平台（Taobao Open Platform, TOP）提供的商品评价接口（taobao.item.review.get 或 alibaba.reviews.list）是获取天猫/淘宝商品用户反馈的核心渠道。该接口支持按时间、评分、是否有图等维度筛选评论，广泛应用于竞品分析、舆情监控及选品决策系统。由于阿里系API鉴权体系较为复杂，且涉及用户隐私保护，正确理解其参数结构与返回规范至关重要。
一、接口核心基础信息
表格
项目 |
说明 |
接口名称 |
获取商品评价列表 (taobao.item.review.get) |
请求协议 |
HTTPS POST (推荐) / GET |
数据格式 |
JSON (默认) / XML |
测试地址 |
o0b.cn/anzexi |
鉴权方式 |
TopAppKey + AppSecret + SessionKey (OAuth2.0) + Sign签名 |
适用场景 |
商品口碑分析、差评预警、晒图素材采集、竞品调研 |
二、核心请求参数解析
调用淘宝API需严格遵循TOP签名规范，所有参数参与签名计算。
1. 公共必选参数
表格
参数名 |
类型 |
必填 |
描述 |
app_key |
String |
是 |
应用AppKey，在淘宝开放平台创建应用后获取 |
method |
String |
是 |
API接口名称，如 taobao.item.review.get |
session |
String |
是 |
用户授权SessionKey，代表当前操作者的身份权限（部分公开接口可能不需要，但评价接口通常需商家或高级权限） |
timestamp |
String |
是 |
时间戳，格式 yyyy-MM-dd HH:mm:ss，时区为东八区 |
v |
String |
是 |
API协议版本，通常为 2.0 |
sign_method |
String |
是 |
签名算法，推荐 hmac-sha256 |
sign |
String |
是 |
签名值，由AppSecret对参数排序拼接后加密生成 |
format |
String |
否 |
返回格式，默认为 json |
2. 业务请求参数
表格
参数名 |
类型 |
必填 |
描述 |
num_iid |
Long |
是 |
商品数字ID（Item ID），即淘宝商品详情页URL中的id参数 |
page_no |
Integer |
否 |
页码，从1开始，默认1 |
page_size |
Integer |
否 |
每页条数，最大支持 100，默认40 |
sort_type |
String |
否 |
排序方式：feedbackdate:desc (时间倒序), feedbackdate:asc (时间正序) |
type |
String |
否 |
评价类型：all (全部), good (好评), normal (中评), bad (差评), image (有图), video (有视频) |
show_append |
Boolean |
否 |
是否显示追评，默认 false。若为 true，返回结构中会包含追加评价内容 |
三、标准JSON返回参考示例
以下是基于淘宝开放平台规范整理的标准成功响应结构。注意：出于隐私保护，用户昵称通常会脱敏处理（如 t***1）。
{ "item_review_get_response": { "code": 0, "msg": "success", "request_id": "10b3a8c7-9d2e-4f1a-b5c6-8e7d9f0a1b2c", "total_results": 15680, "reviews": [ { "nid": 123456789012, "oid": 987654321098, "user_nick": "t***1", "user_avatar": "https://img.alicdn.com/avatar/default.png", "user_vip_level": 3, "content": "宝贝收到了，物流很快，包装很严实。质量不错，颜色也很正，跟图片一样。客服态度很好，有问必答。总体满意，下次还会再来！", "reply_content": "感谢亲的支持，祝您生活愉快！", "reply_time": "2026-09-10 10:00:00", "score": 5, "score_desc": "好评", "created": "2026-09-08 14:30:22", "append_comment": { "content": "用了一周来追评，确实很好用，推荐购买！", "created": "2026-09-15 14:30:22" }, "images": [ "https://img.alicdn.com/imgextra/i1/review_img_1.jpg", "https://img.alicdn.com/imgextra/i2/review_img_2.jpg" ], "videos": [ { "url": "https://cloud.video.taobao.com/play/u/123/p/1/e/6/t/1/12345.mp4", "cover": "https://img.alicdn.com/imgextra/video_cover.jpg" } ], "sku_info": "颜色分类:黑色;尺码:L", "useful_count": 12, "tags": ["物流快", "质量好", "服务好"] }, { "nid": 123456789012, "oid": 987654321099, "user_nick": "l***8", "user_avatar": "https://img.alicdn.com/avatar/default_2.png", "user_vip_level": 1, "content": "一般般吧，感觉材质没有描述的那么好，有点薄。", "reply_content": null, "reply_time": null, "score": 3, "score_desc": "中评", "created": "2026-09-07 09:15:10", "append_comment": null, "images": [], "videos": [], "sku_info": "颜色分类:白色;尺码:M", "useful_count": 2, "tags": ["材质一般"] } ], "has_next": true, "current_page": 1, "page_size": 2 } }
