淘宝开放平台核心评论接口为 `taobao.item.reviews.get` （评论列表）和 `taobao.item.review.get` （单条详情），返回统一为JSON格式。以下是完整参数解析：

一、响应顶层结构

json{  "code": 0,  "msg": "success",  "request_id": "abcdef123456",  "resp_data": {    "item_reviews_get_response": {      "total_results": 1250,      "reviews": [ ... ],      "page_no": 1,      "page_size": 20    }  }}

字段	类型	说明
`code`	int	状态码， 0=成功，非0为失败
`msg`	string	状态描述，成功为 `success`
`request_id`	string	请求唯一ID，排查问题用
`total_results`	int	商品总评论数
`page_no`	int	当前页码（默认1）
`page_size`	int	每页条数（默认20，最大50~100）

失败响应示例： {"code":40,"msg":"error","sub_code":"isv.invalid-sign","sub_msg":"签名错误"}

二、单条评论核心字段（重点）

字段名	类型	必有	说明
`review_id` / `id`	string	✅	评论唯一ID，去重/增量采集核心字段
`num_iid` / `item_id`	string	✅	商品ID
`user_nick` / `display_user_nick`	string	✅	买家昵称（部分脱敏，如 `李***0`）
`user_id`	string	❌	用户唯一标识，部分接口返回
`user_level`	string	❌	用户等级，如 `V3`
`user_vip`	bool	❌	是否VIP
`content` / `rate_content`	string	✅	评论正文
`score` / `rating`	int/float	✅	评分 1~5分，支持小数如4.5
`rate_content`	string	❌	评价标签，如 `"好评"` `"差评"`
`created` / `review_time`	string	✅	评论时间，格式 `YYYY-MM-DD HH:MM:SS`
`modified`	string	❌	评论修改时间
`pic_urls` / `images` / `pics`	array	❌	晒图URL列表，无图则为 `[]`
`pic_num`	int	❌	图片数量
`video`	string	❌	视频URL（部分接口支持）
`has_pic`	bool	❌	是否有晒图
`useful_count` / `useful_vote`	int	❌	被标"有用"的次数
`like_count`	int	❌	点赞数（部分接口）
`reply`	object	❌	卖家回复（见下表）
`append_content` / `more_content`	string	❌	追评内容，无则为空
`has_more`	bool	❌	是否有追评
`labels`	array	❌	评论标签，如 `["质量好","物流快"]`
`spec_info` / `auction_sku`	string	❌	评论商品属性，如 `"颜色:白色;尺码:L"`
`reason`	string	❌	差评原因，如 `"商品质量差"`
`use_effect`	string	❌	美妆类目特有，使用效果
`use_scene`	string	❌	3C类目特有，使用场景

三、卖家回复字段（ `reply` 对象）

字段	类型	说明
`content` / `reply_content`	string	回复内容
`reply_time` / `reply_created`	string	回复时间
`seller_nick`	string	卖家昵称

无回复时 reply: null 或 {}

四、完整返回示例

json{  "code": 0,  "msg": "success",  "request_id": "abc123",  "resp_data": {    "item_reviews_get_response": {      "total_results": 1250,      "page_no": 1,      "page_size": 20,      "reviews": [{        "review_id": "9876543210abcdef",        "num_iid": "689712345678",        "user_nick": "tbNick123456",        "user_id": "123456789",        "user_level": "V3",        "user_vip": true,        "content": "纯棉材质很舒服，尺码标准，洗了不缩水，夏天穿透气！",        "created": "2025-05-10 14:30:00",        "modified": "2025-05-11 09:15:00",        "score": 5,        "rate_content": "好评",        "has_more": true,        "more_content": "穿了一周再来追评，版型宽松不挑身材，搭牛仔裤超好看！",        "pic_num": 3,        "pic_urls": [          "https://img.alicdn.com/imgextra/i1/123/O1CN01abc123.jpg",          "https://img.alicdn.com/imgextra/i2/123/O1CN01def456.jpg"        ],        "spec_info": "颜色:白色;尺寸:L",        "useful_vote": 25,        "reply": {          "seller_nick": "旗舰店客服",          "content": "感谢亲的认可，我们会继续努力做好品质~",          "reply_created": "2025-05-10 16:20:00"        }      }]    }  }}

五、常用请求参数（调用时传入）

参数	必填	说明
`num_iid`	✅	商品ID（从商品URL提取）
`page_no`	❌	页码，默认1
`page_size`	❌	每页条数，默认20，最大50
`review_type`	❌	0=全部，1=好评，2=中评，3=差评
`sort`	❌	0=默认，1=最新
`rate_type`	❌	`good`/ `neutral`/ `bad`
`fields`	❌	指定返回字段，如 `content,rating,user_nick`

六、关键注意事项

事项	说明
频率限制	普通开发者约500次/天，企业认证可申请更高配额
数据合规	禁止存储手机号等隐私信息，遵守《淘宝开放平台协议》
分页拉取	单页最多20~50条，需循环 `page_no` 获取全部，建议加 `page_no * page_size >= total_results` 判断终止
字段差异	不同API版本/类目返回字段有差异（如美妆有 `use_effect`，3C有 `use_scene`），以实际返回为准
错误码	`10001` 参数错误， `10002` 商品不存在， `2001` 系统错误， `isv.api-rate-limit-exceeded` 限流

如需获取最新字段定义，建议直接查阅淘宝开放API文档，接口字段会随版本迭代更新。

ITPub博客

淘宝评论API接口返回参数详解

淘宝开放平台核心评论接口为 `taobao.item.reviews.get` （评论列表）和 `taobao.item.review.get` （单条详情），返回统一为JSON格式。以下是完整参数解析：

一、响应顶层结构

二、单条评论核心字段（重点）

三、卖家回复字段（ `reply` 对象）

四、完整返回示例

五、常用请求参数（调用时传入）

六、关键注意事项

最新文章

ITPub博客

淘宝评论API接口返回参数详解

淘宝开放平台核心评论接口为 taobao.item.reviews.get （评论列表）和 taobao.item.review.get （单条详情），返回统一为JSON格式。以下是完整参数解析：

一、响应顶层结构

二、单条评论核心字段（重点）

三、卖家回复字段（ reply 对象）

四、完整返回示例

五、常用请求参数（调用时传入）

六、关键注意事项

最新文章

淘宝开放平台核心评论接口为 `taobao.item.reviews.get` （评论列表）和 `taobao.item.review.get` （单条详情），返回统一为JSON格式。以下是完整参数解析：

三、卖家回复字段（ `reply` 对象）