天眼查平台关键字搜索企业数据API接口技术指南

​

一、接口概述

天眼查提供的企业搜索API接口，支持通过关键字查询企业工商信息、经营状态等核心数据。该接口采用RESTful架构，返回JSON格式数据。

二、接口认证

调用需使用API密钥认证：

 

GET /open/search/v2/company?keyword={关键字}
Authorization: Bearer {您的API密钥}

 

三、请求参数

参数名	类型	必选	说明
keyword	string	是	企业名称/注册号/统一信用代码
pageSize	int	否	分页大小（默认20）
pageNum	int	否	当前页码（默认1）
sortField	string	否	排序字段（如：base）

四、响应结构

 

{
  "result": {
    "total": 128,
    "items": [
      {
        "name": "示例科技有限公司",
        "creditCode": "91310112MA1XXXXXX",
        "regStatus": "存续",
        "legalPerson": "张三",
        "regCapital": "1000万元"
      }
    ]
  }
}

 

五、Python调用示例

 

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调用失败: {str(e)}")
        return []

# 示例调用
companies = search_companies("科技", "YOUR_API_KEY")
for company in companies:
    print(f"企业名称: {company['name']}, 状态: {company['regStatus']}")

 

六、注意事项

频率限制：免费版通常限制100次/天

数据字段：不同套餐返回字段深度不同

错误代码：

401：认证失败

429：请求过于频繁

500：服务器内部错误

七、典型应用场景

企业征信核查

供应链管理

竞品分析

投资尽调

客户资信评估

​审核编辑 黄宇