API文档 搜索查询 企业模糊搜索
基本信息
接口地址
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条数据)
响应参数
参数名类型长度描述
data
data.data
Object 0 返回查询结果,如果没有匹配记录则返回空。具体字段含义见下表
total
data.data.total
Number 0 返回列表中记录总数
num
data.data.num
Number 0 当前返回的条目数
items
data.data.items
Array 0 企业列表
matchType
data.data.items.matchType
String 255 匹配类型
name
data.data.items.name
String 255 企业名称
reg_no
data.data.items.reg_no
String 255 注册号
start_date
data.data.items.start_date
String 255 成立日期
oper_name
data.data.items.oper_name
String 255 企业法定代表人
credit_no
data.data.items.credit_no
String 255 社会统一信用代码
id
data.data.items.id
String 36 企业编号
matchItems
data.data.items.matchItems
String 255 匹配关键字
type
data.data.items.type
String 11 企业类型,枚举值:,0企业,4社团,5律所,6香港公司,7非法社团:8台湾;9澳门
sign
data.sign
String 32 数据签名
status
data.status
String 10 返回结果状态
message
data.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);
});