淘宝商品评论 API（taobao.item.reviews）标准 JSON 示例

淘宝商品评论 API（taobao.item.reviews.get）标准 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

复制代码

{
    "code": 40001,
    "msg": "Invalid access token",
    "request_id": "req_202606231512001234"
}

2. 调用频率超限限流 code=429

复制代码

{
    "code": 429,
    "msg": "请求频次超出限制，请稍后重试",
    "request_id": "req_202606231513005678"
}

3. 商品 ID 无效 / 商品下架 code=50003

复制代码

{
    "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 限流，批量采集商品评论需增加延时；
用户昵称统一脱敏展示，无法获取完整用户名称，遵循平台隐私规范。