Es gibt derzeit keine eigene Firmenakte-App im Zapier-Verzeichnis. Nötig ist sie auch nicht: die Firmenakte-API ist eine gewöhnliche HTTP-Schnittstelle, und Zapier bringt mit Webhooks by Zapier einen Schritt mit, der beliebige HTTP-Anfragen absetzt. Die Antwort steht danach allen weiteren Schritten im Zap zur Verfügung – Google Sheets, HubSpot, Slack, E-Mail oder jede andere der verbundenen Apps.
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.
- Ein Zapier-Konto. Webhooks by Zapier ist bei Zapier ein Premium-Schritt und setzt einen bezahlten Zapier-Plan voraus.
Schritt 1: Den Zap starten
Wählen Sie einen Trigger, der bestimmt, wann Firmendaten geholt werden sollen. Zwei typische Fälle:
- Schedule by Zapier – täglich oder stündlich, um eine Abfrage regelmäßig zu wiederholen.
- Ein Ereignis in einer anderen App – zum Beispiel ein neuer Kontakt im CRM oder eine neue Zeile in einer Tabelle, zu der das Firmenprofil ergänzt werden soll.
Schritt 2: Die API mit Webhooks by Zapier abfragen
Fügen Sie als Action Webhooks by Zapier mit dem Event GET ein:
- URL:
https://api.firmenakte.at/api/v1/businesses - Query String Params: zum Beispiel
city=Wien,legalFormCode=GES,active=true,pageSize=50 - Headers:
x-api-key= Ihr API-Key - Unflatten: yes
Mit Test step holt Zapier eine echte Antwort. Die Treffer liegen im Feld
data, dazu kommentotalRecordsundtotalPages. Jeder Treffer trägt unter anderemfnr,name,legalForm.text,isActive,addressesundregisteredSince. Für ein einzelnes Unternehmen – etwa, wenn der Trigger eine Firmenbuchnummer liefert – lautet die URLhttps://api.firmenakte.at/api/v1/businesses/{fnr}; die Firmenbuchnummer wird dabei aus dem Trigger-Schritt eingefügt. Die Antwort enthält das vollständige Profil: Adressen, Funktionen, Gewerbeberechtigungen, Edikte, Dokumente und die Kennzahlen der Jahresabschlüsse. Wer nur Firmennamen hat, aber keine Firmenbuchnummern, löst sie vorher mitPOST https://api.firmenakte.at/api/v1/businesses/resolve-namesauf – in Zapier ebenfalls mit Webhooks by Zapier, Event POST, Payload Type json. Welche Filter und Endpoints es gibt, steht in der API-Dokumentation.
Schritt 3: Die Daten weitergeben
Ab hier ist es ein gewöhnlicher Zap. Die Liste data stellt Zapier als Line Items dar; Schritte, die Line Items verarbeiten, schreiben je Treffer einen Datensatz:
- Google Sheets → Create Spreadsheet Row(s): eine Zeile je Unternehmen, Spalten aus
fnr,name,legalForm.text,addresses[0].city. - HubSpot, Pipedrive, Airtable, Notion: Datensatz anlegen oder aktualisieren, die Firmenbuchnummer als eindeutigen Schlüssel verwenden.
- Slack, Gmail, Teams: Nachricht mit den Treffern verschicken. Für Abläufe, die je Treffer mehrere Schritte brauchen, gibt es Looping by Zapier.
Änderungen laufend abfragen
Wer einen Bestand beobachten will, baut einen Zap mit Schedule by Zapier als Trigger und fragt den aggregierten Änderungsfeed ab:
- URL:
https://api.firmenakte.at/api/v1/globalchanges/aggregated - Query String Params:
sinceId= die höchsteid, die beim letzten Lauf verarbeitet wurde; optionalfnr, um den Feed auf ein Unternehmen einzuschränken. Die Antwort bündeltbusinessChanges,documentChanges,ediktChangesundglobalChanges, bis zu 2.000 Einträge je Typ. Den Stand zwischen zwei Läufen hält Storage by Zapier: vor dem Request mit Get Value die gespeicherte id lesen, danach mit Set Value die höchste id der Antwort ablegen.sinceIdist exklusiv, es kommt also nur, was nach der gespeicherten id passiert ist.
Kontingent
Jeder Request zählt auf das monatliche Requestkontingent des Plans. Der Stand ist im Dashboard unter firmenakte.at/app/api sichtbar. Beim Testen eines Zaps setzt Zapier echte Requests ab; für einen Zap, der je Trigger-Ereignis läuft, lohnt sich deshalb ein Filter-Schritt davor.