淘宝开放平台核心评论接口为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 } } }字段类型说明codeint状态码0成功非0为失败msgstring状态描述成功为successrequest_idstring请求唯一ID排查问题用total_resultsint商品总评论数page_noint当前页码默认1page_sizeint每页条数默认20最大50~100失败响应示例{code:40,msg:error,sub_code:isv.invalid-sign,sub_msg:签名错误}二、单条评论核心字段重点字段名类型必有说明review_id/idstring✅评论唯一ID去重/增量采集核心字段num_iid/item_idstring✅商品IDuser_nick/display_user_nickstring✅买家昵称部分脱敏如李***0user_idstring❌用户唯一标识部分接口返回user_levelstring❌用户等级如V3user_vipbool❌是否VIPcontent/rate_contentstring✅评论正文score/ratingint/float✅评分1~5分支持小数如4.5rate_contentstring❌评价标签如好评差评created/review_timestring✅评论时间格式YYYY-MM-DD HH:MM:SSmodifiedstring❌评论修改时间pic_urls/images/picsarray❌晒图URL列表无图则为[]pic_numint❌图片数量videostring❌视频URL部分接口支持has_picbool❌是否有晒图useful_count/useful_voteint❌被标有用的次数like_countint❌点赞数部分接口replyobject❌卖家回复见下表append_content/more_contentstring❌追评内容无则为空has_morebool❌是否有追评labelsarray❌评论标签如[质量好,物流快]spec_info/auction_skustring❌评论商品属性如颜色:白色;尺码:Lreasonstring❌差评原因如商品质量差use_effectstring❌美妆类目特有使用效果use_scenestring❌3C类目特有使用场景三、卖家回复字段reply对象字段类型说明content/reply_contentstring回复内容reply_time/reply_createdstring回复时间seller_nickstring卖家昵称无回复时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❌页码默认1page_size❌每页条数默认20最大50review_type❌0全部1好评2中评3差评sort❌0默认1最新rate_type❌good/neutral/badfields❌指定返回字段如content,rating,user_nick六、关键注意事项事项说明频率限制普通开发者约500次/天企业认证可申请更高配额数据合规禁止存储手机号等隐私信息遵守《淘宝开放平台协议》分页拉取单页最多20~50条需循环page_no获取全部建议加page_no * page_size total_results判断终止字段差异不同API版本/类目返回字段有差异如美妆有use_effect3C有use_scene以实际返回为准错误码10001参数错误10002商品不存在2001系统错误isv.api-rate-limit-exceeded限流如需获取最新字段定义建议直接查阅 淘宝开放API文档接口字段会随版本迭代更新。
淘宝评论API接口返回参数详解
发布时间：2026/6/6 20:29:36
淘宝开放平台核心评论接口为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 } } }字段类型说明codeint状态码0成功非0为失败msgstring状态描述成功为successrequest_idstring请求唯一ID排查问题用total_resultsint商品总评论数page_noint当前页码默认1page_sizeint每页条数默认20最大50~100失败响应示例{code:40,msg:error,sub_code:isv.invalid-sign,sub_msg:签名错误}二、单条评论核心字段重点字段名类型必有说明review_id/idstring✅评论唯一ID去重/增量采集核心字段num_iid/item_idstring✅商品IDuser_nick/display_user_nickstring✅买家昵称部分脱敏如李***0user_idstring❌用户唯一标识部分接口返回user_levelstring❌用户等级如V3user_vipbool❌是否VIPcontent/rate_contentstring✅评论正文score/ratingint/float✅评分1~5分支持小数如4.5rate_contentstring❌评价标签如好评差评created/review_timestring✅评论时间格式YYYY-MM-DD HH:MM:SSmodifiedstring❌评论修改时间pic_urls/images/picsarray❌晒图URL列表无图则为[]pic_numint❌图片数量videostring❌视频URL部分接口支持has_picbool❌是否有晒图useful_count/useful_voteint❌被标有用的次数like_countint❌点赞数部分接口replyobject❌卖家回复见下表append_content/more_contentstring❌追评内容无则为空has_morebool❌是否有追评labelsarray❌评论标签如[质量好,物流快]spec_info/auction_skustring❌评论商品属性如颜色:白色;尺码:Lreasonstring❌差评原因如商品质量差use_effectstring❌美妆类目特有使用效果use_scenestring❌3C类目特有使用场景三、卖家回复字段reply对象字段类型说明content/reply_contentstring回复内容reply_time/reply_createdstring回复时间seller_nickstring卖家昵称无回复时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❌页码默认1page_size❌每页条数默认20最大50review_type❌0全部1好评2中评3差评sort❌0默认1最新rate_type❌good/neutral/badfields❌指定返回字段如content,rating,user_nick六、关键注意事项事项说明频率限制普通开发者约500次/天企业认证可申请更高配额数据合规禁止存储手机号等隐私信息遵守《淘宝开放平台协议》分页拉取单页最多20~50条需循环page_no获取全部建议加page_no * page_size total_results判断终止字段差异不同API版本/类目返回字段有差异如美妆有use_effect3C有use_scene以实际返回为准错误码10001参数错误10002商品不存在2001系统错误isv.api-rate-limit-exceeded限流如需获取最新字段定义建议直接查阅 淘宝开放API文档接口字段会随版本迭代更新。
预测分析器)
