首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >淘宝商品评论API接口技术文档(taobao.item.review|含原始 JSON + 落地结构化模型)

淘宝商品评论API接口技术文档(taobao.item.review|含原始 JSON + 落地结构化模型)

原创
作者头像
wx19970108018
发布2026-06-05 17:13:38
发布2026-06-05 17:13:38
10
举报
文章被收录于专栏:经验经验

一、接口简介

接口名称:taobao.item.review(商品评论接口) 该接口为淘宝官方合规数据源,通过商品 ID 批量拉取商品全量评论:主评、追评、晒图、SKU 规格、星级评分、买家脱敏昵称、评论点赞数、商家回复数据;主要用于竞品口碑分析、用户痛点挖掘、产品迭代调研、差评舆情监控、类目市场洞察。需企业实名认证、平台权限审批后才可开通调用,个人开发者权限受限、QPS 与单日配额低。

二、接口基础信息

项目

参数说明

接口网关

TOP 统一网关 c0b.cc/R4rbK2

请求方式

GET/HTTPS POST

数据格式

JSON

接口版本

v=2.0

鉴权规则

AppKey+AppSecret MD5/Hmac-SHA1 签名验签

分页限制

page_size 最大 50 条 / 页,单商品分页上限由接口配额管控

调用限制

企业应用 QPS3~10,个人 QPS≤2;仅返回近 180 天有效评论

数据范围

主评论、追加评论、晒图 URL、SKU 属性、商家回复、有用点赞数

三、通用请求参数(调用入参)

3.1 系统公共必填参数(全接口通用)

参数名

必填

类型

说明

method

String

固定:taobao.item.reviews.get

app_key

String

开放平台应用密钥

timestamp

String

yyyy-MM-dd HH:mm:ss,请求时间戳

format

String

固定 json

v

String

固定 2.0

sign_method

String

md5/hmac-sha1

sign

String

参数加密签名

3.2 业务筛选参数

参数名

必填

说明

num_iid

淘宝商品 ID

page_no

页码,默认 1

page_size

每页条数 1~50,默认 20

review_type

0 全部 / 1 好评 / 2 中评 / 3 差评

has_image

true 仅查带图评论

has_append

true 仅查含追评评论

四、官方原始完整返回 JSON(真实原生返回、可直接调试复用)

json

代码语言:javascript
复制
{
    "item_reviews_get_response": {
        "total_results": 1258,
        "reviews": [
            {
                "review_id": "7295689452365896235",
                "tid": "245896325896325896",
                "display_user_nick": "小***柚",
                "user_nick": "小***柚",
                "is_anonymous": false,
                "content": "面料柔软,尺码标准,做工精细,性价比很高",
                "score": 5,
                "created": "2026-04-12 09:22:36",
                "auction_sku": "颜色:黑色;尺码:XL",
                "useful_count": 36,
                "pic_urls": [
                    "https://img.alicdn.com/imgextra/i1/O1CN01xxxxxx1.jpg",
                    "https://img.alicdn.com/imgextra/i1/O1CN01xxxxxx2.jpg"
                ],
                "user_level": "V4",
                "is_append": true,
                "append_content": "穿洗三次没缩水,版型不变形,推荐购买",
                "append_time": "2026-04-25 11:15:22",
                "seller_reply": {
                    "reply_content": "感谢您细致的评价,我们严控面料品质,欢迎再次选购",
                    "reply_created": "2026-04-13 15:02:11"
                }
            },
            {
                "review_id": "7295689452365896236",
                "tid": "245896325896325897",
                "display_user_nick": "淘***客",
                "user_nick": "淘***客",
                "is_anonymous": true,
                "content": "偏大一个码,线头较多,发货速度慢",
                "score": 2,
                "created": "2026-04-15 16:12:45",
                "auction_sku": "颜色:白色;尺码:L",
                "useful_count": 12,
                "pic_urls": [],
                "user_level": "V2",
                "is_append": false,
                "append_content": "",
                "append_time": "",
                "seller_reply": {
                    "reply_content": "抱歉没能满意,已优化品控与发货时效,可联系客服退换",
                    "reply_created": "2026-04-16 08:33:15"
                }
            }
        ]
    }
}

五、核心字段详细说明

1. 外层汇总字段

表格

字段

类型

释义

业务用途

total_results

Number

商品总评论条数

数据总量统计、分页循环终止判断

2. 单条评论主体字段

表格

字段

类型

释义

review_id

String

评论全局唯一 ID(去重主键)

tid

String

子订单编号

display_user_nick

String

脱敏买家昵称(平台统一打码)

is_anonymous

Boolean

是否匿名评价

content

String

主评正文内容

score

Int

星级 1~5(1 最差 / 5 最优)

created

String

主评创建时间

auction_sku

String

下单 SKU 规格(颜色 / 尺码)

useful_count

Int

评论被点 “有用” 次数

pic_urls

Array

晒图高清地址,空数组 = 无图

user_level

String

淘宝买家会员等级 V1~V6

3. 追评字段

表格

字段

释义

is_append

是否存在追加评论 true/false

append_content

追评文案,无追评为空

append_time

追评发布时间

4. 商家回复子对象 seller_reply

表格

字段

释义

reply_content

商家回复内容

reply_created

商家回复时间

六、标准化结构化 JSON(开发落地存储模型|数据库入库标准格式)

剔除平台冗余层级、统一结构化,直接对应 MySQL 数据表字段,用于数据分析、NLP 分词、竞品库落地

json

代码语言:javascript
复制
{
  "item_id": "6801234567890",
  "total_comment": 1258,
  "comment_list": [
    {
      "review_id": "7295689452365896235",
      "user_name": "小***柚",
      "is_anonymous": false,
      "star": 5,
      "main_content": "面料柔软,尺码标准,做工精细,性价比很高",
      "main_time": "2026-04-12 09:22:36",
      "sku_attr": "黑色-XL",
      "useful_num": 36,
      "img_list": [
        "https://img.alicdn.com/imgextra/i1/O1CN01xxxxxx1.jpg",
        "https://img.alicdn.com/imgextra/i1/O1CN01xxxxxx2.jpg"
      ],
      "user_rank": "V4",
      "has_append": true,
      "append_content": "穿洗三次没缩水,版型不变形,推荐购买",
      "append_time": "2026-04-25 11:15:22",
      "seller_reply_content": "感谢您细致的评价,我们严控面料品质,欢迎再次选购",
      "seller_reply_time": "2026-04-13 15:02:11",
      "comment_tag": ["面料好","尺码准","性价比高"]
    },
    {
      "review_id": "7295689452365896236",
      "user_name": "淘***客",
      "is_anonymous": true,
      "star": 2,
      "main_content": "偏大一个码,线头较多,发货速度慢",
      "main_time": "2026-04-15 16:12:45",
      "sku_attr": "白色-L",
      "useful_num": 12,
      "img_list": [],
      "user_rank": "V2",
      "has_append": false,
      "append_content": "",
      "append_time": "",
      "seller_reply_content": "抱歉没能满意,已优化品控与发货时效,可联系客服退换",
      "seller_reply_time": "2026-04-16 08:33:15",
      "comment_tag": ["尺码偏大","做工差","发货慢"]
    }
  ]
}

落地说明

  1. comment_tag:通过 NLP 关键词提取自动生成标签,用于分类统计差评痛点、产品优点;
  2. 所有空值统一为空字符串 / 空数组,规避数据库 NULL 异常;
  3. 可直接映射评论主表、晒图表、SKU 统计表三张业务库表。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 一、接口简介
  • 二、接口基础信息
  • 三、通用请求参数(调用入参)
    • 3.1 系统公共必填参数(全接口通用)
    • 3.2 业务筛选参数
  • 四、官方原始完整返回 JSON(真实原生返回、可直接调试复用)
  • 五、核心字段详细说明
    • 1. 外层汇总字段
    • 2. 单条评论主体字段
    • 3. 追评字段
    • 4. 商家回复子对象 seller_reply
  • 六、标准化结构化 JSON(开发落地存储模型|数据库入库标准格式)
    • 落地说明
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档