基本信息
接口地址
https://api.qixin.com/APIService/v2/search/advSearch数据格式
JSON
请求方式
GET
请求示例
https://api.qixin.com/APIService/v2/search/advSearch?keyword=今日头条有限公司描述
根据关键词对企业进行模糊搜索
请求参数 (Headers)
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
Auth-Version |
String | 是 | 2.0(参数值),固定传入:2.0 |
appkey |
String | 是 | 启信慧眼数据开放平台获取 ,获取方式:个人中心-安全中心-API 密钥,获取appkey的同时,请完成IP白名单的配置:个人中心-安全中心-API IP白名单设置,如未配置,接口调试会报错“104 未添加IP白名单” |
timestamp |
String | 是 | UNIX时间戳,精确到毫秒,示例:1656921036000,当前系统时间近10分钟有效 |
sign |
String | 是 | 请求认证签名,对appkey+timestamp+secret_key进行md5或者sha256摘要计算的结果,小写字符串(实际加密不带入‘+’) |
请求参数 (Query)
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
keyword |
String | 是 | 企业相关关键字,输入字数大于等于2个或以上,且不允许仅输入公司和有限公司 |
matchType |
String | 否 | 匹配类型(可选),keyword 需要匹配的 字段,可以输入以下一个或者几个类型, 多个类型使用,分隔: partner:股东 oper:法人 member:高管 contact:联系方式 scope:经营范围 ename:公司名称 patent:专利 copyright:著作权作品名称 software:软件著作权名称 trademark:商标 domain:网址 product:产品 |
region |
String | 否 | 地区编码(可选),输入参数为空返回全 部区域匹配记录。可传入 省/直辖市,城市,区县的国家区划码。 只支持传入一个区划码。 省/直辖市:传入国家区划码前两位数字, 如搜索“江苏省”则传入 32,各省/直辖 市编码可参考本文档附录 城市:传入国家区划码前四位数字,如搜 索“苏州市”,则传入 3205 区县:传入国家区划码六位数字,如搜索 “苏州市吴中区”,则传入 320506 可以通过下面网页查询国家区划编码https://www.mca.gov.cn/mzsj/xzqh/2022/202201xzqh.html |
skip |
Number | 否 | 跳过条目数(默认为0,单页返回10条数据) |
响应参数
| 参数名 | 类型 | 长度 | 描述 |
|---|---|---|---|
datadata.data |
Object | 0 | 返回查询结果,如果没有匹配记录则返回空。具体字段含义见下表 |
totaldata.data.total |
Number | 0 | 返回列表中记录总数 |
numdata.data.num |
Number | 0 | 当前返回的条目数 |
itemsdata.data.items |
Array | 0 | 企业列表 |
matchTypedata.data.items.matchType |
String | 255 | 匹配类型 |
namedata.data.items.name |
String | 255 | 企业名称 |
reg_nodata.data.items.reg_no |
String | 255 | 注册号 |
start_datedata.data.items.start_date |
String | 255 | 成立日期 |
oper_namedata.data.items.oper_name |
String | 255 | 企业法定代表人 |
credit_nodata.data.items.credit_no |
String | 255 | 社会统一信用代码 |
iddata.data.items.id |
String | 36 | 企业编号 |
matchItemsdata.data.items.matchItems |
String | 255 | 匹配关键字 |
typedata.data.items.type |
String | 11 | 企业类型,枚举值:,0企业,4社团,5律所,6香港公司,7非法社团:8台湾;9澳门 |
signdata.sign |
String | 32 | 数据签名 |
statusdata.status |
String | 10 | 返回结果状态 |
messagedata.message |
String | 255 | 返回结果消息 |
响应示例
JSON
{
"status": "200",
"message": "操作成功",
"sign": "99ff6119e92ee89947d3c3547c51f710",
"data": {
"total": 345,
"num": 10,
"items": [
{
"name": "北京抖音信息服务有限公司",
"id": "9c80a8cb-9772-443a-b94f-abb15528e915",
"start_date": "2012-03-09",
"oper_name": "张利东",
"reg_no": "110108014706658",
"credit_no": "911101085923662400",
"matchType": "商标信息",
"matchItems": "TOUTIAO AI LAB 今日头条人工智能实验室",
"type": 0
},
{
"name": "今日头条有限公司",
"id": "ea17d0c8-81c5-4226-9704-97c55aa724c3",
"start_date": "2016-08-24",
"oper_name": "张利东",
"reg_no": "110108021890807",
"credit_no": "91110108MA007R7P8D",
"matchType": "企业名称",
"matchItems": "今日头条有限公司",
"type": 0
},
{
"name": "北京今日头条科技有限公司",
"id": "e1c14cef-2ae8-49d4-a6f4-3833cf870c79",
"start_date": "2016-03-16",
"oper_name": "郭继春",
"reg_no": "110105020933807",
"credit_no": "91110105MA004FR44Q",
"matchType": "企业名称",
"matchItems": "北京今日头条科技有限公司",
"type": 0
},
{
"name": "四川今日头条科技有限公司",
"id": "47b9d7b1-40c1-46ca-9bbd-edebff571f39",
"start_date": "2016-02-23",
"oper_name": "郭继春",
"reg_no": "510108000511714",
"credit_no": "91510108MA61TJXP3X",
"matchType": "企业名称",
"matchItems": "四川今日头条科技有限公司",
"type": 0
},
{
"name": "江苏今日头条信息科技有限公司",
"id": "539a2248-d8af-48e2-9c7f-8b36c65e775a",
"start_date": "2016-04-14",
"oper_name": "张利东",
"reg_no": "320214000277323",
"credit_no": "91320214MA1MJ0PK54",
"matchType": "企业名称",
"matchItems": "江苏今日头条信息科技有限公司",
"type": 0
},
{
"name": "抖音视界(北京)有限公司",
"id": "d34ee051-a611-4aa8-950e-4a28d0133761",
"start_date": "2012-07-25",
"oper_name": "张利东",
"reg_no": "110000450211646",
"credit_no": "91110107599635562F",
"matchType": "商标信息",
"matchItems": "今日头条",
"type": 0
},
{
"name": "浙江今日头条科技有限公司",
"id": "e9f9cfff-a6ac-4bd5-987c-2a5b99e2ccac",
"start_date": "2016-12-08",
"oper_name": "向锐",
"reg_no": "330104000406869",
"credit_no": "91330104MA280JKY5K",
"matchType": "企业名称",
"matchItems": "浙江今日头条科技有限公司",
"type": 0
},
{
"name": "深圳今日头条科技有限公司",
"id": "d535cd5b-7d51-495a-97f1-f7373fb6da85",
"start_date": "2017-12-07",
"oper_name": "张利东",
"reg_no": "440300203144153",
"credit_no": "91440300MA5EWHWQ6J",
"matchType": "企业名称",
"matchItems": "深圳今日头条科技有限公司",
"type": 0
},
{
"name": "湖北今日头条科技有限公司",
"id": "74e7e71d-39e4-4acb-af92-4483f91cadfb",
"start_date": "2018-01-16",
"oper_name": "郭继春",
"reg_no": "420100000911919",
"credit_no": "91420100MA4KXJWQ03",
"matchType": "企业名称",
"matchItems": "湖北今日头条科技有限公司",
"type": 0
},
{
"name": "上海今日头条科技有限公司",
"id": "cd82102c-ae35-4a59-b100-ae9c95fc276e",
"start_date": "2017-02-03",
"oper_name": "赵祺",
"reg_no": "310104000693511",
"credit_no": "91310104MA1FR7C72G",
"matchType": "企业名称",
"matchItems": "上海今日头条科技有限公司",
"type": 0
}
]
}
}
代码示例
javascript
let request = require('request');
let urlEncode = require('urlencode');
let crypto = require('crypto');
let baseUrl = 'https://api.qixin.com/APIService/v2/search/advSearch';
let appkey = '正式appkey';
let secretKey = '正式secret_key';
let timeStamp = new Date().getTime();
const hash = crypto.createHash('md5');
let sign = hash.update(appkey + timeStamp + secretKey).digest('hex');
let urlParams = {
keyword: 'keyword的值',
matchType: 'matchType的值',
region: 'region的值',
skip: 'skip的值'
}
let concatParams = []
for (let key in urlParams) {
concatParams.push(key + '=' + urlParams[key]);
}
let options = {
'method': 'GET',
'url': baseUrl + '?' + concatParams.join('&'),
'headers': {
'Connection': 'keep-alive',
'Auth-version': '2.0',
'appkey': appkey,
'timestamp': timeStamp,
'sign': sign
}
};
request(options, function (error, response) {
if (error) throw new Error(error);
console.log(response.body);
});