爱企查平台企业详情数据 API 接口使用指南

​

引言 爱企查作为国内知名的企业信息查询平台，汇聚了海量的企业工商信息、经营数据等。对于开发者或数据分析师而言，若能通过其开放的 API 接口获取这些结构化数据，将极大地提升工作效率和应用开发的可能性。本文将探讨如何通过爱企查平台的 API 接口获取企业详情数据。

一、API 接口概述 爱企查平台提供的 API 接口允许授权用户根据特定的查询条件（如企业名称、统一社会信用代码等）获取目标企业的详细信息。返回的数据通常以 JSON 格式组织，包含企业的基本注册信息、股东结构、高管信息、经营状态、知识产权等核心数据。

二、核心步骤

获取 API 访问权限与密钥

访问爱企查开放平台官网（通常在官网能找到开发者中心或开放平台的入口）。

注册开发者账号，创建应用。

获取应用专属的 API Key（有时也称为 App Key 或 Secret Key）。这个密钥是调用 API 的身份凭证，务必妥善保管。

理解 API 请求格式 爱企查的企业详情查询 API 通常是一个 HTTP GET 请求。其基本 URL 结构可能如下：

https://api.aqicha.com/enterprise/detail?key=[您的API Key]&keyword=[查询关键词]

key: 必填参数，填入您申请到的 API Key。

keyword: 必填参数，可以是企业全称、企业简称或统一社会信用代码（18位）。建议使用精确匹配以提高成功率。

其他可选参数可能包括 pageSize（每页返回条数）、pageNum（页码）等，用于分页查询或结果集控制。

解析 API 响应 成功调用后，API 会返回一个 JSON 对象。其结构一般包含：

code: 状态码（如 200 表示成功）。

message: 状态信息（如 "成功"）。

data: 核心数据对象，包含企业详情信息。其内部结构可能包含多个嵌套对象或数组，例如：

baseInfo: 基础信息（名称、注册号、法定代表人、注册资本、成立日期、经营状态、行业等）。

shareholders: 股东信息列表（股东名称、出资比例、出资额等）。

managers: 主要管理人员列表（姓名、职务）。

ipc: 知识产权信息（商标、专利等，可能单独有接口）。

... (其他信息字段根据接口版本不同而变化)。

错误处理 需处理常见的错误情况，例如：

400：请求参数错误（如缺少必填参数）。

401：API Key 无效或未授权。

404：未找到匹配的企业。

429：请求过于频繁，触发限流。

500：服务器内部错误。

三、Python 示例代码 以下是一个使用 Python requests 库调用爱企查企业详情 API 的简单示例：

import requests

# 替换为您自己的 API Key
API_KEY = 'YOUR_API_KEY_HERE'
# 要查询的企业名称或信用代码
KEYWORD = '北京百度网讯科技有限公司'

# 构建 API 请求 URL
url = f'https://api.aqicha.com/enterprise/detail?key={API_KEY}&keyword={KEYWORD}'

try:
    # 发送 GET 请求
    response = requests.get(url)
    # 检查 HTTP 状态码
    response.raise_for_status()
    # 解析 JSON 响应
    data = response.json()

    # 检查 API 返回的状态码
    if data['code'] == 200:
        # 获取企业基础信息
        base_info = data['data']['baseInfo']
        print(f"企业名称: {base_info['entName']}")
        print(f"法定代表人: {base_info['legalPerson']}")
        print(f"注册资本: {base_info['regCap']} {base_info['regCapCur']}")
        print(f"成立日期: {base_info['esDate']}")
        print(f"经营状态: {base_info['entStatus']}")
        # ... 可以继续解析其他信息，如股东、高管等
    else:
        print(f"API 调用失败! 状态码: {data['code']}, 消息: {data['message']}")

except requests.exceptions.HTTPError as errh:
    print(f"HTTP 错误: {errh}")
except requests.exceptions.ConnectionError as errc:
    print(f"连接错误: {errc}")
except requests.exceptions.Timeout as errt:
    print(f"请求超时: {errt}")
except requests.exceptions.RequestException as err:
    print(f"请求异常: {err}")
except ValueError as ve:
    print(f"JSON 解析错误: {ve}")

四、重要参数说明 (常见字段示例)

参数类型	参数名 (示例)	说明
请求参数	key	API 访问密钥
	keyword	查询关键词 (企业名/信用代码)
	pageSize	(可选) 每页数据条数
	pageNum	(可选) 页码
响应字段	entName	企业名称
(在 data.baseInfo 中)	creditCode	统一社会信用代码
	regNo	注册号
	legalPerson	法定代表人
	regCap	注册资本 (金额)
	regCapCur	注册资本 (币种)
	esDate	成立日期
	entStatus	经营状态 (如 存续、在业、吊销、注销等)
	industry	所属行业
	regAddr	注册地址

五、使用注意事项

合规合法: 严格遵守爱企查平台的 API 使用协议。获取的数据仅可用于协议允许的用途，不得用于非法目的或侵犯他人隐私、商业秘密。

授权与配额: 确保已获得相应接口的调用授权，并了解接口的调用频率限制（QPS、日限额等），避免因超限导致服务中断。

数据更新: 企业信息是动态变化的，API 返回的数据可能存在延迟。对于时效性要求高的场景，需考虑数据的更新频率。

参数校验: 在代码中做好请求参数的校验和错误处理，提高程序的健壮性。

敏感信息: 处理返回数据时，注意对可能的敏感信息（如身份证号片段、联系方式，如果接口返回的话）进行脱敏或谨慎处理。

接口变更: 平台 API 可能升级或调整，需关注官方公告，及时更新调用方式。

结语 通过爱企查的 API 接口获取企业详情数据，为开发者整合企业信息、进行商业分析、风险监控等应用提供了强大的数据支持。开发者在使用时应本着合规、尊重的原则，充分利用这一宝贵的数据资源。务必详细阅读并遵守爱企查开放平台的最新官方文档和协议规定。

​审核编辑 黄宇