1688采购工厂货源对接API

1688现有API列表

item_get 获得1688商品详情
item_search 按关键字搜索商品
item_search_img 按图搜索1688商品（拍立淘）
item_search_suggest 获得搜索词推荐
item_fee 获得商品快递费用
seller_info 获得店铺详情
item_search_shop 获得店铺的所有商品
item_password 获得淘口令真实url
upload_img 上传图片到1688
item_search_seller 搜索店铺列表
img2text 图片识别商品接口
item_get_app 获取1688app上原数据
buyer_order_list 获取购买到的商品订单列表
cat_get 获得1688商品分类

查看API调用文档

部分API调用成功率

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版本

1688商品采集示例

商品详情页

item_get商品详情调用代码示例

PHP代码

<?php

// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输，若要加密请参考API文档
$method = "GET";
$url = "https://api-gw.cn/1688/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=610947572360";
$curl = curl_init();
curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_SSL_VERIFYHOST,FALSE);
curl_setopt($curl, CURLOPT_SSL_VERIFYPEER,FALSE);
curl_setopt($curl, CURLOPT_FAILONERROR, false);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_HEADER, true);
curl_setopt($curl, CURLOPT_ENCODING, "gzip");
var_dump(curl_exec($curl));
?>

响应数据

item: {
num_iid: 601824709263,
title: "韩版仿兔毛围巾秋冬毛毛围巾学生毛毛绒围脖冬季女套头防寒户外",
desc_short: "",
price: "2.2",
total_price: 0,
suggestive_price: 0,
orginal_price: "2.2",
nick: "_sopid@BBBEbRNm7OS0uGCXPJucMBy2w",
num: 3784255,
min_num: 2,
detail_url: "https://detail.1688.com/offer/601824709263.html",
pic_url: "https://cbu01.alicdn.com/img/ibank/11921650503_1818272533.jpg",
brand: "",
brandId: "",
rootCatId: 0,
cid: 325,
crumbs: [ ],
created_time: "",
modified_time: "",
delist_time: "",
desc: "<div id="offer-template-0"></div><div > </div> <div ><span ><strong> <span >材质：双面仿兔毛毛绒面料，</span></strong></span></div> <div ><span ><strong><span >不掉毛（不是薄薄的单面哦）</span></strong></span></div> <div ><span ><strong ><span >厚款3.39元</span></strong></span></div> <div ><span ><strong><span ><span >普通款2.38元</span></span></strong></span></div> <div ><span ><strong><span ><span >每条围巾都是独立OPP袋子包装，放心选购！</span></span></strong></span></div> <div ><span ><strong><span >现货供应，厂家直销，没有中间商赚差价，有大量可以谈价，有量有价</span></strong></span></div> <div ><span ><strong><span >（抖音，快手，直播电商福利品，天猫，淘宝，PDD，跨境电商供应商）</span></strong></span></div> <div ><strong><span ><span ><span >这款围巾是不掉毛的，有些激光高温裁剪残留的浮毛，抖抖就好了哦。</span></span></span></strong></div> <div > </div> <div ><span ><img src="https://cbu01.alicdn.com/img/ibank/O1CN01emutXa27pyd6vYZzm_!!2206475177847-0-cib.jpg" alt="undefined"/><br/><strong>此图拉拉袋包装的为客户定做款（大货是OPP透明袋独立包装）</strong><br/><img src="https://img.alicdn.com/imgextra/i3/2272041426/O1CN01kFnNOl1MP9H5642lo_!!2272041426.jpg" align="absmiddle"/></span></div> <div ><img src="https://img.alicdn.com/imgextra/i3/2272041426/TB2lZSUX7iHJuJjSZFjXXcGvXXa_!!2272041426.jpg" align="absmiddle"/><img src="https://img.alicdn.com/imgextra/i2/2272041426/TB2rvmVXYSGJuJjSZFqXXXo2pXa_!!2272041426.jpg" align="absmiddle"/></div> <div > </div> <p><img src="https://img.alicdn.com/imgextra/i3/2272041426/O1CN01EKuyER1MP9LVqRODf_!!2272041426.jpg" align="absmiddle"/></p> <p> </p> <p><img src="https://img.alicdn.com/imgextra/i3/2272041426/O1CN01fH7zeu1MP9LXYMDb9_!!2272041426.jpg" align="absmiddle"/></p> <p> </p> <p><img src="https://img.alicdn.com/imgextra/i3/2272041426/O1CN01o03kWB1MP9LUPh2vD_!!2272041426.jpg" align="absmiddle"/></p> <p> </p> <p><img src="https://img.alicdn.com/imgextra/i4/2272041426/O1CN01zAl3p11MP9LTi5nZh_!!2272041426.jpg" align="absmiddle"/></p> <p> </p> <p><img src="https://img.alicdn.com/imgextra/i3/2272041426/O1CN01Zv9KBT1MP9LUIKRow_!!2272041426.jpg" align="absmiddle"/></p> <p> </p> <p><img src="https://img.alicdn.com/imgextra/i3/2272041426/O1CN01VlbKPj1MP9LU0NVFN_!!2272041426.jpg" align="absmiddle"/></p> <p> </p> <p><img src="https://img.alicdn.com/imgextra/i4/2272041426/O1CN01MjaoVZ1MP9LTiFjny_!!2272041426.jpg" align="absmiddle"/></p> <p> </p> <p><img src="https://img.alicdn.com/imgextra/i4/2272041426/O1CN01junsnm1MP9LX5bOdM_!!2272041426.jpg" align="absmiddle"/></p> <p> </p> <p><img src="https://img.alicdn.com/imgextra/i2/2272041426/O1CN014Dv2oq1MP9LU0KgIb_!!2272041426.jpg" align="absmiddle"/></p> <p> </p> <p><img src="https://img.alicdn.com/imgextra/i4/2272041426/O1CN01jNA7KZ1MP9LUHdDBF_!!2272041426.jpg" align="absmiddle"/></p> <p> </p> <p><img src="https://img.alicdn.com/imgextra/i3/2272041426/O1CN01JZW4Hn1MP9LUHd91D_!!2272041426.jpg" align="absmiddle"/></p> <p> </p> <p><img src="https://img.alicdn.com/imgextra/i3/2272041426/O1CN01nSbj2H1MP9LVqZ2mg_!!2272041426.jpg" align="absmiddle"/></p> <p> </p> <p><img src="https://img.alicdn.com/imgextra/i4/2272041426/O1CN01HmPSpT1MP9LSDyrsr_!!2272041426.jpg" align="absmiddle"/></p> <p> </p> <p> </p> <div >..........</div><img src="https://www.o0b.cn/i.php?t.png&rid=gw-4.659f5f89a544b&p=1778786772&k=i_key&t=1704943498" style="display:none" />",
desc_img: [
"https://cbu01.alicdn.com/img/ibank/O1CN01emutXa27pyd6vYZzm_!!2206475177847-0-cib.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01kFnNOl1MP9H5642lo_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/TB2lZSUX7iHJuJjSZFjXXcGvXXa_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i2/2272041426/TB2rvmVXYSGJuJjSZFqXXXo2pXa_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01EKuyER1MP9LVqRODf_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01fH7zeu1MP9LXYMDb9_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01o03kWB1MP9LUPh2vD_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01zAl3p11MP9LTi5nZh_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01Zv9KBT1MP9LUIKRow_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01VlbKPj1MP9LU0NVFN_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01MjaoVZ1MP9LTiFjny_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01junsnm1MP9LX5bOdM_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i2/2272041426/O1CN014Dv2oq1MP9LU0KgIb_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01jNA7KZ1MP9LUHdDBF_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01JZW4Hn1MP9LUHd91D_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i3/2272041426/O1CN01nSbj2H1MP9LVqZ2mg_!!2272041426.jpg",
"https://img.alicdn.com/imgextra/i4/2272041426/O1CN01HmPSpT1MP9LSDyrsr_!!2272041426.jpg"
],
item_imgs: [
{
url: "https://cbu01.alicdn.com/img/ibank/11921650503_1818272533.jpg"
},
{
url: "https://cbu01.alicdn.com/img/ibank/11921665153_1818272533.jpg"
},
{
url: "https://cbu01.alicdn.com/img/ibank/11884953047_1818272533.jpg"
},
{
url: "https://cbu01.alicdn.com/img/ibank/11954549050_1818272533.jpg"
},
{
url: "https://cbu01.alicdn.com/img/ibank/12483429103_1818272533.jpg"
}
],
item_weight: "",
item_size: "",
location: "浙江省 金华市",
post_fee: "",
express_fee: "",
ems_fee: "",
shipping_to: "",
has_discount: "",
video: "https://cloud.video.taobao.com/play/u/2206475177847/p/1/e/6/t/1/238604472723.mp4",
is_virtual: "",
sample_id: "",
is_promotion: "",
props_name: "0:0:颜色:红色;1:0:长度(CM):厚款;1:1:长度(CM):普通款;0:1:颜色:黑色;0:2:颜色:白色;0:3:颜色:灰色;0:4:颜色:杏色;0:5:颜色:粉色;0:6:颜色:咖啡色;0:7:颜色:米色;0:8:颜色:卡其色",
prop_imgs: {
prop_img: [
{
properties: "0:0",
url: "https://cbu01.alicdn.com/img/ibank/11884977080_1818272533.jpg"
},
{
properties: "0:1",
url: "https://cbu01.alicdn.com/img/ibank/11954549680_1818272533.jpg"
},
{
properties: "0:2",
url: "https://cbu01.alicdn.com/img/ibank/11921650503_1818272533.jpg"
},
{
properties: "0:3",
url: "https://cbu01.alicdn.com/img/ibank/11921680795_1818272533.jpg"
},
{
properties: "0:4",
url: "https://cbu01.alicdn.com/img/ibank/11954549050_1818272533.jpg"
},
{
properties: "0:5",
url: "https://cbu01.alicdn.com/img/ibank/11921689268_1818272533.jpg"
},
{
properties: "0:6",
url: "https://cbu01.alicdn.com/img/ibank/11954552765_1818272533.jpg"
},
{
properties: "0:7",
url: "https://cbu01.alicdn.com/img/ibank/O1CN01PtW77W27pyekEhcAt_!!2206475177847-0-cib.jpg"
},
{
properties: "0:8",
url: "https://cbu01.alicdn.com/img/ibank/O1CN01t2Q1ci27pyjXB0fxo_!!2206475177847-0-cib.jpg"
}
]
},
property_alias: "0:0:红色;1:0:厚款;1:1:普通款;0:1:黑色;0:2:白色;0:3:灰色;0:4:杏色;0:5:粉色;0:6:咖啡色;0:7:米色;0:8:卡其色",
props: [
{
name: "品牌",
value: "高着"
},
{
name: "编织方法",
value: "经编"
},
{
name: "功能",
value: "保暖"
},
{
name: "适合季节",
value: "冬季"
},
{
name: "货号",
value: "WJ618"
},
{
name: "产地",
value: "浙江义乌"
},
{
name: "款式",
value: "中长"
},
{
name: "颜色",
value: "红色"
},
{
name: "颜色",
value: "黑色"
},
{
name: "颜色",
value: "白色"
},
{
name: "颜色",
value: "灰色"
},
{
name: "颜色",
value: "杏色"
},
{
name: "颜色",
value: "粉色"
},
{
name: "颜色",
value: "咖啡色"
},
{
name: "颜色",
value: "米色"
},
{
name: "颜色",
value: "卡其色"
},
{
name: "主要下游平台",
value: "淘宝"
},
{
name: "主要下游平台",
value: "京东"
},
{
name: "主要下游平台",
value: "ebay"
},
{
name: "主要下游平台",
value: "亚马逊"
},
{
name: "主要下游平台",
value: "wish"
},
{
name: "主要下游平台",
value: "快手"
},
{
name: "主要下游平台",
value: "速卖通"
},
{
name: "主要下游平台",
value: "天猫"
},
{
name: "主要下游平台",
value: "独立站"
},
{
name: "主要下游平台",
value: "LAZADA"
},
{
name: "主要下游平台",
value: "拼多多"
},
{
name: "主要下游平台",
value: "抖音"
},
{
name: "有可授权的自有品牌",
value: "否"
},
{
name: "是否跨境出口专供货源",
value: "是"
},
{
name: "上市年份/季节",
value: "2021年秋季"
},
{
name: "宽度(CM)",
value: "12cm"
},
{
name: "风格",
value: "百搭"
},
{
name: "风格",
value: "优雅"
},
{
name: "风格",
value: "极简"
},
{
name: "风格",
value: "休闲风"
},
{
name: "风格",
value: "时尚OL"
},
{
name: "风格",
value: "简约"
},
{
name: "风格",
value: "欧美"
},
{
name: "风格",
value: "轻奢风"
},
{
name: "风格",
value: "chic风"
},
{
name: "风格",
value: "高级感"
},
{
name: "面料名称",
value: "毛绒"
},
{
name: "风格分类",
value: "时尚通勤"
},
{
name: "处理工艺",
value: "经编"
},
{
name: "流行元素分类",
value: "无"
}
],
total_sold: 3784255,
skus: {
sku: [
{
price: 19.9,
total_price: 19.9,
orginal_price: 19.9,
properties: "0:0;1:0",
properties_name: "0:0:颜色:红色;1:0:长度(CM):厚款",
quantity: 107768,
sku_id: 5330445855405,
spec_id: "dffc05abd3cc2692be66130c56acac05"
},
{
price: 4.99,
total_price: 4.99,
orginal_price: 4.99,
properties: "0:0;1:1",
properties_name: "0:0:颜色:红色;1:1:长度(CM):普通款",
quantity: 0,
sku_id: 5330445855404,
spec_id: "87b07b1e746bd546e97a0f5888726ae3"
},
{
price: 19.9,
total_price: 19.9,
orginal_price: 19.9,
properties: "0:1;1:0",
properties_name: "0:1:颜色:黑色;1:0:长度(CM):厚款",
quantity: 567793,
sku_id: 5330445855411,
spec_id: "9cd686521c2fd040c8649860acec8bdd"
},
{
price: 4.99,
total_price: 4.99,
orginal_price: 4.99,
properties: "0:1;1:1",
properties_name: "0:1:颜色:黑色;1:1:长度(CM):普通款",
quantity: 0,
sku_id: 5330445855410,
spec_id: "e664b2e7c4adae52d35767f51a9219f6"
},
{
price: 19.9,
total_price: 19.9,
orginal_price: 19.9,
properties: "0:2;1:0",
properties_name: "0:2:颜色:白色;1:0:长度(CM):厚款",
quantity: 397925,
sku_id: 5330445855399,
spec_id: "ff52cef105655f7ab5caec128d7f5b42"
},
{
price: 4.99,
total_price: 4.99,
orginal_price: 4.99,
properties: "0:2;1:1",
properties_name: "0:2:颜色:白色;1:1:长度(CM):普通款",
quantity: 0,
sku_id: 5330445855398,
spec_id: "18dc5ba8c7dc3df0eb8b731977df2372"
},
{
price: 19.9,
total_price: 19.9,
orginal_price: 19.9,
properties: "0:3;1:0",
properties_name: "0:3:颜色:灰色;1:0:长度(CM):厚款",
quantity: 536357,
sku_id: 5330445855409,
spec_id: "69ba3f5dd5429b7a2349aa7007e36ec2"
},
{
price: 4.99,
total_price: 4.99,
orginal_price: 4.99,
properties: "0:3;1:1",
properties_name: "0:3:颜色:灰色;1:1:长度(CM):普通款",
quantity: 8016,
sku_id: 5330445855408,
spec_id: "05808df6001a6ffa6fa13ae7df588b36"
},
{
price: 19.9,
total_price: 19.9,
orginal_price: 19.9,
properties: "0:4;1:0",
properties_name: "0:4:颜色:杏色;1:0:长度(CM):厚款",
quantity: 518903,
sku_id: 5330445855413,
spec_id: "6e4dad184c2c91ee842e57e7bd3c2d7a"
},
{
price: 4.99,
total_price: 4.99,
orginal_price: 4.99,
properties: "0:4;1:1",
properties_name: "0:4:颜色:杏色;1:1:长度(CM):普通款",
quantity: 0,
sku_id: 5330445855412,
spec_id: "1ab2b4cd3cc2b51ed4055978ca4b8579"
},
{
price: 19.9,
total_price: 19.9,
orginal_price: 19.9,
properties: "0:5;1:0",
properties_name: "0:5:颜色:粉色;1:0:长度(CM):厚款",
quantity: 341421,
sku_id: 5330445855403,
spec_id: "81b14fea1ec2ab8223182654a4fa535d"
},
{
price: 4.99,
total_price: 4.99,
orginal_price: 4.99,
properties: "0:5;1:1",
properties_name: "0:5:颜色:粉色;1:1:长度(CM):普通款",
quantity: 0,
sku_id: 5330445855402,
spec_id: "7a394d5d7d8560fae263cd2ffe9ee444"
},
{
price: 19.9,
total_price: 19.9,
orginal_price: 19.9,
properties: "0:6;1:0",
properties_name: "0:6:颜色:咖啡色;1:0:长度(CM):厚款",
quantity: 0,
sku_id: 5330445855397,
spec_id: "73780d960f97044e62c5c455f8ac3169"
},
{
price: 4.99,
total_price: 4.99,
orginal_price: 4.99,
properties: "0:6;1:1",
properties_name: "0:6:颜色:咖啡色;1:1:长度(CM):普通款",
quantity: 0,
sku_id: 5330445855396,
spec_id: "423651c0792f75de75484ae9bd5fe535"
},
{
price: 19.9,
total_price: 19.9,
orginal_price: 19.9,
properties: "0:7;1:0",
properties_name: "0:7:颜色:米色;1:0:长度(CM):厚款",
quantity: 635661,
sku_id: 5330445855401,
spec_id: "d2a1e859dd96d103a1528d0da51cb7cd"
},
{
price: 4.99,
total_price: 4.99,
orginal_price: 4.99,
properties: "0:7;1:1",
properties_name: "0:7:颜色:米色;1:1:长度(CM):普通款",
quantity: 0,
sku_id: 5330445855400,
spec_id: "45b9c574ac45662aba79f2cb72d20112"
},
{
price: 19.9,
total_price: 19.9,
orginal_price: 19.9,
properties: "0:8;1:0",
properties_name: "0:8:颜色:卡其色;1:0:长度(CM):厚款",
quantity: 670411,
sku_id: 5330445855407,
spec_id: "d5d868eb21093caa979a913e7a639fea"
},
{
price: 4.99,
total_price: 4.99,
orginal_price: 4.99,
properties: "0:8;1:1",
properties_name: "0:8:颜色:卡其色;1:1:长度(CM):普通款",
quantity: 0,
sku_id: 5330445855406,
spec_id: "f7931f4b9892a8c41b76205cb1d50627"
}
]
},
seller_id: null,
sales: 0,
shop_id: null,
props_list: {
0:0: "颜色:红色",
1:0: "长度(CM):厚款",
1:1: "长度(CM):普通款",
0:1: "颜色:黑色",
0:2: "颜色:白色",
0:3: "颜色:灰色",
0:4: "颜色:杏色",
0:5: "颜色:粉色",
0:6: "颜色:咖啡色",
0:7: "颜色:米色",
0:8: "颜色:卡其色"
},
seller_info: {
nick: "_sopid@BBBEbRNm7OS0uGCXPJucMBy2w",
user_num_id: null,
sid: null,
title: null,
zhuy: null,
shop_name: null
},
tmall: "false",
error: "",
warning: "",
url_log: [ ],
unit: null,
is_support_mix: null,
mix_amount: null,
mix_begin: null,
mix_number: null,
priceRange: [
[
2,
"2.2"
]
],
priceRangeOriginal: [ ],
_ddf: "sop",
props_img: {
0:0: "https://cbu01.alicdn.com/img/ibank/11884977080_1818272533.jpg",
0:1: "https://cbu01.alicdn.com/img/ibank/11954549680_1818272533.jpg",
0:2: "https://cbu01.alicdn.com/img/ibank/11921650503_1818272533.jpg",
0:3: "https://cbu01.alicdn.com/img/ibank/11921680795_1818272533.jpg",
0:4: "https://cbu01.alicdn.com/img/ibank/11954549050_1818272533.jpg",
0:5: "https://cbu01.alicdn.com/img/ibank/11921689268_1818272533.jpg",
0:6: "https://cbu01.alicdn.com/img/ibank/11954552765_1818272533.jpg",
0:7: "https://cbu01.alicdn.com/img/ibank/O1CN01PtW77W27pyekEhcAt_!!2206475177847-0-cib.jpg",
0:8: "https://cbu01.alicdn.com/img/ibank/O1CN01t2Q1ci27pyjXB0fxo_!!2206475177847-0-cib.jpg"
},
sales_info: {
seller_num: "",
repeat_rate_purchase: "",
per_capita_purchases: "",
comment_num: "",
comment_url: ""
},
format_check: "ok",
shop_item: [ ],
relate_items: [ ]
},