Casafari REST APIs: Was Sie mit jeder API bauen können – und wann MCP die bessere Wahl ist

Die Casafari-Plattform stellt sieben REST APIs bereit – Location Lookup, Area Insights, Property Sourcing, Seller Leads, Comparables & Valuation, Claro sowie Account –, um Immobiliendaten direkt in eigene Applikationen, CRMs oder Banken-Backends zu integrieren. Während der einstiegsrelevante Dienst Location Lookup 0 Tokens kostet, bietet der Free-Plan 1.000 Tokens für 30 Tage ohne Kreditkarte. Sämtliche APIs greifen auf einen bereinigten Property Graph über 16 Länder (USA: Markteintritt läuft, ausgewählte Bundesstaaten, nur Gewerbeimmobilien, über Claro AI) zu (developers.casafari.com, Oktober 2026).

Welche Casafari REST APIs gibt es und wofür eignet sich jede?

Stellen Sie sich folgendes Szenario vor: Das Produktteam eines Berliner Maklerhauses steht am Montag vor der Aufgabe, eine automatische Immobilienbewertung im eigenen Kundenportal bereitzustellen. Das Ziel ist klar: Die Nutzer sollen die Anwendung nicht verlassen müssen, um Marktpreise oder Vergleichsobjekte einzusehen. Genau an dieser Schnittstelle schlägt die Stunde einer strukturierten REST API.

Die CASAFARI APIs für Immobiliendaten basieren auf einem umfangreichen Property Graph. Dieser erfasst Wohn- und Gewerbeimmobilien zum Kauf und zur Miete in 16 Ländern. Jedes Objekt wird bereinigt, dedupliziert und als einzelner Datensatz mit vollständiger Preis- und Statushistorie geführt (developers.casafari.com, Oktober 2026). Um dieses Datenfundament in eigene Softwarelösungen einzubinden, stellt die Plattform spezialisierte Schnittstellen bereit, die in der offiziellen REST-Referenz mit allen Operationen (auf Englisch) dokumentiert sind.

Location Lookup: Ortsnamen in location ids auflösen

Jede gezielte Abfrage von Immobiliendaten setzt eine eindeutige räumliche Abgrenzung voraus. Bei Eingaben in Suchfeldern – etwa „Prenzlauer Berg“, „München-Schwabing“ oder „PLZ 20357“ – übersetzt der Dienst Location Lookup Freitextanfragen in universelle Identifikatoren, die sogenannten location ids.

Typischer Anwendungsfall ist die Autovervollständigung in einer Portal-App oder einer Maklersoftware. Die technische Umsetzung erfolgt über die Operation GET /v1/locations/search (developers.casafari.com, Oktober 2026). Da Aufrufe von Location Lookup 0 Tokens kosten, empfiehlt es sich, diesen Dienst stets als ersten Schritt vorzuschalten. Da location ids stabil sind, können Produktteams empfangene IDs in der eigenen Datenbank zwischenspeichern, um wiederkehrende Anfragen lokal aufzulösen.

Weitere Details finden Sie in der Dokumentation unter Location Lookup in der Dokumentation (auf Englisch).

Area Insights: Quadratmeterpreise und Trends je Stadtteil

Für Proptechs und Analyseplattformen sind aggregierte Kennzahlen essenziell, um Marktstrukturen transparent abzubilden. Ein konkretes Beispiel ist der Aufbau eines Rendite-Rechners, der Kauf- und Mietpreisniveaus verschiedener Bezirke gegenüberstellt – etwa beim Vergleich von Investitionschancen zwischen Hamburg-Eimsbüttel und Hamburg-Harburg.

Über Area Insights lassen sich Kennzahlen wie die Preisentwicklung pro Quadratmeter sowie Kauf- und Mietpreise je Quadratmeter abfragen, aus denen sich die Bruttomietrendite berechnen lässt. Ein weiteres Einsatzfeld sind monatlich aktualisierte Marktbericht-Widgets auf einer Maklerwebsite, die automatisiert per Cron-Job mit frischen Kennzahlen versorgt werden. Eine vertiefende Einordnung zur Bedeutung dieser Metriken bietet der Fachbeitrag über Mietrendite: warum sie zählt und wie man sie findet. Entwickler finden die genauen Spezifikationen in den Anwendungsfällen auf developers.casafari.com (auf Englisch) sowie der Area Insights Dokumentation (auf Englisch).

Property Sourcing: eine eigene Immobiliensuche in Ihrer App

Wenn ein Immobilienportal oder eine Makler-App ein eigenes Suchinterface bereitstellen möchte, stehen Produktteams vor der Herausforderung, Mehrfachinserate aus unterschiedlichen Quellen zu bereinigen. Über die API für Property Sourcing greifen Entwickler auf den deduplizierten Gesamtbestand zu.

Nutzer sehen dadurch genau einen konsolidierten Datensatz pro Immobilie, inklusive der vollständigen Preisentwicklung und allen Statusänderungen. Wie der Aufbau einer leistungsfähigen Eigenentwicklung gelingt, zeigt die Fallstudie: eine Mobile-App auf der Casafari API. Da der Datenabruf nach dem Polling-Prinzip erfolgt, werden Aktualisierungen in regelmäßigen Intervallen abgefragt. Sämtliche Endpunkte sind in der Property Sourcing Dokumentation (auf Englisch) beschrieben.

Seller Leads: wiederholte Preissenkungen im Umkreis für die Akquise

Für Maklerhäuser ist die kontinuierliche Objektakquise ein zentraler Erfolgsfaktor. Anstatt Portale manuell nach wiederholten Preisreduzierungen zu durchsuchen, bindet das Entwicklerteam die Daten direkt in das interne CRM-System ein.

Über Seller Leads werden Objekte im Umkreis von 50 bis 300 Metern um einen Punkt importiert, deren Angebotspreis wiederholt gesenkt wurde – mit Anzahl und Höhe der Senkungen sowie der datierten Preis- und Statushistorie (developers.casafari.com, Oktober 2026). Bei der Ausgestaltung der Akquisitionsprozesse ist zu beachten, dass die API rein objektbezogene Inseratsdaten liefert; die Kontaktaufnahme mit Eigentümern hat stets im Rahmen der rechtlichen Vorgaben von DSGVO und UWG zu erfolgen. Technische Einzelheiten liefert die Seller Leads Dokumentation (auf Englisch).

Comparables & Valuation: Vergleichsobjekte und Wertindikation per API

Bei der Kreditvergabe oder der Wertermittlung benötigen Banken und Gutachter nachvollziehbare Marktdaten. Die API für Comparables & Valuation liefert eine strukturierte Auswertung vergleichbarer Objekte in einem definierten Umkreis.

Ein Aufruf erfolgt beispielsweise über die Operation POST /v1/comparables/search unter Angabe des Suchradius, des Objekttyps und der gewünschten Anzahl an Vergleichsobjekten (developers.casafari.com, Oktober 2026). Diese Daten dienen Kreditinstituten als Plausibilisierung im Rahmen der Beleihungswertprüfung. Sie ergänzen formelle Gutachten nach ImmoWertV oder BelWertV durch eine aktuelle Marktperspektive. Nähere Informationen finden Sie im Produktbereich Bewertungen & Marktstudie und der Comparables & Valuation Dokumentation (auf Englisch).

Claro: Gewerbeflächen nach Ihrem Suchprofil prüfen

Expansionsteams von Einzelhandelsketten oder Gastronomiebetrieben stehen vor der Aufgabe, eine Vielzahl von Immobilieninseraten gegen komplexe Anforderungsprofile zu prüfen. Claro analysiert Gewerbeobjekte und bewertet, wie gut Inserate zu den Vorgaben bezüglich Fläche, Lage und Mietobergrenze passen.

Der Abdeckungsbereich von Claro umfasst Gewerbeflächen in Spanien und Deutschland sowie Gewerbegrundstücke in Deutschland (developers.casafari.com, Oktober 2026). Für tiefergehende Standortanalysen – etwa zur Ermittlung von Passantenfrequenz, Einzugsgebieten oder Sozio-Demografie – lässt sich die Lösung ideal mit Location Intelligence kombinieren. Dokumentiert sind die Endpunkte in der Claro Dokumentation (auf Englisch) und den Claro Anwendungsfällen (auf Englisch).

Account: Token-Verbrauch und Schlüssel im Griff

Zur Abfrage von Kontostand und Verbrauchsdaten stellt die Schnittstelle Account (GET /v1/account) eine Leseoperation bereit; API-Schlüssel werden in der Konsole erstellt und widerrufen. Produktteams nutzen diese Endpunkte, um den aktuellen Token-Stand in internen Dashboards anzuzeigen und automatisierte Benachrichtigungen vor Ablauf von Kontingenten einzurichten.

Die Abrechnung der Nutzung erfolgt flexibel über verschiedene Pläne:

Sämtliche Schlüssel und Verträge werden zentral in der Konsole verwaltet. Weitere Detailfragen zur Tarifstruktur beantwortet die Übersicht Abrechnung und Abonnement im Hilfe-Center sowie die Seite Pläne und Tokens in der FAQ (auf Englisch).

REST oder MCP: Wann ist welche Schnittstelle die richtige?

Bei der Architekturentscheidung stehen Entwickler vor der Wahl zwischen einer klassischen REST API und Casafari MCP (Model Context Protocol).

REST ist die bevorzugte Wahl, wenn Sie deterministische Softwareprodukte für Endnutzer bauen – beispielsweise Portale, Kundenanwendungen, CRM-Integrationen oder Backend-Prozesse. Hier verbleiben die API-Schlüssel sicher auf dem Server.

MCP hingegen richtet sich an KI-Assistenten und Entwicklerumgebungen wie Claude, ChatGPT, Cursor, VS Code oder Gemini CLI. Über Streamable HTTP und OAuth 2.1 verbinden sich Nutzer direkt im Browser ohne manuelle Schlüsseleingabe mit den spezifischen MCP-Servern unter platform.casafari.com/mcp/<product> (developers.casafari.com, Oktober 2026). Ein Claude-Code-Plugin mit Skills, eine Gemini-CLI-Erweiterung und Codebeispiele finden Sie im GitHub-Repository casafari-mcp (auf Englisch).

Beide Schnittstellen greifen auf dasselbe Datenfundament und dasselbe Token-Budget zu. Zu beachten ist dabei die sprachliche Unterscheidung: Der Abrechnungsverbrauch wird in Tokens gemessen, während die Authentifizierung bei MCP über Access Tokens nach OAuth 2.1 erfolgt. Eine detaillierte Übersicht bietet der Artikel CASAFARI MCP für KI-Agenten sowie die Anleitungen MCP-Server verbinden (auf Englisch) und die Zuordnung von MCP-Tools zu REST-Operationen (auf Englisch).

So starten Sie: Konto, Schlüssel, erster Aufruf

Der Einstieg erfordert nur wenige Schritte. Über die Plattform erstellen Sie ein kostenloses Konto auf der Casafari-Plattform, das direkt mit 1.000 Tokens für 30 Tage ausgestattet ist. Für umfangreichere Unternehmensprojekte fragen Sie auf der Plattform den Custom-Plan an (Pläne im Überblick, englisch).

Nach der Erstellung des API-Schlüssels empfiehlt sich als erster Aufruf die Abfrage von Location Lookup, um die benötigten location ids für Zielgebiete zu ermitteln. Damit steht dem Vorhaben des Berliner Produktteams nichts mehr im Weg: Die Bewertung im Kundenportal und die Renditekarte im Dashboard lassen sich präzise und fristgerecht umsetzen.

Häufig gestellte Fragen

Was kann ich mit der Casafari API konkret bauen?

Mit den Casafari REST APIs lassen sich unter anderem folgende Anwendungsfälle realisieren: automatisierte Immobilienbewertungen, Analysen von Quadratmeterpreis-Trends, die Ermittlung von Preissenkungs-Leads um einen Punkt (High Potential Seller Leads), eine eigene Immobiliensuche innerhalb von Apps sowie die Berechnung von Mietrenditen je Gebiet. Alle Anwendungen greifen auf einen bereinigten Property Graph über 16 Länder zu. Weitere Details finden Sie in den Anwendungsfällen auf developers.casafari.com (auf Englisch).

Was kostet die Casafari API und was sind Tokens?

Der Einstieg erfolgt über den Free-Plan mit 1.000 Tokens für 30 Tage ohne Kreditkarte. Für den regulären Betrieb steht der Agent-Plan für 49 € pro Monat bei jährlicher Zahlungsweise oder 70 € bei monatlicher Abrechnung (jeweils zzgl. USt.) bereit, während individuelle Custom-Pläne per Vertrag geregelt werden. Aufrufe von Location Lookup kosten 0 Tokens, während der Verbrauch anderer Anfragen in Tokens abgerechnet wird (developers.casafari.com, Oktober 2026).

Wann sollte ich REST statt MCP nutzen?

Eine REST API ist die richtige Wahl, wenn Sie deterministische Endnutzer-Produkte wie Portale, CRM-Systeme oder automatisierte Backend-Jobs entwickeln, bei denen Schlüssel serverseitig verwaltet werden. MCP eignet sich hingegen für die direkte Interaktion mit KI-Assistenten wie Claude, ChatGPT oder Cursor. Beide Schnittstellen greifen auf dasselbe Konto, dasselbe Token-Budget und dieselben Daten zu.

Wie finde ich die location id für einen Stadtteil oder eine Postleitzahl?

Die Ermittlung von location ids erfolgt über den kostenlosen Dienst Location Lookup mittels der Operation GET /v1/locations/search. Durch die Übermittlung eines Ortsnamens oder einer Postleitzahl erhalten Entwickler die eindeutige ID, die von allen anderen Schnittstellen als Parameter akzeptiert wird. Der Dienst ist zudem als MCP-Server unter platform.casafari.com/mcp/locations verfügbar.

Deckt die Casafari API auch Österreich und die Schweiz ab?

Ja. Der Property Graph von Casafari erfasst Immobiliendaten aus 16 Ländern, darunter Österreich und die Schweiz (developers.casafari.com, Oktober 2026). Genauere Angaben dazu, in welchen Ländern Casafari-Daten verfügbar sind, finden Sie im entsprechenden Artikel des Hilfe-Centers. Für den Dienst Claro gilt, dass Gewerbeflächen in Spanien und Deutschland sowie Gewerbegrundstücke in Deutschland unterstützt werden.