先明确核心前提:1688 官方开放平台不存在可根据商品 ID 查询任意商品公开评论的通用接口,旧版公开评论接口已经永久下线。现存官方评价接口仅支持查询自身账号下订单对应的评价,无法实现竞品商品评论获取。市面上货源分析、采购风控场景所用的商品评论查询能力,普遍采用第三方聚合数据接口实现,下面分开说明两种接口完整调用流程。
一、官方评价接口 alibaba.trade.rate.get(仅自有订单评价)
调用前置准备
首先前往 1688 开放平台完成企业开发者注册,创建应用并提交接口权限申请,获取应用密钥信息。后续通过平台标准 OAuth 授权流程,获取有效的访问凭证,所有请求都必须携带该凭证。
请求组装规则
采用平台统一网关地址发起请求,请求方式支持 GET 与 POST。需要补齐平台规定的全部公共参数,包含接口名称、应用标识、时间戳、版本号、返回格式以及签名信息。签名需要按照平台规则,将所有参数排序后加密生成,防止请求被篡改。业务层面只需要传入采购订单编号作为核心参数。
请求与数据获取流程
组装完成全部参数并生成签名后,向官方网关发起网络请求。平台校验签名、授权凭证与接口权限无误后,返回这条订单对应的买卖双方评价内容。
使用限制
该接口无法直接传入商品编号查询商品下全部公开买家评论,仅能匹配授权账号实际产生的订单,适合自有采购系统管理订单评价,不能用于竞品货源调研。
二、第三方聚合商品评论接口(按商品 ID 获取公开评论,主流业务方案)
调用前置准备
向数据服务商申请接入权限,获取专属访问密钥与接口网关地址,保存密钥用于鉴权。确认接口支持根据商品编号分页拉取评论数据。
请求参数配置
核心必填参数包含服务商分配的密钥、1688 商品编号。部分场景需要附带对应店铺名称;可选参数包含页码、单页数据条数、返回数据格式。页码默认从第一页开始,单页请求数量不宜设置过大。
发起请求与分页逻辑
通过网络请求访问接口网关,携带配置好的全部参数。接口校验密钥合法后,返回当前页面的评论信息。想要获取更多评论时,持续递增页码循环请求。两次连续请求之间设置合理间隔,避免短时间高频访问触发限流。当接口不再返回评论内容时,停止分页请求。
返回内容处理
接口返回标准化文本数据,内容包含商品平均分、总体评论数量、单条评价正文、追评内容、下单规格、评价时间、晒图链接、商家回复等信息。系统接收数据之后,可以直接用于业务展示或者数据分析。
三、线上业务调用重要规范
缓存机制
商品评论不会实时大量更新,不需要每次用户访问都调用接口。拉取到的数据在本地进行一段时间缓存,重复查询优先读取缓存内容,减少接口调用频次。
资源适配
接口返回的商品评论图片自带防盗链限制,前端无法直接加载原图地址。业务系统需要搭建中转服务处理图片访问,避免图片展示失败。
异常处理
运行过程中可能出现网络超时、访问限流、服务临时波动等情况。请求失败时优先读取本地缓存数据保障业务正常展示,同时记录异常信息便于排查。
数据处理规范
重复分页拉取过程中会出现重复评论,依靠评论唯一标识进行数据去重,避免数据库重复存储。
四、补充方案提醒
不少人会尝试抓取商品网页前端评论接口。这类方式存在持续的反爬限制,经常出现访问拦截、验证码校验、网络封禁等问题,稳定性极差。只适合短期临时查看数据,绝对不能作为商业化业务长期调用方案。
五、合规相关要求
接口获取到的评论数据仅可用于自身货源筛选、采购风险评估等内部业务。不允许对外批量转发、售卖数据;同时做好买家相关信息脱敏,不采集、泄露用户隐私信息。