速卖通商品搜索API:分页漂移、签名与跨境字段实操

速卖通商品搜索API

今天一起来聊一聊速卖通商品搜索,关于跨境商品数据到底该怎么批量拿。

先来说说我自己的经历。当时要拉一批跨境商品的价格和销量做选品分析,我想着搜索接口嘛,传 keyword 进去,page_no 从1开始翻,翻到没有下一页为止,数据不就到手了。结果跑了二十几页,表格里开始出现重复的商品ID,同一个商品在两页里都冒出来。我以为是自己去重没写对,加了个 set 再跑,数据是不重复了,但条数比预想的少了一大截——有些商品在翻页的间隙里被跳过去了,我连它存在过都不知道。

后来一个做跨境工具的朋友点了我一句:速卖通的搜索分页存在数据偏移,接口本身就不保证“第2页严格接着第1页”,你拿 page_no 老老实实累加,拿到的是一个会漂移的滑动窗口。这句话就点醒了我。

之后我把采集的过程拆分出来,发现关键动作只有那么几个,做对了,数据才能用。

先搞清楚你要调的是哪一套接口

速卖通开放平台有两套体系,选错了后面全白搭。

商家自用接口只服务你自己店铺的商品,查不了竞品,做选品工具的话从一开始就用错了工具。联盟分销接口才能查全网公开商品,支持多语言多币种,做竞品监控和跨境选品得走这一套。两套网关地址都不一样,签名和权限也各有各的要求,混着找方案只会把时间耗在“为什么这个商品ID查不出来”上。

另外,个人开发者权限很低,完整商品数据基本拿不到,企业认证是硬门槛。接口也有调用频次限制,个人账号和企业账号的日额度差着好几倍,批量任务得提前把配额算清楚。

第一步:分页是滑动窗口,不是固定格子

速卖通搜索接口的分页参数很直白,page_no 加 page_size,page_size 默认20,上限是50,填大了会被截断。逻辑看起来简单,但真正的坑在于翻页会漂移。

部分场景下,你请求第3页拿到的商品,可能和第2页有重叠,也可能中间跳过了几条。这不是你代码写错了,是搜索结果本身在翻页过程中发生了变化。

应对这件事的办法只有一个:本地去重,按 product_id 判重,同时接受“拿到多少算多少”。建一个 seen_item_ids 集合,每页返回的商品先查集合,没见过的才入库,见过的直接跳过。翻页的终止条件用“返回空列表”或者“没有下一页”,不要拿 total_results 去除以 page_size 算循环次数,那个数跟实际能翻到的深度对不上。

第二步:签名要显式指定算法,时间戳用UTC

签名这块我踩得最深的一脚,是时间戳格式。速卖通的 timestamp 要求UTC时区的ISO格式,类似 2025-12-03T12:00:00Z,不是北京时间的 yyyy-MM-dd HH:mm:ss,也不是简单的毫秒数。我第一次对接的时候习惯性用了本地时间,签名连续报401,错误信息只说Invalid Signature,不告诉你错在哪个参数。

后来对着文档逐字比对才发现,sign_method 也漏了。速卖通的签名必须显式指定 sign_method=sha256,不写的话默认算法可能不是你以为的那个。

完整的签名逻辑是:所有参数按 key 的 ASCII 升序排列,拼成 key=value&key=value 的形式,值要做URL编码,然后在末尾拼接 app_secret,用SHA256加密后转大写。注意速卖通不是把密钥放首尾两头,只在末尾加一次。服务器时间还得跟官方NTP同步,误差超过5分钟签名直接失败。

第三步:多语言多币种是标配,不是可选项

速卖通面向的是全球买家,返回字段里天然带着跨境属性,有几个地方不提前处理,数据会看着正常、实际没法用。

关键词的语言要匹配目标站点。直接传中文去搜英文站,返回结果大概率是空的,关键词必须按目标市场的语言填写,俄语站传俄语,西语站传西语。价格字段带币种,售价和币种是成对出现的,做比价之前得先把币种统一,别拿USD和EUR直接比大小。广告商品会混在搜索结果里,接口返回的推广位需要根据字段自行过滤,不然算均价的时候会被拉偏。

第四步:搜索建池,详情补档,别指望一个接口全包

搜索接口给的是摘要,product_id、标题、价格、销量、主图、店铺名这些,够你做第一轮筛选。完整的SKU规格、库存、物流模板、多语言详情,得拿 product_id 去调详情接口补。

这个分工跟国内电商搜索的逻辑是一样的,搜索负责“找到候选”,详情负责“看清档案”,顺序别反。如果你拿搜索接口反复去查同一个商品想拿它的完整档案,那是用错了工具,配额烧得冤枉。

新媒体平台api数据接口

如果你要把一批跨境商品的价格和销量批量拉回来做对比,或者定时追踪竞品的变化,可以使用极致了数据的电商采集接口。速卖通这块支持按关键词批量拉取商品列表,product_id、标题、价格、销量这些核心字段结构化输出,拿回来直接进表做排序和筛选,再拿ID去补详情。

新媒体平台api数据接口

有技术团队可以直接对接API,传关键词和分页参数,把数据接入到自有系统中进行比对分析。不擅长写代码的人可以用飞书「多平台数据采集助手」插件,配置关键词和采集频率,数据自动写进多维表格,并且可以设置定时任务自动更新。完全不想碰技术的,联系客服定制数据表,告诉对方要采哪些关键词、什么频率、什么格式,直接交付。

签名、分页漂移、去重、限流重试这些工程细节,接口那边已经处理掉了,你不用自己一个个兜。如果想要调用新媒体账号实时数据的话,可以使用极致了数据的api接口来获取当前的数据,支持多并发,可以批量查询多个账号、多个平台的数据。

总结

速卖通商品搜索API的采集过程就是四个步骤:首先搞清楚调的是哪一套接口,然后用本地去重应对分页漂移,接着把签名算法和UTC时间戳写对,最后用搜索建池、详情补档,把摘要和完整档案分开拿。

每一项工作都离不开数据的支持。极致了数据支持下,速卖通商品列表可以按关键词批量拉取,签名和分页偏移的处理已经封装好,并且可以通过API对接或者飞书插件实现零代码接入。分页不是格子是窗口,这件事记清楚,数据才能用。

上一篇:

相关新闻

客服微信

联系我们

18658854422

微信号: wx2026-maxiao

邮件:474804@qq.com

工作时间:周一至周五,9:00-18:00,节假日休息