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

news/2024/11/29 16:32:29/

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宝贝详情数据

请求示例

  • 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)状态信息详细描述是否收费
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未知错误否

http://www.ppmy.cn/news/296261.html

相关文章

荣耀V40正式发布：三大黑科技引擎 全方位护航游戏体验

荣耀V40正式发布：三大黑科技引擎 全方位护航游戏体验

2021年荣耀新品发布会&#xff0c;荣耀V40正式发布。正如此次产品全新Slogan“前所未感”&#xff0c;荣耀V40不仅在ID设计上将理性的矩形空间和感性的色彩变幻相融合&#xff0c;采用1:3:9:27等比矩形序列重新划分平面&#xff0c;展示出一种重新定义秩序的逻辑美学&#xff0…
阅读更多...
电商平台如何高效快速获取信息？

电商平台如何高效快速获取信息？

随着互联网的发展&#xff0c;电商跨境电商给我们的购物带来了巨大的便利和变化。 比如电商平台中&#xff0c;经常要做的就是如何获取某个平台畅销产品。这里举例&#xff0c;淘宝畅销榜的信息获取。 请求地址 公共参数 请求参数 请求参数&#xff1a;q 参数说明&#xf…
阅读更多...
设计模式之十生成器模式

设计模式之十生成器模式

概念 生成器模式的核心是当构建生成一个对象的时候&#xff0c;这个对象一般比较复杂。需要包含多个步骤&#xff0c;虽然每个步骤具体的实现不同&#xff0c;但是都遵循一定的流程与规则 。建造模式是将复杂的内部创建封装在内部&#xff0c;对于外部调用的人来说&#xff0c…
阅读更多...
“卖键盘的被键盘侠喷了” | 社交网络的戾气怎么这么重

“卖键盘的被键盘侠喷了” | 社交网络的戾气怎么这么重

六一儿童节的时候&#xff0c;cherry中国在微博发起了一个抽奖活动。 很正常的抽奖&#xff0c;对不对&#xff1f;但是因为一条评论&#xff0c;整个画风就全都乱起来了。 火野胖次 的评论略显侵略性&#xff0c;官微回复表示“我问您哪句话总结出这个意思&#xff1f;”下面就…
阅读更多...
foobar2000隐藏桌面悬浮窗头像_如何解锁华为手机隐藏的超能力？

foobar2000隐藏桌面悬浮窗头像_如何解锁华为手机隐藏的超能力？

华为手机有哪些过人之处&#xff1f; 先别着急回答 本期小编将介绍五个很多人都不知道的 华为手机隐藏超能力 想成为玩机高手&#xff1f; 其实很简单 01 备忘录&#xff0c;还可以这么玩 备忘录是大家平时工作生活中都常会用到的应用&#xff0c;看起来很普通&#xff0c;其实…
阅读更多...
华为手机键盘android不能长按,输入法cherry经典机械键盘怎么不能长按出来数字...

华为手机键盘android不能长按,输入法cherry经典机械键盘怎么不能长按出来数字...

[问题反馈] 输入法cherry经典机械键盘怎么不能长按出来数字 116910 电梯直达 huafans01245393877 略有小成 发表于 2020-3-10 22:30:22 来自&#xff1a;HUAWEI Mate 30 Pro 5G 最新回复 2020-3-11 15:54:54 输入法cherry经典机械键盘怎么不能长按出来数字&#xff0c;我网上搜…
阅读更多...
工厂智慧能源-AcrelCloud-5000智慧能源综合解决方案

工厂智慧能源-AcrelCloud-5000智慧能源综合解决方案

功能&#xff1a; AcrelCloud-5000能耗管理云平台采用泛在物联、云计算、大数据、移动通讯、智能传感等技术手段可为用户提供能源数据、统计分析、能效分析、用能预警、设备管理等服务&#xff0c;平台可以广泛应用于多种领域。 ​ 应用场所&#xff1a; 云平台结构&#xf…
阅读更多...
《LCHub低代码指南》：ChatGPT会取代低代码开发平台吗？

《LCHub低代码指南》：ChatGPT会取代低代码开发平台吗？

目录 一、低代码开发平台的优势 1. 提高开发效率 2. 降低开发成本 3. 提高应用程序的质量 二、ChatGPT的优势 三、ChatGPT是否会取代低代码开发平台 四、结论 随着数字化时代的到来，低代码开发平台已经成为了企业数字化转型的重要工具之一。然而，随着人工智能技术的不…
阅读更多...
最新文章

Copyright @ 2022~2023