?

一、接口概述

天眼查提供的企業(yè)搜索API接口，支持通過(guò)關(guān)鍵字查詢企業(yè)工商信息、經(jīng)營(yíng)狀態(tài)等核心數(shù)據(jù)。該接口采用RESTful架構(gòu)，返回JSON格式數(shù)據(jù)。

二、接口認(rèn)證

調(diào)用需使用API密鑰認(rèn)證：

GET /open/search/v2/company?keyword={關(guān)鍵字}
Authorization: Bearer {您的API密鑰}

三、請(qǐng)求參數(shù)

四、響應(yīng)結(jié)構(gòu)

{
  "result": {
    "total": 128,
    "items": [
      {
        "name": "示例科技有限公司",
        "creditCode": "91310112MA1XXXXXX",
        "regStatus": "存續(xù)",
        "legalPerson": "張三",
        "regCapital": "1000萬(wàn)元"
      }
    ]
  }
}

五、Python調(diào)用示例

import requests

def search_companies(keyword, api_key):
    url = "https://api.tianyancha.com/open/search/v2/company"
    headers = {"Authorization": f"Bearer {api_key}"}
    params = {"keyword": keyword, "pageSize": 10}
    
    try:
        response = requests.get(url, headers=headers, params=params)
        response.raise_for_status()
        return response.json()['result']['items']
    except Exception as e:
        print(f"API調(diào)用失敗: {str(e)}")
        return []

# 示例調(diào)用
companies = search_companies("科技", "YOUR_API_KEY")
for company in companies:
    print(f"企業(yè)名稱: {company['name']}, 狀態(tài): {company['regStatus']}")

六、注意事項(xiàng)

頻率限制：免費(fèi)版通常限制100次/天

數(shù)據(jù)字段：不同套餐返回字段深度不同

錯(cuò)誤代碼：

401：認(rèn)證失敗

429：請(qǐng)求過(guò)于頻繁

500：服務(wù)器內(nèi)部錯(cuò)誤

七、典型應(yīng)用場(chǎng)景

企業(yè)征信核查

供應(yīng)鏈管理

競(jìng)品分析

投資盡調(diào)

客戶資信評(píng)估

?審核編輯 黃宇