1688API接口采集
接口列表
请求示例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_get-获得1688商品详情
请求参数
请求参数:num_iid=679068178178
参数说明:num_iid:1688商品ID
sales_data:&sales_data=1 获取近30天成交数据
agent:&agent=1 获取1688分销代发价格数据
名称 | 类型 | 必须 | 描述 |
---|---|---|---|
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版本 |
Request address:
https://api-1.onebound.cn/1688/item_get/?key=t&
&num_iid=679068178178&cache=no&&lang=zh-CN&secret=
---------------------------------------
Result Object:
---------------------------------------
{
"item": {
"num_iid": "679068178178",
"title": "素予 早秋2022新款简约多色圆领衬衫韩版宽松慵懒长袖上衣女2714",
"desc_short": "",
"price": "75.00",
"total_price": 0,
"suggestive_price": 0,
"orginal_price": "78.00",
"nick": "Soul Detail实力旗舰店",
"num": "17528",
"min_num": "2",
"detail_url": "https://detail.1688.com/offer/679068178178.html",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN01KpSLgE1NtDAMQQsEw_!!2207720171627-0-cib.jpg",
"brand": "",
"brandId": "",
"rootCatId": "10166",
"cid": "1031918",
"crumbs": [],
"created_time": "",
"modified_time": "",
"delist_time": "",
"desc": "<div id=\"offer-template-0\"></div><p><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01w6f76Q1NtDADOuMrS_!!2207720171627-0-cib.jpg?__r__=1657963044130\" alt=\"2714商品信息_01.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01bRvyFn1NtDADOvuUX_!!2207720171627-0-cib.jpg?__r__=1657963044131\" alt=\"2714商品信息_02.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01Zh6Bly1NtDATVpPmi_!!2207720171627-0-cib.jpg?__r__=1657963044131\" alt=\"2714商品信息_03.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01oAwiZj1NtDATVn06x_!!2207720171627-0-cib.jpg?__r__=1657963044131\" alt=\"2714商品信息_05.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01kdB7oO1NtDATVnjrL_!!2207720171627-0-cib.jpg?__r__=1657963044131\" alt=\"2714商品信息_06.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01iFBse11NtDASK1jjz_!!2207720171627-0-cib.jpg?__r__=1657963044131\" alt=\"2714商品信息_07.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01lb0WDB1NtDADOwFJL_!!2207720171627-0-cib.jpg?__r__=1657963044131\" alt=\"2714商品信息_08.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01VZIYIo1NtDARTbl1V_!!2207720171627-0-cib.jpg?__r__=1657963044131\" alt=\"2714商品信息_12_01.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01MXJnEj1NtDAIH8JFt_!!2207720171627-0-cib.jpg?__r__=1657963044131\" alt=\"2714商品信息_12_02.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01txWtUo1NtDASK4kpK_!!2207720171627-0-cib.jpg?__r__=1657963047953\" alt=\"2714商品信息_12_03.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01iieVj61NtDASK4DbB_!!2207720171627-0-cib.jpg?__r__=1657963047953\" alt=\"2714商品信息_12_04.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN013n52Uz1NtDAPHF7Bu_!!2207720171627-0-cib.jpg?__r__=1658030111838\" alt=\"2714231C模特排版_01.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01bpDSRI1NtDAUKfB7S_!!2207720171627-0-cib.jpg?__r__=1658030111838\" alt=\"2714231C模特排版_02.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN0123Knsf1NtDAOo3R4k_!!2207720171627-0-cib.jpg?__r__=1658030111838\" alt=\"2714231C模特排版_03.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01BHURt31NtDAUKeZhJ_!!2207720171627-0-cib.jpg?__r__=1658030111838\" alt=\"2714231C模特排版_04.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01CSLtXO1NtDAUKheyf_!!2207720171627-0-cib.jpg?__r__=1658030111838\" alt=\"2714231C模特排版_05.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01SxZlyH1NtDAPHHGEq_!!2207720171627-0-cib.jpg?__r__=1658030111838\" alt=\"2714231C模特排版_06.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01tbcqeP1NtDAWPhJyW_!!2207720171627-0-cib.jpg?__r__=1658030111839\" alt=\"2714231C模特排版_07.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01N68Pfb1NtDAPHHfDP_!!2207720171627-0-cib.jpg?__r__=1658030111839\" alt=\"2714231C模特排版_08.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01lnPpu21NtDAUKibEw_!!2207720171627-0-cib.jpg?__r__=1658030111839\" alt=\"2714231C模特排版_09.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01BuIZ4V1NtDAUKeqOs_!!2207720171627-0-cib.jpg?__r__=1658030111839\" alt=\"2714231C模特排版_10.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01KNUmzE1NtDAKbp9M0_!!2207720171627-0-cib.jpg?__r__=1658030117685\" alt=\"2714231C模特排版_11.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01Asz3tN1NtDAQa7mmi_!!2207720171627-0-cib.jpg?__r__=1658030117685\" alt=\"2714231C模特排版_12.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01IgEL0Y1NtDAOo3hnt_!!2207720171627-0-cib.jpg?__r__=1658030117685\" alt=\"2714231C模特排版_13.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01ZzoDbo1NtDAUKgzT3_!!2207720171627-0-cib.jpg?__r__=1658030117685\" alt=\"2714231C模特排版_17.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN016MJ9AW1NtDAQa8WVd_!!2207720171627-0-cib.jpg?__r__=1658030117685\" alt=\"2714231C模特排版_18.jpg\"/></p><img src=\"https://www.o0b.cn/i.php?t.png&rid=1.632bd56cc8136&p=1778788030&k=i_key&t=1663817070\" style=\"display:none\" />",
"desc_img": [
"https://cbu01.alicdn.com/img/ibank/O1CN01w6f76Q1NtDADOuMrS_!!2207720171627-0-cib.jpg?__r__=1657963044130",
"https://cbu01.alicdn.com/img/ibank/O1CN01bRvyFn1NtDADOvuUX_!!2207720171627-0-cib.jpg?__r__=1657963044131",
"https://cbu01.alicdn.com/img/ibank/O1CN01Zh6Bly1NtDATVpPmi_!!2207720171627-0-cib.jpg?__r__=1657963044131",
"https://cbu01.alicdn.com/img/ibank/O1CN01oAwiZj1NtDATVn06x_!!2207720171627-0-cib.jpg?__r__=1657963044131",
"https://cbu01.alicdn.com/img/ibank/O1CN01kdB7oO1NtDATVnjrL_!!2207720171627-0-cib.jpg?__r__=1657963044131",
"https://cbu01.alicdn.com/img/ibank/O1CN01iFBse11NtDASK1jjz_!!2207720171627-0-cib.jpg?__r__=1657963044131",
"https://cbu01.alicdn.com/img/ibank/O1CN01lb0WDB1NtDADOwFJL_!!2207720171627-0-cib.jpg?__r__=1657963044131",
"https://cbu01.alicdn.com/img/ibank/O1CN01VZIYIo1NtDARTbl1V_!!2207720171627-0-cib.jpg?__r__=1657963044131",
"https://cbu01.alicdn.com/img/ibank/O1CN01MXJnEj1NtDAIH8JFt_!!2207720171627-0-cib.jpg?__r__=1657963044131",
"https://cbu01.alicdn.com/img/ibank/O1CN01txWtUo1NtDASK4kpK_!!2207720171627-0-cib.jpg?__r__=1657963047953",
"https://cbu01.alicdn.com/img/ibank/O1CN01iieVj61NtDASK4DbB_!!2207720171627-0-cib.jpg?__r__=1657963047953",
"https://cbu01.alicdn.com/img/ibank/O1CN013n52Uz1NtDAPHF7Bu_!!2207720171627-0-cib.jpg?__r__=1658030111838",
"https://cbu01.alicdn.com/img/ibank/O1CN01bpDSRI1NtDAUKfB7S_!!2207720171627-0-cib.jpg?__r__=1658030111838",
"https://cbu01.alicdn.com/img/ibank/O1CN0123Knsf1NtDAOo3R4k_!!2207720171627-0-cib.jpg?__r__=1658030111838",
"https://cbu01.alicdn.com/img/ibank/O1CN01BHURt31NtDAUKeZhJ_!!2207720171627-0-cib.jpg?__r__=1658030111838",
"https://cbu01.alicdn.com/img/ibank/O1CN01CSLtXO1NtDAUKheyf_!!2207720171627-0-cib.jpg?__r__=1658030111838",
"https://cbu01.alicdn.com/img/ibank/O1CN01SxZlyH1NtDAPHHGEq_!!2207720171627-0-cib.jpg?__r__=1658030111838",
"https://cbu01.alicdn.com/img/ibank/O1CN01tbcqeP1NtDAWPhJyW_!!2207720171627-0-cib.jpg?__r__=1658030111839",
"https://cbu01.alicdn.com/img/ibank/O1CN01N68Pfb1NtDAPHHfDP_!!2207720171627-0-cib.jpg?__r__=1658030111839",
"https://cbu01.alicdn.com/img/ibank/O1CN01lnPpu21NtDAUKibEw_!!2207720171627-0-cib.jpg?__r__=1658030111839",
"https://cbu01.alicdn.com/img/ibank/O1CN01BuIZ4V1NtDAUKeqOs_!!2207720171627-0-cib.jpg?__r__=1658030111839",
"https://cbu01.alicdn.com/img/ibank/O1CN01KNUmzE1NtDAKbp9M0_!!2207720171627-0-cib.jpg?__r__=1658030117685",
"https://cbu01.alicdn.com/img/ibank/O1CN01Asz3tN1NtDAQa7mmi_!!2207720171627-0-cib.jpg?__r__=1658030117685",
"https://cbu01.alicdn.com/img/ibank/O1CN01IgEL0Y1NtDAOo3hnt_!!2207720171627-0-cib.jpg?__r__=1658030117685",
"https://cbu01.alicdn.com/img/ibank/O1CN01ZzoDbo1NtDAUKgzT3_!!2207720171627-0-cib.jpg?__r__=1658030117685",
"https://cbu01.alicdn.com/img/ibank/O1CN016MJ9AW1NtDAQa8WVd_!!2207720171627-0-cib.jpg?__r__=1658030117685"
],
"item_imgs": [
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01KpSLgE1NtDAMQQsEw_!!2207720171627-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN012r0deM1NtDAB3ZSLz_!!2207720171627-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN012KX5vX1NtDARBbvOz_!!2207720171627-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01FnnwOL1NtDAP9337L_!!2207720171627-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01FmLtsZ1NtDAO8a0wo_!!2207720171627-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01ZK1dwE1NtDAELLDT7_!!2207720171627-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01IvZCTA1NtDAHUcF13_!!2207720171627-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01N46IjA1NtDALIRr7F_!!2207720171627-0-cib.jpg"
}
],
"item_weight": "",
"item_size": "",
"location": "广东省 广州市",
"post_fee": null,
"express_fee": "",
"ems_fee": "",
"shipping_to": "",
"has_discount": "",
"video": null,
"is_virtual": "",
"sample_id": "",
"is_promotion": "",
"props_name": "0:0:白色;0:1:淡紫;0:2:灰色;0:3:藏蓝;1:0:均码",
"prop_imgs": {
"prop_img": [
{
"properties": "0:0",
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01FmLtsZ1NtDAO8a0wo_!!2207720171627-0-cib.jpg"
},
{
"properties": "0:1",
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01ZK1dwE1NtDAELLDT7_!!2207720171627-0-cib.jpg"
},
{
"properties": "0:2",
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01IvZCTA1NtDAHUcF13_!!2207720171627-0-cib.jpg"
},
{
"properties": "0:3",
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01N46IjA1NtDALIRr7F_!!2207720171627-0-cib.jpg"
}
]
},
"property_alias": "0:0:白色;0:1:淡紫;0:2:灰色;0:3:藏蓝;1:0:均码",
"props": [
{
"name": "面料名称",
"show": false,
"value": "莱赛尔纤维"
},
{
"name": "主面料成分",
"show": false,
"value": "莱赛尔纤维"
},
{
"name": "图案",
"show": false,
"value": "纯色"
},
{
"name": "袖长",
"show": false,
"value": "长袖"
},
{
"name": "工艺",
"show": false,
"value": "高温定型"
},
{
"name": "货号",
"show": false,
"value": "2714231c-s05"
},
{
"name": "品牌",
"show": false,
"value": "Soul Detail"
},
{
"name": "版型",
"show": false,
"value": "宽松型"
},
{
"name": "衣长",
"show": false,
"value": "普通款(50cm<衣长≤65cm)"
},
{
"name": "领型",
"show": false,
"value": "圆领"
},
{
"name": "袖型",
"show": false,
"value": "常规袖"
},
{
"name": "上市年份/季节",
"show": false,
"value": "2022年秋季"
},
{
"name": "颜色",
"show": false,
"value": "白色,淡紫,灰色,藏蓝"
},
{
"name": "尺码",
"show": false,
"value": "均码"
},
{
"name": "风格类型",
"show": false,
"value": "日韩休闲"
},
{
"name": "门襟",
"show": false,
"value": "单排扣"
},
{
"name": "主面料成分含量",
"show": false,
"value": "90%(不含)-95%(含)"
},
{
"name": "风格",
"show": false,
"value": "休闲风,简约风,韩系风,冷淡风"
},
{
"name": "是否跨境货源",
"show": false,
"value": "否"
}
],
"total_sold": null,
"skus": {
"sku": [
{
"price": "78.00",
"total_price": 0,
"sales": "1801",
"properties": "0:0;1:0",
"properties_name": "0:0:颜色:白色;1:0:尺码:均码",
"quantity": "3059",
"sku_id": "5041306738458",
"spec_id": "9ce76d4e383faffd7829838ec03ad7c7"
},
{
"price": "78.00",
"total_price": 0,
"sales": "162",
"properties": "0:1;1:0",
"properties_name": "0:1:颜色:淡紫;1:0:尺码:均码",
"quantity": "4817",
"sku_id": "5041306738459",
"spec_id": "3e83c84e5594749f58e586de08ded5f0"
},
{
"price": "78.00",
"total_price": 0,
"sales": "299",
"properties": "0:2;1:0",
"properties_name": "0:2:颜色:灰色;1:0:尺码:均码",
"quantity": "4689",
"sku_id": "5041306738460",
"spec_id": "69725e1f0a17f9d0f02626717ad2a0be"
},
{
"price": "78.00",
"total_price": 0,
"sales": "33",
"properties": "0:3;1:0",
"properties_name": "0:3:颜色:藏蓝;1:0:尺码:均码",
"quantity": "4963",
"sku_id": "5041306738461",
"spec_id": "c13c7cd6d967dcbc1906c6b91d855714"
}
]
},
"seller_id": "2207720171627",
"sales": 2547,
"shop_id": "2207720171627",
"props_list": {
"0:0": "颜色:白色",
"0:1": "颜色:淡紫",
"0:2": "颜色:灰色",
"0:3": "颜色:藏蓝",
"1:0": "尺码:均码"
},
"seller_info": {
"nick": "Soul Detail实力旗舰店",
"user_num_id": "2207720171627",
"sid": "b2b-22077201716274375e",
"title": "Soul Detail实力旗舰店",
"zhuy": "https://winport.m.1688.com/page/index.html?memberId=b2b-22077201716274375e",
"shop_name": "Soul Detail实力旗舰店"
},
"tmall": "false",
"error": "",
"warning": "",
"url_log": [],
"unit": null,
"is_support_mix": "true",
"mix_amount": "100",
"mix_begin": "0",
"mix_number": "2147483647",
"scale": "",
"sellUnit": "件",
"props_img": {
"0:0": "https://cbu01.alicdn.com/img/ibank/O1CN01FmLtsZ1NtDAO8a0wo_!!2207720171627-0-cib.jpg",
"0:1": "https://cbu01.alicdn.com/img/ibank/O1CN01ZK1dwE1NtDAELLDT7_!!2207720171627-0-cib.jpg",
"0:2": "https://cbu01.alicdn.com/img/ibank/O1CN01IvZCTA1NtDAHUcF13_!!2207720171627-0-cib.jpg",
"0:3": "https://cbu01.alicdn.com/img/ibank/O1CN01N46IjA1NtDALIRr7F_!!2207720171627-0-cib.jpg"
},
"sales_data": null,
"priceRange": [
[
"2",
"78.00"
],
[
"5",
"75.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": "96c482f4facc309dea08aace21b3794b",
"secache_time": 1663817070,
"secache_date": "2022-09-22 11:24:30",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:14 max:10100 all[34=14+3+17];expires:2030-12-31",
"execution_time": "1.408",
"server_time": "Beijing/2022-09-22 11:24:30",
"client_ip": "106.6.38.190",
"call_args": {
"num_iid": "679068178178"
},
"api_type": "1688",
"translate_language": "zh-CN",
"translate_engine": "google_new",
"server_memory": "4.07MB",
"request_id": "1.632bd56cc8136",
"last_id": "1233155708"
}
API 工具
API SDK 调用示例 API SDK下载 API测试工具
获得此API