• 速卖通按关键字搜索商品

    item_search-按关键字搜索aliexpress商品  注册开通

    onebound.aliexpress.item_search

    公共参数

    名称类型必须描述
    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=shoe&start_price=&end_price=&page=&cat=&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=

    参数说明：q:搜索关键字
    cat:分类ID
    start_price:开始价格
    end_price:结束价格
    sort:排序[bid,_bid,_sale,_new]
    (bid:总价,sale:销量,new上架时间,加_前缀为从大到小排序)
    page:

    响应参数

    Version: Date:

    名称类型必须示例值描述
    num_iidBigint032944112999宝贝ID
    titleString0Male Breathable Comfortable Casual Shoes Fashion Men Canvas Shoes Lace up Wear-resistant Men Sneakers zapatillas deportiva商品标题
    pic_urlString0//ae01.alicdn.com/kf/HTB1_AwYXdfvK1RjSspfq6zzXFXap/Male-Breathable-Comfortable-Casual-Shoes-Fashion-Men-Canvas-Shoes-Lace-up-Wear-resistant-Men-Sneakers-zapatillas.jpg_220x220xz.jpg宝贝图片
    promotion_priceString08.75-8.97优惠价
    priceString08.75-8.97价格
    salesInt0销量
    feedbackInt080评论数
    ordersInt0815订单数
    sample_idString0商品风格标识ID
    post_feeFloat09.91物流费用
    starString04.8商品评分
    areaString0店铺所在地
    detailString0//www.aliexpress.com/item/Male-Breathable-Comfortable-Casual-Shoes-Fashion-Men-Canvas-Shoes-Lace-up-Wear-resistant-Men-Sneakers-zapatillas/32944112999.html商品链接

    请求示例

    1. 	
    2. -- 请求示例 url 默认请求参数已经URL编码处理
    3. curl -i "https://api-gw.onebound.cn/aliexpress/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=shoe&start_price=&end_price=&page=&cat=&discount_only=&sort=&page_size=&seller_info=&nick=&ppath="

    响应示例

    1. {
    2. 	"items": {
    3. 		"page": 1,
    4. 		"error": "",
    5. 		"real_total_results": "453438",
    6. 		"total_results": 4400,
    7. 		"item": [
    8. 			{
    9. 				"title": "Zapatillas de deporte vulcanizadas transpirables informales para Mujer, a la moda mocasines de suela gruesa, tenis, 2022",
    10. 				"pic_url": "//ae04.alicdn.com/kf/S9d8cb2a5e9c04db0854ead8b2c523619G.jpg",
    11. 				"promotion_price": 5.87,
    12. 				"price": 5.87,
    13. 				"orginal_price": "",
    14. 				"sales": 0,
    15. 				"num_iid": "3256804443696695",
    16. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-0",
    17. 				"seller_nick": "",
    18. 				"detail_url": "https://www.aliexpress.com/item/3256804443696695.html"
    19. 			},
    20. 			{
    21. 				"title": "Zapatillas de deporte de moda para mujer, zapatos planos de plataforma de Color sólido, informales, transpirables, con tacón de cuña, para caminar",
    22. 				"pic_url": "https://ae04.alicdn.com/kf/S973f37df9f98417dad3498eb589df409b.jpg",
    23. 				"promotion_price": 19.95,
    24. 				"price": 19.95,
    25. 				"orginal_price": "",
    26. 				"sales": 0,
    27. 				"num_iid": "3256804418555420",
    28. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-1",
    29. 				"seller_nick": "",
    30. 				"detail_url": "https://www.aliexpress.com/item/3256804418555420.html"
    31. 			},
    32. 			{
    33. 				"title": "Zapatillas deportivas vulcanizadas para mujer, zapatos planos informales con cordones, de malla, ligeras y transpirables",
    34. 				"pic_url": "//ae04.alicdn.com/kf/Hbc91dcf8e36845219a82654b434b8c3fo.jpg",
    35. 				"promotion_price": 24.68,
    36. 				"price": 24.68,
    37. 				"orginal_price": "",
    38. 				"sales": 0,
    39. 				"num_iid": "3256802945582352",
    40. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-2",
    41. 				"seller_nick": "",
    42. 				"detail_url": "https://www.aliexpress.com/item/3256802945582352.html"
    43. 			},
    44. 			{
    45. 				"title": "Zapatillas de suela gruesa para hombre y mujer, chanclas de plataforma antideslizantes, zapatos de diseñador, sandalias",
    46. 				"pic_url": "https://ae04.alicdn.com/kf/Sec33322602a94251bf12531885670b07x.jpg",
    47. 				"promotion_price": 3.6,
    48. 				"price": 3.6,
    49. 				"orginal_price": "",
    50. 				"sales": 0,
    51. 				"num_iid": "3256804226773913",
    52. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-3",
    53. 				"seller_nick": "",
    54. 				"detail_url": "https://www.aliexpress.com/item/3256804226773913.html"
    55. 			},
    56. 			{
    57. 				"title": "Botas de nieve impermeables para niños y niñas, zapatos de cuero sintético, botas de goma, a la moda, novedad de invierno, 2022",
    58. 				"pic_url": "//ae04.alicdn.com/kf/Sb5100b42cf4e412b825da6ed4b61556fE.jpg",
    59. 				"promotion_price": 11.3,
    60. 				"price": 11.3,
    61. 				"orginal_price": "",
    62. 				"sales": 0,
    63. 				"num_iid": "2251832027324502",
    64. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-4",
    65. 				"seller_nick": "",
    66. 				"detail_url": "https://www.aliexpress.com/item/2251832027324502.html"
    67. 			},
    68. 			{
    69. 				"title": "Zapatos de invierno para mujer, botas Chelsea de tacón grueso con plataforma y punta redonda a la moda, botines de cuero cómodos para fiesta, diseño de lujo",
    70. 				"pic_url": "https://ae04.alicdn.com/kf/S774066f17c0c43d6a31720010fb48e1dL.jpg",
    71. 				"promotion_price": 143.22,
    72. 				"price": 143.22,
    73. 				"orginal_price": "",
    74. 				"sales": 0,
    75. 				"num_iid": "3256804438691675",
    76. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-5",
    77. 				"seller_nick": "",
    78. 				"detail_url": "https://www.aliexpress.com/item/3256804438691675.html"
    79. 			},
    80. 			{
    81. 				"title": "B",
    82. 				"pic_url": null,
    83. 				"promotion_price": null,
    84. 				"price": null,
    85. 				"orginal_price": "",
    86. 				"sales": 0,
    87. 				"num_iid": null,
    88. 				"sample_id": null,
    89. 				"seller_nick": "",
    90. 				"detail_url": "https://www.aliexpress.com/item/.html"
    91. 			},
    92. 			{
    93. 				"title": "Zapatos casuales para Hombre, Zapatillas cómodas para correr, zapatos para caminar a la moda, Zapatillas transpirables de talla grande, 2022",
    94. 				"pic_url": "https://ae04.alicdn.com/kf/Hc0d9a40e469442b4b027532f79974f77c.jpg",
    95. 				"promotion_price": 12.71,
    96. 				"price": 12.71,
    97. 				"orginal_price": "",
    98. 				"sales": 0,
    99. 				"num_iid": "3256802256175093",
    100. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-7",
    101. 				"seller_nick": "",
    102. 				"detail_url": "https://www.aliexpress.com/item/3256802256175093.html"
    103. 			},
    104. 			{
    105. 				"title": "Zapatillas de deporte para niña, zapatos transpirables de malla para bebé, zapatillas planas para niña pequeña, zapatillas para exteriores, novedad de 2022",
    106. 				"pic_url": "https://ae04.alicdn.com/kf/Sf1b3b5dddb21472faedec3419c0899db9.jpg",
    107. 				"promotion_price": 11.21,
    108. 				"price": 11.21,
    109. 				"orginal_price": "",
    110. 				"sales": 0,
    111. 				"num_iid": "3256803612454382",
    112. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-8",
    113. 				"seller_nick": "",
    114. 				"detail_url": "https://www.aliexpress.com/item/3256803612454382.html"
    115. 			},
    116. 			{
    117. 				"title": "Botas informales para bebé, zapatos de nieve para niños y niñas, calzado deportivo blanco de marca, zapatillas de deporte para niños 22-28",
    118. 				"pic_url": "//ae04.alicdn.com/kf/H17d3bbd6915b408aac1cb0ec3265776eM.png",
    119. 				"promotion_price": 9.59,
    120. 				"price": 9.59,
    121. 				"orginal_price": "",
    122. 				"sales": 0,
    123. 				"num_iid": "3256804396405635",
    124. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-9",
    125. 				"seller_nick": "",
    126. 				"detail_url": "https://www.aliexpress.com/item/3256804396405635.html"
    127. 			},
    128. 			{
    129. 				"title": "DEKABR-Botas cálidas de piel auténtica para hombre, botines de nieve impermeables hechos a manos, de invierno",
    130. 				"pic_url": "//ae04.alicdn.com/kf/Se67ada468d9442898e8e8ddba4a5b249X.jpg",
    131. 				"promotion_price": 32.9,
    132. 				"price": 32.9,
    133. 				"orginal_price": "",
    134. 				"sales": 0,
    135. 				"num_iid": "2255799897710441",
    136. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-10",
    137. 				"seller_nick": "",
    138. 				"detail_url": "https://www.aliexpress.com/item/2255799897710441.html"
    139. 			},
    140. 			{
    141. 				"title": "B",
    142. 				"pic_url": null,
    143. 				"promotion_price": null,
    144. 				"price": null,
    145. 				"orginal_price": "",
    146. 				"sales": 0,
    147. 				"num_iid": null,
    148. 				"sample_id": null,
    149. 				"seller_nick": "",
    150. 				"detail_url": "https://www.aliexpress.com/item/.html"
    151. 			},
    152. 			{
    153. 				"title": "Zapatos deportivos para niños, zapatillas de moda para niños y niñas, zapatos para correr en la escuela, Tenis transpirables con cordones de invierno de 5 a 15 años, 2022 tenis para niño zapatillas para",
    154. 				"pic_url": "//ae04.alicdn.com/kf/Sea9e1e47ad5a4b629902fe551baa549fQ.jpg",
    155. 				"promotion_price": 6.11,
    156. 				"price": 6.11,
    157. 				"orginal_price": "",
    158. 				"sales": 0,
    159. 				"num_iid": "3256804127615711",
    160. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-12",
    161. 				"seller_nick": "",
    162. 				"detail_url": "https://www.aliexpress.com/item/3256804127615711.html"
    163. 			},
    164. 			{
    165. 				"title": "LP-zapatos informales de punta redonda para mujer, calzado con colgante de pie plano, cómodos, a la moda, para primavera y otoño, 2022",
    166. 				"pic_url": "//ae04.alicdn.com/kf/S3c6da287e2a74a71ae97ae4739aa7968q.jpg",
    167. 				"promotion_price": 41.49,
    168. 				"price": 41.49,
    169. 				"orginal_price": "",
    170. 				"sales": 0,
    171. 				"num_iid": "3256804412497648",
    172. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-13",
    173. 				"seller_nick": "",
    174. 				"detail_url": "https://www.aliexpress.com/item/3256804412497648.html"
    175. 			},
    176. 			{
    177. 				"title": "Zapatillas de deporte para bebé, zapatos planos de moda para niños y niñas, zapatillas deportivas de malla elástica sólida para correr, 2020",
    178. 				"pic_url": "https://ae04.alicdn.com/kf/Hafaf35221d644b0eb9ecac3a15e4e0cbs.jpg",
    179. 				"promotion_price": 9.49,
    180. 				"price": 9.49,
    181. 				"orginal_price": "",
    182. 				"sales": 0,
    183. 				"num_iid": "3256801199795215",
    184. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-14",
    185. 				"seller_nick": "",
    186. 				"detail_url": "https://www.aliexpress.com/item/3256801199795215.html"
    187. 			},
    188. 			{
    189. 				"title": "Zapatillas deportivas de amortiguación para niños y niñas, zapatos deportivos informales resistentes al desgaste, ligeros, transpirables, talla 21-30",
    190. 				"pic_url": "https://ae04.alicdn.com/kf/Sc184eaad797b4e548b85ee8149c1b154m.jpg",
    191. 				"promotion_price": 9.64,
    192. 				"price": 9.64,
    193. 				"orginal_price": "",
    194. 				"sales": 0,
    195. 				"num_iid": "3256803728446891",
    196. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-15",
    197. 				"seller_nick": "",
    198. 				"detail_url": "https://www.aliexpress.com/item/3256803728446891.html"
    199. 			},
    200. 			{
    201. 				"title": "zapatillas hombre Zapatilla deportivas transpirables para hombres, zapatos masculinos de deporte, cómodos, ligeros, antideslizantes, de estilo casual y resistentes al desgaste, adecuados para correr, en oferta",
    202. 				"pic_url": "https://ae04.alicdn.com/kf/S54dc8fda03c24b07abef3d3d66e750f7r.jpg",
    203. 				"promotion_price": 15.75,
    204. 				"price": 15.75,
    205. 				"orginal_price": "",
    206. 				"sales": 0,
    207. 				"num_iid": "2255801036808411",
    208. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-16",
    209. 				"seller_nick": "",
    210. 				"detail_url": "https://www.aliexpress.com/item/2255801036808411.html"
    211. 			},
    212. 			{
    213. 				"title": "Zapatos de fútbol TF/FG para hombre, botas de fútbol altas/bajas, antideslizantes para exteriores, hierba Multicolor, zapatillas de entrenamiento, EUR35-45",
    214. 				"pic_url": "https://ae04.alicdn.com/kf/Sb51910b34bc245608c7359962d83a6e5c.jpg",
    215. 				"promotion_price": 11.02,
    216. 				"price": 11.02,
    217. 				"orginal_price": "",
    218. 				"sales": 0,
    219. 				"num_iid": "3256804146829423",
    220. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-17",
    221. 				"seller_nick": "",
    222. 				"detail_url": "https://www.aliexpress.com/item/3256804146829423.html"
    223. 			},
    224. 			{
    225. 				"title": "Conjunto informal de dos piezas para mujer, jersey de cuello redondo, Tops y pantalones largos sólidos, moda elegante para oficina, 2021",
    226. 				"pic_url": "//ae04.alicdn.com/kf/Ha2f2d3eb1a954448bc5d77dbea9b1c78X.jpg",
    227. 				"promotion_price": 15.58,
    228. 				"price": 15.58,
    229. 				"orginal_price": "",
    230. 				"sales": 0,
    231. 				"num_iid": "3256802092388974",
    232. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-18",
    233. 				"seller_nick": "",
    234. 				"detail_url": "https://www.aliexpress.com/item/3256802092388974.html"
    235. 			},
    236. 			{
    237. 				"title": "Zapatillas De lona transpirables para Hombre, zapatos planos informales para caminar, vulcanizados sin cordones, calzado De trabajo De verano",
    238. 				"pic_url": "https://ae04.alicdn.com/kf/S900a126b69d24c499e0ed3b80d1fd16dI.jpg",
    239. 				"promotion_price": 5.83,
    240. 				"price": 5.83,
    241. 				"orginal_price": "",
    242. 				"sales": 0,
    243. 				"num_iid": "3256804085362912",
    244. 				"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-19",
    245. 				"seller_nick": "",
    246. 				"detail_url": "https://www.aliexpress.com/item/3256804085362912.html"
    247. 			}
    248. 		],
    249. 		"related_keywords": [],
    250. 		"nav_catcamp": [],
    251. 		"crumbs": [],
    252. 		"breadcrumbs": [],
    253. 		"navs": [],
    254. 		"data_from": "",
    255. 		"url": "",
    256. 		"keyword": "shoe",
    257. 		"cid": "",
    258. 		"page_size": 20,
    259. 		"pagecount": ""
    260. 	},
    261. 	"error_code": "0000",
    262. 	"reason": "ok",
    263. 	"secache": "a799cd7c0b5c3217932480868ddb51cc",
    264. 	"secache_time": 1662620749,
    265. 	"secache_date": "2022-09-08 15:05:49",
    266. 	"error": "",
    267. 	"cache": 0,
    268. 	"api_info": "today:70 max:10100 all[122=70+25+27];expires:2030-12-31",
    269. 	"execution_time": "1.393",
    270. 	"server_time": "Beijing/2022-09-08 15:05:49",
    271. 	"client_ip": "106.6.32.13",
    272. 	"call_args": {
    273. 		"q": "shoe"
    274. 	},
    275. 	"api_type": "aliexpress",
    276. 	"translate_language": "zh-CN",
    277. 	"translate_engine": "google_cn",
    278. 	"server_memory": "0.86MB",
    279. 	"request_id": "gw-4.6319944bd46ea",
    280. 	"last_id": "1203543829"
    281. }

    异常示例相关资料错误码解释

    状态代码(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未知错误否
  • 相关阅读:
    温度、机械振动等对电子产品的影响
    LA@特征值和特征向量的性质
    SpringBoot——》引入Redis
    ovs dpdk debug
    5、数据库经验总结
    基于JAVA+SpringMVC+Mybatis+MYSQL的家庭理财管理系统
    redis的详解和项目应用之SESSION共享
    Vue源码学习(十五):diff算法(二)交叉比对(双指针)
    Random与random的区别
    复选框 前端代码
  • 原文地址：https://blog.csdn.net/Noah_ZX/article/details/126764984