?

引言 愛企查作為國內知名的企業信息查詢平臺，匯聚了海量的企業工商信息、經營數據等。對于開發者或數據分析師而言，若能通過其開放的 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}")

四、重要參數說明 (常見字段示例)

五、使用注意事項

合規合法: 嚴格遵守愛企查平臺的 API 使用協議。獲取的數據僅可用于協議允許的用途，不得用于非法目的或侵犯他人隱私、商業秘密。

授權與配額: 確保已獲得相應接口的調用授權，并了解接口的調用頻率限制（QPS、日限額等），避免因超限導致服務中斷。

數據更新: 企業信息是動態變化的，API 返回的數據可能存在延遲。對于時效性要求高的場景，需考慮數據的更新頻率。

參數校驗: 在代碼中做好請求參數的校驗和錯誤處理，提高程序的健壯性。

敏感信息: 處理返回數據時，注意對可能的敏感信息（如身份證號片段、聯系方式，如果接口返回的話）進行脫敏或謹慎處理。

接口變更: 平臺 API 可能升級或調整，需關注官方公告，及時更新調用方式。

結語 通過愛企查的 API 接口獲取企業詳情數據，為開發者整合企業信息、進行商業分析、風險監控等應用提供了強大的數據支持。開發者在使用時應本著合規、尊重的原則，充分利用這一寶貴的數據資源。務必詳細閱讀并遵守愛企查開放平臺的最新官方文檔和協議規定。

?審核編輯 黃宇