Allgemeine Informationen

Hier finden Sie ein paar Allgemeine Infos zu der immowelt.at-API und den WebServices.

Was ist die Immowelt "API"?

API, "Application Programming Interface", ist eine definierte Schnittstelle für Programmierer. Diese ermöglicht die Nutzung bestimmter Dienste eines API-Anbieters.

Die Immowelt stellt Ihnen über verschiedene WebServices eine Standard-API zur Verfügung, über die Sie die Immobiliensuche und -anzeige in Ihr bestehendes System sehr einfach integrieren können.

Über diese API erhalten Sie Zugriff auf die Geoinformationen sowie das Immobilienangebot der Immowelt. Für die Verwendung innerhalb Ihrer Applikation ist ein bestimmtes Vorgehen beim Abruf der Daten empfehlenswert. Als Ergebnis der API-Aufrufe erhalten Sie die entsprechenden Rohdaten, die Sie nach Ihren Wünschen und Anforderungen in Ihrer Anwendung präsentieren können.

Die Immowelt WebService API ist sprachenunabhängig konzipiert, d. h. Sie können mit jeder Programmiersprache diese API nutzen. Für die Kommunikation zwischen Ihrem System und der Immowelt WebService API werden XML-Nachrichten verwendet. Diese Nachrichten werden über http versendet.

Weitere Hilfen bietet Ihnen die technische Dokumentation.

Was benötige ich für die Nutzung der API mit WebServices?

Sie benötigen einen immowelt.at-API Key für die Authentifizierung, den Sie von uns erhalten. Die von Ihnen verwendete Programmiersprache, muss WebServices mittels SOAP unterstützen.

Welche WebServices gibt es?

LocationService

Dieser WebService enthält mehrere Methoden für den Zugriff auf die Geoinformationen der AVIV Germany GmbH. Nähere Informationen finden Sie in der technischen Dokumentation.

EstateService

Dieser WebService enthält verschiedene Methoden für den Zugriff auf die Immobiliensuche mit den Daten des LocationService und weiteren Kriterien, die die Immobiliensuche einschränken. Es werden auch Funktionen zur Umkreissuche angeboten. Eine Umkreissuche liefert Objekte, die innerhalb eines angegebenen Kreises um eine PLZ oder Ortes liegen.

Als Ergebnis erhält man eine Ergebnisliste mit den gefundenen Immobilienobjekten.

Sie können die Ergebnisliste nach mehreren Kriterien sortieren lassen, z. B. zuerst nach Preis, dann nach Wohnfläche.

Die Anzahl der Objekte pro Seite ist ein Parameter in der Abfrage:

  • Werte: max. 500
  • Sortierungen können über fest definierte Enum-Werte gesetzt werden.

EstateExpose

Dieser WebService steht Ihnen zur Verfügung, um Detailinformationen zu einem bestimmen Immobilienangebot (Exposé) abzurufen.

Ein Direktaufruf eines Angebots ist sowohl mit der Objektnummer (Guid), als auch mit der Immowelt-OnlineID möglich.

Bilder werden bei Immowelt gehostet und per Link zur Verfügung gestellt.

Folgende Bildformate werden angeboten:

  • kleines Bild für die Ergebnisliste
  • Bild für Exposé "Exposé"

CommunicationService

Mittels dieses WebService stehen Ihnen Methoden zum Versenden von Kontaktanfragen, Gesuchsanfragen, Empfehlungen zur Verfügung.

Wie funktioniert der Datenabruf prinzipiell?

  1. Eine Region wird durch eine GeoID identifiziert. Beispiel: Deutschland hat eine, sowie Bayern, Nürnberg und Stadtteile von Nürnberg auch. Eine Suchanfrage an den LocationService wandelt den Suchbegriff in eine GeoID um.

  2. Mit dieser GeoID + Suchkriterien können Sie Listen aus dieser Region abfragen. Beispiel: 3-5 Zimmer Wohnung, 90-130qm

  3. Aus der Liste kann ein Exposé für die Detailansicht mit allen Daten ausgesucht werden. Ein Exposé wird durch eine eindeutige Kennziffer (GUID) identifiziert. Mit dieser GUID können die Daten abgerufen werden.

Nähere Informationen zu den einzelnen Services bietet Ihnen die technische Dokumentation.

Cachen von Abfragen

Wollen Sie Abfragen zwischenspeichern, denken Sie bitte daran, dass ein Objekt in der Zwischenzeit deaktiviert werden kann. Aktualisieren Sie deshalb ihre Daten regelmäßig!

Support

Für die API steht Ihnen unser Support zur Verfügung.

Bevor Sie an den Support schreiben, können Sie auch den Bereich "Wann setze ich eine API ein" lesen - hier finden Sie zahlreiche Informationen zur API.

Sollten Sie hier keine Antwort für Ihre Problemstellung finden, schreiben Sie bitte eine Mail mit Ihrer Anfrage an: api@immowelt.de