店铺详情API接口的作用是获取一个电商平台上某个店铺的详细信息,包括店铺名称、销售商品数量、好评度、logo、店铺描述等。开发者可以通过该接口获取到店铺的原始数据,方便进行数据分析、爬取等操作。
通过该接口获取到的店铺详情数据可以结合其他数据进行深度挖掘,例如可以将店铺数据对比分析,找出竞争对手和市场机会,并对店铺进行定位和优化。
总的来说,该接口可以帮助开发者深度挖掘电商平台上的店铺数据,从而更好地为客户提供个性化服务和优质商品推荐。
1688.seller_info-获得店铺详情【获取接口免费测试请私信】
公共参数
名称 | 类型 | 必须 | 描述 |
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版本 |
请求参数
请求参数:seller_id=2206619673102
参数说明:seller_id:卖家id
响应参数
Version: Date:
名称 | 类型 | 必须 | 示例值 | 描述 |
items | items[] | 0 | 按关键字搜索商品 | |
id | String | 0 | 950078515 | 店铺id |
nick | String | 0 | 余姚市联盛模塑厂 | 卖家昵称 |
good_num | String | 0 | ||
level | String | 0 | 1 | |
created | String | 0 | 2009年03月23日 | |
shop_type | String | 0 | 个体经营 | 店铺类型 |
user_num_id | String | 0 | yylsmould | |
company_id | String | 0 | 92330281MA2EP3DC93 | |
company_dj | String | 0 | 余姚市市场监督管理局 | |
company_time | String | 0 | 2009-03-23 至 长期 | |
company_info | Mix | 0 | company_info[] | 公司信息 |
cid | String | 0 | ||
sid | String | 0 | yylsmould | 店铺ID |
pic_url | String | 0 | ||
video | String | 0 | ||
title | String | 0 | 余姚市联盛模塑厂 | 店铺标题 |
address | String | 0 | 中国浙江宁波余姚市凤山街道五星村上峰岭15号(自主申报) | 卖家详细地址 |
phone | String | 0 | 13429262679 | |
zhuy | String | 0 | 店铺主页 | |
fh_score | String | 0 | 0.11 | |
hm_score | String | 0 | 0.02 | |
xy_score | String | 0 | -0.06 | |
ht_score | String | 0 | 0.41 | |
menu | String | 0 | 一般经营项目:模具的制造;塑料制品的加工;第一类医疗器械的制造。 |
PHP请求示例
<?php
// 请求示例 url 默认请求参数已经URL编码处理
// 本示例代码未加密secret参数明文传输,若要加密请参考:https://help/demo/sdk/demo-sign.php
$method = "GET";
$url = "https://1688/seller_info/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&seller_id=2206619673102";
$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));
?>
响应示例
{
"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"
}
异常示例
{
"error": "item-not-found",
"reason": "商品没找到",
"error_code": "2000",
"success": 0,
"cache": 0,
"api_info": "today:0 max:10000",
"execution_time": 0.081,
"server_time": "Beijing/2020-06-10 23:44:00",
"call_args": [],
"api_type": "taobao",
"request_id": "15ee0ffc041242"}
错误码解释
状态代码(error_code) | 状态信息 | 详细描述 | 是否收费 |
0000 | success | 接口调用成功并返回相关数据 | 是 |
2000 | Search success but no result | 接口访问成功,但是搜索没有结果 | 是 |
4000 | Server internal error | 服务器内部错误 | 否 |
4001 | Network error | 网络错误 | 否 |
4002 | Target server error | 目标服务器错误 | 否 |
4003 | Param error | 用户输入参数错误 | 忽略 |
4004 | Account not found | 用户帐号不存在 | 忽略 |
4005 | Invalid authentication credentials | 授权失败 | 忽略 |
4006 | API stopped | 您的当前API已停用 | 忽略 |
4007 | Account stopped | 您的账户已停用 | 忽略 |
4008 | API rate limit exceeded | 并发已达上限 | 忽略 |
4009 | API maintenance | API维护中 | 忽略 |
4010 | API not found with these values | API不存在 | 忽略 |
4012 | Please add api first | 请先添加api | 忽略 |
4013 | Number of calls exceeded | 调用次数超限 | 忽略 |
4014 | Missing url param | 参数缺失 | 忽略 |
4015 | Wrong pageToken | 参数pageToken有误 | 忽略 |
4016 | Insufficient balance | 余额不足 | 忽略 |
4017 | timeout error | 请求超时 | 否 |
5000 | unknown error | 未知错误 | 否 |
文章内容有限,欢迎私信沟通!