企业档案深度查询

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` 专利,仅法律状态含「公开」:名称、类型、法律状态、公开号、公开日期 空列表不报错。未请求的维度不会出现在响应里。

POSThttps://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
打开 Markdown

鉴权

需要 API Key。开放极少量匿名试用(1 次/日);登录用户免费 3 次/日,超出按 ¥0.08/次 扣费;黄金会员 200 次/日、企业会员 10000 次/日免费。注:risk 维度会额外消耗较多服务调用,建议按需查询。

获取 API Key:/account/keys

请求头

Header类型必填说明
Authorizationstring必填鉴权。推荐:Bearer <API Key>。兼容请求头 X-API-Key,以及 Query api_key / apikey / key(key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效)。付费接口需携带有效 Key。
Content-Typestring请求体格式

请求参数

POST · APPLICATION/JSON

参数类型必填说明示例
companystring企业名称(2-80 字、含中文,支持简称/全称模糊搜索);兼容别名 name阿里巴巴
dimensionstring查询维度,逗号分隔。可选: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

字段类型说明
basicobject工商基本信息
basic.company_namestring企业全称
basic.legal_personstring法定代表人
basic.credit_codestring统一社会信用代码
basic.register_capitalstring注册资本
basic.establish_datestring成立日期
basic.business_statusstring经营状态
basic.industrystring所属行业
basic.register_addressstring注册地址
basic.business_scopestring经营范围
extensionobject企业化扩展(年限/规模标签/状态/活力评分/摘要)
extension.company_age_yearsnumber成立年限
extension.register_capital_labelstring规模标签(巨型/大型/中型/小型/微型企业)
extension.vitality_scorenumber企业活力评分(0-100)
extension.summarystring自然语言摘要
statsobject各维度记录计数
shareholdersarray股东列表(dimension 含 shareholders 时返回)
executivesarray主要成员(dimension 含 executives 时返回)
investmentsarray对外投资(dimension 含 investments 时返回)
changesarray变更记录(dimension 含 changes 时返回)
riskobject风险综合:被执行/失信/限高/经营异常/严重违法/行政处罚(dimension 含 risk 时返回)
annual_reportsobject年报(dimension 含 annual_report 时返回):total + list[{year,release_date}] + latest
annual_reports.latestobject最近一年年报:year、release_date(详情未通时先给这两项)
licensesobject资质/行政许可(dimension 含 licenses 时返回)。旧字段 name/number/authority/issue_date/end_date/status/product 保留
licenses.list.start_datestring有效起始期(新增别名,多回落发证日)
licenses.list.end_datestring有效截止期
licenses.list.file_nostring许可文件编号
licenses.list.file_namestring许可文件名称
licenses.list.license_authoritystring许可机关
licenses.list.contentstring许可内容
licenses.admin_licensesobject行政许可列表:total + list[{start_date,end_date,file_no,file_name,license_authority,content}];源未通时为空列表
trademarksobject商标(dimension 含 trademarks 时返回)。仅「商标注册」「商标申请」
trademarks.list.announcement_datestring公告日期(新增)
patentsobject专利(dimension 含 patents 时返回)。仅法律状态含「公开」
patents.list.namestring专利名称
patents.list.typestring专利类型
patents.list.legal_statusstring法律状态(仅公开/公布)
patents.list.pub_nostring公开号
patents.list.pub_datestring公开日期
stats.annual_report_countnumber年报年份条数
stats.license_countnumber资质/许可条数
stats.admin_license_countnumber行政许可条数
stats.trademark_countnumber过滤后的商标条数
stats.patent_countnumber过滤后的专利条数
tipsstring品牌提示(所有接口统一返回):极数本源 · 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)

在线调试

填写参数后运行,将真实调用接口;计入免费额度。

RequestPOST
POST https://v1.apizero.cn/api/company-profile

认证方式

参数(2)

>_

待运行

填写参数后点击「运行调试」查看响应

错误码

先看业务 code。HTTP 也可能不是 200。

业务码HTTP说明
0200成功
4000400参数错误
4011401API Key 无效
4013403API Key 已暂停
4014403当前 IP 不在 Key 白名单
4015401此接口需要 API Key
4022402余额不足
4029429调用过快(QPS)
4030429今日免费额度已用完
4040503接口已下线
4041404接口不存在
5000500服务器内部错误
5020502上游暂时不可用
5021502上游返回格式异常
5030502暂无可用节点

额度与计费

计费模式按次付费 · 点数包
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

    首次上线:企业多维度深度档案(工商/股东/高管/投资/变更/风险)+ 活力评分。

免责声明

本接口企业工商及风险数据来源于公开权威渠道,仅供商业尽调与风控参考,不构成任何投资或合作决策依据;最终以国家企业信用信息公示系统等官方登记信息为准。严禁将本接口用于非法调查、骚扰、欺诈等用途,由此产生的一切法律责任由调用方自行承担。