Die empirica-systeme REST-API ist eine Programmierschnittstelle für Anwendungen auf Basis unserer Immobilienmarktdatenbank.

REST-API Response JSON

Die JSON basierte Schnittststelle ist an den Funktionsumfang des empirica-systeme Analyst angelehnt. Damit stehen Ihnen nahezu sämtliche Filteroptionen (Standort-, Markt- und Objektabgrenzung) als Web-Service bereit und können direkt in Ihre Anwendungen eingebunden werden.

Auch für die Analyse, d.h. für die Auswertung von Abfragen stellt unsere API zahlreiche Funktionen (Zeitreihen, Mittelwerte und Verteilungen) als REST-Endpoints bereit. Dies gewährleistet eine effiziente Integrationsfähigkeit bei hoher Flexibilität.

Räumliche Abfrageoptionen

Wie der Markt-Analyst verfügt unsere API über Abfrage­optionen von Adressen/Koordinate, Ortsteilen und Postleitzahlen bis hin zum Immobillienmarkt (Kreise, Nuts, Gemeinen) oder dem bundesweiten Immobilien­portfolio.

Sachliche Abfrageoptionen

Unsere Segmente können auch hier als effizienter Zugriff auf den jeweiligen Immobilien­­teilmarkt genutz werden, damit entfallen zahlreiche Filterbedinungen. Die Anwendung muss also nur noch die entsprechenden sachlichen Kriterien (z.B. Fläche oder Baujahr) definieren, sodass Vergleichs­objekte und Abfrage­statistiken der spezifischen fachlichen Frage­stellung entsprechen.

Immobilien­marktstatistik

Nach der Abfrage erhalten Sie neben dem Zugriff auf die gefilterte Objekttabelle diverse Statistiken mit allen wesentlichen Kennwerten einer Markt- oder Standortanalyse.

  • Anzahl der Fälle
  • Mittelwerte (Mittelwert, Median, flächengewichtetes Mittel)
  • Perzentile/Verteilung (1-100)
  • Zeitreihe (Preise, Preise und Mieten je m², Kaufpreisfaktor und Bruttoanfangsrendite)

Alle Daten und Kennwerte werden Ihnen dabei als JSON bereitgestellt.

Dokumentation und Workflowmanagement

Unsere API ist mittels der weiter verbreiteten Swagger Open-Source Bibliothek gebaut und dokumentiert. Ihre Entwickler werden es lieben!

Unser System ermöglicht es Abfragen aus dem Mark-Analyst direkt in REST Client Code zu überführen. Damit können ohne Programmier-Vorkenntnisse lauffähige REST-Client-Abfragen erstellt werden, die als Prototype an Entwickler weitergegeben werden können.

Wenn Sie eine empirica-systeme Lizenz mit API/REST Zugang haben, finden Sie hier die Swagger Dokumentation.

Beispielanwendung: Immobilienmarktdaten via REST-API aus R abrufen

Das folgende Skript zeigt exemplarisch, wie eine Immobilienmarktstatistik via empirica-systeme REST-API direkt aus R abgerufen werden kann. Im Folgenden Beispiel werden exemplarisch die Medianpreise für Berlin und Hamburg abgerufen. Je nach User-Input und gewählten Endpoint können alle erdenklichen Kennwerte und Parameter abgerufen werden.

Sie können das Beispiel direkt in R-Studio kopieren und ausführen. Sie können das Skript auch hier herunterladen. Viel Spaß beim Ausprobieren.