1688商品详情接口使用全过程_前端

tem_get-获得1688商品详情 前往测试

onebound.1688.item_get


公共参数

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

名称

类型

必须

描述

key

String

调用key(必须以GET方式拼接在URL中)

secret

String

调用密钥

api_name

String

API接口名称(包括在请求地址中)[item_search,item_get,item_search_shop等]

cache

String

[yes,no]默认yes,将调用缓存的数据,速度比较快

result_type

String

[json,jsonu,xml,serialize,var_export]返回数据格式,默认为json,jsonu输出的内容中文可以直接阅读

lang

String

[cn,en,ru]翻译语言,默认cn简体中文

version

String

API版本


请求参数

请求参数:num_iid=610947572360

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


响应参数

Version: Date:

名称

类型

必须

示例值

描述

item

item[]

0

宝贝详情数据


请求示例

  • Curl
  • PHP
  • PHPsdk
  • JAVA
  • C#
  • Python

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


响应示例

{
	"item": {
		"num_iid": "610947572360",
		"title": "厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G",
		"desc_short": "",
		"price": "799.00",
		"total_price": 0,
		"suggestive_price": 0,
		"orginal_price": "799.00",
		"nick": "qin多亲科技",
		"num": "1763",
		"detail_url": "https://detail.1688.com/offer/610947572360.html",
		"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg",
		"brand": "",
		"brandId": "",
		"rootCatId": "",
		"cid": "50903",
		"desc": "<div id=\"offer-template-0\"></div><p><span><span>深圳市多亲科技有限公司(简称“多亲科技”)成立于2014年9月是国内领先的人工智能硬件解决方案供应商。多亲科技积极推动人工智能技术的创新研发,在人工智能终端设备、系统软件的研发和生产领域,具有深厚的技术沉淀与实力。</span></span></p><p><span> </span></p><p><span>        多亲产品销售网络覆盖全国各地乃至远销海外,欢迎企业定制、团购、经销代理。</span></p><p><span>        优质的产品、过硬的技术、完善的服务、是我们合作双赢的开篇。</span></p><p><span>        <span ><strong><span >欢迎有意向者实地考察,垂询电话:13662284449.</span></strong></span></span></p><p><span> </span></p><p><span>温馨提示:</span></p><p><span><span><span>1、可定制--</span></span>承接各种订单订制!为客户定制机身、开机画面、预装软件、包装等定制!</span><br /><span><span><span>2、质量保证--</span></span>本公司专注通讯行业10年,线下线下百花齐放,客户复购率达30%以上。</span><br /><span><span><span>3、价格实惠--</span></span>本店是工厂直供,没有中间商差价,一站到客,薄利多销。</span><br /><span><span><span>4、售后服务--</span></span>本店出售的所有产品均提供1年的质保。因质量原因退换货(非人为因素)30天内换新。</span></p><p> </p><p><span><img alt=\"undefined\" height=\"446.22866894197955\" src=\"https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg\" width=\"790\" /><br /><img alt=\"undefined\" height=\"457.5154730327144\" src=\"https://cbu01.alicdn.com/img/ibank/2020/303/507/14112705303_979836901.jpg\" width=\"790\" /><br /><img alt=\"undefined\" height=\"443.2365499573014\" src=\"https://cbu01.alicdn.com/img/ibank/2020/499/812/14150218994_979836901.jpg\" width=\"790\" /><br /><img alt=\"undefined\" height=\"440.350569675723\" src=\"https://cbu01.alicdn.com/img/ibank/2020/770/128/14199821077_979836901.jpg\" width=\"790\" /><br /></span></p><p><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/588/942/13197249885_979836901.jpg\" /></p><p><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/778/789/13234987877_979836901.jpg\" /><br /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/109/489/13234984901_979836901.jpg\" /><br /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/156/072/13197270651_979836901.jpg\" /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/270/710/13235017072_979836901.jpg\" /><br /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/735/999/13234999537_979836901.jpg\" /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/549/252/13197252945_979836901.jpg\" /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/409/552/13197255904_979836901.jpg\" /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/247/935/13278539742_979836901.jpg\" /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/355/845/13278548553_979836901.jpg\" /><br /><br /></p><p><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/917/372/13197273719_979836901.jpg\" /><br /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/969/099/13234990969_979836901.jpg\" /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/175/455/13278554571_979836901.jpg\" /></p><p><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/427/386/13314683724_979836901.jpg\" /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/331/365/13278563133_979836901.jpg\" /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/654/500/13235005456_979836901.jpg\" /><br /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/542/110/13235011245_979836901.jpg\" /><br /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/291/020/13235020192_979836901.jpg\" /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/329/635/13278536923_979836901.jpg\" /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/996/155/13278551699_979836901.jpg\" /></p><p><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/230/920/13235029032_979836901.jpg\" /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/464/972/13197279464_979836901.jpg\" /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/380/275/13278572083_979836901.jpg\" /><br /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/999/462/13197264999_979836901.jpg\" /><br /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/868/245/13278542868_979836901.jpg\" /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/843/410/13235014348_979836901.jpg\" /><br /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/897/200/13235002798_979836901.jpg\" /><br /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/914/800/13235008419_979836901.jpg\" /><br /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/709/762/13197267907_979836901.jpg\" /><br /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/427/545/13278545724_979836901.jpg\" /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/741/003/13197300147_979836901.jpg\" /><br /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/175/710/13235017571_979836901.jpg\" /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/410/485/13278584014_979836901.jpg\" /><br /><br /><img alt=\"undefined\" src=\"https://cbu01.alicdn.com/img/ibank/2020/863/665/13278566368_979836901.jpg\" /><br /><br /><br /></p>",
		"item_imgs": [
			{
				"url": "https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg"
			},
			{
				"url": "https://cbu01.alicdn.com/img/ibank/2020/445/748/13819847544_979836901.jpg"
			},
			{
				"url": "https://cbu01.alicdn.com/img/ibank/2020/487/543/13234345784_979836901.jpg"
			},
			{
				"url": "https://cbu01.alicdn.com/img/ibank/2020/296/695/13418596692_979836901.jpg"
			},
			{
				"url": "https://cbu01.alicdn.com/img/ibank/2020/167/778/13462877761_979836901.jpg"
			}
		],
		"item_weight": "",
		"post_fee": "",
		"express_fee": "",
		"ems_fee": "",
		"shipping_to": "",
		"video": [],
		"sample_id": "",
		"props_name": "0:0:机身内存:64GB;1:0:颜色:铁灰色;1:1:颜色:瓷白色",
		"prop_imgs": {
			"prop_img": []
		},
		"property_alias": "0:0:64GB;1:0:铁灰色;1:1:瓷白色",
		"props": [
			{
				"name": "品牌",
				"value": "多亲"
			},
			{
				"name": "型号",
				"value": "Qin 2 Pro"
			},
			{
				"name": "手机类型",
				"value": "老人手机"
			},
			{
				"name": "外形",
				"value": "直板"
			},
			{
				"name": "主屏尺寸",
				"value": "大屏幕(5.0英寸—5.9英寸)"
			},
			{
				"name": "网络制式",
				"value": "移动4G(TD-LTE),联通/电信4G(FDD-LTE)"
			},
			{
				"name": "操作系统",
				"value": "Android 9.0系统"
			},
			{
				"name": "电池容量",
				"value": "2100"
			},
			{
				"name": "摄像头像素",
				"value": "1200万-1999万"
			},
			{
				"name": "存储卡",
				"value": "支持存储卡"
			},
			{
				"name": "处理器核心",
				"value": "八核"
			},
			{
				"name": "运行内存",
				"value": "2GB"
			},
			{
				"name": "手机版本",
				"value": "大陆行货"
			},
			{
				"name": "售后类型",
				"value": "全国联保"
			},
			{
				"name": "上市时间",
				"value": "2019"
			},
			{
				"name": "适用送礼场合",
				"value": "员工福利,颁奖纪念,广告促销,节日,展销会,公关策划,生日,商务馈赠"
			},
			{
				"name": "3C证书编号",
				"value": "2019161606319519"
			},
			{
				"name": "CPU品牌",
				"value": "展讯"
			},
			{
				"name": "运营商",
				"value": "中国移动,中国电信,中国联通"
			},
			{
				"name": "网络模式",
				"value": "单卡单模"
			},
			{
				"name": "机身内存",
				"value": "64GB"
			},
			{
				"name": "颜色",
				"value": "铁灰色,瓷白色"
			},
			{
				"name": "电信设备进网许可证编号",
				"value": "02-B613-192425"
			}
		],
		"total_sold": "1",
		"scale": "",
		"sellUnit": "",
		"skus": {
			"sku": [
				{
					"price": "799.00",
					"total_price": 0,
					"sales": "55",
					"properties": "0:0;1:1",
					"properties_name": "0:0:机身内存:64GB;1:1:颜色:瓷白色",
					"quantity": "932",
					"sku_id": "4309097072612",
					"spec_id": "63828b15ad641fdb131775f32e4c050c"
				},
				{
					"price": "799.00",
					"total_price": 0,
					"sales": "159",
					"properties": "0:0;1:0",
					"properties_name": "0:0:机身内存:64GB;1:0:颜色:铁灰色",
					"quantity": "831",
					"sku_id": "4302217872901",
					"spec_id": "0eb631954bfe8fb00a45824fc6193f2f"
				}
			]
		},
		"seller_id": "2206619673102",
		"sales": 30,
		"shop_id": "",
		"props_list": {
			"0:0": "机身内存:64GB",
			"1:0": "颜色:铁灰色",
			"1:1": "颜色:瓷白色"
		},
		"seller_info": {
			"nick": "qin多亲科技",
			"user_num_id": "2206619673102",
			"sid": "b2b-2206619673102e9470",
			"title": "深圳多亲科技实力卖场",
			"zhuy": "https://winport.m.1688.com/page/index.html?memberId=b2b-2206619673102e9470",
			"shop_name": "qin多亲科技"
		},
		"tmall": "",
		"data_from": "1688app",
		"error": "",
		"unit": "部",
		"is_support_mix": null,
		"mix_amount": null,
		"mix_begin": null,
		"mix_number": null,
		"min_num": "2",
		"sales_data": "",
		"location": "广东省 深圳市",
		"props_img": [],
		"sales_info": {
			"seller_num": "",
			"repeat_rate_purchase": "",
			"per_capita_purchases": "",
			"comment_num": "",
			"comment_url": ""
		},
		"desc_img": [
			"https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/303/507/14112705303_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/499/812/14150218994_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/770/128/14199821077_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/588/942/13197249885_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/778/789/13234987877_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/109/489/13234984901_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/156/072/13197270651_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/270/710/13235017072_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/735/999/13234999537_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/549/252/13197252945_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/409/552/13197255904_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/247/935/13278539742_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/355/845/13278548553_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/917/372/13197273719_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/969/099/13234990969_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/175/455/13278554571_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/427/386/13314683724_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/331/365/13278563133_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/654/500/13235005456_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/542/110/13235011245_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/291/020/13235020192_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/329/635/13278536923_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/996/155/13278551699_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/230/920/13235029032_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/464/972/13197279464_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/380/275/13278572083_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/999/462/13197264999_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/868/245/13278542868_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/843/410/13235014348_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/897/200/13235002798_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/914/800/13235008419_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/709/762/13197267907_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/427/545/13278545724_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/741/003/13197300147_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/175/710/13235017571_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/410/485/13278584014_979836901.jpg",
			"https://cbu01.alicdn.com/img/ibank/2020/863/665/13278566368_979836901.jpg"
		],
		"shop_item": [],
		"relate_items": []
	},
	"secache": "f75c59301daa3fc1610a8563c998f851",
	"secache_time": 1608276252,
	"secache_date": "2020-12-18 15:24:12",
	"translate_status": "",
	"translate_time": 0,
	"language": {
		"default_lang": "cn",
		"current_lang": "cn"
	},
	"error": "",
	"reason": "",
	"error_code": "0000",
	"cache": 0,
	"api_info": "today:12 max:10000",
	"execution_time": 6.65,
	"server_time": "Beijing/2020-12-18 15:24:17",
	"client_ip": "182.111.155.89",
	"call_args": {
		"num_iid": "610947572360",
		"area_id": "440111"
	},
	"api_type": "1688",
	"translate_language": "zh-CN",
	"translate_engine": "google_cn",
	"server_memory": "4.44MB",
	"request_id": "gw-2.5fdc591b3bdb0"
}


异常示例

{
  "error": "item-not-found",
  "reason": "商品没找到",
  "error_code": "2000",
  "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": "1688",
  "request_id": "15ee0ffc041242"
}