よくある質問
開発者から最も多く寄せられる質問への回答。
開発者から最も多く寄せられる質問への短い回答です。詳細はリンク先のページにあります。
データ
データはどこから来ていますか?
公式の登記簿と公告からです:商業登記簿(Handelsregister)、年次財務諸表を含む企業登記簿(Unternehmensregister)、倒産公告。ニュースとWebサイトの内容はWebから来ています。詳しくはデータの提供状況で。
多くの情報は、公開された書類や公告から自動で読み取っています。そのために最新の技術を使い、品質に大きく投資していますが、個別の誤りが生じる可能性はあります。
データはどれくらい新しいですか?
企業プロフィールは私たちのデータベースから提供されます。リアルタイムを使うと、APIは商業登記簿にもライブで照会し、現在登記されている人物を返します。書類は、リクエストした時点でAPIが登記簿から取得します。
同じ書類が少し前に取得されていた場合、最大24時間前のものであることがあります。
企業は年次財務諸表を決算日から遅くとも12か月以内に公開しなければならず、多くの企業がその期間をいっぱいまで使います。そのため、最新の財務諸表が前々年のものであることもよくあります。
ある企業の値がないのはなぜですか?
多くの場合、その企業に公開義務がないためです。何が公開されるかは法的形態と規模によります。例えば小規模なGmbHは損益計算書を公開しないため、通常は売上高がありません。空の値はレスポンスでnullまたは[]として現れます。
同じ名称の企業が複数ある場合はどうなりますか?
複数の企業が共有する名称では、APIはそのうちの1社(目的の企業とは限りません)を返すか、404を返すことがあります。正確さが必要なら、登記裁判所と登記番号(例:「Ansbach HRB 6089」)、またはentity_idで照会してください。同じ番号が多くの裁判所にあるため、登記番号だけでは足りません。
課金
データを返さない機能にもクレジットはかかりますか?
いいえ。機能はデータを返した場合にのみ課金されます。一方AIモードは、企業が見つからなくても課金されます。APIがリクエストを408で中止した場合のみ課金されません。リアルタイムは、新しい内容がなくても、ライブ取得が成功するたびにクレジットがかかります。
失敗したリクエストのコストは?
無料です。エラーで終わったリクエストは課金されません。唯一の例外はAIモードの追加料金です。ステータス402の場合、meta.request_credit_costにそのリクエストでかかりえた最大額が示されます。詳しくはエラーで。
クレジットサブスクリプションは必要ですか?
いいえ。企業プロフィール、検索とエクスポート、書類、Signalsはどのアカウントでも使え、支払うのはクレジットだけです。クレジットサブスクリプションでは追加のデータが利用可能になります:
- Plus:人物プロフィール。
- Pro:拡張財務KPI、機能「企業ネットワーク」、所有・経営陣・倒産の検索フィルター、Signalsのトピック「倒産」。
- Max:Proのすべてに加え、機能「詳細な株主情報」、エネルギー事業者の部門別財務諸表、Signalsのトピック「組織再編とM&A」。
料金とプランについてはすべて課金にあります。
スタートクレジットとチャージクレジットの有効期間は?
新しいアカウントには 150 スタートクレジットが付きます。クレジットサブスクリプションがない場合、スタートクレジットとチャージクレジットは 30 日間有効です。クレジットサブスクリプションが有効な間は失効しません。
技術
タイムアウトはどう設定すればよいですか?
リアルタイム、人物プロフィール、書類はリクエストに時間がかかるため、120 秒以上にしてください。リアルタイムでライブ取得だけが失敗した場合は、リアルタイムの追加料金なしで保存済みのデータが返ります。リクエストに時間がかかりすぎると408で、書類では504で終わります。その場合は何も課金されません。後でもう一度試してください。
リクエストはどれくらい送れますか?
企業プロフィールはアカウントごとに1分あたり 60 リクエスト、書類は 5 リクエストです。それを超えると、APIはステータス429を返し、Retry-Afterで待ち時間を示します。すべての制限は制限にあります。
二重に支払わずにリクエストを繰り返せますか?
はい。企業プロフィール、人物プロフィール、検索、書類で可能です。ヘッダーIdempotency-Keyに独自の値を送ってください。24時間以内に同じキーと同じパラメータでリクエストを繰り返すと、料金はかかりません。
複数のAPIキーを使えますか?
はい。アカウント › APIキーで、例えばアプリケーションごとにキーを追加作成できます。キーを削除するとすぐに無効になります。すべてのキーはアカウントの残高を共有します。