• 淘宝/天猫按分类搜索淘宝直播接口 API 使用说明

    item_videolist-按分类搜索淘宝直播接口 [查看演示] API测试工具 注册开通

    onebound.taobao.item_videolist

    公共参数

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

    名称类型必须描述
    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版本

    请求参数

    请求参数：channelId=0&page=1

    参数说明：channelId：视频分类ID
    page页数

    响应参数

    Version: Date:

    名称类型必须示例值描述

    title

    		String0年货盛宴 心意之选商品标题

    num_iid

    		Bigint0294846800380宝贝ID

    view_count

    		Int0890观看人数

    pic_url

    		String0https://gw.alicdn.com/tfscom/i1/O1CN019WuTCM1WkoKlZhTPU_!!0-dgshop.jpg宝贝图片

    detail_url

    		String0//h5.m.taobao.com/taolive/video.html?id=294846800380宝贝链接

    seller_info

    		Mix0{"user_num_id": 2064892827, "head_img": "//img.alicdn.com/imgextra/i4/2064892827/O1CN01FQoRJd1WkoJuNhJOw_!!2064892827-0-beehive-scenes.jpg", "seller_nick": "雅诗兰黛旗舰店"}卖家信息

    请求示例

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

    响应示例

    1. {
    2. 		"items": {
    3. 		"channel_id": 0,
    4. 		"page": "5",
    5. 		"page_size": 10,
    6. 		"real_total_results": 1000,
    7. 		"total_results": 1000,
    8. 		"page_count": 100,
    9. 		"data_from": "app",
    10. 		"item": [
    11. 			{
    12. 				"title": "有温度的小石头",
    13. 				"num_iid": "295999018811",
    14. 				"view_count": "215",
    15. 				"pic_url": "https://img.alicdn.com/imgextra/i1/6000000006651/O1CN01G4pLtF1z0CtBZSU7F_!!6000000006651-0-tblive.jpg",
    16. 				"detail_url": "//h5.m.taobao.com/taolive/video.html?id=295999018811",
    17. 				"seller_info": {
    18. 					"user_num_id": "59632",
    19. 					"head_img": "//img.alicdn.com/imgextra/i3/6000000006633/O1CN01Qb05DO1yrxklqRO7j_!!6000000006633-0-tblive.jpg",
    20. 					"seller_nick": "善石柏缘"
    21. 				}
    22. 			},
    23. 			{
    24. 				"title": "小玩通的直播间",
    25. 				"num_iid": "295408948484",
    26. 				"view_count": "10",
    27. 				"pic_url": "https://img.alicdn.com/imgextra/i2/O1CN01v5Ks0Z1wsIoMjVn0m_!!0-tbCommonAudio.jpg",
    28. 				"detail_url": "//h5.m.taobao.com/taolive/video.html?id=295408948484",
    29. 				"seller_info": {
    30. 					"user_num_id": "254632",
    31. 					"head_img": "//gdp.alicdn.com/shop-logo//11/68/TB1cQ9JLrrpK1RjSZTESuwWAVXa.jpg",
    32. 					"seller_nick": "小哈香水严选"
    33. 				}
    34. 			},
    35. 			{
    36. 				"title": "新年囤好货新店大酬宾",
    37. 				"num_iid": "295773049663",
    38. 				"view_count": "12",
    39. 				"pic_url": "https://gw.alicdn.com/tfscom/i1/O1CN010Y9BYE1al305W4aex_!!0-dgshop.jpg",
    40. 				"detail_url": "//h5.m.taobao.com/taolive/video.html?id=295773049663",
    41. 				"seller_info": {
    42. 					"user_num_id": "403369",
    43. 					"head_img": "//gdp.alicdn.com/shop-logo//45/42/TB15C2n3uL2gK0jSZFmwu37iXXa.png",
    44. 					"seller_nick": "家乡好优选"
    45. 				}
    46. 			},
    47. 			{
    48. 				"title": "年货福利来啦",
    49. 				"num_iid": "296049354114",
    50. 				"view_count": "500",
    51. 				"pic_url": "https://img.alicdn.com/imgextra/i1/O1CN01xTxskf1CfVQlLcAhd_!!0-tbCommonAudio.jpg",
    52. 				"detail_url": "//h5.m.taobao.com/taolive/video.html?id=296049354114",
    53. 				"seller_info": {
    54. 					"user_num_id": "1148032",
    55. 					"head_img": "//img.alicdn.com/imgextra/i4/1148032/TB2_2Tzzv5TBuNjSspmXXaDRVXa_!!1148032-0-beehive-scenes.jpg",
    56. 					"seller_nick": "港仔先生"
    57. 				}
    58. 			},
    59. 			{
    60. 				"title": "大码女靴断码特价处理",
    61. 				"num_iid": "296024138273",
    62. 				"view_count": "291",
    63. 				"pic_url": "https://gw.alicdn.com/tfscom/i1/O1CN01TS0ijV1jceHIogR40_!!0-dgshop.jpg",
    64. 				"detail_url": "//h5.m.taobao.com/taolive/video.html?id=296024138273",
    65. 				"seller_info": {
    66. 					"user_num_id": "1264569",
    67. 					"head_img": "//gdp.alicdn.com/shop-logo//dc/5b/TB1Y1L7SpXXXXXHXXXXSutbFXXX.jpg",
    68. 					"seller_nick": "王小妖大码女鞋"
    69. 				}
    70. 			},
    71. 			{
    72. 				"title": "各店的300-130",
    73. 				"num_iid": "296254443199",
    74. 				"view_count": "4228",
    75. 				"pic_url": "https://gw.alicdn.com/tfscom/i1/O1CN01UZHHAP1CqUw7GNmz0_!!0-dgshop.jpg",
    76. 				"detail_url": "//h5.m.taobao.com/taolive/video.html?id=296254443199",
    77. 				"seller_info": {
    78. 					"user_num_id": "10820132",
    79. 					"head_img": "//img.alicdn.com/imgextra/i2/6000000006283/O1CN01QYWUUQ1wHf5qtd07i_!!6000000006283-0-tblive.jpg",
    80. 					"seller_nick": "果爸书书"
    81. 				}
    82. 			},
    83. 			{
    84. 				"title": "库茵新品上新",
    85. 				"num_iid": "295757777888",
    86. 				"view_count": "9307",
    87. 				"pic_url": "https://img.alicdn.com/imgextra/i3/6000000005960/O1CN01PYzift1ttjAbTeOvx_!!6000000005960-0-tblive.jpg",
    88. 				"detail_url": "//h5.m.taobao.com/taolive/video.html?id=295757777888",
    89. 				"seller_info": {
    90. 					"user_num_id": "27763132",
    91. 					"head_img": "//gw2.alicdn.com/tfscom/tuitui/TB1n0d2LXXXXXXFapXXXXXXXXXX",
    92. 					"seller_nick": "叭哒女王"
    93. 				}
    94. 			},
    95. 			{
    96. 				"title": "zhyt828的直播间",
    97. 				"num_iid": "295755881697",
    98. 				"view_count": "430",
    99. 				"pic_url": "https://img.alicdn.com/imgextra/i3/6000000003073/O1CN017gZnm51YZTkyshbyk_!!6000000003073-0-tblive.jpg",
    100. 				"detail_url": "//h5.m.taobao.com/taolive/video.html?id=295755881697",
    101. 				"seller_info": {
    102. 					"user_num_id": "30586132",
    103. 					"head_img": "//gdp.alicdn.com/shop-logo//b1/2a/TB10A9RiAyWBuNjy0FpSuussXXa.jpg",
    104. 					"seller_nick": "金华佛手"
    105. 				}
    106. 			},
    107. 			{
    108. 				"title": "年终大促～T特价场",
    109. 				"num_iid": "295440344582",
    110. 				"view_count": "560",
    111. 				"pic_url": "https://img.alicdn.com/imgextra/i1/O1CN01qnzeQP1FY7tbw0Nnm_!!0-tbCommonAudio.jpg",
    112. 				"detail_url": "//h5.m.taobao.com/taolive/video.html?id=295440344582",
    113. 				"seller_info": {
    114. 					"user_num_id": "36239832",
    115. 					"head_img": "//img.alicdn.com/imgextra/i3/36239832/O1CN01syc4oh2MV6iY6dGSv_!!36239832-0-beehive-scenes.jpg",
    116. 					"seller_nick": "COSHMIR"
    117. 				}
    118. 			},
    119. 			{
    120. 				"title": "新年背新包特惠抢不停",
    121. 				"num_iid": "296239047108",
    122. 				"view_count": "48",
    123. 				"pic_url": "https://gw.alicdn.com/tfscom/i4/O1CN01pjx0gq1YXeBPZifrk_!!0-dgshop.jpg",
    124. 				"detail_url": "//h5.m.taobao.com/taolive/video.html?id=296239047108",
    125. 				"seller_info": {
    126. 					"user_num_id": "36453069",
    127. 					"head_img": "//gdp.alicdn.com/shop-logo/https://img.alicdn.com/imgextra/i4/6000000005925/O1CN01D9n0TY1tdhKqfGOYi_!!6000000005925-0-shopmanager.jpg",
    128. 					"seller_nick": "宁远包包"
    129. 				}
    130. 			}
    131. 		]
    132. 	},
    133. 	"error": "",
    134. 	"reason": "",
    135. 	"error_code": "0000",
    136. 	"cache": 0,
    137. 	"api_info": "today:27 max:10000",
    138. 	"execution_time": 0.637,
    139. 	"server_time": "Beijing/2021-01-20 16:32:35",
    140. 	"client_ip": "115.151.186.91",
    141. 	"call_args": [],
    142. 	"api_type": "taobao",
    143. 	"translate_language": "zh-CN",
    144. 	"translate_engine": "google_cn",
    145. 	"server_memory": "5.34MB",
    146. 	"request_id": "4.6007eaa2e0364"
    147. 	}

     异常示例

    1. {
    2.   "error": "item-not-found",
    3.   "reason": "商品没找到",
    4.   "error_code": "2000",
    5.   "success": 0,
    6.   "cache": 0,
    7.   "api_info": "today:0 max:10000",
    8.   "execution_time": 0.081,
    9.   "server_time": "Beijing/2020-06-10 23:44:00",
    10.   "call_args": [],
    11.   "api_type": "taobao",
    12.   "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未知错误否

  • 相关阅读:
    工程伦理--13.3 “邻避效应”中的社会公平问题
    WEB 渗透之SSRF
    Unity 向量
    【C++程序员必修第一课】C++基础课程-05：运算符（上）
    css样式在弹性盒元素在必要的时候拆行
    数组原地哈西一类题一网打尽
    [C题目]力扣142. 环形链表 II
    改造xxl-job适配nacos注册中心
    jquery导航图片全屏滚动、首页全屏轮播图，各式相册
    第七章《Java的异常处理》第3节：异常的嵌套处理
  • 原文地址：https://blog.csdn.net/Noah_ZX/article/details/125885095