企查查开放平台接口实战系列（一）：企业高级搜索接口使用指南

zhensherlock

已于 2025-04-15 17:05:18 修改

阅读量548

点赞数 14

分类专栏：企查查开放平台文章标签： node.js 数据分析大数据

于 2025-04-15 17:04:52 首次发布

本文链接：https://blog.csdn.net/zhensherlock/article/details/147142249

版权

企查查开放平台专栏收录该内容

1 篇文章

订阅专栏

本系列文章将逐一介绍企查查开放平台提供的常用接口，帮助开发者快速接入企业信息数据。本篇作为开篇，聚焦“企业高级搜索”接口，带您一步步完成接入。

一、接口简介

企业高级搜索接口允许开发者通过关键词（如企业名、人名、产品名、地址、电话、经营范围等）搜索匹配的企业列表信息，返回的数据包括但不限于企业名称、法定代表人、企业状态、成立日期、统一社会信用代码、注册号等。

接口地址：

https://api.qichacha.com/FuzzySearch/GetList

支持格式：JSON
请求方式：GET

该接口适用于企业信息查询、市场调研、客户挖掘等场景。

二、申请准备

1. 注册并申请 AppKey 与 SecretKey

前往企查查开放平台注册账号，并申请接口权限，获取以下信息：

AppKey：应用标识
SecretKey：私密密钥

这两个参数将用于生成请求签名。

三、签名机制

调用接口需在 HTTP 请求头中携带签名参数，签名算法如下：

获取当前时间戳 Timespan，精确到秒的 Unix 时间戳。
将 AppKey、Timespan 和 SecretKey 拼接成字符串：AppKey + Timespan + SecretKey
对拼接后的字符串进行 MD5 加密，得到 32 位大写字符串，即为 Token

Node.js 示例代码：

const crypto = require('crypto');

function generateToken(appKey, secretKey) {
  const timespan = Math.floor(Date.now() / 1000).toString();
  const originStr = appKey + timespan + secretKey;
  const token = crypto.createHash('md5').update(originStr).digest('hex').toUpperCase();
  return { token, timespan };
}

请求头示例：

Token: {生成的Token}
Timespan: {生成的Unix时间戳}

四、请求参数说明

参数名称	类型	是否必填	描述
key	String	是	应用 AppKey
searchKey	String	是	搜索关键字，如企业名、人名、地址等
provinceCode	String	否	省份代码（6 位行政区划代码）
cityCode	String	否	城市代码（6 位行政区划代码）
pageSize	String	否	每页条数，默认 10，最大 20
pageIndex	String	否	页码，默认第一页

💡 行政区划代码可参考接口页面提供的 Excel 文档。

五、请求示例（Node.js）

const axios = require('axios');
const crypto = require('crypto');

const appKey = 'your_appkey';
const secretKey = 'your_secretkey';

const timespan = Math.floor(Date.now() / 1000).toString();
const originStr = appKey + timespan + secretKey;
const token = crypto.createHash('md5').update(originStr).digest('hex').toUpperCase();

const headers = {
  Token: token,
  Timespan: timespan,
};

const params = {
  key: appKey,
  searchKey: '字节跳动',
  pageSize: '10',
  pageIndex: '1',
};

axios.get('https://api.qichacha.com/FuzzySearch/GetList', { headers, params })
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.error(error);
  });

六、返回结果示例

{
  "Status": "200",
  "Message": "成功",
  "Result": [
    {
      "KeyNo": "d5f1f5f1f5f1f5f1f5f1f5f1f5f1f5f1",
      "Name": "北京字节跳动科技有限公司",
      "CreditCode": "91110108051341136B",
      "StartDate": "2012-03-12",
      "OperName": "张一鸣",
      "Status": "存续",
      "No": "110108015939901",
      "Address": "北京市海淀区知春路甲48号2号楼10A"
    }
  ]
}