淘宝联盟物料API升级迭代和维易接口更新说明

网站公告    2024年03月19日
当前位置:公告 > 正文

公告:淘客物料API升级说明

尊敬的各位新老用户:


因受淘宝联盟官方物料API升级迭代影响,一批旧版物料接口将在2024年3月15号下线,更新为新接口。受影响接口有三类接口:

物料搜索、物料精选、淘宝客商品详情查询(简版)

这三个接口将用新的升级版接口替代。


更多信息请参考官方公告:

https://qn.taobao.com/headline/news/10706379?spm=a211vu.12026430.0.0.15173929XVNQYz


【38大促物料上线】

淘宝38大促直播平台百万出资补贴直播间单品,请在该页面获取物料:https://www.veapi.cn/gonggao/detail_83.html


【维易部分API更新说明】


受此影响,维易淘客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,将用于取代旧版hcapihcapi_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 ,

目前观察,新版物料接口稳定性没有旧版好,可能会存在限流或无结果,请随时反馈。

在线
客服

会员请加QQ群交流:

微信
咨询

加微信咨询
顶部