摘要
在竞品调研、商品口碑分析、选品系统、产品优化分析业务中，需要获取淘宝、天猫商品用户评价、晒图、追评、商家回复数据。很多项目会尝试爬虫抓取评论区，但页面动态渲染、签名加密、IP 风控、分页规则频繁变更。
淘宝开放平台 TOP 提供taobao.item.reviews.get商品评论接口，可以合规获取商品公开评价数据，返回评分、评论文本、晒图、SKU 规格、追评、商家回复等脱敏结构化数据。本文从方案选型、接口基础、请求参数、JSON 样例、字段释义、错误码、开发流程、生产踩坑完整解析。
一、接口基础信息
1.接口简介
项目 说明
接口 Method taobao.item.reviews.get（前往Taobaoapi2014体验）
请求方式 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，不可超限
