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

taobao.ovs.tbk.dg.material.optional (海外淘宝客-推广者-物料搜索)

海外淘宝客物料搜索API

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
start_price String 可选 1 起始价格范围
q String 可选 裤子 搜索词
site String 可选 TW 站点标识:TW(台湾);HK(香港);MY(马来);SG(新加坡);AU(澳大利亚);CA(加拿大);MO(澳门)
unid String 可选 123 渠道自定义参数
page_no Number 可选 1 页码,默认1
usertype Number 可选 1 商品来源过滤:0(淘宝商品),1(天猫商品)
page_size Number 可选 20 页大小,默认20
end_price String 可选 3 截止价格范围
sort String 可选 price:asc 排序 * default(默认排序) * price:asc(价格升序) * price:des(价格降序) * sales:des(销量降序) * sales:asc(销量升序) * sales:des(销量降序)
adzone_id Number 必须 123 广告位ID

响应参数

名称 类型 示例值 描述
result HSFResultDTO N/A N/A
  • search_item_list
  • SearchItemDTO []
  • N/A
  • N/A
  • └ item_name
  • String
  • 钙片
  • 宝贝标题
  • └ pic_url
  • String
  • https://img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg
  • 宝贝主图链接
  • └ price
  • String
  • 12
  • 商品价格
  • └ promotion_price
  • String
  • 13
  • 宝贝折扣价
  • └ price_after_coupon
  • String
  • 14
  • 宝贝券后价
  • └ usertype
  • String
  • 1
  • 卖家类型,1表示天猫,0表示淘宝
  • └ seller_nick_name
  • String
  • xx旗舰店
  • 卖家昵称
  • └ month_sell_count
  • String
  • 55
  • 月销量
  • └ coupon_amount
  • String
  • 23
  • 券面额
  • └ click_url
  • String
  • https://s.click.taobao.com/abc
  • 推广链接

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
OvsTbkDgMaterialOptionalRequest req = new OvsTbkDgMaterialOptionalRequest();
req.setStartPrice("1");
req.setQ("裤子");
req.setSite("TW");
req.setUnid("123");
req.setPageNo(1L);
req.setUsertype(1L);
req.setPageSize(20L);
req.setEndPrice("3");
req.setSort("price:asc");
req.setAdzoneId(123L);
OvsTbkDgMaterialOptionalResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<ovs_tbk_dg_material_optional_response>
    <result>
        <search_item_list>
            <search_item_d_t_o>
                <item_name>钙片</item_name>
                <pic_url>https://img.alicdn.com/bao/uploaded/i4/745957850/TB1WzSRmV9gSKJjSspbXXbeNXXa_!!0-item_pic.jpg</pic_url>
                <price>12</price>
                <promotion_price>13</promotion_price>
                <price_after_coupon>14</price_after_coupon>
                <usertype>1</usertype>
                <seller_nick_name>xx旗舰店</seller_nick_name>
                <month_sell_count>55</month_sell_count>
                <coupon_amount>23</coupon_amount>
                <click_url>https://s.click.taobao.com/abc</click_url>
            </search_item_d_t_o>
        </search_item_list>
    </result>
</ovs_tbk_dg_material_optional_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

返回
顶部