淘宝天猫商品评论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 限流，建议引入 Redis 任务队列。 用户隐私脱敏：返回昵称全部脱敏，不会返回手机号、完整用户 ID，业务不要做逆向解析。 商品下架处理：商品删除 / 下架，捕获ITEM_NOT_FOUND错误，标记本地商品，停止该商品评论采集。 ## 五、业务拓展：多接口联动 taobao.item.get商品详情接口：商品基础信息与评论数据做关联分析； NLP 大模型：对评论文本做情感分析、提取用户痛点关键词； 定时增量任务：定时拉取新增评论，只同步新产生评价，减少接口调用消耗。 ## 六、适用业务场景 竞品口碑分析：抓取竞品评论，挖掘用户痛点、好评亮点，辅助产品差异化定位。 选品系统：根据评分、差评占比辅助货源筛选。 产品优化：提取评论高频反馈，用于产品、包装改良。 舆情监控：自有店铺商品差评预警。 NLP 文本分析：对评论做情感分析，构建商品口碑仪表盘。
