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

    item_search_best-天猫畅销榜

    前往获取key和secret

    onebound.taobao.item_search_best

    公共参数

    请求地址: https://api-gw.onebound.cn/taobao/item_search_best

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

    请求参数

    请求参数：q=

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

    响应参数

    Version: Date:

    名称类型必须示例值描述

    items

    		items[]0天猫畅销榜

    q

    		String0无线键盘关键字

    item

    		item[]0宝贝详情数据

    请求示例

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

    响应示例

    1. {
    2. 	"q": "无线键盘",
    3. 	"item": [
    4. 		{
    5. 			"title": "【官方旗舰店】罗技K380无线蓝牙网红键盘安静ipad平板电脑台式手机女生可爱办公游戏打字专用外接外设罗技官方旗舰店",
    6. 			"pic_url": "https://img.alicdn.com/bao/uploaded/TB1edMaXCzqK1RjSZFjSuvlCFXa.jpg_350x350",
    7. 			"price": "159.00",
    8. 			"sales": "8176",
    9. 			"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"
    10. 		},
    11. 		{
    12. 			"title": "BOW航世笔记本外接有线键盘无声静音USB迷你小型无线台式机电脑外置办公专用打字小巧便携鼠标套装女生可爱bow航世专卖店",
    13. 			"pic_url": "https://img.alicdn.com/bao/uploaded/O1CN01JZg8H41vwatN5XdYt_!!6000000006237-0-yinhe.jpg_350x350",
    14. 			"price": "29.00",
    15. 			"sales": "7558",
    16. 			"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"
    17. 		},
    18. 		{
    19. 			"title": "飞利浦无线键盘鼠标套装可充电静音轻薄防溅水键鼠笔记本台式电脑飞利浦卡博专卖店",
    20. 			"pic_url": "https://img.alicdn.com/bao/uploaded/TB1pxrUNbr1gK0jSZFDSuv9yVXa.jpg_350x350",
    21. 			"price": "59.90",
    22. 			"sales": "6688",
    23. 			"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"
    24. 		},
    25. 		{
    26. 			"title": "铂科无线键盘键鼠手机平板电脑USB家用办公笔记本无线键盘鼠标套装打字台式便携防水外接充电式鼠标燕庆数码专营店",
    27. 			"pic_url": "https://img.alicdn.com/bao/uploaded/TB1zs_uUHr1gK0jSZFDSuv9yVXa.jpg_350x350",
    28. 			"price": "29.90",
    29. 			"sales": "6325",
    30. 			"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"
    31. 		},
    32. 		{
    33. 			"title": "BOW航世 巧克力键盘有线台式电脑联想笔记本USB外接家用办公打字专用苹果无线小键盘鼠标键鼠套装静音迷你bow旗舰店",
    34. 			"pic_url": "https://img.alicdn.com/bao/uploaded/TB100eIxkomBKNjSZFqSuttqVXa.jpg_350x350",
    35. 			"price": "39.00",
    36. 			"sales": "6141",
    37. 			"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"
    38. 		},
    39. 		{
    40. 			"title": "ikbc87机械键盘cherry樱桃无线办公青茶黑银静音红轴c104有线游戏ikbc旗舰店",
    41. 			"pic_url": "https://img.alicdn.com/bao/uploaded/TB1fUrHiNn1gK0jSZKPSutvUXXa.jpg_350x350",
    42. 			"price": "299.00",
    43. 			"sales": "5525",
    44. 			"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"
    45. 		},
    46. 		{
    47. 			"title": "铂科无线键盘鼠标套装笔记本无线键鼠台式电脑游戏外接usb办公套装打字台式便携防水外接充电式鼠标燕庆数码专营店",
    48. 			"pic_url": "https://img.alicdn.com/bao/uploaded/i1/812019296/O1CN01DDAG8Z2IXcSjQtY7z_!!812019296.jpg_350x350",
    49. 			"price": "29.90",
    50. 			"sales": "5081",
    51. 			"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"
    52. 		},
    53. 		{
    54. 			"title": "Huawei/华为蓝牙无线键盘鼠标套装静音新款MateBook/magicbook充电超薄迷你外接笔记本苹果手机平板ipad通用亿丰宇数码专营店",
    55. 			"pic_url": "https://img.alicdn.com/bao/uploaded/i1/2206614523620/O1CN016IzZWt1cc0OkUsk0a_!!2206614523620.jpg_350x350",
    56. 			"price": "39.90",
    57. 			"sales": "4981",
    58. 			"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"
    59. 		},
    60. 		{
    61. 			"title": "无线蓝牙键盘可充电静音超薄迷你适用苹果ipad键盘电脑手机平板雷宝龙旗舰店",
    62. 			"pic_url": "https://img.alicdn.com/bao/uploaded/i3/2200834899866/O1CN01etajdQ2MkgF49887O_!!2200834899866.jpg_350x350",
    63. 			"price": "29.90",
    64. 			"sales": "4827",
    65. 			"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"
    66. 		},
    67. 		{
    68. 			"title": "英菲克V750B蓝牙键盘无线新款适用于苹果ipad华为平板电脑手机通英菲克旗舰店",
    69. 			"pic_url": "https://img.alicdn.com/bao/uploaded/TB1ZT9jLW61gK0jSZFlSutDKFXa.jpg_350x350",
    70. 			"price": "29.90",
    71. 			"sales": "3756",
    72. 			"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"
    73. 		},
    74. 		{
    75. 			"title": "",
    76. 			"pic_url": "",
    77. 			"price": "",
    78. 			"sales": "",
    79. 			"detail_url": ""
    80. 		}
    81. 	],
    82. 	"error": "",
    83. 	"reason": "",
    84. 	"error_code": "0000",
    85. 	"cache": 0,
    86. 	"api_info": "today:30 max:10000",
    87. 	"execution_time": 1.697,
    88. 	"server_time": "Beijing/2021-04-22 15:15:48",
    89. 	"client_ip": "106.6.32.155",
    90. 	"call_args": [],
    91. 	"api_type": "taobao",
    92. 	"translate_language": "zh-CN",
    93. 	"translate_engine": "google_cn",
    94. 	"server_memory": "5.5MB",
    95. 	"request_id": "gw-3.608122a3161fb"
    96. }

    异常示例

    {
  "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)状态信息详细描述是否收费
    0000success接口调用成功并返回相关数据是
    2000Search success but no result接口访问成功，但是搜索没有结果是
    4000Server internal error服务器内部错误否
    4001Network error网络错误否
    4002Target server error目标服务器错误否
    4003Param error用户输入参数错误忽略
    4004Account not found用户帐号不存在忽略
    4005Invalid authentication credentials授权失败忽略
    4006API stopped您的当前API已停用忽略
    4007Account stopped您的账户已停用忽略
    4008API rate limit exceeded并发已达上限忽略
    4009API maintenanceAPI维护中忽略
    4010API not found with these valuesAPI不存在忽略
    4012Please add api first请先添加api忽略
    4013Number of calls exceeded调用次数超限忽略
    4014Missing url param参数缺失忽略
    4015Wrong pageToken参数pageToken有误忽略
    4016Insufficient balance余额不足忽略
    4017timeout error请求超时否
    5000unknown error未知错误否
  • 相关阅读:
    Spring Cloud OpenFeign模版化客户端
    数据结构与算法之LeetCode-64-最小路径和（动态规划求解）
    解析访问的 IP 地址-获取城市信息
    文章《Semantic Kernel -- LangChain 的替代品？》的错误和疑问 探讨
    Golang for循环遍历小坑
    leetcode 70.爬楼梯、322.零钱兑换、279.完全平方数
    2022年NPDP考完多久出成绩？怎么查询？
    【c】指针
    【代码精读】optee的进入和退出的方式
    锁竞争导致的慢sql分析
  • 原文地址：https://blog.csdn.net/Noah_ZX/article/details/125885382