摘要
在电商竞品分析、商品口碑挖掘场景中,买家秀图片与评价内容是非常有价值的参考数据。很多开发人员会选择爬虫抓取页面买家秀内容,但页面 DOM 经常变动、图片防盗链、IP 风控等问题会持续增加维护成本。本文介绍淘宝开放平台 TOP 买家秀相关接口,讲解接口能力、请求参数、返回字段,附带标准 JSON 返回样例,对比爬虫方案差异,梳理开发接入要点与避坑经验,为电商内容数据采集提供合规稳定的技术方案。
1. 前言:爬虫采集买家秀的痛点
网页端爬取买家秀存在大量工程难题:
页面结构迭代频繁,图片地址存在防盗链、临时签名,图片链接短期失效;
大量图片请求极易触发平台风控,IP 封禁、验证码拦截;
数据混杂,需要区分普通评价图、追评图、视频买家秀,清洗成本高;
爬虫采集存在合规风险,大规模抓取稳定性差。
接口名称:taobao.item_review_show (淘宝买家秀API,Taobaoapi2014前往体验)
所属平台:淘宝开放平台 TOP
请求协议:HTTPS POST
编码格式:UTF-8
配套关联接口:taobao.item.get(商品详情)、taobao.item.reviews.get(商品评论)
淘宝 TOP 开放平台提供买家秀相关接口,可结构化获取买家发布的图文、视频素材,返回标准化字段,无需解析前端页面,适合用于内部口碑分析、竞品用户实拍内容研究。
接口说明:买家秀接口依托 TOP 体系,一般和商品评论接口
taobao.item.reviews.get联动,评论结果中内嵌买家秀图片、视频资源字段。
2. 请求入参说明
表格
| 参数名 | 是否必传 | 说明 |
|---|---|---|
| appkey | 是 | TOP 应用密钥,开放平台创建应用获取 |
| timestamp | 是 | 请求时间戳 |
| sign | 是 | TOP 请求签名,按规则 MD5 生成大写签名 |
| item_id | 是 | 商品宝贝 ID |
| fields | 是 | 指定需要返回的字段,按需勾选图片、视频相关字段 |
| page_no | 否 | 分页页码 |
| page_size | 否 | 单页评论条数,受接口配额限制 |
推荐 fields:num_iid,rid,content,photos,video,created,nick,rate
3. 返回核心字段说明
外层结构:item_reviews_get_response,评论数组:reviews.review
表格
| 字段 | 含义 | 开发注意事项 |
|---|---|---|
| rid | 评论唯一 ID | 用于数据去重 |
| num_iid | 商品宝贝 ID | 关联商品基础信息 |
| content | 评价文字内容 | 用户评价正文 |
| photos | 买家秀图片数组 | 图片 URL 集合,存在防盗链限制 |
| video | 买家秀视频对象 | 包含视频地址、封面图,无视频时为空 |
| created | 评价创建时间 | yyyy-MM-dd HH:mm:ss |
| nick | 评价用户昵称 | 平台脱敏 |
| rate | 评分等级 | 1~5 星 |