使用 1688 开放平台 API 接口获取商品详情信息

作者：Noah

2023-11-20
江西
本文字数：8426 字
阅读完需：约 28 分钟

摘要：本文将介绍如何使用 1688 开放平台的 API 接口来获取商品详情信息。通过调用这些接口，您可以方便地获取商品的基本信息、价格、库存等数据，为您的业务提供强大的支持。

一、API 接口简介

1688 开放平台提供了丰富的 API 接口，帮助开发者快速实现各种业务需求。其中，商品详情信息的获取是很多业务场景中的基础功能。通过调用相应的 API 接口，您可以获取到商品的基本信息、价格、库存等数据，为您的业务提供强大的支持。

二、API 接口请求方式

1688 开放平台的 API 接口采用了 RESTful 设计风格，您可以通过 HTTP 协议的 GET 和 POST 方法来调用这些接口。为了确保数据的安全性，建议您使用 HTTPS 协议进行请求。

三、获取商品详情信息的 API 接口

要获取商品详情信息，您需要调用以下 API 接口：

商品详细信息查询接口（product_get）：通过商品 ID 获取商品的详细信息。
商品属性查询接口（product_attribute_get）：通过商品 ID 和属性 ID 获取商品的属性值。
商品图片查询接口（product_image_get）：通过商品 ID 和图片类型获取商品的图片信息。

四、API 接口参数说明

1688.item_get

公共参数

请求参数

请求参数：num_iid=555696089192

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

响应参数

Version: Date:

五、API 接口返回结果示例

商品详细信息查询接口（product_get）返回结果示例：

Result Object:---------------------------------------{	"item": {		"num_iid": "555696089192",		"title": "秋冬中长款毛衣套头女韩版宽松蝙蝠袖针织衫加厚外套高领冬季女装",		"desc_short": "",		"price": "65.00",		"total_price": 0,		"suggestive_price": 0,		"orginal_price": "65.00",		"nick": "彤彤毛衫工厂店",		"num": "5111",		"min_num": "1",		"detail_url": "https://detail.1688.com/offer/555696089192.html",		"pic_url": "https://cbu01.alicdn.com/img/ibank/2020/194/896/20708698491_1110747443.jpg",		"brand": "",		"brandId": "",		"rootCatId": "10166",		"cid": "127386001",		"crumbs": [],		"created_time": "",		"modified_time": "",		"delist_time": "",		"desc": "<div id=\"offer-template-0\"></div><p></p>\r\n<table border=\"0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n<tbody>\r\n<tr>\r\n<td colspan=\"3\">\r\n<div ><strong >店铺推荐</strong><img src=\"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png\" width=\"25%\"/></div>\r\n</td>\r\n</tr>\r\n<tr>\r\n<td >\r\n<table border=\"0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n<tbody>\r\n<tr>\r\n<td align=\"center\"><img src=\"https://cbu01.alicdn.com/img/ibank/2020/228/579/19656975822_1110747443.310x310.jpg\" width=\"100%\"/></td>\r\n</tr>\r\n<tr>\r\n<td align=\"center\" ><span >抢购价</span><span >￥55.00</span><img src=\"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png\" width=\"60%\"/></td>\r\n</tr>\r\n</tbody>\r\n</table>\r\n</td>\r\n<td >\r\n<table border=\"0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n<tbody>\r\n<tr>\r\n<td align=\"center\"><img src=\"https://cbu01.alicdn.com/img/ibank/2019/804/385/12464583408_1110747443.310x310.jpg\" width=\"100%\"/></td>\r\n</tr>\r\n<tr>\r\n<td align=\"center\" ><span >抢购价</span><span >￥65.00</span><img src=\"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png\" width=\"60%\"/></td>\r\n</tr>\r\n</tbody>\r\n</table>\r\n</td>\r\n<td >\r\n<table border=\"0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n<tbody>\r\n<tr>\r\n<td align=\"center\"><img src=\"https://cbu01.alicdn.com/img/ibank/2018/873/001/9261100378_1961146388.310x310.jpg\" width=\"100%\"/></td>\r\n</tr>\r\n<tr>\r\n<td align=\"center\" ><span >抢购价</span><span >￥55.00</span><img src=\"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png\" width=\"60%\"/></td>\r\n</tr>\r\n</tbody>\r\n</table>\r\n</td>\r\n</tr>\r\n<tr>\r\n<td >\r\n<table border=\"0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n<tbody>\r\n<tr>\r\n<td align=\"center\"><img src=\"https://cbu01.alicdn.com/img/ibank/2019/126/974/12313479621_1110747443.310x310.jpg\" width=\"100%\"/></td>\r\n</tr>\r\n<tr>\r\n<td align=\"center\" ><span >抢购价</span><span >￥68.00</span><img src=\"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png\" width=\"60%\"/></td>\r\n</tr>\r\n</tbody>\r\n</table>\r\n</td>\r\n<td >\r\n<table border=\"0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n<tbody>\r\n<tr>\r\n<td align=\"center\"><img src=\"https://cbu01.alicdn.com/img/ibank/2020/488/754/20495457884_1110747443.310x310.jpg\" width=\"100%\"/></td>\r\n</tr>\r\n<tr>\r\n<td align=\"center\" ><span >抢购价</span><span >￥62.00</span><img src=\"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png\" width=\"60%\"/></td>\r\n</tr>\r\n</tbody>\r\n</table>\r\n</td>\r\n<td >\r\n<table border=\"0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n<tbody>\r\n<tr>\r\n<td align=\"center\"><img src=\"https://cbu01.alicdn.com/img/ibank/2020/956/251/20430152659_1110747443.310x310.jpg\" width=\"100%\"/></td>\r\n</tr>\r\n<tr>\r\n<td align=\"center\" ><span >抢购价</span><span >￥60.00</span><img src=\"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png\" width=\"60%\"/></td>\r\n</tr>\r\n</tbody>\r\n</table>\r\n</td>\r\n</tr>\r\n<tr>\r\n<td >\r\n<table border=\"0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n<tbody>\r\n<tr>\r\n<td align=\"center\"><img src=\"https://cbu01.alicdn.com/img/ibank/2020/426/727/22450727624_1110747443.310x310.jpg\" width=\"100%\"/></td>\r\n</tr>\r\n<tr>\r\n<td align=\"center\" ><span >抢购价</span><span >￥63.00</span><img src=\"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png\" width=\"60%\"/></td>\r\n</tr>\r\n</tbody>\r\n</table>\r\n</td>\r\n<td >\r\n<table border=\"0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n<tbody>\r\n<tr>\r\n<td align=\"center\"><img src=\"https://cbu01.alicdn.com/img/ibank/2020/194/896/20708698491_1110747443.310x310.jpg\" width=\"100%\"/></td>\r\n</tr>\r\n<tr>\r\n<td align=\"center\" ><span >抢购价</span><span >￥62.00</span><img src=\"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png\" width=\"60%\"/></td>\r\n</tr>\r\n</tbody>\r\n</table>\r\n</td>\r\n<td >\r\n<table border=\"0\" cellpadding=\"0\" cellspacing=\"0\" >\r\n<tbody>\r\n<tr>\r\n<td align=\"center\"><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01uWZKGY1MJCH63kqJf_!!6000000001413-0-cib.310x310.jpg\" width=\"100%\"/></td>\r\n</tr>\r\n<tr>\r\n<td align=\"center\" ><span >抢购价</span><span >￥63.00</span><img src=\"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png\" width=\"60%\"/></td>\r\n</tr>\r\n</tbody>\r\n</table>\r\n</td>\r\n</tr>\r\n</tbody>\r\n</table>\r\n<p></p>\r\n<div>\r\n<div >\r\n<div><img src=\"https://cbu01.alicdn.com/img/ibank/2020/043/884/20632488340_1110747443.jpg\" alt=\"undefined\"/><br/><br/><img src=\"https://cbu01.alicdn.com/img/ibank/2020/273/107/20708701372_1110747443.jpg\" alt=\"undefined\" width=\"790\" height=\"790\"/><br/><br/><img src=\"https://cbu01.alicdn.com/img/ibank/2020/919/764/20632467919_1110747443.jpg\" alt=\"undefined\" width=\"790\" height=\"790\"/><br/><br/><img src=\"https://cbu01.alicdn.com/img/ibank/2020/194/896/20708698491_1110747443.jpg\" alt=\"undefined\" width=\"790\" height=\"790\"/><br/><br/><img src=\"https://cbu01.alicdn.com/img/ibank/2020/188/186/20789681881_1110747443.jpg\" alt=\"undefined\" width=\"790\" height=\"790\"/><br/><br/><img src=\"https://cbu01.alicdn.com/img/ibank/2020/588/464/20632464885_1110747443.jpg\" alt=\"undefined\" width=\"790\" height=\"790\"/><br/><br/><img src=\"https://cbu01.alicdn.com/img/ibank/2020/162/194/20632491261_1110747443.jpg\" alt=\"undefined\" width=\"790\" height=\"790\"/><br/><br/><img src=\"https://cbu01.alicdn.com/img/ibank/2020/898/674/20632476898_1110747443.jpg\" alt=\"undefined\" width=\"790\" height=\"790\"/><br/><br/><img src=\"https://cbu01.alicdn.com/img/ibank/2020/774/717/20789717477_1110747443.jpg\" alt=\"undefined\" width=\"790\" height=\"790\"/><br/><br/><img src=\"https://cbu01.alicdn.com/img/ibank/2020/780/005/20632500087_1110747443.jpg\" alt=\"undefined\" width=\"790\" height=\"790\"/><br/><br/><img src=\"https://cbu01.alicdn.com/img/ibank/2020/390/227/20708722093_1110747443.jpg\" alt=\"undefined\" width=\"790\" height=\"790\"/><br/><br/><img src=\"https://cbu01.alicdn.com/img/ibank/2020/189/686/20708686981_1110747443.jpg\" alt=\"undefined\" width=\"790\" height=\"790\"/><br/><br/><img src=\"https://cbu01.alicdn.com/img/ibank/2019/424/441/12783144424_1110747443.jpg\" alt=\"11802556403_1110747443\" width=\"790\" height=\"790\"/><br/><br/><img src=\"https://cbu01.alicdn.com/img/ibank/2019/617/080/12821080716_1110747443.jpg\" alt=\"11766705266_1110747443\"/></div>\r\n</div>\r\n</div><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-4.655af08dbcb72&p=1032056093&k=i_key&t=1700458640\" style=\"display:none\" />",		"desc_img": [			"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",			"https://cbu01.alicdn.com/img/ibank/2020/228/579/19656975822_1110747443.310x310.jpg",			"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",			"https://cbu01.alicdn.com/img/ibank/2019/804/385/12464583408_1110747443.310x310.jpg",			"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",			"https://cbu01.alicdn.com/img/ibank/2018/873/001/9261100378_1961146388.310x310.jpg",			"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",			"https://cbu01.alicdn.com/img/ibank/2019/126/974/12313479621_1110747443.310x310.jpg",			"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",			"https://cbu01.alicdn.com/img/ibank/2020/488/754/20495457884_1110747443.310x310.jpg",			"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",			"https://cbu01.alicdn.com/img/ibank/2020/956/251/20430152659_1110747443.310x310.jpg",			"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",			"https://cbu01.alicdn.com/img/ibank/2020/426/727/22450727624_1110747443.310x310.jpg",			"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",			"https://cbu01.alicdn.com/img/ibank/2020/194/896/20708698491_1110747443.310x310.jpg",			"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",			"https://cbu01.alicdn.com/img/ibank/O1CN01uWZKGY1MJCH63kqJf_!!6000000001413-0-cib.310x310.jpg",			"https://img.alicdn.com/imgextra/i4/36030596/TB2wVmOXi2mJKJjy0FhXXckoXXa-36030596.png",			"https://cbu01.alicdn.com/img/ibank/2020/043/884/20632488340_1110747443.jpg",			"https://cbu01.alicdn.com/img/ibank/2020/273/107/20708701372_1110747443.jpg",			"https://cbu01.alicdn.com/img/ibank/2020/919/764/20632467919_1110747443.jpg",			"https://cbu01.alicdn.com/img/ibank/2020/194/896/20708698491_1110747443.jpg",			"https://cbu01.alicdn.com/img/ibank/2020/188/186/20789681881_1110747443.jpg",			"https://cbu01.alicdn.com/img/ibank/2020/588/464/20632464885_1110747443.jpg",			"https://cbu01.alicdn.com/img/ibank/2020/162/194/20632491261_1110747443.jpg",			"https://cbu01.alicdn.com/img/ibank/2020/898/674/20632476898_1110747443.jpg",			"https://cbu01.alicdn.com/img/ibank/2020/774/717/20789717477_1110747443.jpg",			"https://cbu01.alicdn.com/img/ibank/2020/780/005/20632500087_1110747443.jpg",			"https://cbu01.alicdn.com/img/ibank/2020/390/227/20708722093_1110747443.jpg",			"https://cbu01.alicdn.com/img/ibank/2020/189/686/20708686981_1110747443.jpg",			"https://cbu01.alicdn.com/img/ibank/2019/424/441/12783144424_1110747443.jpg",			"https://cbu01.alicdn.com/img/ibank/2019/617/080/12821080716_1110747443.jpg"		],		"item_imgs": [			{				"url": "https://cbu01.alicdn.com/img/ibank/2020/194/896/20708698491_1110747443.jpg"			},			{				"url": "https://cbu01.alicdn.com/img/ibank/2020/162/194/20632491261_1110747443.jpg"			},			{				"url": "https://cbu01.alicdn.com/img/ibank/2020/774/717/20789717477_1110747443.jpg"			},			{				"url": "https://cbu01.alicdn.com/img/ibank/2020/898/674/20632476898_1110747443.jpg"			},			{				"url": "https://cbu01.alicdn.com/img/ibank/O1CN01xJUT56253lrhwwoz5_!!2669477471-0-cib.jpg"			}		],		"item_weight": "",		"item_size": "",		"location": "浙江省嘉兴市",		"post_fee": 4,		"express_fee": "",		"ems_fee": "",		"shipping_to": "",		"has_discount": "",		"video": "https://cloud.video.taobao.com/play/u/2669477471/p/2/e/6/t/1/418132488730.mp4",		"is_virtual": "",		"sample_id": "",		"is_promotion": "",		"props_name": "0:0:颜色:红色;0:1:颜色:黑色;1:0:尺码:一件可拍  均码",		"prop_imgs": {			"prop_img": [				{					"properties": "0:0",					"url": "https://cbu01.alicdn.com/img/ibank/2020/194/896/20708698491_1110747443.jpg"				},				{					"properties": "0:1",					"url": "https://cbu01.alicdn.com/img/ibank/2020/898/674/20632476898_1110747443.jpg"				}			]		},		"property_alias": "0:0:红色;0:1:黑色;1:0:一件可拍  均码",		"props": [			{				"name": "货号",				"show": false,				"value": "HH-158-100"			},			{				"name": "面料名称",				"show": false,				"value": "针织混纺"			},			{				"name": "主面料成分2",				"show": false,				"value": "聚酯纤维（涤纶）"			},			{				"name": "主面料成分",				"show": false,				"value": "腈纶"			},			{				"name": "图案",				"show": false,				"value": "纯色"			},			{				"name": "厚薄",				"show": false,				"value": "厚"			},			{				"name": "组合形式",				"show": false,				"value": "单件"			},			{				"name": "款式",				"show": false,				"value": "套头"			},			{				"name": "版型",				"show": false,				"value": "宽松型"			},			{				"name": "袖型",				"show": false,				"value": "常规袖"			},			{				"name": "上市年份/季节",				"show": false,				"value": "2023年秋季"			},			{				"name": "领型",				"show": false,				"value": "圆领"			},			{				"name": "袖长",				"show": false,				"value": "长袖"			},			{				"name": "流行元素",				"show": false,				"value": "螺纹"			},			{				"name": "衣长",				"show": false,				"value": "中长款(65cm<衣长≤80cm)"			},			{				"name": "工艺",				"show": false,				"value": "拼贴/拼接"			},			{				"name": "颜色",				"show": false,				"value": "红色,黑色"			},			{				"name": "尺码",				"show": false,				"value": "一件可拍  均码"			},			{				"name": "风格类型",				"show": false,				"value": "气质通勤"			},			{				"name": "穿着方式",				"show": false,				"value": "套头"			},			{				"name": "主面料成分含量",				"show": false,				"value": "50%（不含）-70%（含）"			},			{				"name": "门襟",				"show": false,				"value": "套头"			},			{				"name": "风格",				"show": false,				"value": "英伦风"			},			{				"name": "是否跨境货源",				"show": false,				"value": "否"			}		],		"total_sold": null,		"skus": {			"sku": [				{					"price": "65.00",					"total_price": 0,					"sales": "4297",					"properties": "0:0;1:0",					"properties_name": "0:0:颜色:红色;1:0:尺码:一件可拍  均码",					"quantity": "1589",					"sku_id": "4730262673752",					"spec_id": "5662a10e8283586509b22afca62d332b"				},				{					"price": "65.00",					"total_price": 0,					"sales": "2362",					"properties": "0:1;1:0",					"properties_name": "0:1:颜色:黑色;1:0:尺码:一件可拍  均码",					"quantity": "3522",					"sku_id": "4730262673753",					"spec_id": "7cb4420f14f7a9ae00c0255d75ff75b4"				}			]		},		"seller_id": "2669477471",		"sales": 1790,		"shop_id": "2669477471",		"props_list": {			"0:0": "颜色:红色",			"0:1": "颜色:黑色",			"1:0": "尺码:一件可拍  均码"		},		"seller_info": {			"nick": "彤彤毛衫工厂店",			"user_num_id": "2669477471",			"sid": "b2b-266947747195f05",			"title": "嘉兴市秀洲区洪合镇美彤服装厂",			"zhuy": "https://winport.m.1688.com/page/index.html?memberId=b2b-266947747195f05",			"shop_name": "彤彤毛衫工厂店"		},		"tmall": "false",		"error": "",		"warning": "",		"url_log": [],		"unit": null,		"is_support_mix": "true",		"mix_amount": "1",		"mix_begin": "0",		"mix_number": "2147483647",		"scale": "",		"sellUnit": "件",		"props_img": {			"0:0": "https://cbu01.alicdn.com/img/ibank/2020/194/896/20708698491_1110747443.jpg",			"0:1": "https://cbu01.alicdn.com/img/ibank/2020/898/674/20632476898_1110747443.jpg"		},		"sales_data": null,		"priceRange": [			[				"1",				"65.00"			],			[				"10",				"64.00"			],			[				"50",				"62.00"			]		],		"priceRangeOriginal": [],		"_ddf": "ti",		"sales_info": {			"seller_num": "",			"repeat_rate_purchase": "",			"per_capita_purchases": "",			"comment_num": "",			"comment_url": ""		},		"format_check": "ok",		"shop_item": [],		"relate_items": []	},	"error": "",	"secache": "95fc21debe6c629e941d808b214a3b07",	"secache_time": 1700458640,	"secache_date": "2023-11-20 13:37:20",	"translate_status": "",	"translate_time": 0,	"language": {		"default_lang": "cn",		"current_lang": "cn"	},	"reason": "",	"error_code": "0000",

复制代码

发布于: 刚刚阅读数: 5

Noah

关注

如果您对电商API感兴趣可联系我 2023-09-21 加入

我是一名IT领域的专家，拥有多年的从业经验。作为一名CSDN/掘金等平台优质作者，我细心研究最新的技术趋势，并将其成功应用于实际项目中。同时，我擅长于IT方面的API接口技术。

发布

暂无评论

创作场景