淘宝天猫商品评论 API 接口解析（附 JSON 样例）

摘要

在竞品调研、商品口碑分析、选品系统、产品优化分析业务中，需要获取淘宝、天猫商品用户评价、晒图、追评、商家回复数据。很多项目会尝试爬虫抓取评论区，但页面动态渲染、签名加密、IP 风控、分页规则频繁变更，爬虫维护成本极高，还存在合规风险。

淘宝开放平台 TOP 提供taobao.item.reviews.get商品评论接口，可以合规获取商品公开评价数据，返回评分、评论文本、晒图、SKU 规格、追评、商家回复等脱敏结构化数据。本文从方案选型、接口基础、请求参数、Json样例、字段释义、错误码、开发流程、生产踩坑完整解析。

一、接口基础信息

1.接口简介

项目	说明
接口 Method	taobao.item.reviews.get（前往Taobaoapi2014体验）
请求网关	c0b.cc/R4rbK2
请求方式	GET / POST，生产环境推荐 POST
鉴权方式	app_key + app_secret；部分店铺私有评价需要 OAuth session 授权
签名算法	md5 /hmac‑sha256，参数按 ASCII 字典序升序生成 sign 签名
协议版本	v2.0
返回格式	JSON / XML，项目开发优先 JSON
硬性数据边界	仅返回近 180 天评论；基础权限 page_size 最大 20；单商品存在最大可拉取页数上限；用户昵称脱敏输出

2.公共请求参数

参数名	类型	必填	说明
method	string	是	固定值 taobao.item.reviews.get
app_key	string	是	开放平台分配的应用密钥
timestamp	string	是	GMT+8 时区，格式yyyy‑MM‑dd HH:mm:ss；时间误差不可超过 10 分钟
v	string	是	协议版本，固定2.0
sign_method	string	是	签名算法，hmac‑sha256 /md5
sign	string	是	加密生成的签名字符串
session	string	否	读取店铺私有评价时需要 OAuth 授权 session，公开商品评价一般不需要

3.业务入参

参数名	类型	必填	说明
num_iid	long	是	淘宝 / 天猫商品宝贝 ID，从商品链接提取
page_no	int	否	分页页码，起始为 1
page_size	int	否	单页条数，基础权限最大 20，不可超限

二、返回 JSON 样例

{
    "item_reviews_get_response": {
        "request_id": "req‑20260923162000789456",
        "total_results": 856,
        "page_no": 1,
        "page_size": 20,
        "reviews": [
            {
                "review_id": "7295689452365896235",
                "display_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"
                ],
                "is_append": false,
                "append_content": "",
                "append_time": "",
                "seller_reply": "感谢亲的认可，我们会继续把控产品品质，期待您再次光临！"
            },
            {
                "review_id": "7295689452365896236",
                "display_user_nick": "用***户",
                "is_anonymous": false,
                "content": "面料偏薄，夏天穿尚可，包装比较简单",
                "score": 3,
                "created": "2026‑04‑15 16:10:22",
                "auction_sku": "颜色:白色;尺码:L",
                "useful_count": 12,
                "pic_urls": [],
                "is_append": true,
                "append_content": "使用半个月，没有起球，整体还行。",
                "append_time": "2026‑04‑25 11:30:10",
                "seller_reply": "非常抱歉没能让您完全满意，我们会优化包装工艺。"
            }
        ]
    }
}

异常返回示例（商品不存在 / 无权限）

{
    "error_response": {
        "code":15,
        "msg":"调用失败",
        "sub_code":"isv.invalid‑permission",
        "sub_msg":"接口权限不足，请申请taobao.item.reviews.get接口权限",
        "request_id":"req‑20260923162100123456"
    }
}

三、核心返回字段释义

字段	释义	业务处理提示
review_id	评论唯一 ID	去重、增量采集主键
display_user_nick	脱敏买家昵称	全部脱敏，无法拿到完整昵称
is_anonymous	是否匿名评价	布尔值
content	评价正文	用于文本分析、口碑统计
score	评价评分，1‑5 分	统计好评、中评、差评分布
created	评价创建时间	注意：仅近 180 天数据有效
auction_sku	对应购买 SKU 规格	关联商品 SKU 做维度分析
useful_count	评论点赞有用数	辅助判断评论参考价值
pic_urls	晒图图片数组	CDN 防盗链，需要下载转自有存储
is_append	是否存在追评	true 代表存在追加评价
append_content	追评内容	追评为空则为空字符串
append_time	追评时间	无追评时为空
seller_reply	商家回复内容	为空代表商家未回复

四、生产环境高频踩坑总结

权限单独申请：该接口不是应用默认开通，必须手动提交权限申请，未申请直接返回权限不足错误。

分页终止条件：不要只依赖 total_results，以reviews数组为空作为循环结束条件。

180 天时间限制：接口不会返回 180 天之前的历史评价，业务不要做超期数据预期。

晒图防盗链：pic_urls图片链接不能直接对外引用，必须下载转自有对象存储。

追评判空：is_append为 false 时，append_content、append_time为空字符串，代码做空判断。

严格控制 QPS：评论接口配额较低，高频批量采集极易 429 限流，建议引入任务队列。

用户隐私脱敏：返回昵称全部脱敏，不会返回手机号、完整用户 ID，业务不要做逆向解析。

商品下架处理：商品删除 / 下架，捕获ITEM_NOT_FOUND错误，标记本地商品，停止该商品评论采集。

五、业务拓展：多接口联动

taobao.item.get商品详情接口：商品基础信息与评论数据做关联分析；

NLP 大模型：对评论文本做情感分析、提取用户痛点关键词；

定时增量任务：定时拉取新增评论，只同步新产生评价，减少接口调用消耗。

六、适用业务场景

竞品口碑分析：抓取竞品评论，挖掘用户痛点、好评亮点，辅助产品差异化定位。

选品系统：根据评分、差评占比辅助货源筛选。

产品优化：提取评论高频反馈，用于产品、包装改良。

舆情监控：自有店铺商品差评预警。

NLP 文本分析：对评论做情感分析，构建商品口碑仪表盘。

全球电商API&反向海淘系统搭建

19970108018

admin 发表于2026-09-23 15:16:52 浏览69 评论0

摘要