企业档案深度查询

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

鉴权

匿名可调用:QPS 1、日 1 次(仅供试用);登录后:QPS 3、日 3 次;黄金会员:QPS 10、日 200 次;钻石会员:QPS 30、日 1000 次;企业会员:QPS 120、日 10000 次。批量查询请控制在QPS 120以内。

获取 API Key

请求头

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

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

basicobject

工商基本信息

company_namestring

企业全称

legal_personstring

法定代表人

credit_codestring

统一社会信用代码

register_capitalstring

注册资本

establish_datestring

成立日期

business_statusstring

经营状态

industrystring

所属行业

register_addressstring

注册地址

business_scopestring

经营范围

extensionobject

企业化扩展(年限/规模标签/状态/活力评分/摘要)

company_age_yearsnumber

成立年限

register_capital_labelstring

规模标签(巨型/大型/中型/小型/微型企业)

vitality_scorenumber

企业活力评分(0-100)

summarystring

自然语言摘要

statsobject

各维度记录计数

shareholdersarray

股东列表(dimension 含 shareholders 时返回)

shareholders[]string

shareholders 的一项

executivesarray

主要成员(dimension 含 executives 时返回)

executives[]string

executives 的一项

investmentsarray

对外投资(dimension 含 investments 时返回)

investments[]string

investments 的一项

changesarray

变更记录(dimension 含 changes 时返回)

changes[]string

changes 的一项

riskobject

风险综合:被执行/失信/限高/经营异常/严重违法/行政处罚(dimension 含 risk 时返回)

annual_reportsobject

年报(dimension 含 annual_report 时返回):total + list[{year,release_date}] + latest

latestobject

最近一年年报:year、release_date(详情未通时先给这两项)

licensesobject

资质/行政许可(dimension 含 licenses 时返回)。旧字段 name/number/authority/issue_date/end_date/status/product 保留

list.start_datestring

有效起始期(新增别名,多回落发证日)

list.end_datestring

有效截止期

list.file_nostring

许可文件编号

list.file_namestring

许可文件名称

list.license_authoritystring

许可机关

list.contentstring

许可内容

admin_licensesobject

行政许可列表:total + list[{start_date,end_date,file_no,file_name,license_authority,content}];源未通时为空列表

trademarksobject

商标(dimension 含 trademarks 时返回)。仅「商标注册」「商标申请」

list.announcement_datestring

公告日期(新增)

patentsobject

专利(dimension 含 patents 时返回)。仅法律状态含「公开」

list.namestring

专利名称

list.typestring

专利类型

list.legal_statusstring

法律状态(仅公开/公布)

list.pub_nostring

公开号

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"
}

请求示例

示例都是服务端写法。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。

0200

成功

4000400

参数错误

4011401

API Key 无效

4013403

API Key 已暂停

4014403

当前 IP 不在 Key 白名单

4015401

此接口需要 API Key

4022402

余额不足

4029429

调用过快(QPS)

4030429

今日免费额度已用完

4040503

接口已下线

4041404

接口不存在

5000500

服务器内部错误

5020502

上游暂时不可用

5021502

上游返回格式异常

5030502

暂无可用节点

调用限制

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

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

免责声明

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