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

taobao.tbk.shop.recommend.get (淘宝客-公用-店铺关联推荐)

入参卖家id,可推荐与此店铺相关联的相关店铺。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
count Number 可选 20 返回数量,默认20,最大值40
fields String 必须 user_id,shop_title,shop_type,seller_nick,pict_url,shop_url 需返回的字段列表
platform Number 可选 1 链接形式:1:PC,2:无线,默认:1
user_id Number 必须 123 卖家Id

响应参数

名称 类型 示例值 描述
results NTbkShop [] 淘宝客店铺
  • └ user_id
  • Number
  • 123
  • 卖家ID
  • └ shop_title
  • String
  • 女装店铺
  • 店铺名称
  • └ seller_nick
  • String
  • demo
  • 卖家昵称
  • └ shop_type
  • String
  • B
  • 店铺类型,B:天猫,C:淘宝
  • └ shop_url
  • String
  • http://store.taobao.com/shop/xxx
  • 店铺地址
  • └ pict_url
  • String
  • http://img01.taobaocdn.com/bao/uploaded/i1/xxx.jpg
  • 店标图片

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
TbkShopRecommendGetRequest req = new TbkShopRecommendGetRequest();
req.setCount(20L);
req.setFields("user_id,shop_title,shop_type,seller_nick,pict_url,shop_url");
req.setPlatform(1L);
req.setUserId(123L);
TbkShopRecommendGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<tbk_shop_recommend_get_response>
    <results>
        <n_tbk_shop>
            <user_id>123</user_id>
            <shop_title>女装店铺</shop_title>
            <seller_nick>demo</seller_nick>
            <shop_type>B</shop_type>
            <shop_url>http://store.taobao.com/shop/xxx</shop_url>
            <pict_url>http://img01.taobaocdn.com/bao/uploaded/i1/xxx.jpg</pict_url>
        </n_tbk_shop>
    </results>
</tbk_shop_recommend_get_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>

错误码解释

错误码 错误描述 解决方案
isp.tbkapi-service-unavailable 内部服务不可用 稍后重试

API工具

如何获得此API

FAQ

返回
顶部