文档中心 > API类目 > 淘宝客API

taobao.tbk.thor.mfrs.promotion.query (淘宝联盟厂商找优惠)

根据用户输入的图片或者淘口令,识别淘内相似商品,并对符合条件的商品集做商业化处理后,返回该商品列表。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
option ManufacturerLaunchOption 可选 查询请求对象
  • └ img
  • String
  • 可选
  • base64xxxx
  • 图片按照短边不超过320的方式等比例缩放,转字节流时按jpg格式,压缩率80进行转换
  • └ sub_title
  • String
  • 可选
  • 柠檬泡泡糖
  • 商品副标题
  • └ scene_code
  • String
  • 必须
  • h5_img
  • 场景类型
  • └ unique_id_type
  • String
  • 可选
  • oaid
  • OAID/手机号/imei
  • └ price
  • String
  • 可选
  • 9.9
  • 价格
  • └ pid
  • String
  • 必须
  • mm_0_0_0
  • 媒体pid
  • └ title
  • String
  • 可选
  • 泡泡糖
  • 商品标题
  • └ sku
  • String
  • 可选
  • 4g+128g
  • sku名
  • └ unique_id
  • String
  • 可选
  • 123
  • 唯一标识
  • └ url
  • String
  • 可选
  • http://www.taobao.com
  • 商品链接
  • └ tbpwd
  • String
  • 可选
  • 淘口令¥dfadfa¥
  • 淘口令
  • └ scene_sub_code
  • String
  • 可选
  • Hitoch
  • 子场景码:Hivision(拍照识图)、Hitoch(双指按压)
  • └ from
  • String
  • 可选
  • taobao
  • 如手淘、京东、抖音、快手
  • └ variable_map
  • String
  • 可选
  • {}
  • 扩展字段

响应参数

名称 类型 示例值 描述
source_item ManufacturerItemsDto 原商品信息
  • └ img
  • String
  • http://g.search.alicdn.com/img/bao/uploaded/i4/O1CN01kPaEx423V85zEvcJa_!!0-item_pic.jpg
  • 商品图片地址
  • └ shop
  • String
  • xx官方店
  • 店铺名称
  • └ coupon
  • String
  • 5元
  • 优惠券信息
  • └ item_title
  • String
  • 光明成人奶粉全脂袋装400g烘焙奶茶蛋糕 大学生成人奶粉全家早餐
  • 商品标题
  • └ sale_price
  • String
  • 99
  • 售价
  • └ icon_list
  • String []
  • 满xx减xx
  • 营销标签
  • └ impression_tracking_url
  • String
  • https://trace.thor.alimama.com/trace/impression?pv_id=1346601450649681984&i=0&refpid=mm_0_0_0&nid=634180232404&type=
  • 曝光反馈地址
  • └ free_shipment
  • String
  • 1
  • 是否包邮
  • └ click_through_by_h5
  • String
  • https://redirect.simba.taobao.com/rd?c=un&w=bd&f=http%3A%2F%2Fa.m.taobao.com%2Fi634180232404.htm%3F%26utd_id%3DXgIp0gPdHJkDACaskJChvf%2525252BD%26sid%3Dc5a247bbc61a26a95feba3a4cc978cf3%26%3Dmrci0&pid=mm_0_0_0&k=f08ff385262fad84
  • 跳转地址
  • └ zk_final_price
  • String
  • 33
  • 价格
  • └ volume
  • String
  • 1
  • 30天销量
  • └ click_tracking_url
  • String
  • https://trace.thor.alimama.com/trace/impression?pv_id=1346601450649681984&i=0&refpid=mm_0_0_0&nid=634180232404&type=
  • 点击反馈链接
  • └ provcity
  • String
  • 北京
  • 地区
  • └ click_through_by_deeplink
  • String
  • tbopen://m.taobao.com/tbopen/index.html?&action=ali.open.nav&module=h5&bootImage=0&source=alimama&appkey=mm_0_0_0&h5Url=https%3A%2F%2Fredirect.simba.taobao.com%2Frd%3Fc%3Dun%26w%3Dbd%26f%3Dhttp%253A%252F%252Fa.m.taobao.com%252Fi634180232404.htm%253F%2526utd_id%253DXgIp0gPdHJkDACaskJChvf%252525252BD%2526sid%253Dc5a247bbc61a26a95feba3a4cc978cf3%2526%253Dmrci0%26pid%3Dmm_0_0_0%26k%3Df08ff385262fad84&bc_fl_src=tunion_vipmedia_manufacturer
  • deeplink地址
  • └ coupon_click_through_by_deeplink
  • String
  • https://redirect.simba.taobao.com/rd?c=un&w=bd&f=http%3A%2F%2Fa.m.taobao.com%2Fi634180232404.htm%3F%26utd_id%3DXgIp0gPdHJkDACaskJChvf%2525252BD%26sid%3Dc5a247bbc61a26a95feba3a4cc978cf3%26%3Dmrci0&pid=mm_0_0_0&k=f08ff385262fad84
  • 券地址
  • └ coupon_click_through_by_h5
  • String
  • tbopen://m.taobao.com/tbopen/index.html?&action=ali.open.nav&module=h5&bootImage=0&source=alimama&appkey=mm_0_0_0&h5Url=https%3A%2F%2Fredirect.simba.taobao.com%2Frd%3Fc%3Dun%26w%3Dbd%26f%3Dhttp%253A%252F%252Fa.m.taobao.com%252Fi634180232404.htm%253F%2526utd_id%253DXgIp0gPdHJkDACaskJChvf%252525252BD%2526sid%253Dc5a247bbc61a26a95feba3a4cc978cf3%2526%253Dmrci0%26pid%3Dmm_0_0_0%26k%3Df08ff385262fad84&bc_fl_src=tunion_vipmedia_manufacturer
  • 领取deeplink地址
  • └ shop_type
  • String
  • 天猫
  • 店铺类型
page_size String 20 分页大小
page String 1 页码
status String 0 请求状态码
desc String 正常 异常描述
url String https://www.taobao.com 返回h5入口地址

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkThorMfrsPromotionQueryRequest req = new TbkThorMfrsPromotionQueryRequest();
TbkThorMfrsPromotionQueryRequest.ManufacturerLaunchOption obj1 = new TbkThorMfrsPromotionQueryRequest.ManufacturerLaunchOption();
obj1.setImg("base64xxxx");
obj1.setSubTitle("柠檬泡泡糖");
obj1.setSceneCode("h5_img");
obj1.setUniqueIdType("oaid");
obj1.setPrice("9.9");
obj1.setPid("mm_0_0_0");
obj1.setTitle("泡泡糖");
obj1.setSku("4g+128g");
obj1.setUniqueId("123");
obj1.setUrl("http://www.taobao.com");
obj1.setTbpwd("淘口令¥dfadfa¥");
obj1.setSceneSubCode("Hitoch");
obj1.setFrom("taobao");
obj1.setVariableMap("{}");
req.setOption(obj1);
TbkThorMfrsPromotionQueryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_thor_mfrs_promotion_query_response>
    <source_item>
        <img>http://g.search.alicdn.com/img/bao/uploaded/i4/O1CN01kPaEx423V85zEvcJa_!!0-item_pic.jpg</img>
        <shop>xx官方店</shop>
        <coupon>5元</coupon>
        <item_title>光明成人奶粉全脂袋装400g烘焙奶茶蛋糕 大学生成人奶粉全家早餐</item_title>
        <sale_price>99</sale_price>
        <icon_list>
            <string>满xx减xx</string>
        </icon_list>
        <impression_tracking_url>https://trace.thor.alimama.com/trace/impression?pv_id=1346601450649681984&amp;i=0&amp;refpid=mm_0_0_0&amp;nid=634180232404&amp;type=</impression_tracking_url>
        <free_shipment>1</free_shipment>
        <click_through_by_h5>https://redirect.simba.taobao.com/rd?c=un&amp;w=bd&amp;f=http%3A%2F%2Fa.m.taobao.com%2Fi634180232404.htm%3F%26utd_id%3DXgIp0gPdHJkDACaskJChvf%2525252BD%26sid%3Dc5a247bbc61a26a95feba3a4cc978cf3%26%3Dmrci0&amp;pid=mm_0_0_0&amp;k=f08ff385262fad84</click_through_by_h5>
        <zk_final_price>33</zk_final_price>
        <volume>1</volume>
        <click_tracking_url>https://trace.thor.alimama.com/trace/impression?pv_id=1346601450649681984&amp;i=0&amp;refpid=mm_0_0_0&amp;nid=634180232404&amp;type=</click_tracking_url>
        <provcity>北京</provcity>
        <click_through_by_deeplink>tbopen://m.taobao.com/tbopen/index.html?&amp;action=ali.open.nav&amp;module=h5&amp;bootImage=0&amp;source=alimama&amp;appkey=mm_0_0_0&amp;h5Url=https%3A%2F%2Fredirect.simba.taobao.com%2Frd%3Fc%3Dun%26w%3Dbd%26f%3Dhttp%253A%252F%252Fa.m.taobao.com%252Fi634180232404.htm%253F%2526utd_id%253DXgIp0gPdHJkDACaskJChvf%252525252BD%2526sid%253Dc5a247bbc61a26a95feba3a4cc978cf3%2526%253Dmrci0%26pid%3Dmm_0_0_0%26k%3Df08ff385262fad84&amp;bc_fl_src=tunion_vipmedia_manufacturer</click_through_by_deeplink>
        <coupon_click_through_by_deeplink>https://redirect.simba.taobao.com/rd?c=un&amp;w=bd&amp;f=http%3A%2F%2Fa.m.taobao.com%2Fi634180232404.htm%3F%26utd_id%3DXgIp0gPdHJkDACaskJChvf%2525252BD%26sid%3Dc5a247bbc61a26a95feba3a4cc978cf3%26%3Dmrci0&amp;pid=mm_0_0_0&amp;k=f08ff385262fad84</coupon_click_through_by_deeplink>
        <coupon_click_through_by_h5>tbopen://m.taobao.com/tbopen/index.html?&amp;action=ali.open.nav&amp;module=h5&amp;bootImage=0&amp;source=alimama&amp;appkey=mm_0_0_0&amp;h5Url=https%3A%2F%2Fredirect.simba.taobao.com%2Frd%3Fc%3Dun%26w%3Dbd%26f%3Dhttp%253A%252F%252Fa.m.taobao.com%252Fi634180232404.htm%253F%2526utd_id%253DXgIp0gPdHJkDACaskJChvf%252525252BD%2526sid%253Dc5a247bbc61a26a95feba3a4cc978cf3%2526%253Dmrci0%26pid%3Dmm_0_0_0%26k%3Df08ff385262fad84&amp;bc_fl_src=tunion_vipmedia_manufacturer</coupon_click_through_by_h5>
        <shop_type>天猫</shop_type>
    </source_item>
    <page_size>20</page_size>
    <page>1</page>
    <status>0</status>
    <desc>正常</desc>
    <url>https://www.taobao.com</url>
</tbk_thor_mfrs_promotion_query_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部