?

在企業信息查詢、市場調研或商業智能應用中，獲取精準的企業列表數據至關重要。順企網作為國內知名的企業信息平臺，提供了豐富的企業數據服務。本文將重點介紹其提供的“根據關鍵詞獲取企業列表”API接口，幫助開發者快速集成和使用。

接口功能概述

該API接口的核心功能是允許開發者通過提交一個或多個關鍵詞，檢索與之匹配的企業列表信息。接口返回的結果通常包含企業的基本概要信息，如企業名稱、注冊號、地址、行業分類等。

請求方式與參數

接口通常采用HTTP GET或POST請求方式。以下是一個典型的請求結構所需的關鍵參數：

請求示例URL (GET):

https://api.shunqi.com/v1/enterprises/search?keyword=智能制造&api_key=YOUR_API_KEY&page=1&page_size=10

響應數據結構

成功的響應通常包含以下結構（以JSON格式為例）：

{
  "code": 200,
  "msg": "success",
  "data": {
    "total": 1250, // 符合條件的企業總數
    "page": 1, // 當前頁碼
    "page_size": 10, // 當前頁企業數量
    "list": [
      {
        "id": "1234567890", // 企業唯一ID
        "name": "某某智能科技有限公司", // 企業名稱
        "reg_no": "XXXXXXXXX", // 注冊號/統一社會信用代碼
        "address": "某省某市某區...", // 注冊地址
        "industry": "制造業/專用設備制造", // 所屬行業
        "legal_person": "張某某", // 法定代表人
        "reg_capital": "1000萬元", // 注冊資本
        "est_date": "2015-08-10" // 成立日期
      },
      // ... 更多企業信息
    ]
  }
}

錯誤碼說明

接口調用可能返回的錯誤碼示例：

調用示例代碼 (Python)

以下是一個使用Python requests庫調用該接口的簡單示例：

import requests

def search_shunqi_enterprises(keyword, api_key, page=1, page_size=10):
    """
    根據關鍵詞搜索順企網企業列表
    :param keyword: 搜索關鍵詞
    :param api_key: API密鑰
    :param page: 頁碼
    :param page_size: 每頁數量
    :return: 企業列表數據 (dict)
    """
    url = "https://api.shunqi.com/v1/enterprises/search"
    params = {
        "keyword": keyword,
        "api_key": api_key,
        "page": page,
        "page_size": page_size
    }
    try:
        response = requests.get(url, params=params)
        response.raise_for_status()  # 檢查HTTP錯誤
        data = response.json()
        if data.get('code') == 200:
            return data['data']  # 返回數據部分
        else:
            print(f"API Error: {data.get('msg')} (Code: {data.get('code')})")
            return None
    except requests.exceptions.RequestException as e:
        print(f"Request failed: {e}")
        return None

# 使用示例
api_key = "YOUR_ACTUAL_API_KEY"  # 替換為你的真實API密鑰
results = search_shunqi_enterprises("環保設備", api_key)
if results:
    print(f"找到 {results['total']} 家企業")
    for enterprise in results['list']:
        print(f"- {enterprise['name']} ({enterprise['industry']})")

注意事項與最佳實踐

API密鑰保護：api_key是身份憑證，務必妥善保管，避免在客戶端代碼或公開倉庫中泄露。

參數編碼：確保關鍵詞等參數正確進行URL編碼處理。

錯誤處理：代碼中應包含完善的錯誤處理邏輯，應對網絡問題、API限流或返回錯誤。

調用頻率限制：遵守平臺規定的調用頻率限制（Rate Limit），避免因頻繁請求被封禁。可考慮使用緩存或異步任務。

分頁處理：當結果數量龐大時，需要循環處理分頁（page）參數獲取所有數據。

數據用途：嚴格遵守順企網的API使用協議和數據授權范圍。

總結

順企網的“根據關鍵詞獲取企業列表”API是一個功能強大且實用的工具，為開發者提供了便捷的企業信息查詢通道。通過理解其請求參數、響應結構和錯誤處理機制，開發者可以高效地將此功能集成到自己的應用系統中，服務于企業信息查詢、商業分析、潛在客戶挖掘等多種業務場景。在實際開發中，請務必參考順企網官方提供的最新API文檔以獲取最準確的信息。如有任何疑問，歡迎大家留言探討。

?
審核編輯 黃宇