【API迭代】物料搜索结果迭代升级

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

为保障各淘宝客搜索体验，淘宝联盟结合非CPS同款/相似商品推荐能力，针对消费者搜索场景进行迭代升级，本次迭代将于2026.09.20上线涉及接口为：① taobao.tbk.sc.material.optional.upgrade( 淘宝客-服务商-物料搜索升级版 ) ② taobao.tbk.dg.material.optional.upgrade( 淘宝客-推广者-物料搜索升级版 )
迭代细节如下：

一、场景ID 2入参改造

q参数入参商品标题或商品长链接进行搜索时，如开发者在biz_scene_id未入参2，但联盟校验到您有场景ID2的权限，将自动为您返回商品推广链接及商品ID。

注：①无场景ID2权限且商品标题搜索出来的商品仅有一个时，依旧不返回商品推广链接及商品ID；②无场景ID2权限时，入参商品长链接搜索依旧返回报错；③本次标题搜索将计入场景 ID2调用监控；④ 入参的商品长链接需满足合规要求https://qn.taobao.com/headline/news/10727069?spm=a211vu.12026430.0.0.b46b39295dCyEU

二、个性化搜索迭代

1. 针对个性化搜索，新增指定投放：120232。各开发者可入参special_id、relation_id、device_value获取个性化商品推荐，如您未入参上述字段，联盟将返回默认搜索结果。

注：如您已开通定向邀约的uvid权限，device_type支持入参uvid，您可以在device_value入参各uvid信息。

注：在您使用该能力前，您需要点击以下链接签署相关协议：https://pub.alimama.com/fourth/protocol/common.htm?key=hangye_laxin 未签署协议的调用会返回报错。注：如您是工具服务商，需要您服务的淘客账号签署该协议。

2. 放开非CPS同款/相似商品推荐能力。各开发者无需单独向联盟提交申请，均可使用。该能力的使用详情您可以查询：https://qn.taobao.com/headline/news/10724297?spm=a211vu.12026430.0.0.1fff3929BWtJIC

注：如您已接入非CPS同款/相似商品推荐能力，为保障该能力的正常使用，请您升级能力上线前提前签署1中协议。

3. 原个性化搜索投放：124253能力也迁移至120232，且后续仅维护120232。为保障您更好的使用，请使用124253的开发者迁移至120232。

更多信息您可以进钉钉群，群号:145450004082【进群可先阅读群公告】