一、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接口参数说明
返回数据： 请求示例
{
"item": {
"num_iid": "570076908845",
"title": "2023夏季新款女装韩版连衣裙印花女中长款短袖t恤女学生上衣打底",
"desc_short": "",
"price": "9.50",
"total_price": 0,
"suggestive_price": 0,
"orginal_price": "10.50",
"nick": "鹏发制衣厂",
"num": "48430",
"min_num": "1",
"detail_url": "https://detail.1688.com/offer/570076908845.html",
"pic_url": "https://cbu01.alicdn.com/img/ibank/2018/087/474/8898474780_1830039265.jpg",
"brand": "",
"brandId": "",
"rootCatId": "10166",
"cid": "1031919",
"crumbs": [],
"created_time": "",
"modified_time": "",
"delist_time": "",
"desc": "<div id=\"offer-template-0\"></div><p><img src=\"https://cbu01.alicdn.com/img/ibank/2018/364/997/8935799463_1830039265.jpg\" align=\"absmiddle\"/><img src=\"https://cbu01.alicdn.com/img/ibank/2018/187/474/8898474781_1830039265.jpg\" align=\"absmiddle\"/><img src=\"https://cbu01.alicdn.com/img/ibank/2018/464/997/8935799464_1830039265.jpg\" align=\"absmiddle\"/><img src=\"https://cbu01.alicdn.com/img/ibank/2018/960/632/8918236069_1830039265.jpg\" align=\"absmiddle\"/><img src=\"https://cbu01.alicdn.com/img/ibank/2018/079/277/8935772970_1830039265.jpg\" align=\"absmiddle\"/><img src=\"https://cbu01.alicdn.com/img/ibank/2018/817/444/8898444718_1830039265.jpg\" align=\"absmiddle\"/><img src=\"https://cbu01.alicdn.com/img/ibank/2018/475/564/8898465574_1830039265.jpg\" align=\"absmiddle\"/><img src=\"https://cbu01.alicdn.com/img/ibank/2018/558/397/8935793855_1830039265.jpg\" align=\"absmiddle\"/><img src=\"https://cbu01.alicdn.com/img/ibank/2018/416/967/8935769614_1830039265.jpg\" align=\"absmiddle\"/><img src=\"https://cbu01.alicdn.com/img/ibank/2018/027/444/8898444720_1830039265.jpg\" align=\"absmiddle\"/><img src=\"https://cbu01.alicdn.com/img/ibank/2018/202/405/8898504202_1830039265.jpg\" align=\"absmiddle\"/></p>\r\n<div >...........</div><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-1.655c4c98aa7cd&p=1032056093&k=i_key&t=1700547741\" style=\"display:none\" />",
"desc_img": [
"https://cbu01.alicdn.com/img/ibank/2018/364/997/8935799463_1830039265.jpg",
"https://cbu01.alicdn.com/img/ibank/2018/187/474/8898474781_1830039265.jpg",
"https://cbu01.alicdn.com/img/ibank/2018/464/997/8935799464_1830039265.jpg",
"https://cbu01.alicdn.com/img/ibank/2018/960/632/8918236069_1830039265.jpg",
"https://cbu01.alicdn.com/img/ibank/2018/079/277/8935772970_1830039265.jpg",
"https://cbu01.alicdn.com/img/ibank/2018/817/444/8898444718_1830039265.jpg",
"https://cbu01.alicdn.com/img/ibank/2018/475/564/8898465574_1830039265.jpg",
"https://cbu01.alicdn.com/img/ibank/2018/558/397/8935793855_1830039265.jpg",
"https://cbu01.alicdn.com/img/ibank/2018/416/967/8935769614_1830039265.jpg",
"https://cbu01.alicdn.com/img/ibank/2018/027/444/8898444720_1830039265.jpg",
"https://cbu01.alicdn.com/img/ibank/2018/202/405/8898504202_1830039265.jpg"
],
"item_imgs": [
{
"url": "https://cbu01.alicdn.com/img/ibank/2018/087/474/8898474780_1830039265.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/2018/027/444/8898444720_1830039265.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/2019/886/157/10421751688_1830039265.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/2019/531/521/10448125135_1830039265.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/2019/405/397/10421793504_1830039265.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/2018/817/444/8898444718_1830039265.jpg"
}
],
"item_weight": "",
"item_size": "",
"location": "广东揭阳",
"post_fee": 3,
"express_fee": "",
"ems_fee": "",
"shipping_to": "",
"has_discount": "",
"video": "https://cloud.video.taobao.com/play/u/2204599425/p/2/e/6/t/1/315338923798.mp4",
"is_virtual": "",
"sample_id": "",
"is_promotion": "",
"props_name": "0:0:颜色:黑色;0:1:颜色:白色;1:0:尺码:M;1:1:尺码:L;1:2:尺码:XL;1:3:尺码:XXL;1:4:尺码:3XL",
"prop_imgs": {
"prop_img": [
{
"properties": "0:0",
"url": "https://cbu01.alicdn.com/img/ibank/2018/027/444/8898444720_1830039265.jpg"
},
{
"properties": "0:1",
"url": "https://cbu01.alicdn.com/img/ibank/2018/817/444/8898444718_1830039265.jpg"
}
]
},
"property_alias": "0:0:黑色;0:1:白色;1:0:M;1:1:L;1:2:XL;1:3:XXL;1:4:3XL",
"props": [
{
"name": "面料名称",
"show": false,
"value": "牛奶丝"
},
{
"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": "903#"
},
{
"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": "2023年夏季"
},
{
"name": "颜色",
"show": false,
"value": "黑色,白色"
},
{
"name": "尺码",
"show": false,
"value": "M,L,XL,XXL,3XL"
},
{
"name": "风格类型",
"show": false,
"value": "气质通勤"
},
{
"name": "主面料成分含量",
"show": false,
"value": "90%（不含）-95%（含）"
},
{
"name": "风格",
"show": false,
"value": "通勤风"
},
{
"name": "跨境风格类型",
"show": false,
"value": "气质优雅"
},
{
"name": "是否跨境货源",
"show": false,
"value": "是"
},
{
"name": "主面料成分2含量",
"show": false,
"value": "90%（不含）-95%（含）"
},
{
"name": "主要下游销售地区1",
"show": false,
"value": "欧美"
},
{
"name": "主要下游销售地区2",
"show": false,
"value": "东南亚"
}
],
"total_sold": null,
"skus": {
"sku": [
{
"price": "10.50",
"total_price": 0,
"sales": "8391",
"properties": "0:0;1:0",
"properties_name": "0:0:颜色:黑色;1:0:尺码:M",
"quantity": "4035",
"sku_id": "3672970980984",
"spec_id": "4b2120e532948daa11e58e09bb260801"
},
{
"price": "10.50",
"total_price": 0,
"sales": "7529",
"properties": "0:0;1:1",
"properties_name": "0:0:颜色:黑色;1:1:尺码:L",
"quantity": "4166",
"sku_id": "3672970980986",
"spec_id": "b99ece08861a79e13a4dba90e97ebff8"
},
{
"price": "10.50",
"total_price": 0,
"sales": "6742",
"properties": "0:0;1:2",
"properties_name": "0:0:颜色:黑色;1:2:尺码:XL",
"quantity": "4914",
"sku_id": "3672970980988",
"spec_id": "5c337082186ff55b2d8267560ac89d59"
},
{
"price": "10.50",
"total_price": 0,
"sales": "3384",
"properties": "0:0;1:3",
"properties_name": "0:0:颜色:黑色;1:3:尺码:XXL",
"quantity": "6911",
"sku_id": "3843956243934",
"spec_id": "dc048f4577f72dd6b932615edef1fab6"
},
{
"price": "10.50",
"total_price": 0,
"sales": "2713",
"properties": "0:0;1:4",
"properties_name": "0:0:颜色:黑色;1:4:尺码:3XL",
"quantity": "2874",
"sku_id": "3954190437042",
"spec_id": "4488bdac02f75a3cbe99ddaa5eb60838"
},
{
"price": "10.50",
"total_price": 0,
"sales": "5517",
"properties": "0:1;1:0",
"properties_name": "0:1:颜色:白色;1:0:尺码:M",
"quantity": "5457",
"sku_id": "3672970980983",
"spec_id": "cef93beef156f1799e736c649f36efae"
},
{
"price": "10.50",
"total_price": 0,
"sales": "5365",
"properties": "0:1;1:1",
"properties_name": "0:1:颜色:白色;1:1:尺码:L",
"quantity": "5585",
"sku_id": "3672970980985",
"spec_id": "82114cbd2c10b5e97b01af1510807e2d"
},
{
"price": "10.50",
"total_price": 0,
"sales": "4510",
"properties": "0:1;1:2",
"properties_name": "0:1:颜色:白色;1:2:尺码:XL",
"quantity": "6285",
"sku_id": "3672970980987",
"spec_id": "c45d8408137e34adf8e695250c42a2e9"
},
{
"price": "10.50",
"total_price": 0,
"sales": "2188",
"properties": "0:1;1:3",
"properties_name": "0:1:颜色:白色;1:3:尺码:XXL",
"quantity": "7705",
"sku_id": "3843956243933",
"spec_id": "df78564262818d6eb0c428a37ab4a251"
},
{
"price": "10.50",
"total_price": 0,
"sales": "1737",
"properties": "0:1;1:4",
"properties_name": "0:1:颜色:白色;1:4:尺码:3XL",
"quantity": "498",
"sku_id": "3954190437041",
"spec_id": "f10897bb259d8dcf6717ed95fd2cfb95"
}
]
},
"seller_id": "2204599425",
"sales": 2882,
"shop_id": "2204599425",
"props_list": {
"0:0": "颜色:黑色",
"0:1": "颜色:白色",
"1:0": "尺码:M",
"1:1": "尺码:L",
"1:2": "尺码:XL",
"1:3": "尺码:XXL",
"1:4": "尺码:3XL"
},
"seller_info": {
"nick": "鹏发制衣厂",
"user_num_id": "2204599425",
"sid": "b2b-2204599425",
"title": "汕头鹏发服装实力供应商",
"zhuy": "https://winport.m.1688.com/page/index.html?memberId=b2b-2204599425",
"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/2018/027/444/8898444720_1830039265.jpg",
"0:1": "https://cbu01.alicdn.com/img/ibank/2018/817/444/8898444718_1830039265.jpg"
},
"sales_data": null,
"priceRange": [
[
"1",
"10.50"
],
[
"50",
"10.00"
],
[
"500",
"9.50"
]
],
"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": "3705ef5a309b3740ed93a4be9ddd7d64",
"secache_time": 1700547741,
"secache_date": "2023-11-21 14:22:21",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:95 max:10000 all[328=95+173+60];expires:2030-12-31",
"execution_time": "4.514",
"server_time": "Beijing/2023-11-21 14:22:21",
"client_ip": "61.131.237.29",
"call_args": {
"num_iid": "570076908845"
},
"api_type": "1688",
"translate_language": "zh-CN",
"translate_engine": "baidu",
"server_memory": "3.59MB",
"request_id": "gw-1.655c4c98aa7cd",
"last_id": "2293375807"
}
