淘宝/天猫：畅销榜 API 返回值说明

item_search_best-天猫畅销榜 [查看演示] API测试工具 注册开通

onebound.taobao.item_search_best

公共参数

请求地址: api-gw.onebound.cn/taobao/item…

名称	类型	必须	描述
key	String	是	调用key（必须以GET方式拼接在URL中）
secret	String	是	调用密钥
api_name	String	是	API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等]
cache	String	否	[yes,no]默认yes，将调用缓存的数据，速度比较快
result_type	String	否	[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读
lang	String	否	[cn,en,ru]翻译语言，默认cn简体中文
version	String	否	API版本

请求参数

请求参数：q=

参数说明：q：搜索关键字 关键字为空搜索出能搜索的类目\

响应参数

Version: Date:

名称	类型	必须	示例值	描述
items	items[]	0		天猫畅销榜
q	String	0	无线键盘	关键字
item	item[]	0		宝贝详情数据

请求示例

• Curl
• PHP
• PHPsdk
• JAVA
• C#
• Python

	
-- 请求示例 url 默认请求参数已经URL编码处理
curl -i "https://api-gw.onebound.cn/taobao/item_search_best/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q="

响应示例

{
	"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"
		},
		{
			"title": "Huawei/华为蓝牙无线键盘鼠标套装静音新款MateBook/magicbook充电超薄迷你外接笔记本苹果手机平板ipad通用亿丰宇数码专营店",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i1/2206614523620/O1CN016IzZWt1cc0OkUsk0a_!!2206614523620.jpg_350x350",
			"price": "39.90",
			"sales": "4981",
			"detail_url": "https://s.click.taobao.com/t?e=m%3D2%26s%3Dziw%2Fycwwp70cQipKwQzePOeEDrYVVa64r4ll3HtqqoxyINtkUhsv0F%2FtGfD0ipL5U4PimJnr1wQWGml3PLSlC2fKtDBMFT9QT0n8%2BzH0s2yjZ3Yv0zGjw19EeTtntI44APM1yEWlIVSjIEW9hmxymShtL6%2BI76V2VqyNplfNiJ3TWeCq80TnD40hN46u0JKDIYULNg46oBA%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=7nVpYMxYISn6Xj1tvLB1uIKWhI777QfIJu13my1gT8zXvVuodLBBNQLQ2BXBI0NBHZYjz5SHnQyC3fUIhm8pkCYRN23sb4nrWmMEqhySZi1O&union_lens=lensId%3AMAPI%401617738660%400bb57632_0804_178a8bcfbed_cdd4%4001"
		},
		{
			"title": "无线蓝牙键盘可充电静音超薄迷你适用苹果ipad键盘电脑手机平板雷宝龙旗舰店",
			"pic_url": "https://img.alicdn.com/bao/uploaded/i3/2200834899866/O1CN01etajdQ2MkgF49887O_!!2200834899866.jpg_350x350",
			"price": "29.90",
			"sales": "4827",
			"detail_url": "https://s.click.taobao.com/t?e=m%3D2%26s%3Dv19h%2BkmS5FscQipKwQzePOeEDrYVVa64r4ll3HtqqoxyINtkUhsv0F%2FtGfD0ipL5U4PimJnr1wQWGml3PLSlC2fKtDBMFT9QT0n8%2BzH0s2yjZ3Yv0zGjw19EeTtntI44APM1yEWlIVScFfIFqyZdKJs47UhVtjnn%2F0TowK7g5BWsagQRsxTI%2Bmy8nc7QIYuhEpQV88orRmiiZ%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=1J8mdqrzD5B1sY3QVqpTiObNOq1DxfrgKEiqDP42fgryjqgVKCHAlKcExLxeEIfWVxf8EDDmfhmWO4dmp0zylJ4hG6V8AvWftZ1h8NltZgfU&union_lens=lensId%3AMAPI%401617738660%400bb57632_0804_178a8bcfbed_cdd6%4001"
		},
		{
			"title": "英菲克V750B蓝牙键盘无线新款适用于苹果ipad华为平板电脑手机通英菲克旗舰店",
			"pic_url": "https://img.alicdn.com/bao/uploaded/TB1ZT9jLW61gK0jSZFlSutDKFXa.jpg_350x350",
			"price": "29.90",
			"sales": "3756",
			"detail_url": "https://s.click.taobao.com/t?e=m%3D2%26s%3DWW1%2Fxm4oFIscQipKwQzePOeEDrYVVa64r4ll3HtqqoxyINtkUhsv0Ac3BClBIClZkYq54YhbC%2BMWGml3PLSlC2fKtDBMFT9QT0n8%2BzH0s2yjZ3Yv0zGjw19EeTtntI44SG2odnQsJfFijvXGmIWuq0owlW2eDJuuA4xr0CbX7iOGv1kaVyqkIByItbCTVBmy&scm=null&pvid=100_11.14.179.76_3219_1261617742646638487&app_pvid=59590_33.5.222.19_839_1617742646635&ptl=floorId:2836;originalFloorId:2836;pvid:100_11.14.179.76_3219_1261617742646638487;app_pvid:59590_33.5.222.19_839_1617742646635&xId=6O2YPDr0B4t1CV1aMh6Lxs1agw9UpKZKX8OX8pBMbL366uL6wmGJzxYTWHBR35hV9fyc207c9VGuUznSkFvzrkXf7mt16sWOD14NS1ULyABf&union_lens=lensId%3AMAPI%401617742646%402105de13_3d62_178a8f9cd98_4ff5%4001"
		},
		{
			"title": "",
			"pic_url": "",
			"price": "",
			"sales": "",
			"detail_url": ""
		}
	],
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:30 max:10000",
	"execution_time": 1.697,
	"server_time": "Beijing/2021-04-22 15:15:48",
	"client_ip": "106.6.32.155",
	"call_args": [],
	"api_type": "taobao",
	"translate_language": "zh-CN",
	"translate_engine": "google_cn",
	"server_memory": "5.5MB",
	"request_id": "gw-3.608122a3161fb"
}
```
```
异常示例

```
{
  "error": "data error",
  "reason": "",
  "error_code": "5000",
  "success": 0,
  "cache": 0,
  "api_info": "today:0 max:10000",
  "execution_time": 0.081,
  "server_time": "Beijing/2020-06-10 23:44:00",
  "call_args": [],
  "api_type": "taobao",
  "request_id": "15ee0ffc041242"}
```

[]()相关资料错误码解释

| 状态代码(error_code) | 状态信息                               | 详细描述            | 是否收费 |
| ---------------- | ---------------------------------- | --------------- | ---- |
| 0000             | success                            | 接口调用成功并返回相关数据   | 是    |
| 2000             | Search success but no result       | 接口访问成功，但是搜索没有结果 | 是    |
| 4000             | Server internal error              | 服务器内部错误         | 否    |
| 4001             | Network error                      | 网络错误            | 否    |
| 4002             | Target server error                | 目标服务器错误         | 否    |
| 4003             | Param error                        | 用户输入参数错误        | 忽略   |
| 4004             | Account not found                  | 用户帐号不存在         | 忽略   |
| 4005             | Invalid authentication credentials | 授权失败            | 忽略   |
| 4006             | API stopped                        | 您的当前API已停用      | 忽略   |
| 4007             | Account stopped                    | 您的账户已停用         | 忽略   |
| 4008             | API rate limit exceeded            | 并发已达上限          | 忽略   |
| 4009             | API maintenance                    | API维护中          | 忽略   |
| 4010             | API not found with these values    | API不存在          | 忽略   |
| 4012             | Please add api first               | 请先添加api         | 忽略   |
| 4013             | Number of calls exceeded           | 调用次数超限          | 忽略   |
| 4014             | Missing url param                  | 参数缺失            | 忽略   |
| 4015             | Wrong pageToken                    | 参数pageToken有误   | 忽略   |
| 4016             | Insufficient balance               | 余额不足            | 忽略   |
| 4017             | timeout error                      | 请求超时            | 否    |
| 5000             | unknown error                      | 未知错误            | 否