【好消息！】升级版物料API开放申请公告

尊敬的淘宝客开发者，您好！

双11升级版物料API将在2023年10月17日正式开放申请！此外，在2023年10月16日，升级版物料API还将增加商品补贴、优惠标签、预售商品信息，下线低调用率字段并对部分字段描述进行变更优化。降低使用门槛，全面助力双11转化提升！

一、升级版物料API信息

1、推广者升级版物料API

2、工具服务商升级版物料API

ps：工具服务商升级版物料API仅新增补贴及优惠标签信息、更新部分字段描述、下线低调用率字段，权限包及申请规则保持不变。

二、物料升级版api申请方式

1、已有升级版物料API权限的开发者无需重复申请，包含“物料搜索升级版”、“物料精选升级版”、“商品详情查询升级版(简易版)”，但请关注将于2023年10月16日上线的新字段及字段变更信息。

2、无升级版权限的开发者，可自2023年10月17日起，登录联盟开放平台自主申请权限。

①“物料搜索升级版”、“物料精选升级版”申请权限包名称：淘宝客【推广者】商品物料获取 点击直达申请

②“商品详情查询升级版(简易版)”针对有“淘宝客【公用】物料信息查询”权限的开发者自动开通

3、针对工具服务商，升级版物料API接口仍遵守工具服务商权限申请规则，暂不支持自主申请。

注意事项一：计划于10月16日下午17点~18点对升级版物料接口进行权限包迁移，迁移期间已有升级版API权限的开发者可能出现无法调用或调用报错，迁移完成后重试即可。

①以下3个接口将迁移至新权限包“淘宝客【推广者】商品物料获取”

taobao.tbk.dg.material.optional.upgrade( 淘宝客-推广者-物料搜索升级版 )

taobao.tbk.dg.material.recommend( 淘宝客-推广者-物料精选升级版 )

taobao.tbk.optimus.tou.material.ids.get( 淘宝客-推广者-物料id列表查询 )

②以下接口将迁移至权限包“淘宝客【公用】物料信息查询”

taobao.tbk.item.info.upgrade.get(淘宝客-公用-商品详情查询升级版（简易版）)

注意事项二：推广者升级版物料API开放申请后，原推广者物料API计划在双11后逐步下线。具体下线事宜将在双11后另行通知，请各位淘宝客尽快申请升级版物料api权限。

三、升级版物料api优势及亮点

1、商品信息结构化展示

①将商品信息字段分为3类：商品基础信息、价格促销信息、淘客推广信息；

②将优惠信息标准化表达为：优惠名称、优惠描述、优惠金额、优惠开始和结束时间；

③在商品信息中增加品牌名称。

2、增加商品到手价促销信息

包含预估到手价（含到手价优惠路径）、预热到手价（含预热到手价优惠路径）、预估凑单价（含预估凑单优惠路径，路径仅物料精选）、更多优惠（商品其他的优惠信息）、商品利益点标签（如88VIP、花呗免息、猫超买返等）。

3、更新字段描述、下线低使用率字段

①更新优化入参出参中字段的描述，便于开发者理解及使用，并对使用率低的字段进行下线；

②入参下线字段包含：如链接形式(pc/无线)、本地化业务相关、物料评估相关等；

③出参中原物料api部分字段迁移到升级版：如预售商品相关、选品库相关、前N件佣金信息相关等。

④出参新增“优惠券ID”字段。

四、各个api接口字段变化详情（2023年10月16日上线）

1、“物料搜索升级版”入参及出参字段优化详情

接口名称：

taobao.tbk.dg.material.optional.upgrade(淘宝客-推广者-物料搜索升级版)

taobao.tbk.sc.material.optional.upgrade(淘宝客-服务商-物料搜索升级版)

字段优化详情：

入参变更内容

出参变更内容

2、“物料精选升级版”入参及出参字段优化详情

接口名称：

taobao.tbk.dg.material.recommend(淘宝客-推广者-物料精选升级版)

taobao.tbk.sc.material.recommend(淘宝客-服务商-物料精选升级版)

字段优化详情：

入参变更内容

出参变更内容

3、“商品详情查询升级版（简易版）”入参及出参字段优化详情

接口名称：taobao.tbk.item.info.upgrade.get(淘宝客-公用-商品详情查询升级版（简易版）)

字段优化详情：

入参无变化

出参变更内容

附升级版物料API媒体接入使用建议：

https://www.yuque.com/taobaolianmengguanfangxiaoer/fgr12p/ynmx2x3w43p2gptf?singleDoc#

更多升级相关问题扫码加入官方钉钉答疑群