尊敬的各位新老用户:
因受淘宝联盟官方物料API升级迭代影响,一批旧版物料接口将在2024年3月15号下线,更新为新接口。受影响接口有三类接口:
物料搜索、物料精选、淘宝客商品详情查询(简版)
这三个接口将用新的升级版接口替代。
更多信息请参考官方公告:
https://qn.taobao.com/headline/news/10706379?spm=a211vu.12026430.0.0.15173929XVNQYz
淘宝38大促直播平台百万出资补贴直播间单品,请在该页面获取物料:https://www.veapi.cn/gonggao/detail_83.html
受此影响,维易淘客API同步更新以下接口,请在3月15号前对照修正,主要是部分的入参修正,以及出参较大的不同。
在此之前,旧接口仍可用,但在3月15号后将停止,请尽快更新,以保障业务平稳过度!
【特别注意】2024年2月27号起,RID(relation_id)是转链、搜索、淘口令解析场景必传的参数了。请在调用全网转链、万能转链、批量转链、搜索、口令解析等接口时,加传relation_id参数。如对渠道不了解,请参考https://www.veapi.cn/apidoc/taobaolianmeng/113
新手没接触过渠道ID的(rid),请参考这篇文章照着做快速创建一个rid : https://www.veapi.cn/taokelianmeng/545.html
1、批量查询商品信息接口getitems接口名称切换成 tkiteminfo,入参一致。出参不同。
文档地址:https://www.veapi.cn/apidoc/taobaolianmeng/143
2、新推出万能转链接口generalconvert,将用于取代旧版hcapi和hcapi_v2(这2个接口有可能停用,时间待定),支持商品、店铺推广、大促活动会场推广,
请参考https://www.veapi.cn/apidoc/taobaolianmeng/366 ,
另有批量转链接口 https://www.veapi.cn/apidoc/taobaolianmeng/367
目前hcapi还可以使用,没有明确下架时间,部分功能是新版万能转链generalconvert没有的。您可以继续使用,但请把detail=1参数(如果有传的话)换成detail=2
3、超级搜索接口tb_search 以及旧搜索接口 super 请切换到tb_search_update 注意:搜索接口不再支持数字ID输出字符串ID。因涉及流量转化率问题,纯数字ID查询无成交的,将逐步关闭其数字ID入参。请尽量使用我们的转链接口带来成交转化率。 注意请务必传入relationId。
文档地址:https://www.veapi.cn/apidoc/taobaolianmeng/362
4、物料精选和找相似接口similaritem换成新版materialupdate
文档地址:https://www.veapi.cn/apidoc/taobaolianmeng/363
其中物料ID也进行了更新,返回字段更丰富,参考 https://www.veapi.cn/apidoc/taobaolianmeng/365
5、猜你喜欢接口 guesslike (接口名称不变)更新成新的出参。
文档地址:https://www.veapi.cn/apidoc/taobaolianmeng/140
6、调用数字ID和字符串ID互转的接口(gettbnumid 和 numidtostrid),请在会员中心授权,并添加pid和relation_id,否则2月1号以后会出错。
文档:https://www.veapi.cn/apidoc/taobaolianmeng/108 和 https://www.veapi.cn/apidoc/taobaolianmeng/122
7、请调用以下三个淘宝联盟接口的,增加 version=202402 参数,以切换到新版
/global/unionhc 全网转链
/tbk/shoplink 店铺推广转链 https://www.veapi.cn/apidoc/taobaolianmeng/118
/tbk/activityinfo 活动转链推广 https://www.veapi.cn/apidoc/taobaolianmeng/134
version参数后续长期使用,以应对今后非平滑切换接口时使用。
8、还有部分老客户不知道已上线全量维权订单接口,欢迎接入简化程序 https://www.veapi.cn/apidoc/taobaolianmeng/361
9、淘客热销高佣产品接口 products 请切换到物料精选升级版 materialupdate
热销高佣产品文档地址:https://www.veapi.cn/apidoc/taobaolianmeng/140
物料精选升级版 https://www.veapi.cn/apidoc/taobaolianmeng/363
热销商品对应的物料ID列表:
热销商品,物料ID: | 优质品,物料ID: | 母婴,物料ID: | 特价,物料ID: |
默认项 86597, 女装 3767, 家居 3758, 数码 3759, 鞋包 3762, 美妆 3763, 男装 3764, 内衣 3765, 母婴 3760, 食品 3761, 运动 3766 | 默认项 3786, 女装 86623, 家居 86622, 数码 86621, 鞋包 86620, 美妆 86619, 男装 86618, 内衣 86617, 母婴 86616, 食品 86614, 运动 86615 | 默认项 3760, 备孕 4040, 0至6个月 4041, 7至12个月 4042, 1至3岁 4043, 4至6岁 4044, 7至12岁 4045 | 默认项 4094 |
最后,请仍在使用几年前旧接口的用户,尽快切换到新版API:https://www.veapi.cn/apidoc/wendangzhinan ,
目前观察,新版物料接口稳定性没有旧版好,可能会存在限流或无结果,请随时反馈。