天眼查API文档

通过此API可以查询企业的基本信息

接口概述

天眼查企业基本信息查询接口允许您通过企业名称或统一社会信用代码查询企业的详细信息。 该接口基于天眼查开放平台的ic/baseinfoV2接口实现。

基础URL

GET /api/tianyan-company-info

请求参数

参数名类型必填描述
keywordString企业名称或统一社会信用代码

请求示例

查询企业信息

curl -X GET "http://localhost:3000/api/tianyan-company-info?keyword=中航重机股份有限公司" \ -H "Authorization: 2f595f6e-770e-4e76-9ec3-e0622d9c7678"

注意:如果使用中文参数,需要对URL进行编码。例如上面的请求应该编码为:

curl -X GET "http://localhost:3000/api/tianyan-company-info?keyword=%E4%B8%AD%E8%88%AA%E9%87%8D%E6%9C%BA%E8%82%A1%E4%BB%BD%E6%9C%89%E9%99%90%E5%85%AC%E5%8F%B8" \ -H "Authorization: 2f595f6e-770e-4e76-9ec3-e0622d9c7678"

响应格式

成功响应

{ "success": true, "data": { // 天眼查返回的企业信息数据 } }

错误响应

{ "success": false, "error": "Failed to fetch company information", "message": "错误描述" }

返回数据结构

天眼查API返回的数据结构较为复杂,包含以下主要字段:

字段名类型描述
resultObject企业基本信息对象
result.idNumber企业ID
result.nameString企业名称
result.creditCodeString统一社会信用代码
result.regNumberString注册号
result.orgNumberString组织机构代码
result.statusString经营状态
result.companyTypeString企业类型
result.legalPersonNameString法定代表人
result.registeredCapitalString注册资本
result.establishTimeString成立日期
result.regLocationString注册地址
result.businessScopeString经营范围

错误码说明

错误码说明
400缺少必要的参数keyword
405请求方法不被允许(仅支持GET)
500服务器内部错误或天眼查API调用失败

更多关于天眼查API的信息,请参考:天眼查开放平台