计费
一次请求的费用，以及如何追溯。
各端点和功能的价格
API 以积分计费。每个请求收取其端点的基础价格，再加上返回数据的功能以及你选择的附加费。所有套餐的价格都相同。你的套餐决定你可以使用哪些功能。
| 端点 | 内容 | 积分 |
|---|---|---|
| fetch-organization | 含基本数据的公司档案 | 5 |
| fetch-organization | 功能，见下一张表 | 1 至 80 |
| fetch-organization | AI 模式附加费，即使没有匹配 | +20 |
| fetch-organization | 实时模式附加费，每次成功的实时获取 | +10 |
| fetch-person | 人物档案，含网络检索（Plus 起） | 15 |
| fetch-person |
功能 shareholdings，仅在返回数据时
|
+5 |
| fetch-person |
功能 network（Pro、Max），仅在返回数据时
|
+25 |
| search-organizations | 一页结果，即使为空 | 1 |
| fetch-document | 一份已交付的文件 | 15 |
| signals | 一页 Signals 或单条信号 | 20 |
| signals |
主题目录 /v1/signals/catalog
|
免费 |
| account, auth | 账户、余额、用量、密钥、令牌和 Webhook 端点 | 免费 |
你可以逐个请求 fetch-organization 的功能。每个功能仅在返回数据时收费：
| 功能 | 内容 | 积分 | 套餐 |
|---|---|---|---|
| related_persons | 管理层 | 2 | 所有账户 |
| shareholders | 股东（Beta） | 5 | 所有账户 |
| shareholders_deep | 深度股东信息 | 80 | Max |
| ubos | 受益所有人（UBO，Beta） | 10 | 所有账户 |
| shareholdings | 持股（Beta） | 5 | 所有账户 |
| mergers_and_acquisitions | 合并与收购（M&A，Beta） | 20 | 所有账户 |
| network | 公司关系网络（Beta） | 25 | Pro, Max |
| publications | 历史记录：登记公告 | 1 | 所有账户 |
| financial_kpi | 财务 KPI | 1 | 所有账户 |
| balance_sheet_accounts | 资产负债表 | 3 | 所有账户 |
| profit_and_loss_account | 损益表（P&L） | 3 | 所有账户 |
| annual_financial_statements | 年度财务报表（Markdown） | 5 | 所有账户 |
| annual_financial_statements__html | 年度财务报表（HTML） | 5 | 所有账户 |
| insolvency_publications | 破产公告 | 5 | 所有账户 |
| news | 新闻 | 10 | 所有账户 |
| website_content | 网站内容 · 仅与 AI 模式一起使用 | 免费 | 所有账户 |
使用所有功能和两种附加费时，一次 fetch-organization 请求最多花费 215 积分。Max 包含这一范围。
一个监控每 30 天收取固定价格，取决于检查间隔。创建监控和首次基线免费。
| 检查间隔 | 每 30 天的积分 |
|---|---|
| 每天 | 50 |
| 每 3 天 | 40 |
| 每 7 天 | 20 |
| 每 30 天 | 10 |
| 周期内每次额外的成功检查 | +2 |
介于这些档位之间的间隔，按下一个更频繁的档位收费。详见 account/monitors。
只为返回数据的部分付费
没有数据的功能不收费。如果它返回 null 或空列表，你无需为它付费。这适用于每个功能，包括 insolvency_publications：没有破产公告时它免费。
基础价格和附加费遵循各自的规则。每交付一份公司档案，你都要支付基础价格。AI 模式即使没有匹配也收费。实时模式在每次成功的实时获取时收费，即使登记册中没有任何变化。详见附加费。
对于某些功能，具体内容很关键：
shareholders和shareholders_deep仅在有当前条目时收费。只有历史记录时免费。mergers_and_acquisitions仅在有交易、控制关系或法律承继时收费。network仅在至少有一个关联时收费。news只要列表中至少有一篇文章就收费。
fetch-organization 会省略你的套餐不包含的功能，且不计费。
对于搜索与导出、文件和 Signals，你为请求本身付费：一页结果、一份文件、一页 Signals。没有结果的搜索和空的 Signals 页面也会计费。
失败或被拒绝的请求不收费，见错误。
AI 模式和实时模式的附加费
fetch-organization 有两种附加费，你可以按请求开启。
AI 模式（ai_search=on-default，+20 积分）即使根据模糊输入也能找到公司，并在网络上检索。检索一旦运行就会计费，即使没有找到公司或数据源报告错误。只有当 API 以 408 中止请求时才不计费。
实时模式（realtime_mode=handelsregister-default，+10 积分）从 Handelsregister（商业登记册）实时获取已登记的人员。实时获取成功时我们收取附加费，无论返回什么。此时 _realtime_mode.status 的值为 success。
该字段为其他任何值都表示实时获取失败。此时你会得到已存储的数据，并为请求的其余部分付费，不收取实时模式附加费。如果请求耗时过长，API 返回 408，不收费。
1{2 "name": "Hetzner Online GmbH",3 "_realtime_mode": {4 "mode": "handelsregister-default",5 "status": "success"6 },7 "meta": {8 "request_credit_cost": 15,9 "credits_remaining": 14510 }11}
响应中的费用
每个响应都会告诉你它的费用。JSON 响应中位于 meta，文件则位于响应头中。
| 位置 | 含义 |
|---|---|
| meta.request_credit_cost |
此请求的费用。使用幂等键的重试以及几乎所有错误，该值为 0。
|
| meta.credits_remaining | 请求后的余额。 |
| X-Credits-Charged | signals 和已交付的文件：请求的费用，以响应头形式提供。 |
| X-Credits-Remaining | 已交付的文件：请求后的余额，以响应头形式提供。 |
1{2 "name": "Hetzner Online GmbH",3 "meta": {4 "request_credit_cost": 5,5 "credits_remaining": 1456 }7}
身份验证时的拒绝（401、403）和超出限制（429）通常不带 meta。它们从不收费。
每笔扣费都可以在“账户 › 用量”下以及通过 API 的 GET /v1/account/usage/transactions 查到，见 account。
积分不足
在 API 处理请求之前，它会检查你的余额是否足以支付可能的最高费用：基础价格、所有请求的功能和附加费。如果不够，API 返回 402 且不收费。
响应在 meta.request_credit_cost 中显示这一最高值，在 meta.credits_remaining 中显示你的余额。之后实际扣除的金额往往更低，因为没有数据的功能不收费。
举例：含 AI 模式和功能 ubos 的基本数据，事先需要 35 积分。如果 ubos 没有返回数据，请求费用为 25 积分。
signals 以 Problem Details 和代码 INSUFFICIENT_CREDITS 响应。
积分订阅和充值积分
每个新账户都会获得 150 初始积分。有效期为 30 天。
使用积分订阅（Plus、Pro、Max 或 Enterprise）时，你每月都会获得积分。它们在计费周期结束前有效。如果你更换套餐，未用完的月度积分会带入新的周期。Plus 起可以使用 fetch-person；Pro 和 Max 解锁更多数据。
充值积分是一次性额外购买的。没有积分订阅时，它们的有效期为 30 天。只要积分订阅在运行，充值积分和初始积分都不会过期。
你可以在“账户 › 积分”下以及通过 API 的 GET /v1/account/credits 查看余额以及何时有积分到期。
所有套餐和价格见价格页面。