淘宝店铺如何从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测试权限
- version:API版本
- key:调用key,测试key:test_api_key
- api_name:API类型[item_get,item_search]
- cache:[yes,no]默认yes，将调用缓存的数据，速度比较快
- result_type:[json,xml,serialize,var_export]返回数据格式，默认为json
- lang:[cn,en,ru] 翻译语言，默认cn简体中文
- API:item_get 参数说明: num_iid:宝贝ID

公共参数

名称	类型	必须	描述
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版本

请求参数

请求参数：num_iid=610947572360

参数说明：num_iid:1688商品ID

sales_data:&sales_data=1 获取近30天成交数据

agent:&agent=1 获取1688分销代发价格数据

响应示例

php 复制代码

item: {
num_iid: "734672214905",
title: "2023外贸亚马逊速卖通欧美名媛贵妇晚宴轻熟气质女士刺绣连衣裙S",
desc_short: "",
price: "25.90",
total_price: 0,
suggestive_price: 0,
orginal_price: "25.90",
nick: "广州壹顺服饰有限公司",
num: "149654",
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",
crumbs: [ ],
created_time: "",
modified_time: "",
delist_time: "",
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-4.6606262d31347&p=1778786951&k=63112&t=1711679023" style="display:none" />",
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"
],
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: "",
item_size: "",
location: "广东省广州市",
post_fee: 8,
express_fee: "",
ems_fee: "",
shipping_to: "",
has_discount: "",
video: "",
is_virtual: "",
sample_id: "",
is_promotion: "",
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: [
{
name: "面料名称",
show: false,
value: "棉涤"
},
{
name: "图案",
show: false,
value: "纯色"
},
{
name: "工艺",
show: false,
value: "刺绣/绣花"
},
{
name: "产地",
show: false,
value: "广州"
},
{
name: "款式",
show: false,
value: "吊带款"
},
{
name: "组合形式",
show: false,
value: "单件"
},
{
name: "裙长",
show: false,
value: "中长裙"
},
{
name: "裙型",
show: false,
value: "A字裙"
},
{
name: "领型",
show: false,
value: "V字领"
},
{
name: "袖型",
show: false,
value: "无袖"
},
{
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: "1018s"
},
{
name: "颜色",
show: false,
value: "黑色,白色,红色"
},
{
name: "尺码",
show: false,
value: "S,M,L,XL,XXL"
},
{
name: "风格类型",
show: false,
value: "私服名媛"
},
{
name: "门襟",
show: false,
value: "套头"
},
{
name: "主面料成分含量",
show: false,
value: "30%（含）-50%（不含）"
},
{
name: "风格",
show: false,
value: "名媛风"
},
{
name: "跨境风格类型",
show: false,
value: "气质优雅"
},
{
name: "是否跨境货源",
show: false,
value: "是"
},
{
name: "主要下游销售地区1",
show: false,
value: "欧美"
},
{
name: "主要下游销售地区2",
show: false,
value: "其他"
}
],
total_sold: 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: "9925",
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"
},
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: "广州壹顺服饰有限公司"
},
tmall: "false",
error: "",
warning: "",
url_log: [ ],
unit: null,
is_support_mix: null,
mix_amount: null,
mix_begin: null,
mix_number: null,
scale: "",
sellUnit: "件",
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"
},
sales_data: null,
priceRange: [
[
"2",
"25.90"
]
],
priceRangeOriginal: [ ],
_ddf: "ti",
sales_info: {
seller_num: "",
repeat_rate_purchase: "",
per_capita_purchases: "",
comment_num: "",
comment_url: ""
},
format_check: "ok",
shop_item: [ ],
relate_items: [ ]
},