1688商品详情API应用之无货源铺货 SAAS：合规采集、多平台一键上架、SKU / 库存 / 价格自动同步

admin3小时前1688 API3

1688商品详情接口：item_get，item_get_pro

通过商品id获取商品详情信息，包括商品标题、价格、url，商品主图、详情图，sku信息等。点此测试API

编辑

公共参数

名称	类型	必须	描述
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		宝贝详情数据
num_iid	String	0	610947572360	宝贝ID
title	String	0	厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G	商品标题
desc_short	String	0
price	Float	1	799.00	价格
batch_price	Float	1	799.00	批发价格【如代发存在区间起批量优先展示代发价格】
total_price	Float	0	0
suggestive_price	Float	0	0
orginal_price	Float	0	799.00	原价
nick	String	0	qin多亲科技(_sopid@BBBSvyqimnYtLnmm90B_59dsg)	卖家昵称(以上2种参数都有可能输出，凡是_sopid@开头的即为加密openid)
num	Int	0	2191
min_num	Int	0	2	最小起批量
detail_url	String	0	https://detail.1688.com/offer/610947572360.html	宝贝链接
pic_url	String	0	https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg	宝贝图片
rootCatId	Int	0	0	顶级分类ID
cid	Int	0	124264005
desc	String	0
item_imgs	Mix	0	item_imgs[]	商品图片
item_weight	String	0
video	video[]	0		商品视频
sample_id	String	0
props_name	String	0	0:0:机身内存:64GB;1:0:颜色:铁灰色;1:1:颜色:瓷白色	商品属性名
prop_imgs	prop_imgs[]	0		商品属性图片列表
property_alias	String	0	0:0:64GB;1:0:铁灰色;1:1:瓷白色	属性别名
props	Mix	0	[{"name": "品牌", "value": "other"}]	商品详情
total_sold	Int	0	1
scale	Int	0
sellUnit	Int	0
skus	skus[]	0		商品规格信息列表
seller_id	Int	0	2206619673102	卖家ID
sales	Int	0	100	销售额
shop_id	Int	0	151372205	店铺ID
props_list	Mix	0	{"0:0": "机身内存:64GB"}	商品属性
tmall	Boolean	0	false	是否天猫
data_from	String	0	1688app	错误信息
error	String	0		错误信息
unit	String	0	部;	单位
is_support_mix	Boolean	0	true
mix_amount	Int	0	30
mix_Begin	Int	0
mix_number	Int	0
sales_data	Date	0
location	String	0	广东省深圳市	发货地
props_img	Mix	0		属性图片
sales_info	Mix	0
desc_img	Mix	0	[{"https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg"}]	详情图片列表
shop_item	Mix	0
relate_items	Mix	0

响应示例

"item": {		"num_iid": "952042688449",		"title": "辣妹性感美式挂脖吊带小背心女夏季带胸垫新款设计感小众美背上衣",		"desc_short": "",		"price": "12.10",		"total_price": 0,		"suggestive_price": 0,		"orginal_price": "12.10",		"nick": "汕头市潮阳区贵屿鑫顺发针织内衣厂",		"num": 124762,		"min_num": 20,		"detail_url": "https://detail.1688.com/offer/952042688449.html",		"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN011iB2gE2JzqvRBkyMG_!!2206789229493-0-cib.jpg",		"brand": "",		"brandId": "",		"rootCatId": 10166,		"cid": 1031920,		"desc": "<div id=\"offer-template-0\"></div><div  title=\"SHOPTOOL_POSITION_TOP_BEGIN\">&nbsp;</div>\r\n<div  title=\"SHOPTOOL_关联营销_596355_BEGIN\">&nbsp;</div>\r\n<table border=\"0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n<tbody>\r\n<tr>\r\n<td >&nbsp;</td>\r\n</tr>\r\n<tr>\r\n<td width=\"187\" valign=\"midden\" > <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01MXHvva2JzqwSWw6Tt_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td >&nbsp;</td>\r\n<td width=\"187\" valign=\"midden\" > <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01NicsJa2JzqwBA3O1v_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td >&nbsp;</td>\r\n<td width=\"187\" valign=\"midden\" > <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01t6E8Jr2JzqwDCrTWE_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td >&nbsp;</td>\r\n<td width=\"187\" valign=\"midden\" > <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01tuG2Pc2JzqwM75HcZ_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n</tr>\r\n<tr>\r\n<td >&nbsp;</td>\r\n</tr>\r\n<tr>\r\n<td width=\"187\" valign=\"midden\" > <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01pRFczP2Jzqw7bPT00_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td >&nbsp;</td>\r\n<td width=\"187\" valign=\"midden\" > <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01dYxlKE2Jzqw6wRPlI_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td >&nbsp;</td>\r\n<td width=\"187\" valign=\"midden\" > <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01fYP8SP2Jzqw60HCl9_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td >&nbsp;</td>\r\n<td width=\"187\" valign=\"midden\" > <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN017kiO7t2JzqvvVlSsn_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n</tr>\r\n<tr>\r\n<td >&nbsp;</td>\r\n</tr>\r\n<tr>\r\n<td width=\"187\" valign=\"midden\" > <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01xvVIG82Jzqvvrni7X_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td >&nbsp;</td>\r\n<td width=\"187\" valign=\"midden\" > <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01MphTHr2JzqviYTHzi_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td >&nbsp;</td>\r\n<td width=\"187\" valign=\"midden\" > <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01w8pp4d2JzqvBmU4m3_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td >&nbsp;</td>\r\n<td width=\"187\" valign=\"midden\" > <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01yTZK9n2JzqtFw7DJJ_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n</tr>\r\n<tr>\r\n<td >&nbsp;</td>\r\n</tr>\r\n<tr>\r\n<td width=\"187\" valign=\"midden\" > <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01nM9XGb2Jzqv7PL6NQ_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td >&nbsp;</td>\r\n<td width=\"187\" valign=\"midden\" > <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01qZdKqM2Jzquf6nwOs_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td >&nbsp;</td>\r\n<td width=\"187\" valign=\"midden\" > <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01QjSHw22JzquA05wX4_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n<td >&nbsp;</td>\r\n<td width=\"187\" valign=\"midden\" > <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01IoaSJe2Jzqu0d6F2J_!!2206789229493-0-cib.220x220.jpg\"/> </td>\r\n</tr>\r\n<tr>\r\n<td >&nbsp;</td>\r\n</tr>\r\n</tbody>\r\n</table>\r\n<div  title=\"SHOPTOOL_关联营销_596355_END\">&nbsp;</div>\r\n<div  title=\"SHOPTOOL_POSITION_TOP_END\">&nbsp;</div>\r\n<div><img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN0103fjbc2JzqvOqHU8e_!!2206789229493-0-cib.jpg\" alt=\"f50c6017-e4ad-4319-98f5-6f80cd34a677.jpe\"/> <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01zOP3TY2JzqvOuAEX9_!!2206789229493-0-cib.jpg\" alt=\"f87b0226-5bf2-48f3-ae09-df4457fde524.jpe\"/> <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01X44dwZ2JzqvPxPdKg_!!2206789229493-0-cib.jpg\" alt=\"203036b5-6059-4f3c-b8c8-fca49d35b20c.jpe\"/> <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01dqJ1Jh2JzqvOqGTl6_!!2206789229493-0-cib.jpg\" alt=\"663a91ee-9142-45ae-94c3-328e98ab94ae.jpe\"/> <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01CFMhoR2JzqvOPW3HU_!!2206789229493-0-cib.jpg\" alt=\"80306dc1-5eb4-447c-a464-b83d8246a1a2.jpe\"/> <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01DMMsMM2JzqvRSZ2Ao_!!2206789229493-0-cib.jpg\" alt=\"bb054391-c2d5-4592-86c7-f3134727d5a2.jpe\"/> <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01aroTHD2JzqvPgKzCK_!!2206789229493-0-cib.jpg\" alt=\"b05ca283-a76e-4d96-9453-9252117f0468.jpe\"/> <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01grQuzu2JzqvPxSqwW_!!2206789229493-0-cib.jpg\" alt=\"af19539d-d5b3-4c51-a927-4a1b40ad8af4.jpe\"/> <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01NUEyXr2JzqvPgVjeO_!!2206789229493-0-cib.jpg\" alt=\"74cb945b-31ab-4e7e-8953-d348171073e1.jpe\"/> <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN01f9ed1F2JzqvRSYdEk_!!2206789229493-0-cib.jpg\" alt=\"e5e0a61c-0324-4f18-830b-f17453ab49a2.jpe\"/> <img  src=\"https://cbu01.alicdn.com/img/ibank/O1CN011NSRWS2JzqvOPVRvQ_!!2206789229493-0-cib.jpg\" alt=\"d430b0e7-2c34-43ac-bb54-d7f2c7b08953.jpe\"/></div><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-1.69e8843ddc446&p=1778789846&k=i_key&t=1776845888\" style=\"display:none\" />",		"item_imgs": [
			{				"url": "https://cbu01.alicdn.com/img/ibank/O1CN011iB2gE2JzqvRBkyMG_!!2206789229493-0-cib.jpg"
			},
			{				"url": "https://cbu01.alicdn.com/img/ibank/O1CN01ENWxfP2JzqvK4Gx7l_!!2206789229493-0-cib.jpg"
			},
			{				"url": "https://cbu01.alicdn.com/img/ibank/O1CN014CUZd42JzqvQfMbXG_!!2206789229493-0-cib.jpg"
			},
			{				"url": "https://cbu01.alicdn.com/img/ibank/O1CN01pQXRde2JzqvOPVRuz_!!2206789229493-0-cib.jpg"
			},
			{				"url": "https://cbu01.alicdn.com/img/ibank/O1CN01Bas4472JzqvOu8pCq_!!2206789229493-0-cib.jpg"
			},
			{				"url": "https://cbu01.alicdn.com/img/ibank/O1CN01ZkBeoJ2JzqyxsHUXv_!!2206789229493-0-cib.jpg"
			},
			{				"url": "https://cbu01.alicdn.com/img/ibank/O1CN016pF3PA2JzqvPxS7DF_!!2206789229493-0-cib.jpg"
			},
			{				"url": "https://cbu01.alicdn.com/img/ibank/O1CN014J2BFH2JzqvPgT3LU_!!2206789229493-0-cib.jpg"
			},
			{				"url": "https://cbu01.alicdn.com/img/ibank/O1CN01s9LmR22JzqyxsJhm4_!!2206789229493-0-cib.jpg"
			},
			{				"url": "https://cbu01.alicdn.com/img/ibank/O1CN01AqAyz62JzqvQEXdh3_!!2206789229493-0-cib.jpg"
			},
			{				"url": "https://cbu01.alicdn.com/img/ibank/O1CN016vnonQ2JzqyxsHlBb_!!2206789229493-0-cib.jpg"
			},
			{				"url": "https://cbu01.alicdn.com/img/ibank/O1CN01dlb9Kb2Jzqz2a5TQL_!!2206789229493-0-cib.jpg"
			},
			{				"url": "https://cbu01.alicdn.com/img/ibank/O1CN01zP5XAN2JzqvQcIZXZ_!!2206789229493-0-cib.jpg"
			},
			{				"url": "https://cbu01.alicdn.com/img/ibank/O1CN0170N9hg2JzqvOuAMr8_!!2206789229493-0-cib.jpg"
			},
			{				"url": "https://cbu01.alicdn.com/img/ibank/O1CN01uwTic82Jzqz2pJD5s_!!2206789229493-0-cib.jpg"
			}
		],		"item_weight": null,		"location": "广东省汕头市",		"post_fee": null,		"express_fee": null,		"ems_fee": "",		"shipping_to": "",		"video": {			"url": "https://cloud.video.taobao.com/play/u/2206789229493/p/2/e/6/t/1/509480741609.mp4"
		},		"sample_id": "",		"props_name": "0:0:颜色:黑色【高质量-固定杯】113#;0:1:颜色:灰色【高质量-固定杯】113#;0:2:颜色:藏青色【高质量-固定杯】113#;0:3:颜色:白色【高质量-固定杯】113#;0:4:颜色:红色【高质量-固定杯】113#;0:5:颜色:黑色【高质量-固定杯】225#;0:6:颜色:白色【高质量-固定杯】225#;0:7:颜色:红色【高质量-固定杯】225#;0:8:颜色:杏色【高质量-固定杯】225#;0:9:颜色:粉色【高质量-固定杯】225#;1:0:尺码:均码（80-130斤）",		"prop_imgs": {			"prop_img": [
				{					"properties": "0:0",					"url": "https://cbu01.alicdn.com/img/ibank/O1CN014J2BFH2JzqvPgT3LU_!!2206789229493-0-cib.jpg"
				},
				{					"properties": "0:1",					"url": "https://cbu01.alicdn.com/img/ibank/O1CN0170N9hg2JzqvOuAMr8_!!2206789229493-0-cib.jpg"
				},
				{					"properties": "0:2",					"url": "https://cbu01.alicdn.com/img/ibank/O1CN01zP5XAN2JzqvQcIZXZ_!!2206789229493-0-cib.jpg"
				},
				{					"properties": "0:3",					"url": "https://cbu01.alicdn.com/img/ibank/O1CN01AqAyz62JzqvQEXdh3_!!2206789229493-0-cib.jpg"
				},
				{					"properties": "0:4",					"url": "https://cbu01.alicdn.com/img/ibank/O1CN016pF3PA2JzqvPxS7DF_!!2206789229493-0-cib.jpg"
				},
				{					"properties": "0:5",					"url": "https://cbu01.alicdn.com/img/ibank/O1CN01uwTic82Jzqz2pJD5s_!!2206789229493-0-cib.jpg"
				},
				{					"properties": "0:6",					"url": "https://cbu01.alicdn.com/img/ibank/O1CN01ZkBeoJ2JzqyxsHUXv_!!2206789229493-0-cib.jpg"
				},
				{					"properties": "0:7",					"url": "https://cbu01.alicdn.com/img/ibank/O1CN016vnonQ2JzqyxsHlBb_!!2206789229493-0-cib.jpg"
				},
				{					"properties": "0:8",					"url": "https://cbu01.alicdn.com/img/ibank/O1CN01dlb9Kb2Jzqz2a5TQL_!!2206789229493-0-cib.jpg"
				},
				{					"properties": "0:9",					"url": "https://cbu01.alicdn.com/img/ibank/O1CN01s9LmR22JzqyxsJhm4_!!2206789229493-0-cib.jpg"
				}
			]
		},		"property_alias": "0:0:黑色【高质量-固定杯】113#;0:1:灰色【高质量-固定杯】113#;0:2:藏青色【高质量-固定杯】113#;0:3:白色【高质量-固定杯】113#;0:4:红色【高质量-固定杯】113#;0:5:黑色【高质量-固定杯】225#;0:6:白色【高质量-固定杯】225#;0:7:红色【高质量-固定杯】225#;0:8:杏色【高质量-固定杯】225#;0:9:粉色【高质量-固定杯】225#;1:0:均码（80-130斤）",		"props": [
			{				"name": "主面料成分",				"value": "棉"
			},
			{				"name": "款式",				"value": "肩带款"
			},
			{				"name": "面料名称",				"value": "棉"
			},
			{				"name": "品牌",				"value": "鑫顺发"
			},
			{				"name": "弹力",				"value": "无弹"
			},
			{				"name": "衣长",				"value": "长款(80cm<衣长≤100cm)"
			},
			{				"name": "流行元素",				"value": "吊带"
			},
			{				"name": "版型",				"value": "A字型"
			},
			{				"name": "货号",				"value": "1132"
			},
			{				"name": "图案",				"value": "见详情"
			},
			{				"name": "上市年份/季节",				"value": "2025夏季"
			},
			{				"name": "颜色",				"value": "黑色【高质量-固定杯】113#,灰色【高质量-固定杯】113#,藏青色【高质量-固定杯】113#,白色【高质量-固定杯】113#,红色【高质量-固定杯】113#,黑色【高质量-固定杯】225#,白色【高质量-固定杯】225#,红色【高质量-固定杯】225#,杏色【高质量-固定杯】225#,粉色【高质量-固定杯】225#"
			},
			{				"name": "尺码",				"value": "均码（80-130斤）"
			},
			{				"name": "主面料成分含量",				"value": "95%及以上"
			},
			{				"name": "风格类型",				"value": "气质通勤"
			},
			{				"name": "货源类型",				"value": "国内一二线品牌"
			},
			{				"name": "吊牌",				"value": "无吊牌"
			},
			{				"name": "肩带样式",				"value": "Y型背带"
			},
			{				"name": "适用季节",				"value": "四季通用"
			},
			{				"name": "风格",				"value": "都市风"
			},
			{				"name": "是否跨境货源",				"value": "否"
			},
			{				"name": "领标",				"value": "已剪标"
			},
			{				"name": "主面料成分2含量",				"value": "30%（含）-50%（不含）"
			},
			{				"name": "主面料成分2",				"value": "棉/棉"
			}
		],		"total_sold": 1912,		"scale": null,		"sellUnit": null,		"skus": {			"sku": [
				{					"price": "12.98",					"total_price": 0,					"sales": 0,					"properties": "0:0;1:0",					"properties_name": "0:0:颜色:黑色【高质量-固定杯】113#;1:0:尺码:均码（80-130斤）",					"quantity": 12419,					"sku_id": 6221752915089,					"spec_id": "5908d52fa87098c2610a1f06428bf95b"
				},
				{					"price": "12.98",					"total_price": 0,					"sales": 0,					"properties": "0:1;1:0",					"properties_name": "0:1:颜色:灰色【高质量-固定杯】113#;1:0:尺码:均码（80-130斤）",					"quantity": 12320,					"sku_id": 6221752915090,					"spec_id": "ae1d8559cc7438c1305ddf1648f94946"
				},
				{					"price": "12.98",					"total_price": 0,					"sales": 0,					"properties": "0:2;1:0",					"properties_name": "0:2:颜色:藏青色【高质量-固定杯】113#;1:0:尺码:均码（80-130斤）",					"quantity": 12425,					"sku_id": 6221752915097,					"spec_id": "479acc82b24f10aef518eaba4c1971e9"
				},
				{					"price": "12.98",					"total_price": 0,					"sales": 0,					"properties": "0:3;1:0",					"properties_name": "0:3:颜色:白色【高质量-固定杯】113#;1:0:尺码:均码（80-130斤）",					"quantity": 12419,					"sku_id": 6221752915098,					"spec_id": "793e61669531b5b9870c733c94c3d742"
				},
				{					"price": "12.98",					"total_price": 0,					"sales": 0,					"properties": "0:4;1:0",					"properties_name": "0:4:颜色:红色【高质量-固定杯】113#;1:0:尺码:均码（80-130斤）",					"quantity": 12521,					"sku_id": 6221752915099,					"spec_id": "cfde65e181b1697824e9b4c22565937a"
				},
				{					"price": "12.98",					"total_price": 0,					"sales": 0,					"properties": "0:5;1:0",					"properties_name": "0:5:颜色:黑色【高质量-固定杯】225#;1:0:尺码:均码（80-130斤）",					"quantity": 12529,					"sku_id": 6221752915092,					"spec_id": "b5b6c5ed9e5e60ce0ae19895e75b6f0e"
				},
				{					"price": "12.98",					"total_price": 0,					"sales": 0,					"properties": "0:6;1:0",					"properties_name": "0:6:颜色:白色【高质量-固定杯】225#;1:0:尺码:均码（80-130斤）",					"quantity": 12524,					"sku_id": 6221752915093,					"spec_id": "e61214526ed20bd3169ac7abd527b686"
				},
				{					"price": "12.98",					"total_price": 0,					"sales": 0,					"properties": "0:7;1:0",					"properties_name": "0:7:颜色:红色【高质量-固定杯】225#;1:0:尺码:均码（80-130斤）",					"quantity": 12532,					"sku_id": 6221752915094,					"spec_id": "535c679013842afeb53fd4d94b55a6ee"
				},
				{					"price": "12.98",					"total_price": 0,					"sales": 0,					"properties": "0:8;1:0",					"properties_name": "0:8:颜色:杏色【高质量-固定杯】225#;1:0:尺码:均码（80-130斤）",					"quantity": 12535,					"sku_id": 6221752915095,					"spec_id": "e0b9600a93f0f4c77409eafe5d089369"
				},
				{					"price": "12.98",					"total_price": 0,					"sales": 0,					"properties": "0:9;1:0",					"properties_name": "0:9:颜色:粉色【高质量-固定杯】225#;1:0:尺码:均码（80-130斤）",					"quantity": 12538,					"sku_id": 6221752915096,					"spec_id": "a54231c03cdd679758f794f37fa307d0"
				}
			]
		},

返回列表

上一篇：1688拍立淘API接口：通过图片获取商品列表

没有最新的文章了...