【API迭代】物料接口店铺直播间价格接入

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

为广大开发者更方便获取商品的淘系最优到手价，淘宝联盟API接口于2025.11.04针对部分商品接入商家的店铺直播间到手价，相关接入详情如下：

一、涉及接口及参数

（一）物料类接口

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

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

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

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

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

【物料精选接口仅指定投放ID可透出，如有其他投放ID透出需求可工单至联盟内部小二咨询】

请求参数：

暂无调整

响应参数：

① 新增字段：到手价类型，返回“10”代表当前到手价为直播间到手价

price_promotion_info  <<  final_promotion_target_type

② click_url 与 coupon_share_url 跳转至直播间

（二）转链类接口

taobao.tbk.dg.general.link.convert(淘宝客-推广者-万能转链)

taobao.tbk.sc.general.link.convert(淘宝客-服务商-万能转链)

请求参数：

暂无调整

响应参数：

暂无调整，但转链链接将跳转至直播间

二、参数透出逻辑

① 指定商品：当前此类商品多为天猫服饰类目商品，但实际商品以接口透出为准

② 指定时段：商品店铺直播间开播期间【① 如直播未开播或已结束，则不会返回直播间价格；② 仅接入店铺直播间到手价，不包含达人直播间到手价】

③ 指定价格逻辑：

a.如店铺直播间到手价 低于 联盟现有到手价，接口返回店铺直播间到手价，且“final_promotion_target_type”返回“10”；

b.如店铺直播间到手价 高于 联盟现有到手价，接口依据联盟现有到手价返回，“final_promotion_target_type”不返回

三、店铺直播间商品

物料ID：117935

更多信息您可以进钉钉群，群号:145450004082【进群可先阅读群公告】或提交工单工单入口：“联盟开放平台-答疑中心-提交工单”，问题分类选择“基建类API”（https://aff-open.taobao.com/#!/answer?id=1）