課金
リクエストのコストと、その追跡方法。
エンドポイントと機能ごとの料金
APIはクレジットで課金します。各リクエストには、エンドポイントの基本料金に加え、データを返した機能と、選んだ追加料金がかかります。料金はどのプランでも同じです。プランによって、使える機能が決まります。
| エンドポイント | 内容 | クレジット |
|---|---|---|
| fetch-organization | 基本データ付きの企業プロフィール | 5 |
| fetch-organization | 機能（次の表を参照） | 1～80 |
| fetch-organization | AIモードの追加料金（一致がなくても） | +20 |
| fetch-organization | リアルタイムの追加料金（ライブ取得が成功するごとに） | +10 |
| fetch-person | 人物プロフィール、Web調査を含む（Plus以上） | 15 |
| fetch-person |
機能shareholdings（データを返した場合のみ）
|
+5 |
| fetch-person |
機能network（Pro、Max。データを返した場合のみ）
|
+25 |
| search-organizations | 結果1ページ（空のページでも） | 1 |
| fetch-document | 提供された書類1件 | 15 |
| signals | Signals 1ページまたはシグナル1件 | 20 |
| signals |
トピックカタログ/v1/signals/catalog
|
無料 |
| account, auth | アカウント、残高、利用状況、キー、トークン、Webhookエンドポイント | 無料 |
fetch-organizationの機能は1つずつリクエストします。それぞれデータを返した場合のみ課金されます：
| 機能 | 内容 | クレジット | プラン |
|---|---|---|---|
| related_persons | 経営陣 | 2 | すべてのアカウント |
| shareholders | 株主（ベータ） | 5 | すべてのアカウント |
| shareholders_deep | 詳細な株主情報 | 80 | Max |
| ubos | 実質的支配者（UBO、ベータ） | 10 | すべてのアカウント |
| shareholdings | 出資（ベータ） | 5 | すべてのアカウント |
| mergers_and_acquisitions | 合併と買収（M&A、ベータ） | 20 | すべてのアカウント |
| network | 企業ネットワーク（ベータ） | 25 | Pro, Max |
| publications | 履歴：登記公告 | 1 | すべてのアカウント |
| financial_kpi | 財務KPI | 1 | すべてのアカウント |
| balance_sheet_accounts | 貸借対照表 | 3 | すべてのアカウント |
| profit_and_loss_account | 損益計算書 | 3 | すべてのアカウント |
| annual_financial_statements | 年次財務諸表（Markdown） | 5 | すべてのアカウント |
| annual_financial_statements__html | 年次財務諸表（HTML） | 5 | すべてのアカウント |
| insolvency_publications | 倒産公告 | 5 | すべてのアカウント |
| news | ニュース | 10 | すべてのアカウント |
| website_content | Webサイトの内容 · AIモード使用時のみ | 無料 | すべてのアカウント |
すべての機能と両方の追加料金を使うと、fetch-organizationへのリクエストは最大 215 クレジットです。この範囲はMaxに含まれます。
モニターは、チェック間隔に応じて 30 日間ごとに固定料金がかかります。作成と最初のベースラインは無料です。
| チェック間隔 | 30 日間あたりのクレジット |
|---|---|
| 毎日 | 50 |
| 3 日ごと | 40 |
| 7 日ごと | 20 |
| 30 日ごと | 10 |
| 期間内の追加の成功チェック1回ごと | +2 |
これらの段階の間の間隔は、次に頻度の高い段階と同じ料金です。詳しくはaccount/monitorsで。
データを返したものだけ支払う
データのない機能は無料です。nullや空のリストを返した場合、料金はかかりません。これはinsolvency_publicationsを含むすべての機能に当てはまり、倒産公告がなければ無料です。
基本料金と追加料金には独自のルールがあります。基本料金は、提供された企業プロフィールごとにかかります。AIモードは一致がなくてもかかります。リアルタイムは、登記簿に変更がなくても、ライブ取得が成功するたびにかかります。詳しくは追加料金で。
一部の機能では、特定の内容が重要です：
shareholdersとshareholders_deepは、現在の項目がある場合のみかかります。履歴だけなら無料です。mergers_and_acquisitionsは、取引、支配関係、法的承継がある場合のみかかります。networkは、つながりが1つ以上ある場合のみかかります。newsは、リストに記事が1件以上含まれた時点でかかります。
fetch-organizationは、プランに含まれない機能を省き、課金しません。
検索とエクスポート、書類、Signalsでは、リクエストそのものに料金がかかります：結果1ページ、書類1件、Signals 1ページ。結果のない検索や空のSignalsのページも課金されます。
失敗したリクエストや拒否されたリクエストは無料です。エラーを参照。
AIモードとリアルタイムの追加料金
fetch-organizationには、リクエストごとにオンにする2つの追加料金があります。
AIモード（ai_search=on-default、+20 クレジット）は、あいまいな入力からでも企業を見つけ、Webで調査します。企業が見つからなくても、データソースがエラーを報告しても、調査が実行された時点で課金されます。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 |
このリクエストのコスト。Idempotencyキーでの再試行とほぼすべてのエラーでは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はリクエストを処理する前に、残高が最大限のコスト（基本料金、リクエストしたすべての機能、追加料金）をまかなえるかを確認します。足りない場合は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では追加のデータが利用可能になります。
チャージクレジットは、追加で1回限り購入します。クレジットサブスクリプションがない場合、有効期間は 30 日間です。クレジットサブスクリプションが続いている間は、チャージクレジットもスタートクレジットも失効しません。
残高と、いつ何が失効するかは、アカウント › クレジットと、APIのGET /v1/account/creditsで確認できます。
すべてのプランと料金は料金ページにあります。