企业档案深度查询
company-profilePOST输入企业名称,返回单企业多维度档案:工商基本信息、股东、高管、对外投资、变更记录、六类风险,以及年报(含最近一年)、资质/行政许可、商标、专利。`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/api/company-profile平台约定
- 网关 ·
https://v1.apizero.cn - 鉴权 ·
Authorization: Bearer <API Key> - 回包 · JSON {code, msg, data}。成功看 code === 0,不要只看 HTTP 200。
/aidocs/company-profile/raw.md鉴权
需要 API Key。开放极少量匿名试用(1 次/日);登录用户免费 3 次/日,超出按 ¥0.08/次 扣费;黄金会员 200 次/日、企业会员 10000 次/日免费。注:risk 维度会额外消耗较多服务调用,建议按需查询。
获取 API Key:/account/keys
请求头
| 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
| 参数 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| 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
| 字段 | 类型 | 说明 |
|---|---|---|
| basic | object | 工商基本信息 |
| basic.company_name | string | 企业全称 |
| basic.legal_person | string | 法定代表人 |
| basic.credit_code | string | 统一社会信用代码 |
| basic.register_capital | string | 注册资本 |
| basic.establish_date | string | 成立日期 |
| basic.business_status | string | 经营状态 |
| basic.industry | string | 所属行业 |
| basic.register_address | string | 注册地址 |
| basic.business_scope | string | 经营范围 |
| extension | object | 企业化扩展(年限/规模标签/状态/活力评分/摘要) |
| extension.company_age_years | number | 成立年限 |
| extension.register_capital_label | string | 规模标签(巨型/大型/中型/小型/微型企业) |
| extension.vitality_score | number | 企业活力评分(0-100) |
| extension.summary | string | 自然语言摘要 |
| 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 |
| annual_reports.latest | object | 最近一年年报:year、release_date(详情未通时先给这两项) |
| licenses | object | 资质/行政许可(dimension 含 licenses 时返回)。旧字段 name/number/authority/issue_date/end_date/status/product 保留 |
| licenses.list.start_date | string | 有效起始期(新增别名,多回落发证日) |
| licenses.list.end_date | string | 有效截止期 |
| licenses.list.file_no | string | 许可文件编号 |
| licenses.list.file_name | string | 许可文件名称 |
| licenses.list.license_authority | string | 许可机关 |
| licenses.list.content | string | 许可内容 |
| licenses.admin_licenses | object | 行政许可列表:total + list[{start_date,end_date,file_no,file_name,license_authority,content}];源未通时为空列表 |
| trademarks | object | 商标(dimension 含 trademarks 时返回)。仅「商标注册」「商标申请」 |
| trademarks.list.announcement_date | string | 公告日期(新增) |
| patents | object | 专利(dimension 含 patents 时返回)。仅法律状态含「公开」 |
| patents.list.name | string | 专利名称 |
| patents.list.type | string | 专利类型 |
| patents.list.legal_status | string | 法律状态(仅公开/公布) |
| patents.list.pub_no | string | 公开号 |
| patents.list.pub_date | string | 公开日期 |
| 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"
}请求示例
将 YOUR_API_KEY 替换为真实 Key 后运行。
# 1. 密钥:登录 https://apizero.cn/account/keys 申请,写入环境变量 APIZERO_KEY
# 请求头 Authorization: Bearer <key>
import json
import os
import urllib.request
key = os.environ["APIZERO_KEY"]
# 2. 请求地址
url = "https://v1.apizero.cn/api/company-profile"
# 3. 发请求
payload = {
"company": "阿里巴巴",
"dimension": "basic,annual_report,licenses,trademarks,patents",
}
req = urllib.request.Request(
url,
data=json.dumps(payload, ensure_ascii=False).encode("utf-8"),
headers={
"Authorization": "Bearer " + key,
"Content-Type": "application/json",
},
method="POST",
)
with urllib.request.urlopen(req, timeout=15) as resp:
body = json.loads(resp.read().decode("utf-8"))
# 4. 打印整包。
# 第 5 步的字段按本接口 data 里实际键改。
print(json.dumps(body, ensure_ascii=False, indent=2))
# 5. code == 0 后再取字段
if body.get("code") == 0:
data = body.get("data") or {}
print(data)在线调试
填写参数后运行,将真实调用接口;计入免费额度。
认证方式
参数(2)
待运行
填写参数后点击「运行调试」查看响应
错误码
先看业务 code。HTTP 也可能不是 200。
| 业务码 | 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 限制 | 3 req/s |
| 登录免费额度 | 3 次(已认证) |
| 匿名每日额度 | 1 次(无 API Key) |
| 黄金会员 | 每日 200 次 · QPS 10 |
| 企业会员 | 每日 10000 次 · QPS 120 |
购买套餐、看评价请走商城详情。 购买 / 调试
变更日志
- 1.22026-08-28
- 1.12026-08-27
- v1.02026-07-02
首次上线:企业多维度深度档案(工商/股东/高管/投资/变更/风险)+ 活力评分。
免责声明
本接口企业工商及风险数据来源于公开权威渠道,仅供商业尽调与风控参考,不构成任何投资或合作决策依据;最终以国家企业信用信息公示系统等官方登记信息为准。严禁将本接口用于非法调查、骚扰、欺诈等用途,由此产生的一切法律责任由调用方自行承担。