摘要：在电商口碑分析、竞品调研、AI 情感分析、差评预警、买家秀素材挖掘业务场景，需要结构化获取淘宝、天猫商品评价数据。taobao.item.reviews.get淘宝商品评论 API，传入商品num_iid，可以获取主评、追评、晒图、评分、下单 SKU 规格、卖家回复、脱敏用户信息等评价数据集。本文从接口概述、请求入参、返回字段解析、标准 JSON 样例、业务处理流程、开发踩坑、落地场景完整讲解，适合电商后端、数据分析、AI 情感分析系统开发者参考。
一、接口概述
taobao.item.reviews.get为淘宝开放平台商品评论接口，是电商口碑数据的核心数据源。商品详情接口只能拿到商品基础信息，真实用户评价、追评、晒图、差评痛点全部依赖本接口获取。
接口名称：taobao.item_review（taobaoapi2014 前往体验）
接口地址：o0b.cn/opandy （HTTPS，支持 GET/POST）
接口版本：v3（稳定正式版）
请求方式：GET / POST（推荐 POST，参数放 body 避免 URL 超长）
返回格式：标准 JSON
业务用途：根据商品 ID，全量获取商品评论基础评论信息、评论日期、图片、视频、评论者ID、追评、追评内容、视频图文等完整商品评论内容数据。
接口能力覆盖
基础评价：星级评分、主评文本、评价时间、脱敏用户昵称
追加评价：追评内容、追评时间
多媒体：晒图图片 URL 数组
订单维度：下单对应的 SKU 规格名称
互动数据：评论有用点赞数、是否匿名评价
商家侧：卖家回复内容、卖家回复时间
筛选能力：支持按好评 / 中评 / 差评、是否带图进行过滤查询
二、核心请求入参
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| num_iid | bigint | 是 | 淘宝 / 天猫商品 ID，由商品详情 / 列表接口获取 |
| page_no | int | 否 | 页码，起始为 1 |
| page_size | int | 否 | 单页条数，最大 20 |
| rate_type | string | 否 | 评价类型：good好评，neutral中评，bad差评，all全部 |
| has_image | boolean | 否 | true 只返回带晒图评价；false 返回全部 |
| sort | string | 否 | 排序：create_time:desc最新优先，helpful:desc按有用数排序 |
三、返回数据结构解析
顶层响应结构
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 0调用成功；非 0 代表错误码，权限不足、限流、商品不存在 |
| msg | string | 响应描述，成功返回ok；失败输出错误原因 |
| request_id | string | 请求唯一 ID，线上日志排查定位 |
| item_reviews_get_response | object | 评论业务主体对象 |
item_reviews_get_response 对象字段
| 字段 | 类型 | 说明 |
|---|---|---|
| total_results | int | 可返回评价总条数，仅近 180 天数据参考值 |
| page_no | int | 当前请求页码 |
| page_size | int | 每页返回条数 |
| reviews | object | 评论容器对象 |
| review | arrayobject | 评价数组，单条评论对象集合 |
review 单条评价对象字段
| 字段 | 类型 | 说明 |
|---|---|---|
| review_id | string | 评论唯一 ID，用于业务数据去重主键 |
| display_user_nick | string | 脱敏买家昵称，带星号，无真实账号 |
| is_anonymous | boolean | 是否匿名评价 |
| score | int | 星级评分：1‑5；5 好评，1 差评 |
| content | string | 主评文本内容，无文字为空字符串 |
| created | string | 主评创建时间 yyyy‑MM‑dd HH:ss |
| auction_sku | string | 下单 SKU 规格，例：颜色：黑色；尺码：XL |
| pic_urls | arraystring | 晒图图片地址数组，无晒图为空数组 |
| useful_count | int | 该评价被标记 “有用” 的点赞数量 |
| is_append | boolean | 是否存在追评 |
| append_content | string | 追评文本，无追评为空 |
| append_time | string | 追评时间，格式yyyy‑MM‑dd HH:ss |
| seller_reply | string | 卖家回复内容 |
| seller_reply_time | string | 卖家回复时间 |
