关于消费，有一句老话叫货比三家，在互联网时代，应该叫“货比三台”，台，自然指的是购物平台。买一样东西，淘宝上看一看，京东看一看，拼多多再看一看，总之呢，怎么便宜怎么来，小红书上，甚至有人测评，不同平台不同价格买的同一样商品，发货地址是一样的，从而来对比出哪一个平台的产品更具性价比。如今，除了上述平台，网友们还要在1688上比一比。

所谓品牌折扣化，1688拾起C端消费者。1688是阿里巴巴集团旗下的一款B2B电商批发采购平台，以批发和采购业务为核心，覆盖普通商品、服装、电子产品、原材料、工业部件、农产品和化工产品等行业，提供从原料采购、生产加工、现货批发等供应服务。

很多做无货源电商的商品基本都是直接从1688对接过来的，利用API来将1688的商品一键搬运到自己的商城，可以减少很多财力和人力成本。获取API key&secret

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测试。

请求示例（JAVA代码）

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.Reader;
import java.net.URL;
import java.nio.charset.Charset;
import org.json.JSONException;
import org.json.JSONObject;
import java.io.PrintWriter;
import java.net.URLConnection;

public class Example {
	private static String readAll(Reader rd) throws IOException {
		StringBuilder sb = new StringBuilder();
		int cp;
		while ((cp = rd.read()) != -1) {
			sb.append((char) cp);
		}
		return  sb.toString();
	}
	public static JSONObject postRequestFromUrl(String url, String body) throws IOException, JSONException {
		URL realUrl = new URL(url);
		URLConnection conn = realUrl.openConnection();
		conn.setDoOutput(true);
		conn.setDoInput(true);
		PrintWriter out = new PrintWriter(conn.getOutputStream());
		out.print(body);
		out.flush();
		InputStream instream = conn.getInputStream();
		try {
			BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
			String jsonText = readAll(rd);
			JSONObject json = new JSONObject(jsonText);
			return json;
		} finally {
			instream.close();
		}
	}
	public static JSONObject getRequestFromUrl(String url) throws IOException, JSONException {
		URL realUrl = new URL(url);
		URLConnection conn = realUrl.openConnection();
		InputStream instream = conn.getInputStream();
		try {
			BufferedReader rd = new BufferedReader(new InputStreamReader(instream, Charset.forName("UTF-8")));
			String jsonText = readAll(rd);
			JSONObject json = new JSONObject(jsonText);
			return json;
		} finally {
			instream.close();
		}
	}
	public static void main(String[] args) throws IOException, JSONException {
		// 请求示例 url 默认请求参数已经URL编码处理
		String url = "https://api-seaver.cn/1688/item_get/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&num_iid=610947572360";
		JSONObject json = getRequestFromUrl(url);
		System.out.println(json.toString());
	}

}

公共参数

名称	类型	必须	描述
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分销代发价格数据

响应参数

Version: Date:

名称	类型	必须	示例值	描述
item	item[]	0		宝贝详情数据
num_iid	String	0	610947572360	宝贝ID
title	String	0	厂家直销小米有品Qin2 Pro智能手机学生机老人机备用机小爱同学4G	商品标题
desc_short	String	0		商品简介
price	Float	0	799.00	价格
total_price	Float	0	0
suggestive_price	Float	0	0
orginal_price	Float	0	799.00	原价
nick	String	0	qin多亲科技	卖家昵称
num	Int	0	2191
detail_url	String	0	https://detail.1688.com/offer/610947572360.html	宝贝链接
pic_url	String	0	https://cbu01.alicdn.com/img/ibank/2020/063/830/13235038360_979836901.jpg	宝贝图片
brand	String	0	MAJE	品牌
brandId	Int	0	8879363	品牌id
rootCatId	Int	0	0	顶级分类ID
cid	Int	0	124264005
desc	String	0
item_imgs	Mix	0	item_imgs[]	商品图片
item_weight	String	0
post_fee	Float	0	9.00	邮费
express_fee	Float	0	9.00	EMS费用
ems_fee	Float	0	9.00	物流费用
shipping_to	String	0	广东广州白云区	发货至
video	video[]	0		商品视频
sample_id	String	0
props_name	String	0	0:0:机身内存:64GB;1:0:颜色:铁灰色;1:1:颜色:瓷白色	商品属性名
prop_imgs	prop_imgs[]	0		商品属性图片列表
property_alias	String	0	0:0:64GB;1:0:铁灰色;1:1:瓷白色	属性别名
props	Mix	0	[{"name": "品牌", "value": "other"}]	商品详情
total_sold	Int	0	1
scale	Int	0
sellUnit	Int	0
skus	skus[]	0		商品规格信息列表
seller_id	Int	0	2206619673102	卖家ID
sales	Int	0	100	销售额
shop_id	Int	0	151372205	店铺ID
props_list	Mix	0	{"0:0": "机身内存:64GB"}	商品属性
seller_info	seller_info[]	0		卖家信息
tmall	Boolean	0	false	是否天猫
data_from	String	0	1688app	错误信息
error	String	0		错误信息
unit	String	0	部;	单位
is_support_mix	Boolean	0	true
mix_amount	Int	0	30
mix_Begin	Int	0
mix_number	Int	0
sales_data	Date	0
location	String	0	广东省 深圳市	发货地
props_img	Mix	0		属性图片
sales_info	Mix	0
desc_img	Mix	0	[{"https://cbu01.alicdn.com/img/ibank/2020/560/807/14112708065_979836901.jpg"}]	详情图片列表
shop_item	Mix	0
relate_items	Mix	0