淘宝商品评论 API（taobao.item.reviews.get）标准 JSON 示例
一、成功完整返回（官方标准原生结构，适配技术文章）
json
{
"code": 0,
"msg": "success",
"request_id": "req_202606231510007788",
"resp_data": {
"item_reviews_get_response": {
"total_results": 1562,
"page_no": 1,
"page_size": 20,
"reviews": [
{
"review_id": "7295689452365896236",
"num_iid": "689235711245",
"user_nick": "小***柚",
"display_user_nick": "小***柚",
"is_anonymous": false,
"content": "纯棉面料上身舒服，尺码标准，物流次日达，整体很满意",
"score": 5,
"created": "2026-05-20 15:30:22",
"auction_sku": "颜色:黑色;尺码:XL",
"useful_count": 36,
"pic_urls": [
"https://img.alicdn.com/imgextra/i1/O1CN01a12345.jpg",
"https://img.alicdn.com/imgextra/i1/O1CN01a67890.jpg"
],
"user_level": "V4",
"is_append": true,
"append_content": "穿洗半个月没有掉色变形，会回购",
"append_time": "2026-05-27 09:12:10",
"reply": {
"seller_nick": "简禾服饰旗舰店",
"content": "感谢您真实反馈，我们持续严控面料品质！",
"reply_time": "2026-05-20 16:02:45"
}
},
{
"review_id": "7295689452365896237",
"user_nick": "t***9",
"display_user_nick": "t***9",
"is_anonymous": true,
"content": "版型偏大，面料偏薄，日常穿勉强够用",
"score": 3,
"created": "2026-05-22 10:11:10",
"auction_sku": "颜色:白色;尺码:L",
"useful_count": 12,
"pic_urls": [],
"user_level": "V2",
"is_append": false,
"append_content": "",
"append_time": "",
"reply": {}
}
]
}
}}二、异常错误 JSON 示例（3 类高频报错）
1. 鉴权失败 / 无接口权限 code=40001
json
{
"code": 40001, "msg": "Invalid access token", "request_id": "req_202606231512001234"}
2. 调用频率超限限流 code=429
json
{
"code": 429, "msg": "请求频次超出限制，请稍后重试", "request_id": "req_202606231513005678"}
3. 商品 ID 无效 / 商品下架 code=50003
json
{
"code": 50003, "msg": "num_iid不存在或商品已下架", "request_id": "req_202606231514009012"}
三、核心字段简要说明（文章配套解析）
顶层通用状态
code：0 = 成功；非 0 代表错误码request_id：请求流水号，用于排查接口异常
分页汇总层
total_results：商品全部评论总数page_no/page_size：当前页码、单页返回条数
单条评论核心字段
review_id：评论唯一 ID，数据去重、增量采集主键num_iid：商品 ID，关联所属商品score：评分 1-5 星（1/2 差评，3 中评，4/5 好评）content：买家原始评价文字auction_sku：下单规格（颜色 + 尺码）pic_urls：晒图地址数组，无晒图为空数组is_append/append_content：是否追评、追评内容useful_count：该评论被点赞 “有用” 数量reply：商家回复对象，无回复则为空
四、开发解析注意点（写入文章结尾）
pic_urls、reply、append_content可能为空，代码必须做空值判断，防止解析报错；时间字段
created/append_time为标准字符串日期，无需时间戳转换；接口存在 QPS 限流，批量采集商品评论需增加延时；
用户昵称统一脱敏展示，无法获取完整用户名称，遵循平台隐私规范。
