文档中心 > API类目 > 海外-淘宝客API

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

海外淘客店铺搜索

公共参数

请求参数

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

响应参数

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

请求示例

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

响应示例

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

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部