• 阿里巴巴按关键字搜索新品数据 API

    一、参数

    公共参数

    请求地址: https://api-gw.onebound.cn/1688/item_search_new

    名称类型必须描述
    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=衣服&page=1&sort=

    参数说明：q：搜索关键字
    page:翻页
    sort:排序(normal综合,va_rmdarkgmv30rt成交额,bid价格升序，_bid价格降序)

    响应参数

    Version: Date:

    名称类型必须示例值描述

    items

    		items[]0按关键字搜索商品

    page

    		Int01页码

    real_total_results

    		Int01000宝贝数量

    total_results

    		Int01000宝贝数量

    page_size

    		Int020接口返回数量

    pagecount

    		Int0100总页数

    item

    		item[]0宝贝详情数据


    二、示例

    请求示例

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

      前往获取key和secret

    响应示例

    1. {
    2. 	"item": [
    3. 		{
    4. 			"title": "男装2022夏季短袖情侣t恤男女同款时尚简约休闲圆领T恤上衣服批发",
    5. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01vH2Jpd1MNmKzbiavS_!!2213203691423-0-cib.jpg",
    6. 			"promotion_price": null,
    7. 			"price": null,
    8. 			"sales": "2000+",
    9. 			"num_iid": "669093370636",
    10. 			"seller_nick": "石狮市领川服装厂",
    11. 			"tag_percent": "12.3%",
    12. 			"area": "泉州市",
    13. 			"sid": "b2b-221326973628972c61",
    14. 			"detail_url": "https://detail.1688.com/offer/669093370636.html"
    15. 		},
    16. 		{
    17. 			"title": "2022夏季新款印花短袖t恤女网红同款衣服女韩版百搭中长款上衣女",
    18. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01Ek7mv41S5oV5YcCvp_!!2744312196-0-cib.jpg",
    19. 			"promotion_price": null,
    20. 			"price": null,
    21. 			"sales": "1000+",
    22. 			"num_iid": "668773906932",
    23. 			"seller_nick": "普宁市洪阳戴紫妮服装厂",
    24. 			"tag_percent": "17.3%",
    25. 			"area": "普宁市",
    26. 			"sid": "b2b-285040931583cf0",
    27. 			"detail_url": "https://detail.1688.com/offer/668773906932.html"
    28. 		},
    29. 		{
    30. 			"title": "抖音质量磨毛双面德绒短袖t恤女立体卡通夏2022新款上衣大码女装",
    31. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ihTAw31Vqw6C0UByX_!!2213014272705-0-cib.jpg",
    32. 			"promotion_price": null,
    33. 			"price": null,
    34. 			"sales": "200+",
    35. 			"num_iid": "670585170610",
    36. 			"seller_nick": "广州克里贸易有限公司",
    37. 			"tag_percent": "9%",
    38. 			"area": "普宁市",
    39. 			"sid": "b2b-2213014272705d647f",
    40. 			"detail_url": "https://detail.1688.com/offer/670585170610.html"
    41. 		},
    42. 		{
    43. 			"title": "韩路女装 2022春夏新款卡通印花短袖T恤女ins风纯棉宽松潮流体恤",
    44. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01vPvBu722OtAF9rxw2_!!3910967111-0-cib.jpg",
    45. 			"promotion_price": null,
    46. 			"price": null,
    47. 			"sales": "6万+",
    48. 			"num_iid": "668912014686",
    49. 			"seller_nick": "瑞安市萌越贸易有限公司",
    50. 			"tag_percent": "17%",
    51. 			"area": "瑞安市",
    52. 			"sid": "b2b-391096711196312",
    53. 			"detail_url": "https://detail.1688.com/offer/668912014686.html"
    54. 		},
    55. 		{
    56. 			"title": "撞色条纹短袖针织衫女2022夏季新款休闲百搭别致上衣ins显瘦薄款",
    57. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ztb9V421Yg1BzxUC7_!!2213249306997-0-cib.jpg",
    58. 			"promotion_price": null,
    59. 			"price": null,
    60. 			"sales": "1000+",
    61. 			"num_iid": "671716125800",
    62. 			"seller_nick": "广州小仙妮子服装厂",
    63. 			"tag_percent": "4.7%",
    64. 			"area": "广州市",
    65. 			"sid": "b2b-2213249306997da12a",
    66. 			"detail_url": "https://detail.1688.com/offer/671716125800.html"
    67. 		},
    68. 		{
    69. 			"title": "夏新款潮流男女重磅250克落肩半袖t恤供应学生班服宽松嘻哈街舞服",
    70. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01lJUgSo1uVkAiNDhwz_!!2209929186043-0-cib.jpg",
    71. 			"promotion_price": null,
    72. 			"price": null,
    73. 			"sales": "2万+",
    74. 			"num_iid": "670169572856",
    75. 			"seller_nick": "广州旺者归莱服装有限公司",
    76. 			"tag_percent": "10.8%",
    77. 			"area": "广州市",
    78. 			"sid": "b2b-22099291860439e3d0",
    79. 			"detail_url": "https://detail.1688.com/offer/670169572856.html"
    80. 		},
    81. 		{
    82. 			"title": "东南亚跨境全涤男士短袖T恤亚马逊夏季新款短袖上衣时尚潮印花T恤",
    83. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01BeqZdv25bf3xdIOEu_!!2213760247545-0-cib.jpg",
    84. 			"promotion_price": null,
    85. 			"price": null,
    86. 			"sales": "1万+",
    87. 			"num_iid": "671850915594",
    88. 			"seller_nick": "揭阳市衫少服饰有限公司",
    89. 			"tag_percent": "6.9%",
    90. 			"area": "揭阳市",
    91. 			"sid": "b2b-22137602475451e023",
    92. 			"detail_url": "https://detail.1688.com/offer/671850915594.html"
    93. 		},
    94. 		{
    95. 			"title": "韩路女装 主推款纯棉短袖T恤女2022春夏新品宽松潮流趣味印花体恤",
    96. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01v1B5s322OtADFyEOW_!!3910967111-0-cib.jpg",
    97. 			"promotion_price": null,
    98. 			"price": null,
    99. 			"sales": "24万+",
    100. 			"num_iid": "668176444969",
    101. 			"seller_nick": "瑞安市萌越贸易有限公司",
    102. 			"tag_percent": "17%",
    103. 			"area": "瑞安市",
    104. 			"sid": "b2b-391096711196312",
    105. 			"detail_url": "https://detail.1688.com/offer/668176444969.html"
    106. 		},
    107. 		{
    108. 			"title": "男装2022夏季短袖情侣t恤男女同款时尚简约休闲圆领T恤上衣服批发",
    109. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01vH2Jpd1MNmKzbiavS_!!2213203691423-0-cib.jpg",
    110. 			"promotion_price": null,
    111. 			"price": null,
    112. 			"sales": "3万+",
    113. 			"num_iid": "668987018070",
    114. 			"seller_nick": "石狮市艾迪斯顿服装厂",
    115. 			"tag_percent": "15.9%",
    116. 			"area": "泉州市",
    117. 			"sid": "b2b-22132036914233b9ff",
    118. 			"detail_url": "https://detail.1688.com/offer/668987018070.html"
    119. 		},
    120. 		{
    121. 			"title": "当季新品 趋势热卖",
    122. 			"pic_url": null,
    123. 			"promotion_price": null,
    124. 			"price": null,
    125. 			"sales": null,
    126. 			"num_iid": null,
    127. 			"seller_nick": null,
    128. 			"tag_percent": null,
    129. 			"area": null,
    130. 			"sid": null,
    131. 			"detail_url": "https://detail.1688.com/offer/.html"
    132. 		},
    133. 		{
    134. 			"title": "纯棉t恤男2022夏季新款短袖T恤男圆领半袖宽松潮流衣服打底衫男",
    135. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN018WnzOm1DmCvnSox0K_!!2212492580258-0-cib.jpg",
    136. 			"promotion_price": null,
    137. 			"price": null,
    138. 			"sales": "1000+",
    139. 			"num_iid": "671351089756",
    140. 			"seller_nick": "汕头市潮阳区铜盂诗美嘉服装厂",
    141. 			"tag_percent": "8.3%",
    142. 			"area": "汕头市",
    143. 			"sid": "b2b-2212492580258e6ac6",
    144. 			"detail_url": "https://detail.1688.com/offer/671351089756.html"
    145. 		},
    146. 		{
    147. 			"title": "中袖t恤女2022年新款女装气质polo领莫代尔半袖体恤撞色收腰上衣",
    148. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN019VuwdN1vYK19Qcjgl_!!2242696184-0-cib.jpg",
    149. 			"promotion_price": null,
    150. 			"price": null,
    151. 			"sales": "3000+",
    152. 			"num_iid": "670971673377",
    153. 			"seller_nick": "广州声歌服饰有限公司",
    154. 			"tag_percent": "45.4%",
    155. 			"area": "广州市",
    156. 			"sid": "b2b-2242696184",
    157. 			"detail_url": "https://detail.1688.com/offer/670971673377.html"
    158. 		},
    159. 		{
    160. 			"title": "潮迈克男士短袖T恤衣服潮牌潮流半袖男装2022新款夏季修身体恤衫",
    161. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01k1ZXYL2N3uxtkFbjD_!!2212460019908-0-cib.jpg",
    162. 			"promotion_price": null,
    163. 			"price": null,
    164. 			"sales": "200+",
    165. 			"num_iid": "671819478208",
    166. 			"seller_nick": "石狮市祥志日用品商行",
    167. 			"tag_percent": "9.7%",
    168. 			"area": "",
    169. 			"sid": "b2b-22124600199086d3a0",
    170. 			"detail_url": "https://detail.1688.com/offer/671819478208.html"
    171. 		},
    172. 		{
    173. 			"title": "100%棉t恤短袖男修身潮流纯色280g丝光棉男士半袖圆领上衣中青年",
    174. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN018rR3nq1Yidm4jNvRE_!!2212372513093-0-cib.jpg",
    175. 			"promotion_price": null,
    176. 			"price": null,
    177. 			"sales": "7000+",
    178. 			"num_iid": "669931288096",
    179. 			"seller_nick": "桐乡市梧桐辉诺服饰商行",
    180. 			"tag_percent": "16.3%",
    181. 			"area": "桐乡市",
    182. 			"sid": "b2b-22123725130939dd36",
    183. 			"detail_url": "https://detail.1688.com/offer/669931288096.html"
    184. 		},
    185. 		{
    186. 			"title": "2022新款弹力直筒打底上衣五分袖小衫网纱立领印花T恤女装夏季潮",
    187. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01nx3VpR23uJy6lgtVW_!!2260697315-0-cib.jpg",
    188. 			"promotion_price": null,
    189. 			"price": null,
    190. 			"sales": "400+",
    191. 			"num_iid": "671337941177",
    192. 			"seller_nick": "潮州市潮安区金石镇骏龙制衣厂",
    193. 			"tag_percent": "39.7%",
    194. 			"area": "潮州市",
    195. 			"sid": "b2b-2260697315",
    196. 			"detail_url": "https://detail.1688.com/offer/671337941177.html"
    197. 		},
    198. 		{
    199. 			"title": "厂家直销翻领冰丝短袖t恤男式商务休闲条纹宽松薄款Polo衫男装潮",
    200. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01lur0VS1uqoOGKJYOf_!!2213204496089-0-cib.jpg",
    201. 			"promotion_price": null,
    202. 			"price": null,
    203. 			"sales": "700+",
    204. 			"num_iid": "669987872360",
    205. 			"seller_nick": "桐乡市濮院柏梁服装厂",
    206. 			"tag_percent": "19%",
    207. 			"area": "桐乡市",
    208. 			"sid": "b2b-221320449608977b92",
    209. 			"detail_url": "https://detail.1688.com/offer/669987872360.html"
    210. 		},
    211. 		{
    212. 			"title": "现货供应休闲日系短袖T恤男绣潮流日式绣花贴布圆领T恤男外贸衫",
    213. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01o0ZM4b29ayw5yQoaR_!!2209917828085-0-cib.jpg",
    214. 			"promotion_price": null,
    215. 			"price": null,
    216. 			"sales": "300+",
    217. 			"num_iid": "670628937468",
    218. 			"seller_nick": "广州市云格服饰有限公司",
    219. 			"tag_percent": "35.1%",
    220. 			"area": "广州市",
    221. 			"sid": "b2b-2209917828085ceab7",
    222. 			"detail_url": "https://detail.1688.com/offer/670628937468.html"
    223. 		},
    224. 		{
    225. 			"title": "TKPA高街头复古美式oldschool做旧水洗徽章i短袖T恤男女ins国潮牌",
    226. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01FMyJtv1fE8i6JzwT7_!!3344093974-0-cib.jpg",
    227. 			"promotion_price": null,
    228. 			"price": null,
    229. 			"sales": "600+",
    230. 			"num_iid": "670665770082",
    231. 			"seller_nick": "广州悦享商贸有限公司",
    232. 			"tag_percent": "32.7%",
    233. 			"area": "广州市",
    234. 			"sid": "b2b-334409397456d89",
    235. 			"detail_url": "https://detail.1688.com/offer/670665770082.html"
    236. 		},
    237. 		{
    238. 			"title": "中年男士T恤宽松爸爸夏装短袖宽条纹夏季上衣服有口袋中",
    239. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01s8ypcK1jD07xKzQhW_!!2211188044513-0-cib.jpg",
    240. 			"promotion_price": null,
    241. 			"price": null,
    242. 			"sales": "500+",
    243. 			"num_iid": "671263051411",
    244. 			"seller_nick": "桐乡市濮院弘伙服装厂",
    245. 			"tag_percent": "18%",
    246. 			"area": "嘉兴市",
    247. 			"sid": "b2b-2211129648221b6b4d",
    248. 			"detail_url": "https://detail.1688.com/offer/671263051411.html"
    249. 		},
    250. 		{
    251. 			"title": "2022夏季新款宽松T恤短款温柔风上衣条纹冰丝针织衫女短袖",
    252. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01XFne181n3A8yzQGA0_!!2213769605033-0-cib.jpg",
    253. 			"promotion_price": null,
    254. 			"price": null,
    255. 			"sales": "700+",
    256. 			"num_iid": "671604715165",
    257. 			"seller_nick": "广州觅婷阁服装商行",
    258. 			"tag_percent": null,
    259. 			"area": "广州市",
    260. 			"sid": "b2b-2213769605033305d4",
    261. 			"detail_url": "https://detail.1688.com/offer/671604715165.html"
    262. 		},
    263. 		{
    264. 			"title": "2022夏季新款五分袖t恤小清新连帽抽绳百搭休闲青少年套头衫上衣",
    265. 			"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01ODtwTy1oe5h8ZddYU_!!2212454665249-0-cib.jpg",
    266. 			"promotion_price": null,
    267. 			"price": null,
    268. 			"sales": "1000+",
    269. 			"num_iid": "670454273152",
    270. 			"seller_nick": "石狮市崛夜雪锋服装厂",
    271. 			"tag_percent": "16.3%",
    272. 			"area": "石狮市",
    273. 			"sid": "b2b-2212454665249d3f37",
    274. 			"detail_url": "https://detail.1688.com/offer/670454273152.html"
    275. 		}
    276. 	],
    277. 	"data_from": "1688app",
    278. 	"error": "",
    279. 	"reason": "",
    280. 	"error_code": "0000",
    281. 	"cache": 0,
    282. 	"api_info": "today:19 max:11000",
    283. 	"execution_time": "2.566",
    284. 	"server_time": "Beijing/2022-04-15 15:33:41",
    285. 	"client_ip": "106.6.33.38",
    286. 	"call_args": [],
    287. 	"api_type": "1688",
    288. 	"translate_language": "zh-CN",
    289. 	"translate_engine": "google_new",
    290. 	"server_memory": "4.29MB",
    291. 	"request_id": "gw-1.62591fd317826",
    292. 	"last_id": "886371758"}

    异常示例

    1. {
    2.   "error": "data error",
    3.   "reason": "data error",
    4.   "error_code": "5000",
    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": "1688",
    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未知错误否
  • 相关阅读:
    高通平台Android 蓝牙调试和配置手册-- debug QXDM/OTA/Ring buffer/pt4 pt5/PTS logs
    Java语言有多少优势（总结版）
    脚手架开发流程详解
    WebRTC系列-SDP之编码信息收集
    MySQL数据库管理
    java比较两个ArrayList，得出两者中的不同元素
    使用注解方式实现 Redis 分布式锁
    建立自己公众号题库系统
    软件面试逻辑题
    大学四年如何有效的使用『牛客』平台
  • 原文地址：https://blog.csdn.net/Noah_ZX/article/details/126056600