1688商品采集如何实现？分享我正在用的API接口
1688，是物美价廉的代名词了。对电商卖家而言，1688 本质上是一个 “低成本、高效率、低风险” 的货源解决方案。尤其对中小卖家和新手来说，它跳过了传统供应链的高门槛，让 “轻资产做电商” 成为可能 —— 从选品、上新到发货的全流程都被简化，卖家可以更聚焦于销售和运营，快速切入市场。不过，这种模式也需注意供应商质量筛选、价格竞争等问题，但总体而言，1688 仍是电商从业者的重要货源渠道。
![]( "点击并拖拽以移动")
![]( "点击并拖拽以移动")
近来有个项目需要采集到1688的商品货源数据，实现能自动对接1688的商品数据。结合客户需求，我用到了以下的API：
item_search 通过关键字搜索1688商品列表
item_get 通过商品id获取商品详情信息
item_search_img 通过图片搜索商品列表
对接流程：
1、注册账号获取测试API
2、查看相关API文档，了解请求参数、响应参数以及请求示例、响应示例
3、进入API测试页，测试API，查看响应数据是否符合
4、对接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版本 |
PHP请求代码
<?php
// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输，若要加密请参考：https://open.onebound.cn/help/demo/sdk/demo-sign.php
$method = "GET";
$url = "https://api-gw.onebound.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));
?>
API获取响应数据
"item": {
"num_iid": "734672214905",
"title": "2023外贸亚马逊速卖通欧美名媛贵妇晚宴轻熟气质女士刺绣连衣裙S",
"desc_short": "",
"price": "25.90",
"total_price": 0,
"suggestive_price": 0,
"orginal_price": "25.90",
"nick": "广州壹顺服饰有限公司",
"num": 149652,
"min_num": 2,
"detail_url": "https://detail.1688.com/offer/734672214905.html",
"pic_url": "https://cbu01.alicdn.com/img/ibank/O1CN010fV9Ul1GqHNpZ0Rss_!!2831370673-0-cib.jpg",
"brand": "",
"brandId": "",
"rootCatId": 10166,
"cid": 1031910,
"desc": "<div id=\"offer-template-0\"></div><p><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01cq6TdB1GqHO7Q4z1e_!!2831370673-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN016Z7AWG1GqHOPHdNbB_!!2831370673-0-cib.jpg?__r__=1684568299970\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01s3necJ1GqHOVSTyiq_!!2831370673-0-cib.jpg?__r__=1684568299971\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01Dny9Ao1GqHOUro8KX_!!2831370673-0-cib.jpg?__r__=1684568299971\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01nXEeQx1GqHNnuyyIV_!!2831370673-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01iDeOO01GqHNoM2Kwo_!!2831370673-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01UfJZ0a1GqHNgQ58Wh_!!2831370673-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01fvVImH1GqHNjvmFVb_!!2831370673-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN01Wnr7QN1GqHNeNPPmC_!!2831370673-0-cib.jpg\"/><img src=\"https://cbu01.alicdn.com/img/ibank/O1CN017vrKet1GqHNlSFGJb_!!2831370673-0-cib.jpg\"/></p><img src=\"https://www.o0b.cn/i.php?t.png&rid=gw-1.6875bcf7cd784&p=1778788648&k=i_key&t=1752546556\" style=\"display:none\" />",
"item_imgs": [
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN010fV9Ul1GqHNpZ0Rss_!!2831370673-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01mz3HkK1GqHNmBK4Jh_!!2831370673-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01pOxOa91GqHNirInSe_!!2831370673-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN011eMgxW1GqHNgPkjCo_!!2831370673-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01Nys0yw1GqHOOa2c8h_!!2831370673-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01C2elgI1GqHNpUPCYf_!!2831370673-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01aBgJrH1GqHNoM0rE7_!!2831370673-0-cib.jpg"
},
{
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01CM4kGc1GqHNlSBVBB_!!2831370673-0-cib.jpg"
}
],
"item_weight": "",
"location": "广东省广州市",
"post_fee": "",
"express_fee": "",
"ems_fee": "",
"shipping_to": "",
"video": {
"url": null
},
"sample_id": "",
"props_name": "0:0:颜色:黑色;0:1:颜色:白色;0:2:颜色:红色;1:0:尺码:S;1:1:尺码:M;1:2:尺码:L;1:3:尺码:XL;1:4:尺码:XXL",
"prop_imgs": {
"prop_img": [
{
"properties": "0:0",
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01C2elgI1GqHNpUPCYf_!!2831370673-0-cib.jpg"
},
{
"properties": "0:1",
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01CM4kGc1GqHNlSBVBB_!!2831370673-0-cib.jpg"
},
{
"properties": "0:2",
"url": "https://cbu01.alicdn.com/img/ibank/O1CN01aBgJrH1GqHNoM0rE7_!!2831370673-0-cib.jpg"
}
]
},
"property_alias": "0:0:黑色;0:1:白色;0:2:红色;1:0:S;1:1:M;1:2:L;1:3:XL;1:4:XXL",
"props": [],
"total_sold": 0,
"scale": null,
"sellUnit": null,
"skus": {
"sku": [
{
"price": "25.90",
"total_price": 0,
"sales": 0,
"properties": "0:0;1:0",
"properties_name": "0:0:颜色:黑色;1:0:尺码:S",
"quantity": 9978,
"sku_id": 5249324174390,
"spec_id": "eb81c61de14f4adb405ffcc2c8a4a3fb"
},
{
"price": "25.90",
"total_price": 0,
"sales": 0,
"properties": "0:0;1:1",
"properties_name": "0:0:颜色:黑色;1:1:尺码:M",
"quantity": 9943,
"sku_id": 5249324174391,
"spec_id": "4b2120e532948daa11e58e09bb260801"
},
{
"price": "25.90",
"total_price": 0,
"sales": 0,
"properties": "0:0;1:2",
"properties_name": "0:0:颜色:黑色;1:2:尺码:L",
"quantity": 9947,
"sku_id": 5249324174392,
"spec_id": "b99ece08861a79e13a4dba90e97ebff8"
},
{
"price": "25.90",
"total_price": 0,
"sales": 0,
"properties": "0:0;1:3",
"properties_name": "0:0:颜色:黑色;1:3:尺码:XL",
"quantity": 9950,
"sku_id": 5249324174393,
"spec_id": "5c337082186ff55b2d8267560ac89d59"
},
{
"price": "25.90",
"total_price": 0,
"sales": 0,
"properties": "0:0;1:4",
"properties_name": "0:0:颜色:黑色;1:4:尺码:XXL",
"quantity": 9923,
"sku_id": 5249324174394,
"spec_id": "dc048f4577f72dd6b932615edef1fab6"
},
{
"price": "25.90",
"total_price": 0,
"sales": 0,
"properties": "0:1;1:0",
"properties_name": "0:1:颜色:白色;1:0:尺码:S",
"quantity": 9992,
"sku_id": 5249324174395,
"spec_id": "94d1d179497744028aa76873afdeba62"
},
{
"price": "25.90",
"total_price": 0,
"sales": 0,
"properties": "0:1;1:1",
"properties_name": "0:1:颜色:白色;1:1:尺码:M",
"quantity": 9991,
"sku_id": 5249324174396,
"spec_id": "cef93beef156f1799e736c649f36efae"
},
{
"price": "25.90",
"total_price": 0,
"sales": 0,
"properties": "0:1;1:2",
"properties_name": "0:1:颜色:白色;1:2:尺码:L",
"quantity": 9984,
"sku_id": 5249324174397,
"spec_id": "82114cbd2c10b5e97b01af1510807e2d"
},
{
"price": "25.90",
"total_price": 0,
"sales": 0,
"properties": "0:1;1:3",
"properties_name": "0:1:颜色:白色;1:3:尺码:XL",
"quantity": 9993,
"sku_id": 5249324174398,
"spec_id": "c45d8408137e34adf8e695250c42a2e9"
},
{
"price": "25.90",
"total_price": 0,
"sales": 0,
"properties": "0:1;1:4",
"properties_name": "0:1:颜色:白色;1:4:尺码:XXL",
"quantity": 9993,
"sku_id": 5249324174399,
"spec_id": "df78564262818d6eb0c428a37ab4a251"
},
{
"price": "25.90",
"total_price": 0,
"sales": 0,
"properties": "0:2;1:0",
"properties_name": "0:2:颜色:红色;1:0:尺码:S",
"quantity": 9994,
"sku_id": 5249324174400,
"spec_id": "4b3436849e25eacb755f6f29ea09e809"
},
{
"price": "25.90",
"total_price": 0,
"sales": 0,
"properties": "0:2;1:1",
"properties_name": "0:2:颜色:红色;1:1:尺码:M",
"quantity": 9993,
"sku_id": 5249324174401,
"spec_id": "a105e7d232cfb509d4253d59cfe30bbd"
},
{
"price": "25.90",
"total_price": 0,
"sales": 0,
"properties": "0:2;1:2",
"properties_name": "0:2:颜色:红色;1:2:尺码:L",
"quantity": 9991,
"sku_id": 5249324174402,
"spec_id": "3dbe840b47bcb8f849bff38fc1f049fb"
},
{
"price": "25.90",
"total_price": 0,
"sales": 0,
"properties": "0:2;1:3",
"properties_name": "0:2:颜色:红色;1:3:尺码:XL",
"quantity": 9991,
"sku_id": 5249324174403,
"spec_id": "ce7fb37f848bc060cfece58cfbe38c19"
},
{
"price": "25.90",
"total_price": 0,
"sales": 0,
"properties": "0:2;1:4",
"properties_name": "0:2:颜色:红色;1:4:尺码:XXL",
"quantity": 9989,
"sku_id": 5249324174404,
"spec_id": "17a001fccdc38e767030004ac03b8881"
}
]
},
"seller_id": 2216403658837,
"sales": 0,
"shop_id": 2216403658837,
"props_list": {
"0:0": "颜色:黑色",
"0:1": "颜色:白色",
"0:2": "颜色:红色",
"1:0": "尺码:S",
"1:1": "尺码:M",
"1:2": "尺码:L",
"1:3": "尺码:XL",
"1:4": "尺码:XXL"
},
"priceRange": [
[
"2",
"25.90"
]
],
"priceRangeOriginal": [],
"seller_info": {
"nick": "广州壹顺服饰有限公司",
"user_num_id": 2216403658837,
"sid": "b2b-221640365883745cad",
"title": "广州壹顺服饰有限公司",
"zhuy": "https://winport.m.1688.com/page/index.html?memberId=b2b-221640365883745cad",
"shop_name": "广州壹顺服饰有限公司"
},
"unit": "件",
"tmall": "",
"_ddf": "alex",
"error": "",
"props_img": {
"0:0": "https://cbu01.alicdn.com/img/ibank/O1CN01C2elgI1GqHNpUPCYf_!!2831370673-0-cib.jpg",
"0:1": "https://cbu01.alicdn.com/img/ibank/O1CN01CM4kGc1GqHNlSBVBB_!!2831370673-0-cib.jpg",
"0:2": "https://cbu01.alicdn.com/img/ibank/O1CN01aBgJrH1GqHNoM0rE7_!!2831370673-0-cib.jpg"
},
"format_check": "ok",
"desc_img": [
"https://cbu01.alicdn.com/img/ibank/O1CN01cq6TdB1GqHO7Q4z1e_!!2831370673-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN016Z7AWG1GqHOPHdNbB_!!2831370673-0-cib.jpg?__r__=1684568299970",
"https://cbu01.alicdn.com/img/ibank/O1CN01s3necJ1GqHOVSTyiq_!!2831370673-0-cib.jpg?__r__=1684568299971",
"https://cbu01.alicdn.com/img/ibank/O1CN01Dny9Ao1GqHOUro8KX_!!2831370673-0-cib.jpg?__r__=1684568299971",
"https://cbu01.alicdn.com/img/ibank/O1CN01nXEeQx1GqHNnuyyIV_!!2831370673-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01iDeOO01GqHNoM2Kwo_!!2831370673-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01UfJZ0a1GqHNgQ58Wh_!!2831370673-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01fvVImH1GqHNjvmFVb_!!2831370673-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN01Wnr7QN1GqHNeNPPmC_!!2831370673-0-cib.jpg",
"https://cbu01.alicdn.com/img/ibank/O1CN017vrKet1GqHNlSFGJb_!!2831370673-0-cib.jpg"
],
"shop_item": [],
"relate_items": []
},
浙公网安备 33010602011771号