API应用场景以及接入文档、调用完整代码展示如下：
1. 一键铺货
场景 ：有个老板在1688上发现了一款特别好看的杯子，想拿到亚马逊或者Shopee上去卖。
不用API ：老板得把1688上的图片一张张右键保存，把标题复制下来，再打开自己的店铺后台，一点点填上去。一天累死累活也上不了几个商品。
用了API：老板在ERP软件里点一下"一键铺货"，软件通过API瞬间把1688上的图片、标题、价格全抓过来，自动填到自己的店里。一个人能干以前十个人的活！
2. AI比价
场景 ：你想买个手机壳，想知道淘宝、京东、拼多多哪家最便宜。
不用API ：你得自己挨个打开APP去搜。
用了API：这些比价软件在后台通过API，一秒钟把淘宝上卖手机壳的商家价格和销量全查清楚了，直接给你排好序。代购也是同理，用API查好价格和库存，直接给海外客户报个价。
3. 进货系统
场景 ：一个开工厂的，每天要买很多螺丝钉。
不用API ：采购员天天盯着1688看，螺丝钉涨价了没？快没货了没？
用了API：工厂的电脑系统通过API连着1688，只要发现螺丝钉低于100个，或者价格合适，系统自动就下单了，根本不需要人盯着。
以下是API的调用文档：
以下为调用代码完整展示：
{
"item": {
"display":"API调用测试：http://console.open.onebound.cn/console/?i=NewRookie"
"num_iid": "759352034155",
"title": "正版java C++Python编程从入门到精通零基础入门自学程序编程书籍",
"desc_short": "",
"price": "12.90",
"total_price": 0,
"suggestive_price": 0,
"orginal_price": "12.90",
"nick": "xxxxxxxxxxxxxxxx",
"num": 294106,
"min_num": 1,
"detail_url": "https://detail.1688.com/offer/759352034155.html",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN014uLpfh1u13nppPJ7R_!!2216986395976-0-cib.jpg",
"brand": "",
"brandId": "",
"rootCatId": 67,
"cid": 201219202,
"desc": "<div id=\"offer-template-0\"></div><p><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01VSdDxy1u13nmhPMMx_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01jDXf1q1u13niLvniU_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01Bz1DNa1u13niLx8rp_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01p77BJA1u13nlkaPQR_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01OIFiaJ1u13nlpmNZ9_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01wNUmis1u13npUr9sL_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01e4rOoh1u13nppOZQC_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01gMtzrB1u13njwQ9N9_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01HfVVUv1u13nnjVaKE_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01vLn8rp1u13nnjZPMg_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01ta9nlA1u13noE8YC3_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01QsCKX01u13nrKxrH4_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01wk3PvU1u13noVTF6c_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01lip8eD1u13njRUmsm_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01e4DmuB1u13nmhQdN3_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01u7ggfb1u13nmhTJjm_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01nnMlQy1u13nqcMexF_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01NpF8qc1u13nmhQyBC_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01p05D1i1u13nmhTBQA_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01I0W3Zd1u13njwQDZF_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01xvss6N1u13nqcQTy6_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01ZEnksm1u13nmhQEST_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01VShEB31u13niLy9HC_!!2216986395976-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN0183XpXJ1u13nppOuD1_!!2216986395976-0-cib.jpg\"/></p><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-1.6a4463ea555e6&p=3060574917&k=i_key&t=1782866924\" style=\"display:none\" />",
"item_imgs": [
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN014uLpfh1u13nppPJ7R_!!2216986395976-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01hZFtk01u13ndm6GTa_!!2216986395976-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01mT5OnD1u13niLvStw_!!2216986395976-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01gmWluN1u13nppPRQD_!!2216986395976-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01t92VwC1u13nlpnWDU_!!2216986395976-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN0125CfKv1u13nlkZo39_!!2216986395976-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01OpMWkZ1u13njwSZ2w_!!2216986395976-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01yJ4EPn1u13niLyxBi_!!2216986395976-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01q23Fzs1u13nmhv6hZ_!!2216986395976-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01A3y5tv1u13nlmFFzz_!!2216986395976-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01FYfa6P1u13nqcOP5F_!!2216986395976-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01p6YZbB1u13nlkbY9Y_!!2216986395976-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01W87Cqn1u13nmhTS45_!!2216986395976-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01IUaAC11u13njwSZ36_!!2216986395976-0-cib.jpg"
}
],
"item_weight": null,
"location": "河北省廊坊市",
"post_fee": null,
"express_fee": null,
"ems_fee": "",
"shipping_to": "",
"video": {
"url": null
},
"sample_id": "",
"props_name": "0:0:颜色:【全4册】编程从入门到精通;0:1:颜色:【全2册】C语言入门+C++入门;0:2:颜色:【全2册】Java入门+C++入门;0:3:颜色:【全2册】Python编程;0:4:颜色:【全2册】C语言入门+Python;0:5:颜色:Python编程从入门到精通;0:6:颜色:Java从入门到精通;0:7:颜色:C语言从入门到精通;0:8:颜色:C++从入门到精通",
"prop_imgs": {
"prop_img": [
{
"properties": "0:0",
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01W87Cqn1u13nmhTS45_!!2216986395976-0-cib.jpg"
},
{
"properties": "0:1",
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01yJ4EPn1u13niLyxBi_!!2216986395976-0-cib.jpg"
},
{
"properties": "0:2",
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01q23Fzs1u13nmhv6hZ_!!2216986395976-0-cib.jpg"
},
{
"properties": "0:3",
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01OpMWkZ1u13njwSZ2w_!!2216986395976-0-cib.jpg"
},
{
"properties": "0:4",
"url": "https://cbu01.alicdn.com/img/ibank/O1CN0125CfKv1u13nlkZo39_!!2216986395976-0-cib.jpg"
},
{
"properties": "0:5",
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01A3y5tv1u13nlmFFzz_!!2216986395976-0-cib.jpg"
},
{
"properties": "0:6",
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01IUaAC11u13njwSZ36_!!2216986395976-0-cib.jpg"
},
{
"properties": "0:7",
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01FYfa6P1u13nqcOP5F_!!2216986395976-0-cib.jpg"
},
{
"properties": "0:8",
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01p6YZbB1u13nlkbY9Y_!!2216986395976-0-cib.jpg"
}
]
},
"property_alias": "0:0:【全4册】编程从入门到精通;0:1:【全2册】C语言入门+C++入门;0:2:【全2册】Java入门+C++入门;0:3:【全2册】Python编程;0:4:【全2册】C语言入门+Python;0:5:Python编程从入门到精通;0:6:Java从入门到精通;0:7:C语言从入门到精通;0:8:C++从入门到精通",
"props": [
{
"name": "品牌",
"value": "其他"
},
{
"name": "出版社",
"value": "中国商业出版社"
},
{
"name": "作者",
"value": "孙祥月"
},
{
"name": "书名",
"value": "Java从入门到精通 C++从入门到精通"
},
{
"name": "书号",
"value": "9787520823777"
},
{
"name": "材质",
"value": "纸质"
},
{
"name": "正文语种",
"value": "中文"
},
{
"name": "货号",
"value": "9787520823777"
},
{
"name": "系列",
"value": "编程"
},
{
"name": "形象",
"value": "见实物"
},
{
"name": "出版日期",
"value": "1"
},
{
"name": "题材",
"value": "编程"
},
{
"name": "版次",
"value": "1"
},
{
"name": "开本",
"value": "32"
},
{
"name": "图书定价",
"value": "49.8"
},
{
"name": "页数",
"value": "见实物"
},
{
"name": "主要销售地区",
"value": "全国"
},
{
"name": "赠送光碟",
"value": "否"
},
{
"name": "主要下游平台",
"value": "其他"
},
{
"name": "有可授权的自有品牌",
"value": "否"
},
{
"name": "颜色",
"value": "【全4册】编程从入门到精通,【全2册】C语言入门+C++入门,【全2册】Java入门+C++入门,【全2册】Python编程,【全2册】C语言入门+Python,Python编程从入门到精通,Java从入门到精通,C语言从入门到精通,C++从入门到精通"
},
{
"name": "进口",
"value": "否"
},
{
"name": "是否跨境出口专供货源",
"value": "否"
}
],
"total_sold": 43,
"scale": null,
"sellUnit": null,
"skus": {
"sku": [
{
"price": "49.80",
"total_price": 0,
"sales": 0,
"properties": "0:0",
"properties_name": "0:0:颜色:【全4册】编程从入门到精通",
"quantity": 808,
"sku_id": 5237141697065,
"spec_id": "00cc23b53c4b72b4b524b55564a6eae7"
},
{
"price": "25.80",
"total_price": 0,
"sales": 0,
"properties": "0:1",
"properties_name": "0:1:颜色:【全2册】C语言入门+C++入门",
"quantity": 880,
"sku_id": 5237141697066,
"spec_id": "3d5b790617108d35ef5bb2fda8879519"
},
{
"price": "26.80",
"total_price": 0,
"sales": 0,
"properties": "0:2",
"properties_name": "0:2:颜色:【全2册】Java入门+C++入门",
"quantity": 883,
"sku_id": 5237141697067,
"spec_id": "5829fbeff2f97e0cae7db553d6e9eb04"
},
{
"price": "27.80",
"total_price": 0,
"sales": 0,
"properties": "0:3",
"properties_name": "0:3:颜色:【全2册】Python编程",
"quantity": 70,
"sku_id": 5237141697068,
"spec_id": "9edab93d9f4deca9e6a9a9d7064c1606"
},
{
"price": "25.80",
"total_price": 0,
"sales": 0,
"properties": "0:4",
"properties_name": "0:4:颜色:【全2册】C语言入门+Python",
"quantity": 876,
"sku_id": 5237141697069,
"spec_id": "46c1ac002a346ef3344a8348c8568d5d"
},
{
"price": "15.80",
"total_price": 0,
"sales": 0,
"properties": "0:5",
"properties_name": "0:5:颜色:Python编程从入门到精通",
"quantity": 96947,
"sku_id": 5237141697070,
"spec_id": "5aa00eedcc68e4bca27d9edd70967d22"
},
{
"price": "12.90",
"total_price": 0,
"sales": 0,
"properties": "0:6",
"properties_name": "0:6:颜色:Java从入门到精通",
"quantity": 892,
"sku_id": 5237141697071,
"spec_id": "83990fe30e99de9c0dd8e9b864b6b8ae"
},
{
"price": "14.80",
"total_price": 0,
"sales": 0,
"properties": "0:7",
"properties_name": "0:7:颜色:C语言从入门到精通",
"quantity": 95830,
"sku_id": 5237141697072,
"spec_id": "45211ec699f72be686d94501b10fbc6d"
},
{
"price": "15.80",
"total_price": 0,
"sales": 0,
"properties": "0:8",
"properties_name": "0:8:颜色:C++从入门到精通",
"quantity": 96920,
"sku_id": 5237141697073,
"spec_id": "83bfe599af02796b53c150d374a6d245"
}
]
},
"seller_id": 2216986395976,
"sales": 43,
"shop_id": 2216986395976,
"props_list": {
"0:0": "颜色:【全4册】编程从入门到精通",
"0:1": "颜色:【全2册】C语言入门+C++入门",
"0:2": "颜色:【全2册】Java入门+C++入门",
"0:3": "颜色:【全2册】Python编程",
"0:4": "颜色:【全2册】C语言入门+Python",
"0:5": "颜色:Python编程从入门到精通",
"0:6": "颜色:Java从入门到精通",
"0:7": "颜色:C语言从入门到精通",
"0:8": "颜色:C++从入门到精通"
},
"priceRange": [
[
"1",
"12.90"
],
[
"1",
"49.80"
]
],
"priceRangeOriginal": [],
"seller_info": {
"nick": "湖xxxxxxxxxxx",
"user_num_id": 2216986395976,
"sid": "b2b-2216986395976b1806",
"title": "xxxxxxx",
"zhuy": "https://winport.m.1688.com/page/index.html?memberId=b2b-2216986395976b1806",
"shop_name": "xxxxxx"
},
"unit": "套",
"tmall": "",
"_ddf": "alex",
"error": "",
"package": null,
"props_img": {
"0:0": "https://cbu01.alicdn.com/img/ibank/O1CN01W87Cqn1u13nmhTS45_!!2216986395976-0-cib.jpg",
"0:1": "https://cbu01.alicdn.com/img/ibank/O1CN01yJ4EPn1u13niLyxBi_!!2216986395976-0-cib.jpg",
"0:2": "https://cbu01.alicdn.com/img/ibank/O1CN01q23Fzs1u13nmhv6hZ_!!2216986395976-0-cib.jpg",
"0:3": "https://cbu01.alicdn.com/img/ibank/O1CN01OpMWkZ1u13njwSZ2w_!!2216986395976-0-cib.jpg",
"0:4": "https://cbu01.alicdn.com/img/ibank/O1CN0125CfKv1u13nlkZo39_!!2216986395976-0-cib.jpg",
"0:5": "https://cbu01.alicdn.com/img/ibank/O1CN01A3y5tv1u13nlmFFzz_!!2216986395976-0-cib.jpg",
"0:6": "https://cbu01.alicdn.com/img/ibank/O1CN01IUaAC11u13njwSZ36_!!2216986395976-0-cib.jpg",
"0:7": "https://cbu01.alicdn.com/img/ibank/O1CN01FYfa6P1u13nqcOP5F_!!2216986395976-0-cib.jpg",
"0:8": "https://cbu01.alicdn.com/img/ibank/O1CN01p6YZbB1u13nlkbY9Y_!!2216986395976-0-cib.jpg"
},
"format_check": "ok",
"desc_img": [
"https://cbu01.alicdn.com/img/ibank/O1CN01VSdDxy1u13nmhPMMx_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01jDXf1q1u13niLvniU_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01Bz1DNa1u13niLx8rp_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01p77BJA1u13nlkaPQR_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01OIFiaJ1u13nlpmNZ9_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01wNUmis1u13npUr9sL_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01e4rOoh1u13nppOZQC_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01gMtzrB1u13njwQ9N9_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01HfVVUv1u13nnjVaKE_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01vLn8rp1u13nnjZPMg_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01ta9nlA1u13noE8YC3_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01QsCKX01u13nrKxrH4_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01wk3PvU1u13noVTF6c_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01lip8eD1u13njRUmsm_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01e4DmuB1u13nmhQdN3_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01u7ggfb1u13nmhTJjm_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01nnMlQy1u13nqcMexF_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01NpF8qc1u13nmhQyBC_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01p05D1i1u13nmhTBQA_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01I0W3Zd1u13njwQDZF_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01xvss6N1u13nqcQTy6_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01ZEnksm1u13nmhQEST_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01VShEB31u13niLy9HC_!!2216986395976-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN0183XpXJ1u13nppOuD1_!!2216986395976-0-cib.jpg"
],
"shop_item": [],
"relate_items": []
},
"error": "",
"secache": "4dbe62418fff75913121cc700cf6be8c",
"secache_time": 1782866924,
"secache_date": "2026-07-01 08:48:44",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"reason": "",
"error_code": "0000",
"cache": 0,
"api_info": "today:2 max:10000 all[128=2+0+126];expires:2030-02-19",
"execution_time": "1.937",
"server_time": "Beijing/2026-07-01 08:48:44",
"client_ip": "182.108.170.197",
"call_args": {
"num_iid": "759352034155",
"API_type": "1688"
},
"api_type": "1688",
"translate_language": "zh-CN",
"translate_engine": "baidu",
"server_memory": "4.14MB",
"request_id": "gw-1.6a4463ea555e6",
"last_id": "delay"
}