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

是 否 +2 论坛币

k人 参与回答

经管之家送您一份

应届毕业生专属福利!

求职就业群

赵安豆老师微信：zhaoandou666

经管之家联合CDA

送您一个全额奖学金名额~ !

立即领取

感谢您参与论坛问题回答

经管之家送您两个论坛币！

+2 论坛币

一、接口功能说明

天眼查开放的企业搜索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

：服务端发生内部异常

七、主要应用方向

• 客户资信审核
• 投资项目的尽职调查
• 供应链上下游企业信息核验
• 竞争对手分析
• 企业信用评估

扫码加我 拉你入群

请注明：姓名-公司-职位

以便审核进群资格，未注明则拒绝

分享0 收藏0 回帖

关键词：企业数据 API 关键字 Companies exception