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

taobao.tbk.shop.get (淘宝客-推广者-店铺搜索)

淘宝客店铺查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
end_auction_count Number 可选 200 累计推广商品上限
end_commission_rate Number 可选 123 淘客佣金比率上限,1~10000
end_credit Number 可选 20 信用等级上限,1~20
end_total_action Number 可选 100 店铺商品总数上限
fields String 必须 user_id,shop_title,shop_type,seller_nick,pict_url,shop_url 需返回的字段列表
is_tmall Boolean 可选 false 是否商城的店铺,设置为true表示该是属于淘宝商城的店铺,设置为false或不设置表示不判断这个属性
page_no Number 可选 1
  • 默认值:1
  • 第几页,默认1,1~100
    page_size Number 可选 20
  • 默认值:20
  • 页大小,默认20,1~100
    platform Number 可选 1
  • 默认值:1
  • 链接形式:1:PC,2:无线,默认:1
    q String 必须 女装 查询词
    sort String 可选 commission_rate_des 排序_des(降序),排序_asc(升序),佣金比率(commission_rate), 商品数量(auction_count),销售总数量(total_auction)
    start_auction_count Number 可选 123 累计推广商品下限
    start_commission_rate Number 可选 2000 淘客佣金比率下限,1~10000
    start_credit Number 可选 1 信用等级下限,1~20
    start_total_action Number 可选 1 店铺商品总数下限

    响应参数

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

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TbkShopGetRequest req = new TbkShopGetRequest();
    req.setEndAuctionCount(200L);
    req.setEndCommissionRate(123L);
    req.setEndCredit(20L);
    req.setEndTotalAction(100L);
    req.setFields("user_id,shop_title,shop_type,seller_nick,pict_url,shop_url");
    req.setIsTmall(false);
    req.setPageNo(1L);
    req.setPageSize(20L);
    req.setPlatform(1L);
    req.setQ("女装");
    req.setSort("commission_rate_des");
    req.setStartAuctionCount(123L);
    req.setStartCommissionRate(2000L);
    req.setStartCredit(1L);
    req.setStartTotalAction(1L);
    TbkShopGetResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

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

    返回
    顶部