• 1688API接入说明（商品详情数据示例）

    1. API地址:
      https://api-gw.onebound.cn/1688/

    2. 调用示例：
      https://api-gw.onebound.cn/1688/item_get/?key=test_api_key& &num_iid=610947572360&&lang=zh-CN&secret=

    3. 参数说明

      • 通用参数说明

        • version:API版本
        • key:调用key,测试key:test_api_key
        • api_name:API类型[item_get,item_search]
        • cache:[yes,no]默认yes，将调用缓存的数据，速度比较快
        • result_type:[json,xml,serialize,var_export]返回数据格式，默认为json
        • lang:[cn,en,ru] 翻译语言，默认cn简体中文

      • API:item_get 参数说明: num_iid:宝贝ID

    4. 此API目前支持以下基本接口：

      • item_get 获得1688商品详情
      • item_search 按关键字搜索商品
      • item_search_img 按图搜索1688商品（拍立淘）
      • item_search_suggest 获得搜索词推荐
      • item_fee 获得商品快递费用
      • seller_info 获得店铺详情
      • item_search_shop 获得店铺的所有商品
      • item_password 获得淘口令真实url
      • upload_img 上传图片到1688
      • item_search_seller 搜索店铺列表
      • img2text 图片识别商品接口
      • item_get_app 获取1688app上原数据
      • buyer_order_list 获取购买到的商品订单列表
      • cat_get 获得1688商品分类

    其他接口请参考测试界面参数 http://api.onebound.cn/1688/?act=show_api

    item_get-获得1688商品详情API 返回值说明

    公共参数

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

    请求参数

    请求参数：num_iid=610947572360

    参数说明：num_iid:1688商品ID
    sales_data:&sales_data=1 获取近30天成交数据
    agent:&agent=1 获取1688分销代发价格数据

    响应参数

    Version: Date:

     

     

    请求示例

    Curl PHP PHPsdk JAVA C# Python 

    1. # coding:utf-8
    2. """
    3. Compatible for python2.x and python3.x
    4. requirement: pip install requests
    5. """
    6. from __future__ import print_function
    7. import requests
    8. # 请求示例 url 默认请求参数已经做URL编码
    9. url = "https://api-gw.onebound.cn/1688/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=610947572360"
    10. headers = {
    11.     "Accept-Encoding": "gzip",
    12.     "Connection": "close"
    13. }
    14. if __name__ == "__main__":
    15.     r = requests.get(url, headers=headers)
    16.     json_obj = r.json()
    17.     print(json_obj)

    响应示例

    1. {
    2. 	"item": {
    3. 		"num_iid": "610947572360",
    4. 		"title": "厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G",
    5. 		"desc_short": "",
    6. 		"price": "799.00",
    7. 		"total_price": 0,
    8. 		"suggestive_price": 0,
    9. 		"orginal_price": "799.00",
    10. 		"nick": "qin多亲科技",
    11. 		"num": "1763",
    12. 		"detail_url": "https://detail.1688.com/offer/610947572360.html",
    13. 		"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg",
    14. 		"brand": "",
    15. 		"brandId": "",
    16. 		"rootCatId": "",
    17. 		"cid": "50903",
    18. 		"desc": "
      \"offer-template-0\">
      深圳市多亲科技有限公司（简称“多亲科技”)成立于2014年9月是国内领先的人工智能硬件解决方案供应商。多亲科技积极推动人工智能技术的创新研发，在人工智能终端设备、系统软件的研发和生产领域，具有深厚的技术沉淀与实力。
       
              多亲产品销售网络覆盖全国各地乃至远销海外，欢迎企业定制、团购、经销代理。
              优质的产品、过硬的技术、完善的服务、是我们合作双赢的开篇。
              欢迎有意向者实地考察，垂询电话：13662284449.
       
      温馨提示：
      1、可定制--承接各种订单订制！为客户定制机身、开机画面、预装软件、包装等定制！
      2、质量保证--本公司专注通讯行业10年，线下线下百花齐放，客户复购率达30%以上。
      3、价格实惠--本店是工厂直供，没有中间商差价，一站到客，薄利多销。
      4、售后服务--本店出售的所有产品均提供1年的质保。因质量原因退换货（非人为因素）30天内换新。
       
      <span\"undefined\" height=\"446.22866894197955\" src=\"https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg\" width=\"790\" />
      <span\"undefined\" height=\"457.5154730327144\" src=\"https://cbu01.alicdn.com/img/ibank/2020/303/507/14112705303_979836901.jpg\" width=\"790\" />
      <span\"undefined\" height=\"443.2365499573014\" src=\"https://cbu01.alicdn.com/img/ibank/2020/499/812/14150218994_979836901.jpg\" width=\"790\" />
      <span\"undefined\" height=\"440.350569675723\" src=\"https://cbu01.alicdn.com/img/ibank/2020/770/128/14199821077_979836901.jpg\" width=\"790\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/588/942/13197249885_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/778/789/13234987877_979836901.jpg\" />

      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/109/489/13234984901_979836901.jpg\" />

      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/156/072/13197270651_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/270/710/13235017072_979836901.jpg\" />

      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/735/999/13234999537_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/549/252/13197252945_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/409/552/13197255904_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/247/935/13278539742_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/355/845/13278548553_979836901.jpg\" />

      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/917/372/13197273719_979836901.jpg\" />

      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/969/099/13234990969_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/175/455/13278554571_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/427/386/13314683724_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/331/365/13278563133_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/654/500/13235005456_979836901.jpg\" />

      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/542/110/13235011245_979836901.jpg\" />

      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/291/020/13235020192_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/329/635/13278536923_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/996/155/13278551699_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/230/920/13235029032_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/464/972/13197279464_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/380/275/13278572083_979836901.jpg\" />

      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/999/462/13197264999_979836901.jpg\" />

      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/868/245/13278542868_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/843/410/13235014348_979836901.jpg\" />

      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/897/200/13235002798_979836901.jpg\" />

      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/914/800/13235008419_979836901.jpg\" />

      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/709/762/13197267907_979836901.jpg\" />

      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/427/545/13278545724_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/741/003/13197300147_979836901.jpg\" />

      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/175/710/13235017571_979836901.jpg\" />
      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/410/485/13278584014_979836901.jpg\" />

      <span\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/863/665/13278566368_979836901.jpg\" />


      "      ,
    19. 		"item_imgs": [
    20. 			{
    21. 				"url": "https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg"
    22. 			},
    23. 			{
    24. 				"url": "https://cbu01.alicdn.com/img/ibank/2020/445/748/13819847544_979836901.jpg"
    25. 			},
    26. 			{
    27. 				"url": "https://cbu01.alicdn.com/img/ibank/2020/487/543/13234345784_979836901.jpg"
    28. 			},
    29. 			{
    30. 				"url": "https://cbu01.alicdn.com/img/ibank/2020/296/695/13418596692_979836901.jpg"
    31. 			},
    32. 			{
    33. 				"url": "https://cbu01.alicdn.com/img/ibank/2020/167/778/13462877761_979836901.jpg"
    34. 			}
    35. 		],
    36. 		"item_weight": "",
    37. 		"post_fee": "",
    38. 		"express_fee": "",
    39. 		"ems_fee": "",
    40. 		"shipping_to": "",
    41. 		"video": [],
    42. 		"sample_id": "",
    43. 		"props_name": "0:0:机身内存:64GB;1:0:颜色:铁灰色;1:1:颜色:瓷白色",
    44. 		"prop_imgs": {
    45. 			"prop_img": []
    46. 		},
    47. 		"property_alias": "0:0:64GB;1:0:铁灰色;1:1:瓷白色",
    48. 		"props": [
    49. 			{
    50. 				"name": "品牌",
    51. 				"value": "多亲"
    52. 			},
    53. 			{
    54. 				"name": "型号",
    55. 				"value": "Qin 2 Pro"
    56. 			},
    57. 			{
    58. 				"name": "手机类型",
    59. 				"value": "老人手机"
    60. 			},
    61. 			{
    62. 				"name": "外形",
    63. 				"value": "直板"
    64. 			},
    65. 			{
    66. 				"name": "主屏尺寸",
    67. 				"value": "大屏幕(5.0英寸—5.9英寸)"
    68. 			},
    69. 			{
    70. 				"name": "网络制式",
    71. 				"value": "移动4G(TD-LTE),联通/电信4G(FDD-LTE)"
    72. 			},
    73. 			{
    74. 				"name": "操作系统",
    75. 				"value": "Android 9.0系统"
    76. 			},
    77. 			{
    78. 				"name": "电池容量",
    79. 				"value": "2100"
    80. 			},
    81. 			{
    82. 				"name": "摄像头像素",
    83. 				"value": "1200万-1999万"
    84. 			},
    85. 			{
    86. 				"name": "存储卡",
    87. 				"value": "支持存储卡"
    88. 			},
    89. 			{
    90. 				"name": "处理器核心",
    91. 				"value": "八核"
    92. 			},
    93. 			{
    94. 				"name": "运行内存",
    95. 				"value": "2GB"
    96. 			},
    97. 			{
    98. 				"name": "手机版本",
    99. 				"value": "大陆行货"
    100. 			},
    101. 			{
    102. 				"name": "售后类型",
    103. 				"value": "全国联保"
    104. 			},
    105. 			{
    106. 				"name": "上市时间",
    107. 				"value": "2019"
    108. 			},
    109. 			{
    110. 				"name": "适用送礼场合",
    111. 				"value": "员工福利,颁奖纪念,广告促销,节日,展销会,公关策划,生日,商务馈赠"
    112. 			},
    113. 			{
    114. 				"name": "3C证书编号",
    115. 				"value": "2019161606319519"
    116. 			},
    117. 			{
    118. 				"name": "CPU品牌",
    119. 				"value": "展讯"
    120. 			},
    121. 			{
    122. 				"name": "运营商",
    123. 				"value": "中国移动,中国电信,中国联通"
    124. 			},
    125. 			{
    126. 				"name": "网络模式",
    127. 				"value": "单卡单模"
    128. 			},
    129. 			{
    130. 				"name": "机身内存",
    131. 				"value": "64GB"
    132. 			},
    133. 			{
    134. 				"name": "颜色",
    135. 				"value": "铁灰色,瓷白色"
    136. 			},
    137. 			{
    138. 				"name": "电信设备进网许可证编号",
    139. 				"value": "02-B613-192425"
    140. 			}
    141. 		],
    142. 		"total_sold": "1",
    143. 		"scale": "",
    144. 		"sellUnit": "",
    145. 		"skus": {
    146. 			"sku": [
    147. 				{
    148. 					"price": "799.00",
    149. 					"total_price": 0,
    150. 					"sales": "55",
    151. 					"properties": "0:0;1:1",
    152. 					"properties_name": "0:0:机身内存:64GB;1:1:颜色:瓷白色",
    153. 					"quantity": "932",
    154. 					"sku_id": "4309097072612",
    155. 					"spec_id": "63828b15ad641fdb131775f32e4c050c"
    156. 				},
    157. 				{
    158. 					"price": "799.00",
    159. 					"total_price": 0,
    160. 					"sales": "159",
    161. 					"properties": "0:0;1:0",
    162. 					"properties_name": "0:0:机身内存:64GB;1:0:颜色:铁灰色",
    163. 					"quantity": "831",
    164. 					"sku_id": "4302217872901",
    165. 					"spec_id": "0eb631954bfe8fb00a45824fc6193f2f"
    166. 				}
    167. 			]
    168. 		},
    169. 		"seller_id": "2206619673102",
    170. 		"sales": 30,
    171. 		"shop_id": "",
    172. 		"props_list": {
    173. 			"0:0": "机身内存:64GB",
    174. 			"1:0": "颜色:铁灰色",
    175. 			"1:1": "颜色:瓷白色"
    176. 		},
    177. 		"seller_info": {
    178. 			"nick": "qin多亲科技",
    179. 			"user_num_id": "2206619673102",
    180. 			"sid": "b2b-2206619673102e9470",
    181. 			"title": "深圳多亲科技实力卖场",
    182. 			"zhuy": "https://winport.m.1688.com/page/index.html?memberId=b2b-2206619673102e9470",
    183. 			"shop_name": "qin多亲科技"
    184. 		},
    185. 		"tmall": "",
    186. 		"data_from": "1688app",
    187. 		"error": "",
    188. 		"unit": "部",
    189. 		"is_support_mix": null,
    190. 		"mix_amount": null,
    191. 		"mix_begin": null,
    192. 		"mix_number": null,
    193. 		"min_num": "2",
    194. 		"sales_data": "",
    195. 		"location": "广东省 深圳市",
    196. 		"props_img": [],
    197. 		"sales_info": {
    198. 			"seller_num": "",
    199. 			"repeat_rate_purchase": "",
    200. 			"per_capita_purchases": "",
    201. 			"comment_num": "",
    202. 			"comment_url": ""
    203. 		},
    204. 		"desc_img": [
    205. 			"https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg",
    206. 			"https://cbu01.alicdn.com/img/ibank/2020/303/507/14112705303_979836901.jpg",
    207. 			"https://cbu01.alicdn.com/img/ibank/2020/499/812/14150218994_979836901.jpg",
    208. 			"https://cbu01.alicdn.com/img/ibank/2020/770/128/14199821077_979836901.jpg",
    209. 			"https://cbu01.alicdn.com/img/ibank/2020/588/942/13197249885_979836901.jpg",
    210. 			"https://cbu01.alicdn.com/img/ibank/2020/778/789/13234987877_979836901.jpg",
    211. 			"https://cbu01.alicdn.com/img/ibank/2020/109/489/13234984901_979836901.jpg",
    212. 			"https://cbu01.alicdn.com/img/ibank/2020/156/072/13197270651_979836901.jpg",
    213. 			"https://cbu01.alicdn.com/img/ibank/2020/270/710/13235017072_979836901.jpg",
    214. 			"https://cbu01.alicdn.com/img/ibank/2020/735/999/13234999537_979836901.jpg",
    215. 			"https://cbu01.alicdn.com/img/ibank/2020/549/252/13197252945_979836901.jpg",
    216. 			"https://cbu01.alicdn.com/img/ibank/2020/409/552/13197255904_979836901.jpg",
    217. 			"https://cbu01.alicdn.com/img/ibank/2020/247/935/13278539742_979836901.jpg",
    218. 			"https://cbu01.alicdn.com/img/ibank/2020/355/845/13278548553_979836901.jpg",
    219. 			"https://cbu01.alicdn.com/img/ibank/2020/917/372/13197273719_979836901.jpg",
    220. 			"https://cbu01.alicdn.com/img/ibank/2020/969/099/13234990969_979836901.jpg",
    221. 			"https://cbu01.alicdn.com/img/ibank/2020/175/455/13278554571_979836901.jpg",
    222. 			"https://cbu01.alicdn.com/img/ibank/2020/427/386/13314683724_979836901.jpg",
    223. 			"https://cbu01.alicdn.com/img/ibank/2020/331/365/13278563133_979836901.jpg",
    224. 			"https://cbu01.alicdn.com/img/ibank/2020/654/500/13235005456_979836901.jpg",
    225. 			"https://cbu01.alicdn.com/img/ibank/2020/542/110/13235011245_979836901.jpg",
    226. 			"https://cbu01.alicdn.com/img/ibank/2020/291/020/13235020192_979836901.jpg",
    227. 			"https://cbu01.alicdn.com/img/ibank/2020/329/635/13278536923_979836901.jpg",
    228. 			"https://cbu01.alicdn.com/img/ibank/2020/996/155/13278551699_979836901.jpg",
    229. 			"https://cbu01.alicdn.com/img/ibank/2020/230/920/13235029032_979836901.jpg",
    230. 			"https://cbu01.alicdn.com/img/ibank/2020/464/972/13197279464_979836901.jpg",
    231. 			"https://cbu01.alicdn.com/img/ibank/2020/380/275/13278572083_979836901.jpg",
    232. 			"https://cbu01.alicdn.com/img/ibank/2020/999/462/13197264999_979836901.jpg",
    233. 			"https://cbu01.alicdn.com/img/ibank/2020/868/245/13278542868_979836901.jpg",
    234. 			"https://cbu01.alicdn.com/img/ibank/2020/843/410/13235014348_979836901.jpg",
    235. 			"https://cbu01.alicdn.com/img/ibank/2020/897/200/13235002798_979836901.jpg",
    236. 			"https://cbu01.alicdn.com/img/ibank/2020/914/800/13235008419_979836901.jpg",
    237. 			"https://cbu01.alicdn.com/img/ibank/2020/709/762/13197267907_979836901.jpg",
    238. 			"https://cbu01.alicdn.com/img/ibank/2020/427/545/13278545724_979836901.jpg",
    239. 			"https://cbu01.alicdn.com/img/ibank/2020/741/003/13197300147_979836901.jpg",
    240. 			"https://cbu01.alicdn.com/img/ibank/2020/175/710/13235017571_979836901.jpg",
    241. 			"https://cbu01.alicdn.com/img/ibank/2020/410/485/13278584014_979836901.jpg",
    242. 			"https://cbu01.alicdn.com/img/ibank/2020/863/665/13278566368_979836901.jpg"
    243. 		],
    244. 		"shop_item": [],
    245. 		"relate_items": []
    246. 	},
    247. 	"secache": "f75c59301daa3fc1610a8563c998f851",
    248. 	"secache_time": 1608276252,
    249. 	"secache_date": "2020-12-18 15:24:12",
    250. 	"translate_status": "",
    251. 	"translate_time": 0,
    252. 	"language": {
    253. 		"default_lang": "cn",
    254. 		"current_lang": "cn"
    255. 	},
    256. 	"error": "",
    257. 	"reason": "",
    258. 	"error_code": "0000",
    259. 	"cache": 0,
    260. 	"api_info": "today:12 max:10000",
    261. 	"execution_time": 6.65,
    262. 	"server_time": "Beijing/2020-12-18 15:24:17",
    263. 	"client_ip": "182.111.155.89",
    264. 	"call_args": {
    265. 		"num_iid": "610947572360",
    266. 		"area_id": "440111"
    267. 	},
    268. 	"api_type": "1688",
    269. 	"translate_language": "zh-CN",
    270. 	"translate_engine": "google_cn",
    271. 	"server_memory": "4.44MB",
    272. 	"request_id": "gw-2.5fdc591b3bdb0"
    273. }

  • 相关阅读:
    Typora收费后我换了个Markdown编辑器（Marktext）
    Spring-day02 容器的概念，容器中的对象，IOP入门
    Git报错 FETCH_HEAD fatal: refusing to merge unrelated histories
    博客园商业化之路：融资做与众不同的众包平台，让开发能力成为一种服务
    【初中生讲机器学习】12. 似然函数和极大似然估计：原理、应用与代码实现
    一台服务器最大能支持多少条 TCP 连接
    如何建设一个用于编译 iOS App 的 macOS 云服务器集群？
    利用commit理解镜像构成
    c语言输出杨辉三角
    【前端设计模式】之适配器模式
  • 原文地址：https://blog.csdn.net/api_Anzexi/article/details/126287480