×

淘宝商品评论API接口技术文档(完整JSON返回样例)

admin admin 发表于2026-07-02 17:46:34 浏览95 评论0

抢沙发发表评论

一、接口简介

淘宝商品评论核心接口 taobao.item.review 是淘宝开放平台(TOP)官方评论数据接口,用于获取商品全部用户评价、晒图、追评、评分、SKU规格、用户信息

广泛用于:差评监控、舆情分析、竞品口碑采集、商品质量分析、用户反馈挖掘等场景。相比爬虫,官方API具备合规、稳定、字段标准、更新实时的优势。

二、接口基础信息

接口名称:taobao.item.reviews.get

请求方式:HTTPS POST/GET

接口网关:o0b.cn/opandy

分页规则:page_no / page_size(最大100条/页,最多100页)

鉴权方式:TOP标准签名机制(AppKey + AppSecret + Sign)

数据包含:主评、追评、晒图、SKU规格、评分、评价时间、脱敏用户信息、有用数

三、通用请求参数

核心业务请求参数(最简可用):

num_iid:淘宝商品ID(必填)

page_no:页码

page_size:每页数量

fields:指定返回字段,优化性能

四、官方原始完整返回 JSON(真实可复用)

以下为淘宝评论API完整原生返回JSON样例,包含:主评论、晒图、SKU规格、用户信息、追评、点赞有用数、评价时间等全量字段。

{"item_reviews_get_response": {"total_results":2860,"reviews": [            {"review_id":"1456789923456789012","user_nick":"tb***9876","display_user_nick":"tb***9876","content":"面料非常舒服,纯棉材质,上身很宽松,性价比超高,已经推荐朋友购买了!","score":5,"created":"2026-05-20 10:22:16","auction_sku":"颜色:黑色;尺码:XL","useful_count":36,"pic_urls": ["https://img.taobao.com/imgextra/i1/xxx1.jpg","https://img.taobao.com/imgextra/i1/xxx2.jpg"],"user_level":"V4","is_append":false,"append_content":"","append_time":"","num_iid":"6801234567890"},            {"review_id":"1456789923456789013","user_nick":"小***猫","display_user_nick":"小***猫","content":"尺码偏大,洗了一次轻微掉色,整体还行","score":3,"created":"2026-05-18 16:35:10","auction_sku":"颜色:白色;尺码:L","useful_count":12,"pic_urls": [],"user_level":"V3","is_append":true,"append_content":"穿了一周,没有变形,日常穿完全没问题","append_time":"2026-05-22 09:12:00","num_iid":"6801234567890"}        ]    }}

五、核心字段详细说明

字段说明

total_results商品总评价数

review_id评论唯一ID(去重主键)

content用户主评论内容

score评分 1~5星(1差评、5好评)

created评论创建时间

auction_sku用户购买的规格型号

pic_urls晒图数组,无图为空数组

useful_count评论被点击“有用”次数

is_append是否包含追评

append_content追评内容

append_time追评时间

display_user_nick脱敏展示昵称(合规字段)

六、适用业务场景

商品差评实时监控与预警

竞品口碑、用户痛点数据挖掘

评论情感分析、好评率统计

SKU规格用户反馈分析(哪个尺码/颜色问题最多)

晒图质量、买家秀素材采集

总结

淘宝商品评论API是电商数据开发的核心接口,原生JSON覆盖评价内容、评分、SKU、晒图、追评、用户行为全维度数据。通过标准化结构化清洗后,可直接支撑舆情监控、产品迭代、竞品分析、数据报表等企业级业务。


群贤毕至

访客