taobao.item_search_best
public parameter
Request address: application call address
| name | type | must | describe |
|---|---|---|---|
| key | String | yes | Call key (must be spliced in the URL in GET mode) |
| secret | String | yes | call key |
| api_name | String | yes | API interface name (included in the request address) [item_search, item_get, item_search_shop, etc.] |
| cache | String | no | [yes, no] The default is yes, the cached data will be called, and the speed is relatively fast |
| result_type | String | no | [json,jsonu,xml,serialize,var_export] returns the data format, the default is json, and the content output by jsonu can be read directly in Chinese |
| lang | String | no | [cn,en,ru] translation language, default cn Simplified Chinese |
| version | String | no | API version |
request parameters
Request parameters: q=
Parameter description: q: search keyword keyword is empty to search out the categories that can be searched
response parameter
Version: Date:
| name | type | must | example value | describe |
|---|---|---|---|---|
| items |
items[] | 0 | Tmall Bestseller List |
Example request
-- Request example url The default request parameters have been URL-encoded curl -i "https://api-gw.onebound.cn/taobao/item_search_best/?key=<your own apiKey>&secret=<your own apiSecret>&q="
<?php
// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输，若要加密请参考：https://open.onebound.cn/help/demo/sdk/demo-sign.php
$method = "GET";
$url = "https://api-gw.onebound.cn/taobao/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?><?php
//定义缓存目录和引入文件
define("DIR_RUNTIME","runtime/");
define("DIR_ERROR","runtime/");
define("SECACHE_SIZE","0");
//SDK下载地址 https://open.onebound.cn/help/demo/sdk/onebound-api-sdk.zip
include ("ObApiClient.php");
$obapi = new otao\ObApiClient();
$obapi->api_url = "http://api-gw.onebound.cn/";
$obapi->api_urls = array("http://api-gw.onebound.cn/","http://api-1.onebound.cn/");//备用API服务器
$obapi->api_urls_on = true;//当网络错误时，是否启用备用API服务器
$obapi->api_key = "<您自己的apiKey>";
$obapi->api_secret = "<您自己的apiSecret>";
$obapi->api_version ="";
$obapi->secache_path ="runtime/";
$obapi->secache_time ="86400";
$obapi->cache = true;
$api_data = $obapi->exec(
array(
"api_type" =>"taobao",
"api_name" =>"item_search_best",
"api_params"=>array (
'q' => '',
)
)
);
var_dump($api_data);
?>import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.Reader;
import java.net.URL;
import java.nio.charset.Charset;
import org.json.JSONException;
import org.json.JSONObject;
import java.io.PrintWriter;
import java.net.URLConnection;
public class Example {
private static String readAll(Reader rd) throws IOException {
StringBuilder sb = new StringBuilder();
int cp;
while ((cp = rd.read()) != -1) {
sb.append((char) cp);
}
return sb.toString();
}
public static JSONObject postRequestFromUrl(String url, String body) throws IOException, JSONException {
URL realUrl = new URL(url);
URLConnection conn = realUrl.openConnection();
conn.setDoOutput(true);
conn.setDoInput(true);
PrintWriter out = new PrintWriter(conn.getOutputStream());
out.print(body);
out.flush();
InputStream instream = conn.getInputStream();
try {
BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
String jsonText = readAll(rd);
JSONObject json = new JSONObject(jsonText);
return json;
} finally {
instream.close();
}
}
public static JSONObject getRequestFromUrl(String url) throws IOException, JSONException {
URL realUrl = new URL(url);
URLConnection conn = realUrl.openConnection();
InputStream instream = conn.getInputStream();
try {
BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
String jsonText = readAll(rd);
JSONObject json = new JSONObject(jsonText);
return json;
} finally {
instream.close();
}
}
public static void main(String[] args) throws IOException, JSONException {
// 请求示例 url 默认请求参数已经URL编码处理
String url = "https://api-gw.onebound.cn/taobao/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=";
JSONObject json = getRequestFromUrl(url);
System.out.println(json.toString());
}
}example response
{
"q": "无线键盘",
"item": [
{
"title": "【官方旗舰店】罗技K380无线蓝牙网红键盘安静ipad平板电脑台式手机女生可爱办公游戏打字专用外接外设罗技官方旗舰店",
"pic_url": "https://img.alicdn.com/bao/uploaded/TB1edMaXCzqK1RjSZFjSuvlCFXa.jpg_350x350",
"price": "159.00",
"sales": "8176",
"detail_url": "https://s.click.taobao.com/t?e=m%3D2%26s%3DF6o7kwXrX6ocQipKwQzePOeEDrYVVa64r4ll3HtqqoxyINtkUhsv0F%2FtGfD0ipL5U4PimJnr1wQWGml3PLSlC2fKtDBMFT9QT0n8%2BzH0s2yjZ3Yv0zGjw19EeTtntI44CrmmMqCz%2FxW9NunShXFiUbj8Cm8j3o1mM3Qcus9gDJQWbCLyT%2Fn9DT%2FaKoAUC9FwcSpj5qSCmbA%3D&scm=null&pvid=100_11.30.122.15_21086_5341617738660797238&app_pvid=59590_11.181.118.50_1033_1617738660793&ptl=floorId:2836;originalFloorId:2836;pvid:100_11.30.122.15_21086_5341617738660797238;app_pvid:59590_11.181.118.50_1033_1617738660793&xId=2aAcT3wZV441MyLfCdZSlw3HsdCRTHXuDI5gXEZmskK40w2SennXNhRTu665RC3OLGaueoHYGVYsSVB4v3a2FViY3TEq9ccrrUsW7OT0oseE&union_lens=lensId%3AMAPI%401617738660%400bb57632_0804_178a8bcfbec_cdb1%4001"
},
{
"title": "BOW航世笔记本外接有线键盘无声静音USB迷你小型无线台式机电脑外置办公专用打字小巧便携鼠标套装女生可爱bow航世专卖店",
"pic_url": "https://img.alicdn.com/bao/uploaded/O1CN01JZg8H41vwatN5XdYt_!!6000000006237-0-yinhe.jpg_350x350",
"price": "29.00",
"sales": "7558",
"detail_url": "https://s.click.taobao.com/t?e=m%3D2%26s%3D91rBYpZDIeYcQipKwQzePOeEDrYVVa64r4ll3HtqqoxyINtkUhsv0F%2FtGfD0ipL5U4PimJnr1wQWGml3PLSlC2fKtDBMFT9QT0n8%2BzH0s2yjZ3Yv0zGjw19EeTtntI44APM1yEWlIVQhpIO1uuGFvWIDldUMtpOyrf%2FrvZQRRQnXxLZzVxd0imy8nc7QIYuhEpQV88orRmiiZ%2BQMlGz6FQ%3D%3D&scm=null&pvid=100_11.30.122.15_21086_5341617738660797238&app_pvid=59590_11.181.118.50_1033_1617738660793&ptl=floorId:2836;originalFloorId:2836;pvid:100_11.30.122.15_21086_5341617738660797238;app_pvid:59590_11.181.118.50_1033_1617738660793&xId=1edI8KeimgxwYHCU3PiB4Lq0fwi90thAAK9ZMC7V0s7l0Gg18r4HbsDygWMleR1lbNFPgdvOqLiwF6QIGF3OTSrrRSpow9cgsIaV0AI2SIQz&union_lens=lensId%3AMAPI%401617738660%400bb57632_0804_178a8bcfbec_cdbe%4001"
},
{
"title": "飞利浦无线键盘鼠标套装可充电静音轻薄防溅水键鼠笔记本台式电脑飞利浦卡博专卖店",
"pic_url": "https://img.alicdn.com/bao/uploaded/TB1pxrUNbr1gK0jSZFDSuv9yVXa.jpg_350x350",
"price": "59.90",
"sales": "6688",
"detail_url": "https://s.click.taobao.com/t?e=m%3D2%26s%3DUwqj46DkjagcQipKwQzePOeEDrYVVa64r4ll3HtqqoxyINtkUhsv0F%2FtGfD0ipL5U4PimJnr1wQWGml3PLSlC2fKtDBMFT9QT0n8%2BzH0s2yjZ3Yv0zGjw19EeTtntI44APM1yEWlIVSNzj21NxUnDVaS1P7NuWqkC7aMSN1DK%2Fgte8uRU2fmX40hN46u0JKDIYULNg46oBA%3D&scm=null&pvid=100_11.30.122.15_21086_5341617738660797238&app_pvid=59590_11.181.118.50_1033_1617738660793&ptl=floorId:2836;originalFloorId:2836;pvid:100_11.30.122.15_21086_5341617738660797238;app_pvid:59590_11.181.118.50_1033_1617738660793&xId=3PClaxkN4oPyUxJiWW4lnntGC58V0bXKnOakRMMVkpgjoTsqnk44lZgMwKOC9bMKqWLxOASv0wu17yOTpWUWVG7CJWhbDt0h1cQvLjg9eKUb&union_lens=lensId%3AMAPI%401617738660%400bb57632_0804_178a8bcfbec_cdbf%4001"
},
{
"title": "铂科无线键盘键鼠手机平板电脑USB家用办公笔记本无线键盘鼠标套装打字台式便携防水外接充电式鼠标燕庆数码专营店",
"pic_url": "https://img.alicdn.com/bao/uploaded/TB1zs_uUHr1gK0jSZFDSuv9yVXa.jpg_350x350",
"price": "29.90",
"sales": "6325",
"detail_url": "https://s.click.taobao.com/t?e=m%3D2%26s%3Dpt82mgegbRAcQipKwQzePOeEDrYVVa64r4ll3HtqqoxyINtkUhsv0F%2FtGfD0ipL5U4PimJnr1wQWGml3PLSlC2fKtDBMFT9QT0n8%2BzH0s2yjZ3Yv0zGjw19EeTtntI44C4HuMa7Uxjq5HZyq1kkLgh3R%2BeJjp281DRliy8hZrb1UhtkHxZ3V3o0hN46u0JKDIYULNg46oBA%3D&scm=null&pvid=100_11.30.122.15_21086_5341617738660797238&app_pvid=59590_11.181.118.50_1033_1617738660793&ptl=floorId:2836;originalFloorId:2836;pvid:100_11.30.122.15_21086_5341617738660797238;app_pvid:59590_11.181.118.50_1033_1617738660793&xId=2VWth1bbW607RHnkb0qK6CdtM5kwurEKRypxoxkbyeYAJrDb2ofDDZ1txWQWrxzURxlmbnPA0SL8qcDmXJRtGgGM9vlG9m1vSdStTBEny69j&union_lens=lensId%3AMAPI%401617738660%400bb57632_0804_178a8bcfbec_cdc0%4001"
},
{
"title": "BOW航世 巧克力键盘有线台式电脑联想笔记本USB外接家用办公打字专用苹果无线小键盘鼠标键鼠套装静音迷你bow旗舰店",
"pic_url": "https://img.alicdn.com/bao/uploaded/TB100eIxkomBKNjSZFqSuttqVXa.jpg_350x350",
"price": "39.00",
"sales": "6141",
"detail_url": "https://s.click.taobao.com/t?e=m%3D2%26s%3DG4Rrwb4%2Fn38cQipKwQzePOeEDrYVVa64r4ll3HtqqoxyINtkUhsv0F%2FtGfD0ipL5U4PimJnr1wQWGml3PLSlC2fKtDBMFT9QT0n8%2BzH0s2yjZ3Yv0zGjw19EeTtntI446vEizJH6WXGLKCJuWn8uCRIjP5Uhv22UL%2Bzsihq0ksLOsbPLfXOWsEnT0948dnCUxgxdTc00KD8%3D&scm=null&pvid=100_11.30.122.15_21086_5341617738660797238&app_pvid=59590_11.181.118.50_1033_1617738660793&ptl=floorId:2836;originalFloorId:2836;pvid:100_11.30.122.15_21086_5341617738660797238;app_pvid:59590_11.181.118.50_1033_1617738660793&xId=5dlMyQgGHlRwDjok4tYsHia8wjeFIE9HKJLu8Nsn3lKhZfzIneJqJzaPJ5LUdSeY62VVhUIN2AiLdxtYCZxNcM3tX9uWpisenNeMfAsJsmwK&union_lens=lensId%3AMAPI%401617738660%400bb57632_0804_178a8bcfbec_cdc5%4001"
},
{
"title": "ikbc87机械键盘cherry樱桃无线办公青茶黑银静音红轴c104有线游戏ikbc旗舰店",
"pic_url": "https://img.alicdn.com/bao/uploaded/TB1fUrHiNn1gK0jSZKPSutvUXXa.jpg_350x350",
"price": "299.00",
"sales": "5525",
"detail_url": "https://s.click.taobao.com/t?e=m%3D2%26s%3Dj23bsnPtOZ4cQipKwQzePOeEDrYVVa64r4ll3HtqqoxyINtkUhsv0F%2FtGfD0ipL5U4PimJnr1wQWGml3PLSlC2fKtDBMFT9QT0n8%2BzH0s2yjZ3Yv0zGjw19EeTtntI44YvJFZec7iFLPcvrcHC%2Fis61uflf3oSYWQTEbgHxA8nNsvJ3O0CGLoRKUFfPKK0ZoomfkDJRs%2BhU%3D&scm=null&pvid=100_11.30.122.15_21086_5341617738660797238&app_pvid=59590_11.181.118.50_1033_1617738660793&ptl=floorId:2836;originalFloorId:2836;pvid:100_11.30.122.15_21086_5341617738660797238;app_pvid:59590_11.181.118.50_1033_1617738660793&xId=1dqgkjm9d3Kh3CbgTdbVu2aBPvAXR5h1MThsW4BkyJI6WxypjRwqlubmWf9zKQcXJ1Iy8P6ECGyplU3xE27rir2lMUPCSxGYvz45gscvw2Zz&union_lens=lensId%3AMAPI%401617738660%400bb57632_0804_178a8bcfbec_cdd2%4001"
},
{
"title": "铂科无线键盘鼠标套装笔记本无线键鼠台式电脑游戏外接usb办公套装打字台式便携防水外接充电式鼠标燕庆数码专营店",
"pic_url": "https://img.alicdn.com/bao/uploaded/i1/812019296/O1CN01DDAG8Z2IXcSjQtY7z_!!812019296.jpg_350x350",
"price": "29.90",
"sales": "5081",
"detail_url": "https://s.click.taobao.com/t?e=m%3D2%26s%3Da2DxAw2dT84cQipKwQzePOeEDrYVVa64r4ll3HtqqoxyINtkUhsv0F%2FtGfD0ipL5U4PimJnr1wQWGml3PLSlC2fKtDBMFT9QT0n8%2BzH0s2yjZ3Yv0zGjw19EeTtntI44C4HuMa7Uxjq5HZyq1kkLglx%2BbfvFvg8l%2FPG5dr%2F1E%2FQAatB4fwRoyj%2FaKoAUC9FwcSpj5qSCmbA%3D&scm=null&pvid=100_11.30.122.15_21086_5341617738660797238&app_pvid=59590_11.181.118.50_1033_1617738660793&ptl=floorId:2836;originalFloorId:2836;pvid:100_11.30.122.15_21086_5341617738660797238;app_pvid:59590_11.181.118.50_1033_1617738660793&xId=67lBMdQdUKWwqzym6DwE2QPakxU4BSS6PVWdA3m8RkFTNgwmOBLMIqulgnSSR75QIpbzp3F07HeY0emmQsOIhGCpdIMyvvXeBhaOqv4ev4A8&union_lens=lensId%3AMAPI%401617738660%400bb57632_0804_178a8bcfbec_cdd3%4001"
},