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

weixin_44175061

188人浏览 · 2026-06-06 10:42:30

weixin_44175061 · 2026-06-06 10:42:30 发布

一、接口简介

项目核心使用淘宝taobao.item.review 商品评论查询接口，该接口为淘宝数据源，通过商品 ID 批量拉取商品全量评论：主评、追评、晒图、SKU 规格、星级评分、买家脱敏昵称、评论点赞数、商家回复数据；（如添加 Taobaoapi2014），无需店铺卖家权限，直接调用封装 API，一键获取已封装好的数据 API 采集，适合批量查询、中小卖家使用，主要用于竞品口碑分析、用户痛点挖掘、产品迭代调研、差评舆情监控、类目市场洞察。。接口采用加密签名鉴权，个人权限对详细评论、追评、负面评价存在脱敏，企业权限可获取完整评价数据，适合长期商业数据沉淀。

二、接口基础信息

项目	参数说明
接口网关	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

{
    "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