Auswertungen in Excel und Power BI
Mieten, Darlehen und Ausgaben je Objekt direkt in deine Tabelle laden, statt jeden Monat zu exportieren.
Neu in ImmoFreak · REST API
Deine Immobiliendaten. In jedem Programm.
Excel, Google Sheets, Make, Zapier, n8n oder dein eigener Code holen Objekte, Mieter, Projekte, Leads und Kontakte direkt aus ImmoFreak und legen neue an. Ein Schlüssel, Rechte je Bereich und eine Doku, in der du jeden Aufruf sofort ausprobierst.
Im Konto enthalten300 Anfragen pro MinuteOpenAPI 3.1
Terminal
$ curl "https://api.immofreak.de/v1/properties?limit=2" \
-H "Authorization: Bearer ifk_live_••••••••"
{
"data": [
{
"name": "MFH Beispielstraße 7",
"city": "Mainz-Kostheim",
"units": 6,
"purchase_price": 640000
},
…
],
"next_cursor": "eyJpZCI6…"
}- 11Bereiche mit eigenen Rechten
- 51Endpunkte zum Lesen
- 44davon auch zum Anlegen und Ändern
- 300Anfragen pro Minute, ohne Tageslimit
Wofür
Einmal angebunden. Nie wieder exportieren.
Was du heute als CSV aus der App holst und in drei Tabellen zusammenkopierst, läuft über die API von selbst. Sechs Beispiele aus dem Alltag von Investoren, Verwaltern und Maklerbüros.
Google Sheets, das sich selbst füllt
Ein kurzes Apps-Script holt Objekte oder Projekte auf Knopfdruck oder zeitgesteuert in dein Blatt.
Leads von der eigenen Website
Dein Ankaufsformular schreibt jede Anfrage per POST als Lead ins Konto, mit Kontakt, Adresse und Quelle.
Make, Zapier und n8n
Neue Aufgabe, wenn ein Mietvertrag ausläuft. Kontakt anlegen, wenn im CRM ein Deal gewonnen ist. Ohne eine Zeile Code.
Berichte für Investoren und Partner
Eigenes Dashboard mit Leerstand, Mieteingängen und Projektständen, gespeist aus denselben Daten wie die App.
Marktdaten in deiner Analyse
Inserate, Suchaufträge und Merkliste der Marktsuche lesen, zum Beispiel für eigene Preisvergleiche je PLZ.
Bereiche und Rechte
Elf Bereiche. Rechte je Schlüssel.
Die API spiegelt die App: dieselben Bereiche, dieselben Daten. Je Bereich gibt es Aus, Lesen oder Lesen und Schreiben.
| Bereich | Lesen | Anlegen und Ändern | Endpunkte |
|---|---|---|---|
| Leads | ja | ja | leads, lead-sources |
| Akquise | ja | ja | deals, pipelines, stages, deal-analyses |
| Fix & Flip | ja | ja | projects, budget-items, project-costs, project-loans, work-packages und mehr |
| Aufteiler | ja | ja | aufteiler-projects, aufteiler-units, aufteiler-leases und mehr |
| Buy & Hold | ja | ja | properties, units, leases, property-loans, meters, expenses und mehr |
| Mieter | ja | ja | tenants, tenant-payments |
| Makler-CRM | ja | ja | listings, listing-interests, viewings, mandates, commissions |
| Kontakte | ja | ja | contacts, contractors |
| Aufgaben | ja | ja | tasks, checklists |
| Banking | ja | nur lesen | bank-accounts, bank-transactions |
| Marktsuche | ja | nur lesen | market-listings, market-searches, market-favorites |
Die Marktsuche setzt das Markt-Abo im Konto voraus. Bei Inseraten ist ein PLZ-Anfang Pflicht, und Kontaktdaten privater Anbieter gibt die API nicht heraus.
Beispiele
Kopieren, Schlüssel rein. Läuft.
Listen liefern bis zu 100 Einträge je Seite, weitere Seiten holst du mit dem Cursor. Anlegen und Ändern schicken JSON. Mehr Beispiele, auch für Excel und Make, findest du in der App und in der Doku.
# Lesen
curl "https://api.immofreak.de/v1/properties?limit=100" \
-H "Authorization: Bearer DEIN_SCHLÜSSEL"
# Anlegen, die Antwort enthält die neue id
curl -X POST "https://api.immofreak.de/v1/contacts" \
-H "Authorization: Bearer DEIN_SCHLÜSSEL" \
-H "Content-Type: application/json" \
-d '{"name": "Max Mustermann", "email": "max@example.com"}'
# Ändern, nur die mitgeschickten Felder
curl -X PATCH "https://api.immofreak.de/v1/contacts/KONTAKT_ID" \
-H "Authorization: Bearer DEIN_SCHLÜSSEL" \
-H "Content-Type: application/json" \
-d '{"phone": "+49 6131 123456"}'Im Terminal. Weitere Seiten holst du mit ?cursor= und dem Wert aus next_cursor.
Sicherheit
Offen für deine Programme. Zu für alle anderen.
Rechte je Bereich
Für jeden Bereich wählst du Aus, Lesen oder Lesen und Schreiben. Ein Schlüssel für die Buchhaltung sieht keine Leads.
Fest an ein Konto gebunden
Ein Schlüssel arbeitet nur in dem Konto, in dem du ihn angelegt hast. Gespeichert wird zur Prüfung nur ein Hash.
Dieselbe Sicht wie in der App
Der Schlüssel sieht nur, was du auch siehst, mit allen Einschränkungen deines Teams.
Löschen bleibt in der App
Die API legt an und ändert, löscht aber nie. Was weg soll, geht in der App über den Papierkorb.
Ohne IBAN und Steuer-IDs
Bankverbindungen und Steuernummern gibt die API nicht heraus, auch nicht im Bereich Banking.
Ablaufdatum und Widerruf
30 Tage, 90 Tage, ein Jahr oder unbegrenzt. Ein widerrufener Schlüssel funktioniert ab sofort nicht mehr.
So startest du
Drei Schritte. Dann ist der Schlüssel da.
- 1
Integrationen öffnen
In ImmoFreak unter Integrationen die Karte REST API wählen und auf „Schlüssel verwalten“ klicken.
- 2
Schlüssel mit Rechten anlegen
Namen vergeben, Laufzeit wählen und je Bereich festlegen, ob der Schlüssel lesen oder auch schreiben darf.
- 3
Ersten Aufruf schicken
Schlüssel kopieren und loslegen. In der Doku probierst du jeden Endpunkt mit deinem Schlüssel direkt aus.
Fragen
Häufige Fragen zur REST API
Was kostet die REST API?
Die API gehört zu jedem freigegebenen ImmoFreak-Konto, ein Zusatzmodul brauchst du dafür nicht. Nur die Endpunkte der Marktsuche setzen voraus, dass die Marktsuche im Konto gebucht ist.
Wie viele Anfragen darf ich schicken?
Es gibt keine Tages- oder Monatsgrenze. Zum Schutz sind höchstens 300 Anfragen pro Minute je Schlüssel erlaubt. Wer darüber liegt, bekommt kurz den Fehler 429 und schickt die Anfrage nach der angegebenen Wartezeit noch einmal.
Welche Daten kann ich schreiben?
In neun der elf Bereiche kannst du mit POST anlegen und mit PATCH ändern, zum Beispiel Leads, Kontakte, Objekte, Mietverträge, Projekte und Aufgaben. Banking und Marktsuche sind nur lesbar. Verweise wie ein Objekt oder ein Kontakt müssen zu deinem eigenen Konto gehören.
Kann ich über die API löschen?
Nein, mit Absicht. Gelöscht wird in der App, wo der Eintrag erst im Papierkorb landet und sich zurückholen lässt. So kann ein falsch eingestelltes Skript keine Daten vernichten.
Funktioniert das mit Excel, Google Sheets, Make, Zapier oder n8n?
Ja. Excel und Power BI holen die Daten über Power Query, Google Sheets über ein kurzes Apps-Script. In Make, Zapier und n8n nimmst du das HTTP-Modul mit deinem Schlüssel als Bearer-Token. Fertige Beispiele stehen in der App unter Integrationen.
Gibt es eine Dokumentation zum Ausprobieren?
Ja, unter api.immofreak.de/docs steht die komplette Doku mit allen Endpunkten, Feldern, Filtern und Fehlercodes. Jeden Aufruf kannst du dort mit deinem Schlüssel direkt testen. Für Postman oder Code-Generatoren gibt es die OpenAPI-Datei unter api.immofreak.de/v1/openapi.json.
Kann ich die API aus einer Webseite im Browser aufrufen?
Nein. Der Schlüssel ist ein Passwort und gehört auf einen Server, in ein Skript oder in ein Automatisierungswerkzeug. Aufrufe direkt aus dem Browser lässt die API deshalb nicht zu.
Was passiert bei Team-Konten?
Jeder im Team legt eigene Schlüssel an, und jeder Schlüssel sieht nur, was die Person in der App sehen darf. Ein Steuerberater-Zugang kann über die API lesen, aber nichts schreiben.
Deine Daten gehören dir. Jetzt auch in jedem Programm.
Konto anlegen, unter Integrationen einen Schlüssel erstellen und den ersten Aufruf schicken. Die Doku zeigt jeden Endpunkt mit Feldern, Filtern und Beispielen.
Anmeldung ohne Zahlungsdaten · API im Konto enthalten