企业档案深度查询
company-profilePOSThttps://v1.apizero.cn/api/company-profile概述
输入企业名称,返回单企业多维度档案:工商基本信息、股东、高管、对外投资、变更记录、六类风险,以及年报(含最近一年)、资质/行政许可、商标、专利。`dimension` 逗号分隔按需查询,默认 `basic`(会自动带上)。**旧字段只增不删。** ## 可查询维度 - `basic` 工商基本信息(默认必带) - `shareholders` / `executives` / `investments` / `changes` / `risk` - `annual_report` 年报年份列表 + `annual_reports.latest`(仅最近一年:年份、发布日期) - `licenses` 资质证书(旧字段保留)+ 行政许可六字段:`start_date`、`end_date`、`file_no`、`file_name`、`license_authority`、`content`;另有 `admin_licenses` - `trademarks` 商标,仅「商标注册」「商标申请」,含 `announcement_date` - `patents` 专利,仅法律状态含「公开」:名称、类型、法律状态、公开号、公开日期 空列表不报错。未请求的维度不会出现在响应里。
调用约定
- 网关 ·
https://v1.apizero.cn - 鉴权 ·
Authorization: Bearer <API Key> - 回包 · JSON {code, msg, data}。成功看 code === 0,不要只看 HTTP 200。
/aidocs/company-profile/raw.md鉴权
匿名可调用:QPS 1、日 1 次(仅供试用);登录后:QPS 3、日 3 次;黄金会员:QPS 10、日 200 次;钻石会员:QPS 30、日 1000 次;企业会员:QPS 120、日 10000 次。批量查询请控制在QPS 120以内。
获取 API Key:获取 API Key/account/keys
请求头
必填鉴权。推荐:Bearer <API Key>。兼容请求头 X-API-Key,以及 Query api_key / apikey / key(key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效)。付费接口需携带有效 Key。
请求体格式
| Header | 类型 | 必填 | 说明 |
|---|---|---|---|
| Authorization | string | 是 | 必填鉴权。推荐:Bearer <API Key>。兼容请求头 X-API-Key,以及 Query api_key / apikey / key(key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效)。付费接口需携带有效 Key。 |
| Content-Type | string | 否 | 请求体格式 |
请求参数
POST · APPLICATION/JSON
企业名称(2-80 字、含中文,支持简称/全称模糊搜索);兼容别名 name
例阿里巴巴
查询维度,逗号分隔。可选:basic(基本信息)、shareholders(股东)、executives(高管)、investments(对外投资)、changes(变更记录)、risk(风险综合)、annual_report(年报年份+最近一年)、licenses(资质/行政许可)、trademarks(商标,含初审公告等在审状态,不含驳回/无效/撤销/终止/注销)、patents(专利,仅公开)
例basic,annual_report,licenses,trademarks,patents
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| company(企业名称) | string | 是 | 企业名称(2-80 字、含中文,支持简称/全称模糊搜索);兼容别名 name | 阿里巴巴 |
| dimension(查询维度) | string | 否 | 查询维度,逗号分隔。可选:basic(基本信息)、shareholders(股东)、executives(高管)、investments(对外投资)、changes(变更记录)、risk(风险综合)、annual_report(年报年份+最近一年)、licenses(资质/行政许可)、trademarks(商标,含初审公告等在审状态,不含驳回/无效/撤销/终止/注销)、patents(专利,仅公开) | basic,annual_report,licenses,trademarks,patents |
{
"company": "阿里巴巴",
"dimension": "basic,annual_report,licenses,trademarks,patents"
}返回结果
顶层固定为 code / msg / data。下表一般是 data 内字段。 code · msg · data · tips · request_id
工商基本信息
企业全称
法定代表人
统一社会信用代码
注册资本
成立日期
经营状态
所属行业
注册地址
经营范围
企业化扩展(年限/规模标签/状态/活力评分/摘要)
成立年限
规模标签(巨型/大型/中型/小型/微型企业)
企业活力评分(0-100)
自然语言摘要
各维度记录计数
股东列表(dimension 含 shareholders 时返回)
shareholders 的一项
主要成员(dimension 含 executives 时返回)
executives 的一项
对外投资(dimension 含 investments 时返回)
investments 的一项
变更记录(dimension 含 changes 时返回)
changes 的一项
风险综合:被执行/失信/限高/经营异常/严重违法/行政处罚(dimension 含 risk 时返回)
年报(dimension 含 annual_report 时返回):total + list[{year,release_date}] + latest
最近一年年报:year、release_date(详情未通时先给这两项)
资质/行政许可(dimension 含 licenses 时返回)。旧字段 name/number/authority/issue_date/end_date/status/product 保留
有效起始期(新增别名,多回落发证日)
有效截止期
许可文件编号
许可文件名称
许可机关
许可内容
行政许可列表:total + list[{start_date,end_date,file_no,file_name,license_authority,content}];源未通时为空列表
商标(dimension 含 trademarks 时返回)。仅「商标注册」「商标申请」
公告日期(新增)
专利(dimension 含 patents 时返回)。仅法律状态含「公开」
专利名称
专利类型
法律状态(仅公开/公布)
公开号
公开日期
年报年份条数
资质/许可条数
行政许可条数
过滤后的商标条数
过滤后的专利条数
品牌提示(所有接口统一返回):极数本源 · https://apizero.cn
| 字段 | 类型 | 说明 | |||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| basic | object | 工商基本信息 | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
| extension | object | 企业化扩展(年限/规模标签/状态/活力评分/摘要) | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
| stats | object | 各维度记录计数 | |||||||||||||||||||||||||||
| shareholders | array | 股东列表(dimension 含 shareholders 时返回) | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
| executives | array | 主要成员(dimension 含 executives 时返回) | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
| investments | array | 对外投资(dimension 含 investments 时返回) | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
| changes | array | 变更记录(dimension 含 changes 时返回) | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
| risk | object | 风险综合:被执行/失信/限高/经营异常/严重违法/行政处罚(dimension 含 risk 时返回) | |||||||||||||||||||||||||||
| annual_reports | object | 年报(dimension 含 annual_report 时返回):total + list[{year,release_date}] + latest | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
| licenses | object | 资质/行政许可(dimension 含 licenses 时返回)。旧字段 name/number/authority/issue_date/end_date/status/product 保留 | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
| trademarks | object | 商标(dimension 含 trademarks 时返回)。仅「商标注册」「商标申请」 | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
| patents | object | 专利(dimension 含 patents 时返回)。仅法律状态含「公开」 | |||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
| stats.annual_report_count | number | 年报年份条数 | |||||||||||||||||||||||||||
| stats.license_count | number | 资质/许可条数 | |||||||||||||||||||||||||||
| stats.admin_license_count | number | 行政许可条数 | |||||||||||||||||||||||||||
| stats.trademark_count | number | 过滤后的商标条数 | |||||||||||||||||||||||||||
| stats.patent_count | number | 过滤后的专利条数 | |||||||||||||||||||||||||||
| tips | string | 品牌提示(所有接口统一返回):极数本源 · https://apizero.cn | |||||||||||||||||||||||||||
返回示例
{
"code": 0,
"msg": "成功",
"data": {
"basic": {
"company_name": "阿里巴巴(中国)有限公司",
"legal_person": "示例",
"credit_code": "9133...",
"register_capital": "1.4 亿美元",
"establish_date": "2007-03-26",
"business_status": "存续"
},
"extension": {
"company_age_years": 19,
"register_capital_label": "巨型企业",
"vitality_score": 92,
"vitality_level": "极高",
"summary": "……"
},
"stats": {
"shareholder_count": 3,
"risk_total": 0
},
"dimensions": [
"basic"
]
},
"request_id": "...",
"tips": "极数本源 · https://apizero.cn"
}请求示例
示例都是服务端写法。Python / JavaScript 各有常规写法和官方库。
curl -sS -X POST "https://v1.apizero.cn/api/company-profile" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"company": "阿里巴巴",
"dimension": "basic,annual_report,licenses,trademarks,patents"
}'错误码
先看业务 code。HTTP 也可能不是 200。
成功
参数错误
API Key 无效
API Key 已暂停
当前 IP 不在 Key 白名单
此接口需要 API Key
余额不足
调用过快(QPS)
今日免费额度已用完
接口已下线
接口不存在
服务器内部错误
上游暂时不可用
上游返回格式异常
暂无可用节点
| 业务码 | HTTP | 说明 |
|---|---|---|
| 0 | 200 | 成功 |
| 4000 | 400 | 参数错误 |
| 4011 | 401 | API Key 无效 |
| 4013 | 403 | API Key 已暂停 |
| 4014 | 403 | 当前 IP 不在 Key 白名单 |
| 4015 | 401 | 此接口需要 API Key |
| 4022 | 402 | 余额不足 |
| 4029 | 429 | 调用过快(QPS) |
| 4030 | 429 | 今日免费额度已用完 |
| 4040 | 503 | 接口已下线 |
| 4041 | 404 | 接口不存在 |
| 5000 | 500 | 服务器内部错误 |
| 5020 | 502 | 上游暂时不可用 |
| 5021 | 502 | 上游返回格式异常 |
| 5030 | 502 | 暂无可用节点 |
调用限制
- 计费模式
- 按次付费 · 点数包
- QPS 限制
- QPS 3
- 登录免费额度
- 3 次(已认证)
- 匿名每日额度
- 1 次(无 API Key)
- 黄金会员
- 每天 200 次 · QPS 10
- 钻石会员
- 每天 1,000 次 · QPS 30
- 企业会员
- 本接口约 4,987 次/月 · QPS 120
| 计费模式 | 按次付费 · 点数包 |
|---|---|
| QPS 限制 | QPS 3 |
| 登录免费额度 | 3 次(已认证) |
| 匿名每日额度 | 1 次(无 API Key) |
| 黄金会员 | 每天 200 次 · QPS 10 |
| 钻石会员 | 每天 1,000 次 · QPS 30 |
| 企业会员 | 本接口约 4,987 次/月 · QPS 120 |
购买套餐、看评价请走商城详情。 购买 / 调试
更新日志
- 1.22026-08-28
- 1.12026-08-27
- v1.02026-07-02
首次上线:企业多维度深度档案(工商/股东/高管/投资/变更/风险)+ 活力评分。
免责声明
本接口企业工商及风险数据来源于公开权威渠道,仅供商业尽调与风控参考,不构成任何投资或合作决策依据;最终以国家企业信用信息公示系统等官方登记信息为准。严禁将本接口用于非法调查、骚扰、欺诈等用途,由此产生的一切法律责任由调用方自行承担。