Offizielle SDKs
Offizielle Clients für die FirmenData API für Python, JavaScript/TypeScript und n8n — deutsche und Schweizer Unternehmensdaten: Registersuche, Jahresabschlüsse, Unternehmensprofile, Registerdokumente, Gesellschafter und wirtschaftlich Berechtigte (UBO).
Autocomplete funktioniert ohne API-Schlüssel.
Der Endpunkt zur Autovervollständigung von Unternehmensnamen GET https://api.firmendata.com/v1/companies/autocomplete?q=… ist kostenlos, verbraucht keine Credits und benötigt keinen API-Schlüssel. Sie können ihn direkt per HTTP sowie mit den Python- und JavaScript/TypeScript-SDKs aufrufen — erstellen Sie den Client einfach ohne Schlüssel.
Aufrufe ohne Schlüssel werden pro IP-Adresse begrenzt. Das reicht zum Ausprobieren der API, für ein Suchfeld oder gelegentliche Abfragen. Ein API-Schlüssel bietet deutlich höhere Limits und Zugang zu allen weiteren Endpunkten.
Beachten Sie bei einer Antwort mit Status 429 den Header Retry-After. Die Python- und JavaScript/TypeScript-SDKs übernehmen dies automatisch.
curl "https://api.firmendata.com/v1/companies/autocomplete?q=siemens"Pakete
Python
firmendata
Synchroner und asynchroner Zugriff auf die FirmenData API für Python-Anwendungen.
Installation
Autocomplete ohne API-Schlüssel
from firmendata import FirmenData
# No API key needed for autocomplete
for hit in FirmenData().autocomplete("siemens")["data"]:
print(hit["eu_id"], hit["display_name"])Mit API-Schlüssel
from firmendata import FirmenData
fd = FirmenData(api_key="firmendata_live_...")
company = fd.get_company("DED2601V.HRB6684")Voraussetzungen & Funktionen
Python ≥ 3.11. Synchroner Client FirmenData und asynchroner Client AsyncFirmenData.
JavaScript / TypeScript
firmendata
Vollständig typisierter Client für die FirmenData API, basierend auf dem nativen fetch.
Installation
Autocomplete ohne API-Schlüssel
import { FirmenData } from 'firmendata';
// No API key needed for autocomplete
const { data } = await new FirmenData().autocomplete('siemens');Mit API-Schlüssel
import { FirmenData } from 'firmendata';
const fd = new FirmenData({ apiKey: process.env.FIRMENDATA_API_KEY });
const company = await fd.getCompany('DED2601V.HRB6684');Voraussetzungen & Funktionen
Keine Laufzeitabhängigkeiten, vollständige TypeScript-Typen. Nutzt das plattformeigene fetch: Node.js 18+, Bun, Deno, Cloudflare Workers und Browser.
n8n
n8n-nodes-firmendata
Community-Node für Unternehmensrecherche und Automatisierung in n8n-Workflows.
Installation
Öffnen Sie in n8n Einstellungen → Community Nodes → Installieren und geben Sie n8n-nodes-firmendata als Paketnamen ein.
API-Zugangsdaten erforderlich
Der Node benötigt für alle Operationen einen Zugangsdaten-Eintrag vom Typ FirmenData API. Erstellen Sie ihn unter Einstellungen → Zugangsdaten (Settings → Credentials) und hinterlegen Sie einen API-Schlüssel aus Ihrem Konto. Die Operation Autocomplete verbraucht keine Credits.
Operationen
- Autocomplete (keine Credits)
- Search
- Get
- Get Financials
- Get Shareholders
- Get UBO
- Get History
- List Documents
- Download Document
Voraussetzungen & Funktionen
Getestet mit n8n 1.x, n8nNodesApiVersion 1. Benötigt Node.js 20.15+ und FirmenData-API-Zugangsdaten.
Releases & Versionierung
Alle drei Pakete werden aus demselben API-Vertrag generiert und gemeinsam mit übereinstimmenden Versionsnummern veröffentlicht. Sie folgen der semantischen Versionierung. Die Versionshinweise finden Sie im CHANGELOG des jeweiligen Repositorys. Die vollständige Versionshistorie ist auf PyPI und npm verfügbar.
Für weitere Sprachen steht die unveränderte OpenAPI-Spezifikation unter /api/openapi.json bereit. Für KI-Assistenten nutzen Sie unseren MCP-Server.