技术实战：淘宝开放平台商品评价接口技术解析与标准JSON返回参考
前言
淘宝开放平台（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
}
}