APIリファレンス
RESTful APIを通じてドイツ企業の包括的なデータにアクセスします。公式商業登記からのリアルタイム情報。
- ベースURL
https://handelsregister.ai/api- 形式
JSON- 認証
APIキー- レート制限
60回/分(文書は5回/分)
Schnellstart
In drei Schritten zum ersten Unternehmensprofil.
-
01
API-Key holen
Registriere Dich kostenlos und kopiere Deinen API-Key aus dem Dashboard. Neue Konten starten mit Gratis-Credits zum Ausprobieren aller Features.
Dashboard öffnen -
02
Erste Anfrage senden
Ruf ein Unternehmensprofil mit zwei kostenpflichtigen Features ab — den API-Key schickst Du im x-api-key-Header mit:
curl 'https://handelsregister.ai/api/v1/fetch-organization?q=BMW%20AG&feature=financial_kpi&feature=related_persons' \ -H 'x-api-key: YOUR_API_KEY' -
03
Antwort verstehen
Die Kerndaten des Unternehmens sind immer enthalten, jedes angeforderte Feature erscheint als eigener Top-Level-Schlüssel. Das meta-Objekt zeigt genau, was berechnet wurde — Features ohne Daten kosten nichts:
{ "entity_id": "cc78cf0b230aeae35c6df7ba31989bb9", "name": "Bayerische Motoren Werke Aktiengesellschaft", "status": "ACTIVE", "legal_form": "AG", "registration": {"court": "München", "register_type": "HRB", "register_number": "42243"}, "financial_kpi": [{"year": 2021, "revenue": 111239000000, "net_income": 12382000000}, "..."], "related_persons": {"current": ["..."], "past": ["..."]}, "meta": {"request_credit_cost": 8, "credits_remaining": 992} }
エンドポイント
| GET | /v1/fetch-organization 法的地位、財務データ、経営陣など、ドイツ企業の包括的な情報を取得します。 | 5-21クレジット • 60回/分 |
| GET | /v1/fetch-person Handelsregisterdaten und öffentliche Web-Quellen zu einem Personenprofil zusammenführen. ai_search ist hier immer aktiv — die 15 Credits Grundpreis enthalten die AI-Anreicherung bereits. | 15-20 Credits • 60/min |
| GET | /v1/search-organizations 高度なフィルタリングとページネーションサポートを備えたドイツ企業の検索。 | 1クレジット • 60回/分 |
| GET | /v1/fetch-document ドイツ商業登記から公式PDF文書をダウンロードします。 | 5クレジット • 5回/分 |
| GET | /v1/signals Ein Signal ist eine normalisierte Änderung aus dem Handelsregister. Du kannst Signals unternehmensübergreifend durchsuchen, nach Themen filtern oder ein einzelnes Signal per ID abrufen. | 20 Credits pro erfolgreichem Aufruf · Katalog kostenlos • 60/min |
| API | /v1/account/monitors Ein Signal ist eine Änderung im Handelsregister, aufbereitet in einem einheitlichen Format. Mit der Signals-API durchsuchst Du solche Änderungen über alle Unternehmen hinweg. Monitoring geht den umgekehrten Weg: Du wählst ein Unternehmen aus, wir prüfen es regelmäßig und schicken Dir jede neue Änderung als signierten Webhook. Im Webhook steckt unter data.signal das vollständige Signal in genau demselben Schema wie in der Signals-API – dieselben Blöcke event, organization, parties, register_entry, source und details. Du verarbeitest die Payload also direkt weiter, ohne einen zweiten API-Aufruf. | 10–50 Credits pro 30-Tage-Zyklus, je nach Rhythmus |
| GET | /v1/account Schreibgeschützte Endpunkte für Deinen eigenen Account: Profil, verbleibende Credits, Nutzungshistorie und Abo-Status. Damit baust Du eigene Dashboards, Billing-Alerts oder Admin-Tools — Account-Requests sind kostenlos und verbrauchen keine Credits. | Kostenlos · 0 Credits |