一、1688店铺详情接口参数说明:
1.通过店铺主链接(例如:shop_url=https://yylsmould.1688.com),可以获取到 店铺id,卖家昵称,店铺类型,公司信息,店铺标题,卖家详细地址,卖家联系电话,店铺主页等页面上有的数据。
点击获取测试key和secret
二、请求参数
请求参数:nick=&shop_url=https://yylsmould.1688.com
参数说明:nick:店铺昵称
shop_url:PC端店铺主页地址
三、响应参数
名称 类型 示例值 描述
items items[] 按关键字搜索商品
id String 950078515 店铺id
nick String 余姚市联盛模塑厂 卖家昵称
good_num String
level String 1
created String 2009年03月23日
shop_type String 个体经营 店铺类型
user_num_id String yylsmould
company_id String 92330281MA2EP3DC93
company_dj String 余姚市市场监督管理局
company_time String 2009-03-23 至 长期
company_info Mix company_info[] 公司信息
comapnyInfo Mix comapnyInfo[] 公司信息
annualRevenue String 人民币 701 万元/年 - 1000 万元/年 年交易额
factorySize String 2800平方米 厂房面积
manufactureType String OEM加工、ODM加工 产品
productionCapacity String 600000件 产量
productionUnit String 件 单位
qaQc String 内部
rndStaffNum String 5 - 10 人 员工数
technologyType String 注塑/注射 特殊工艺
itemList itemList[] 公司信息
itemName String 厂房面积
itemValue String 2800平方米
cid String
sid String yylsmould 店铺ID
pic_url String
video String
title String 余姚市联盛模塑厂 店铺标题
address String 中国浙江宁波余姚市凤山街道五星村上峰岭15号(自主申报) 卖家详细地址
phone String 13429262679
zhuy String https://yylsmould.1688.com./page/contactinfo.htm 店铺主页
fh_score String 0.11
hm_score String 0.02
xy_score String -0.06
ht_score String 0.41
menu String 一般经营项目:模具的制造;塑料制品的加工;第一类医疗器械的制造。
四、请求示例:(CURL、PHP 、PHPsdk 、Java 、C# 、Python)
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://注册账号获取/1688/seller_info/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&nick=&shop_url=https://yylsmould.1688.com";
JSONObject json = getRequestFromUrl(url);
System.out.println(json.toString());
}
}
响应参数:
{
"user": {
"id": "950078515",
"nick": "余姚市联盛模塑厂",
"good_num": null,
"level": "1",
"created": "2009年03月23日",
"shop_type": "个体经营",
"user_num_id": "yylsmould",
"company_id": "92330281MA2EP3DC93",
"company_dj": "余姚市市场监督管理局",
"company_time": "2009-03-23 至 长期",
"company_info": {
"comapnyInfo": {
"annualRevenue": "人民币 701 万元/年 - 1000 万元/年",
"factorySize": "2800平方米",
"manufactureType": "OEM加工、ODM加工",
"productionCapacity": "600000件",
"productionUnit": "件",
"qaQc": "内部",
"rndStaffNum": "5 - 10 人",
"technologyType": "注塑/注射"
},
"itemList": [
{
"itemName": "厂房面积",
"itemValue": "2800平方米"
},
{
"itemName": "研发人数",
"itemValue": "5 - 10 人"
},
{
"itemName": "加工方式",
"itemValue": "OEM加工、ODM加工"
},
{
"itemName": "加工工艺",
"itemValue": "注塑/注射"
},
{
"itemName": "月产量",
"itemValue": "600000件"
},
{
"itemName": "年营业额",
"itemValue": "人民币 701 万元/年 - 1000 万元/年"
},
{
"itemName": "质量控制",
"itemValue": "内部"
}
]
},
"cid": "-1",
"sid": "yylsmould",
"pic_url": null,
"video": null,
"title": "余姚市联盛模塑厂",
"address": "中国浙江宁波余姚市凤山街道五星村上峰岭15号(自主申报)",
"phone": "13429262679",
"zhuy": "https://yylsmould.1688.com./page/contactinfo.htm",
"fh_score": "-0.15",
"hm_score": "0.02",
"xy_score": "-0.13",
"ht_score": "0.36",
"menu": "一般经营项目:模具的制造;塑料制品的加工;第一类医疗器械的制造。"
},
"secache": "fae723b33d52c0870fda3ba6b0c5b577",
"secache_time": 1614932379,
"secache_date": "2021-03-05 16:19:39",
"translate_status": "",
"translate_time": 0,
"language": {
"default_lang": "cn",
"current_lang": "cn"
},
"error": "",
"reason": "",
"error_code": "0000",
"cache": 1,
"api_info": "today:7 max:10000",
"execution_time": 0.062,
"server_time": "Beijing/2021-03-09 16:55:39",
"client_ip": "106.6.35.144",
"call_args": {
"shop_url": "https://yylsmould.1688.com"
},
"api_type": "1688",
"translate_language": "zh-CN",
"translate_engine": "google_cn",
"server_memory": "3.52MB",
"request_id": "gw-4.6047380bae9e5"
}
API 工具
API SDK调用示例
APISDK下载
API测试工具
如何开通API测试,点击立即开通