公告：淘客物料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，将用于取代旧版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列表：

最后，请仍在使用几年前旧接口的用户，尽快切换到新版API：https://www.veapi.cn/apidoc/wendangzhinan ，

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