
接口名称: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 属性、商家回复、有用点赞数 |
参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
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 | 参数加密签名 |
参数名 | 必填 | 说明 |
|---|---|---|
num_iid | 是 | 淘宝商品 ID |
page_no | 否 | 页码,默认 1 |
page_size | 否 | 每页条数 1~50,默认 20 |
review_type | 否 | 0 全部 / 1 好评 / 2 中评 / 3 差评 |
has_image | 否 | true 仅查带图评论 |
has_append | 否 | true 仅查含追评评论 |
json
{
"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"
}
}
]
}
}表格
字段 | 类型 | 释义 | 业务用途 |
|---|---|---|---|
total_results | Number | 商品总评论条数 | 数据总量统计、分页循环终止判断 |
表格
字段 | 类型 | 释义 |
|---|---|---|
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 |
表格
字段 | 释义 |
|---|---|
is_append | 是否存在追加评论 true/false |
append_content | 追评文案,无追评为空 |
append_time | 追评发布时间 |
表格
字段 | 释义 |
|---|---|
reply_content | 商家回复内容 |
reply_created | 商家回复时间 |
剔除平台冗余层级、统一结构化,直接对应 MySQL 数据表字段,用于数据分析、NLP 分词、竞品库落地
json
{
"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": ["尺码偏大","做工差","发货慢"]
}
]
}comment_tag:通过 NLP 关键词提取自动生成标签,用于分类统计差评痛点、产品优点;原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。