实施步骤
API调用示例(1116-企业基本信息)
客户在购买API后,可选择所购买的API接口进行相关调校工作。具体接口信息可在网址:https://open.tianyancha.com/api_list 获取

因为天眼查商业查询的216个接口,对接操作方式相同,因此下面以API“1116-企业基本信息”为例,做使用调测说明。
获取API基本信息
基本信息:

是否需要授权
是,需要添加请求header
HttpGet get = new HttpGet(url); get.setHeader("Authorization", token); 根据代码示例修改获取方式
/**
* @param path 对⽅或第三⽅提供的路径
* @param token
* @return
*/
public static String getMessageByUrlToken(String path,String token){
String result="";
try {
// 根据地址获取请求
HttpGet request = new HttpGet(path);//这⾥发送get请求
// 获取当前客户端对象
request.setHeader("Authorization", token);
HttpClient httpClient = new DefaultHttpClient();
// 通过请求对象获取响应对象
HttpResponse response = httpClient.execute(request);
// 判断网络连接状态码是否正常(0--200都数正常)
if (response.getStatusLine().getStatusCode() == HttpStatus.SC_OK) {
result= EntityUtils.toString(response.getEntity(),"utf-8"); }
} catch (Exception e) {
// TODO Auto-generated catch block e.printStackTrace();
e.printStackTrace();
}
return result;
}
// 访问授权限制访问级别:普通接⼝ 请求参数
参数 | 必选 | 类型及范围 | 说明 |
|---|---|---|---|
keyword | true | String | 搜索关键字(公司名称、公司id、注册号或社会统⼀信⽤代码) |

请求参数需要URLEncode。
返回结果校验
JSON示例
{
“result”: {
"historyNames" : “贵州力源液压股份有限公司;”,
"cancelDate" null,
"regStatus" : “存续”,
"regCapital" : “77800.32万人民币”,
"city" : “毕节市”,
"staffNumRange" : “5000-9999人”,
"bondNum" : “600765”,
"historyNameList" : [“贵州力源液压股份有限公司”],
"industry" : “汽车制造业”,
"bondName" : “中航重机”,
"revokeDate" : null,
"type" : 1,
"updateTimes" : 1620622963000,
"legalPersonName" : “姬苏春”,
"revokeReason" : “”,
"regNumber" : “520000000005018”,
"creditCode" : “91520000214434146R”,
"property3" : “AVIC Heavy Machinery Co.,Ltd.”,
"usedBondName" : “力源液压->G力源->力源液压”,
"approvedTime" : 1582646400000,
"fromTime" : 847900800000,
"socialStaffNum" : 9023,
"actualCapitalCurrency" : “人民币”,
"alias" : “中航重机”,
"company0rgType" : “其他股份有限公司(上市)”,
"id" : 11684584,
"cancelReason" : “”,
"orgNumber" : “214434146”,
"toTime" : null,
"actualCapital" : “77800.32万人民币”,
"estiblishTime" : 847900800000,
"regInstitute" : “贵阳市市场监督管理局贵州双龙航空港经济区分局”,
"businessScope" : “法律、法规、国务院决定规定禁止的不得经营;”,
"taxNumber" : “91520000214434146R”,
"regCapitalCurrency" : “人民币”,
"tags" : “企业集团;存续;融资轮次;上市信息;项目品牌;投资机构;曾用名”,
"district" : “威宁彝族回族苗族自治县”,
"bondType" : “A股”,
"name" : “中航重机股份有限公司”,
"percentileScore" : 9696,
"industryAll" : {
"categoryMiddle" : “改装汽车制造”,
"categoryBig" : “汽车制造”,
"category" : “制造业”,
"categorySmall" : “”
},
"isMicroEnt" : 0,
"base" : “gz”,
},
“reason”: “ok”,
“reason”: 0
} 关于错误返回值与错误代码,参⻅错误代码说明
返回字段说明
根据返回字段进行调校。
返回值字段 | 字段类型 | 字段说明 | 备注 |
|---|---|---|---|
result | Object | - | - |
historyNames | String | varchar(255) | 曾⽤名 |
regStatus | String | varchar(31) | 企业状态 |
cancelDate | Number | 时间戳 | 注销⽇期 |
regCapital | String | varchar(50) | 注册资本 |
city | String | varchar(20) | 市 |
staffNumRange | String | varchar(200) | ⼈员规模 |
industry | String | varchar(255) | ⾏业 |
historyNameList | Array | - | 曾⽤名 |
bondNum | String | varchar(20) | 股票号 |
type | Number | int(1) | 法⼈类型,1 ⼈ 2 公司 |
bondName | String | varchar(20) | 股票名 |
updateTimes | Number | 时间戳 | 更新时间 |
revokeDate | Number | 时间戳 | 吊销⽇期 |
legalPersonName | String | varchar(255) | 法⼈ |
revokeReason | String | varchar(500) | 吊销原因 |
regNumber | String | varchar(31) | 注册号 |
property3 | String | varchar(255) | 英⽂名 |
creditCode | String | varchar(255) | 统⼀社会信⽤代码 |
usedBondName | String | varchar(20) | 股票曾⽤名 |
fromTime | Number | 时间戳 | 经营开始时间 |
approvedTime | Number | 时间戳 | 核准时间 |
socialStaffNum | Number | int(10) | 参保⼈数 |
alias | String | varchar(255) | 简称 |
companyOrgType | String | varchar(127) | 企业类型 |
actualCapitalCurrency | String | varchar(10) | 实收注册资本币种 ⼈⺠币 美元 欧元 等 |
id | Number | int(20) | 企业id |
orgNumber | String | varchar(31) | 组织机构代码 |
cancelReason | String | varchar(500) | 注销原因 |
toTime | Number | 时间戳 | 经营结束时间 |
actualCapital | String | varchar(50) | 实收注册资⾦ |
estiblishTime | Number | 时间戳 | 成⽴⽇期 |
regInstitute | String | varchar(255) | 登记机关 |
taxNumber | String | varchar(255) | 纳税⼈识别号 |
businessScope | String | varchar(4091) | 经营范围 |
regLocation | String | varchar(255) | 注册地址 |
regCapitalCurrency | String | varchar(10) | 注册资本币种 ⼈⺠币 美元 欧元 等 |
tags | String | varchar(255) | 企业标签 |
district | String | varchar(20) | 区 |
name | String | varchar(255) | 企业名 |
bondType | String | varchar(31) | 股票类型 |
percentileScore | Number | 万分制 | 企业评分 |
industryAll | Object | - | 国⺠经济⾏业分类 |
categoryMiddle | String | varchar(255) | 国⺠经济⾏业分类中类 |
categoryBig | String | varchar(255) | 国⺠经济⾏业分类⼤类 |
category | String | varchar(255) | 国⺠经济⾏业分类⻔类 |
categorySmall | String | varchar(255) | 国⺠经济⾏业分类⼩类 |
isMicroEnt | Number | int(1) | 是否是⼩微企业 0不是 1是 |
base | String | varchar(31) | 省份简称 |
reason | String | - | 错误信息 |
error_code | Number | - | 状态码 |
错误代码说明
代码 | 说明 |
|---|---|
0 | 请求成功 |
300000 | ⽆数据 |
300001 | 请求失败 |
300002 | 账号失效 |
300003 | 账号过期 |
300004 | 访问频率过快 |
300005 | ⽆权限访问此api |
300006 | 余额不⾜ |
300007 | 剩余次数不⾜ |
300008 | 缺少必要参数 |
300009 | 账号信息有误 |
300010 | URL不存在 |
300011 | 此IP⽆权限访问此api |
300012 | 报告⽣成中 |

