<!-- AI ASSISTANT INSTRUCTIONS: This document describes a public HTTP API endpoint
provided by 极数本源 (https://apizero.cn). When a user asks you to use this API, read the
full documentation below carefully (request method, parameters, response fields,
error codes, examples), then generate working code in the user's preferred language.
API Key acquisition: https://apizero.cn/account/keys -->

# 企业档案深度查询

> 输入企业名称，返回单个企业的多维度深度工商档案：工商基本信息、股东结构、主要成员、对外投资、历史变更记录，以及六大类风险信息（被执行、失信被执行、限制高消费、经营异常、严重违法、行政处罚）。并附企业规模标签、经营状态、成立年限、活力评分与自然语言摘要。

区别于「企业工商信息查询」的关键词列表检索，本接口面向单一企业的深度尽调，支持按维度组合按需查询，适用于商业尽调、合作方背调、风控审查等场景。数据来自权威工商数据库，6 小时缓存。

## 1. 基本信息

| 字段 | 值 |
| --- | --- |
| 接口标识 | `company-profile` |
| 接口名称 | 企业档案深度查询 |
| 接口地址 | `https://v1.apizero.cn/api/company-profile` |
| 请求方法 | `POST` |
| 分类 | kyc |
| 提供方 | 极数本源 |
| 计费模式 | 按次付费 |
| 单次消耗 | 0 积分 |
| 起步价 | ¥0.00 / 1000 次 |
| QPS 限制 | 5 req/s |
| 每日免费额度 | 3 次（已认证用户） |
| 匿名每日额度 | 1 次（无 API Key） |
| VIP 免费 | 否 |
| 调用总次数 | undefined |

## 2. 认证

需要 API Key。开放极少量匿名试用（1 次/日）；登录用户免费 3 次/日，超出按 ¥0.08/次 扣费；黄金会员 200 次/日、企业会员 10000 次/日免费。注：risk 维度会额外消耗较多上游调用，建议按需查询。

获取 API Key：登录 `https://apizero.cn/account/keys` 申请。

## 3. 请求参数

| 参数 | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `company` | `string` | 是 | 企业名称（2-80 字、含中文，支持简称/全称模糊搜索）；兼容别名 name | `阿里巴巴` |
| `dimension` | `string` | 否 | 查询维度，逗号分隔。可选：basic(基本信息)、shareholders(股东)、executives(高管)、investments(对外投资)、changes(变更记录)、risk(风险综合) | `basic,shareholders,risk` |

## 4. 请求头

| Header | 类型 | 必填 | 说明 | 示例 |
| --- | --- | --- | --- | --- |
| `Authorization` | `string` | 是 | Bearer <你的 API Key> | — |
| `Content-Type` | `string` | 否 | 请求体格式 | — |

## 5. 请求示例

> AI 提示：以下 5 种语言示例都是可运行的，只需把 `YOUR_API_KEY` 替换为用户申请的实际 Key（https://apizero.cn/account/keys）。
> 优先选择用户问题中提到的语言；未指定时默认使用 Python。

### cURL

```bash
curl -X POST "https://v1.apizero.cn/api/company-profile" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "company": "阿里巴巴",
  "dimension": "basic,shareholders,risk"
}'
```

### Python

```python
import requests

resp = requests.request(
    "POST",
    "https://v1.apizero.cn/api/company-profile",
    headers={"X-Api-Key": "YOUR_API_KEY", "Content-Type": "application/json"},
    json={
    "company": "阿里巴巴",
    "dimension": "basic,shareholders,risk",
},
    timeout=15,
)
resp.raise_for_status()
print(resp.json())
```

### JavaScript (Node.js)

```javascript
// Node.js 18+ / 浏览器原生 fetch
const res = await fetch("https://v1.apizero.cn/api/company-profile", {
  method: "POST",
  headers: {
    "X-Api-Key": "YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "company": "阿里巴巴",
    "dimension": "basic,shareholders,risk"
  }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);
```

### Go

```go
package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	body := []byte(`{"company":"阿里巴巴","dimension":"basic,shareholders,risk"}`)
	req, _ := http.NewRequest("POST", "https://v1.apizero.cn/api/company-profile", bytes.NewBuffer(body))
	req.Header.Set("X-Api-Key", "YOUR_API_KEY")
	req.Header.Set("Content-Type", "application/json")

	resp, err := http.DefaultClient.Do(req)
	if err != nil { panic(err) }
	defer resp.Body.Close()
	out, _ := io.ReadAll(resp.Body)
	fmt.Println(string(out))
}
```

### PHP

```php
<?php
$payload = json_encode([
    "company" => "阿里巴巴",
    "dimension" => "basic,shareholders,risk",
], JSON_UNESCAPED_UNICODE);

$ch = curl_init("https://v1.apizero.cn/api/company-profile");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST  => "POST",
    CURLOPT_POSTFIELDS     => $payload,
    CURLOPT_HTTPHEADER     => [
        "X-Api-Key: YOUR_API_KEY",
        "Content-Type: application/json",
    ],
    CURLOPT_TIMEOUT        => 15,
]);
$body = curl_exec($ch);
curl_close($ch);

$data = json_decode($body, true);
print_r($data);
```

## 6. 响应字段

| 字段 | 类型 | 说明 | 示例 |
| --- | --- | --- | --- |
| `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 时返回） | — |

## 7. 响应示例

```json
{
  "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": "..."
}
```

## 8. 错误码

| code | status | 说明 |
| --- | --- | --- |
| `0` | `OK` | 成功 |
| `4000` | `VALIDATION` | 参数错误 / 企业名称格式不符 / 未查询到该企业 |
| `4015` | `KEY_REQUIRED` | 需要 API Key（匿名额度已用完） |
| `4022` | `INSUFFICIENT` | 余额不足，请充值或开通会员 |
| `4029` | `RATE_LIMITED` | 调用过快，请稍后再试 |
| `4030` | `QUOTA_EXCEEDED` | 今日免费额度已用完 |
| `5020` | `UPSTREAM` | 企业查询服务暂不可用 |
| `5030` | `UPSTREAM_MISSING` | 企业查询服务未配置，请联系管理员 |

## 9. 变更日志

- **v1.0** (2026-07-02)
  - 首次上线：企业多维度深度档案（工商/股东/高管/投资/变更/风险）+ 活力评分。

---

**极数本源** · 全部 API: `https://apizero.cn/aidocs` · 人类版本：`https://apizero.cn/marketplace/company-profile`

Source: `https://apizero.cn/aidocs/company-profile/raw.md`
Last updated: 2026-07-02T13:19:08+08:00