Ja, Firmendaten lassen sich direkt in eine Google-Tabelle holen. Zwei Wege führen dorthin: ohne Code über ein Automatisierungswerkzeug, das einen Google-Sheets-Schritt mitbringt, oder direkt aus der Tabelle heraus mit einem kurzen Apps Script. Dieser Leitfaden beschreibt beide.
Voraussetzungen
Ein Firmenakte-Konto mit einem API-Key. Den Key legen Sie selbst im Dashboard unter firmenakte.at/app/api an; der Free-Plan reicht zum Ausprobieren.
Weg 1: Ohne Code über n8n oder Zapier
Wer n8n oder Zapier bereits verwendet, braucht kein Script. Ein HTTP-Schritt holt die Daten von der API, der Google-Sheets-Schritt schreibt je Unternehmen eine Zeile. Die Einrichtung steht in den Leitfäden Firmendaten in n8n und Firmendaten in Zapier.
Weg 2: Direkt aus der Tabelle mit Apps Script
Die Tabellenfunktionen IMPORTDATA und IMPORTXML können keinen Header mitschicken und kommen deshalb nicht in Frage – der API-Key gehört in den Header x-api-key, nicht in die URL. Ein Apps Script kann das, und es läuft direkt in der Tabelle.
Schritt 1: Den API-Key hinterlegen
Öffnen Sie in der Tabelle Erweiterungen → Apps Script. Unter Projekteinstellungen → Skripteigenschaften legen Sie eine Eigenschaft FIRMENAKTE_KEY mit Ihrem API-Key an. So steht der Key nicht im Code und nicht in einer Zelle.
Schritt 2: Das Script einfügen
Fügen Sie in Code.gs ein: PAYLOADCODEBLOCK0 Beim ersten Ausführen von screenerInTabelle fragt Google nach der Berechtigung, externe Dienste aufzurufen und die Tabelle zu bearbeiten. Danach füllt sich das Blatt „Firmen" mit den Treffern. Die Filter in params sind dieselben wie in der API: city, legalFormCode, oenaceCode, zipCode, active, Kennzahlen wie guv.Umsatzerloese_gte oder employees_gte, dazu orderBy und pageSize bis 100. Bei mehr als 100 Treffern liefert antwort.totalPages die Zahl der Seiten, die mit page nacheinander geholt werden. Welche Filter und Endpoints es gibt, steht in der API-Dokumentation.
Schritt 3: Regelmäßig laufen lassen
Unter Trigger (das Uhrsymbol im Apps-Script-Editor) legen Sie einen zeitgesteuerten Trigger an: Funktion screenerInTabelle, zum Beispiel täglich. Die Tabelle aktualisiert sich dann ohne Zutun.
Ein Firmenprofil zu einer Firmenbuchnummer
Für ein einzelnes Unternehmen holt firmenakteGet("/businesses/34853f") das vollständige Profil: Adressen, Funktionen, Gewerbeberechtigungen, Edikte, Dokumente und unter latestKeyFigures die jüngsten Kennzahlen aus dem Jahresabschluss, etwa umsatzerloese, jahresueberschuss, eigenkapital und employees. Wer eine Spalte mit Firmenbuchnummern hat, geht sie im Script Zeile für Zeile durch und schreibt die gewünschten Felder daneben. Eine benutzerdefinierte Funktion wie =FIRMENNAME(A2) ist technisch ebenso möglich, aber jede Zelle und jede Neuberechnung der Tabelle löst dabei einen eigenen Request aus. Für mehr als ein paar Zeilen ist ein Script, das die Spalte einmal durchgeht, die bessere Wahl.
Kontingent
Jeder Request zählt auf das monatliche Requestkontingent des Plans. Der Stand ist im Dashboard unter firmenakte.at/app/api sichtbar. Eine Screener-Abfrage mit pageSize 100 ist ein Request, unabhängig davon, wie viele Zeilen sie in die Tabelle schreibt.