在企业业务扩展、供应商引入、代理招商、金融风控等场景中,对合作方进行快速、高效的预审已成为刚需。而现实中,企业名称、法人姓名、注册号等信息往往存在“模糊不清”或“非标准”输入,这给系统识别带来了极大挑战。
为了帮助开发者和企业用户解决这一难题,我们提供了一个灵活、高效的接口 —— 企业高级搜索API(ApiCode: 886),支持通过关键词模糊搜索企业基本信息,为后续的详细核验和风控排查打下坚实基础。
一、接口功能概述
接口名称:企业高级搜索
接口地址:https://api.qichacha.com/FuzzySearch/GetList
请求方式:GET
支持格式:JSON
推荐应用场景:
- 商业风控系统:客户信息预审、合作方资质初筛
- 销售拓客平台:通过人名/地址/电话筛选潜在客户企业
- 商家入驻平台:自动识别用户填写的模糊企业名称
- 数据运营:通过关键字批量搜索并构建企业基础信息池
二、请求参数说明
请求头参数(Headers):
参数名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
Token | String | 是 | 鉴权Token:Md5(key + Timespan + SecretKey) 的32位大写字符串 |
Timespan | String | 是 | 精确到秒的Unix时间戳 |
请求查询参数(Query):
参数名 | 类型 | 是否必填 | 描述 |
---|---|---|---|
key | String | 是 | 应用AppKey |
searchKey | String | 是 | 搜索关键字,如企业名、统一社会信用代码、注册号等 |
provinceCode | String | 否 | 可选的省份编码(6位) |
cityCode | String | 否 | 可选的城市编码(6位) |
pageSize | String | 否 | 每页条数,默认10,最大不超过20 |
pageIndex | String | 否 | 当前页码,默认第一页 |
三、返回参数说明
调用成功后,返回结构如下:
{
"Paging": {
"PageSize": 1,
"PageIndex": 1,
"TotalRecords": 88
},
"Result": [
{
"KeyNo": "xxxxxxxxxxx",
"Name": "北京小桔科技有限公司",
"CreditCode": "91440300XXXXXXX",
"StartDate": "2012-07-10",
"OperName": "程某",
"Status": "存续",
"No": "4403011XXXXXXX",
"Address": "北京市朝阳区XXXXXXX"
}
],
"Status": "200",
"Message": "查询成功",
"OrderNumber": "FUZZYSEARCH2021012016353715836099"
}
四、实战示例:Node.js 快速接入
const axios = require('axios');
const crypto = require('crypto');
function generateToken(appKey, timespan, secretKey) {
return crypto.createHash('md5').update(appKey + timespan + secretKey).digest('hex').toUpperCase();
}
async function fuzzySearchCompany(appKey, searchKey, secretKey) {
const timespan = Math.floor(Date.now() / 1000);
const token = generateToken(appKey, timespan, secretKey);
const url = `https://api.qichacha.com/FuzzySearch/GetList?key=${appKey}&searchKey=${encodeURIComponent(searchKey)}`;
try {
const response = await axios.get(url, {
headers: {
'Token': token,
'Timespan': timespan.toString(),
}
});
const data = response.data;
if (data.Result && data.Result.length > 0) {
console.log("企业搜索结果:", data.Result[0]);
} else {
console.log("未匹配到企业信息");
}
} catch (error) {
console.error("接口调用失败:", error);
}
}
// 示例调用
fuzzySearchCompany('your_app_key', '北京小桔科技', 'your_secret_key');
五、典型使用场景
- ✅ 风控平台预审:接收到企业名“xxxxx”,可模糊匹配所有包含该关键词的企业,结合后续企业核验接口,完成精准验证。
- ✅ 自动补全输入:用户在表单输入“xxx”,可实时展示相关企业下拉框,提升用户体验。
- ✅ 销售拓客:输入“共享单车”,返回包含该关键词的企业及法人信息,用于电销线索扩展。
六、总结
企业高级搜索API是风控预审、客户识别、用户运营等场景的第一道门槛。相比传统企业名称精确匹配,它支持更灵活的关键词模糊查询,为业务流程节省大量人工比对成本。
在与企业信息核验API(2001)、工商详情API(735)等接口联动使用时,能构建一套完整的企业信息识别与合规流程,从预判到验证无缝衔接。