Home

Um das SDK mit der ImmobilienScout24-REST-API nutzen zu können, muss man sich für die API-registrieren, dabei gibt es zwei Szenarien, die mit unterschiedlichen Berechtigungen verknüpft sind. Falls du eine Fehlermeldung "403 Acccess Denied" siehst, dann fehlt eine Berechtigung. Sende dann bitte eine E-Mail an [email protected] mit deinem oAuthKey und den API-Request, der die Fehlermeldung erzeugt hat.

Berechtigung "IS24-Komplettbestand":

• Erlaubt eine Suche über alle Objekten bei Immobilienscout24. Man bekommt aber keine Expose-Berechtigung. Diese kann über dieses Formular beantragt werden.

Berechtigung "Objekte eines bestimmten Anbieters/Börse":

• Erlaubt eine Suche im Objektbestand eines bestimmten Anbieters oder eine Börse. Expose-Berechtigung ist enthalten. Voraussetzung ist, dass der Anbieter über oAuth deine Applikation den Zugriff auf seine Objekte erlaubt. (Diese Abfrage funktioniert nicht, wenn der Anbieter das Produkt "Basis-Account" hat).
• Erlaubt das Auslesen aller Objekten eines Anbieters (GET REALESTATE). Das Hochladen von Objekten zu ImmobilienScout24 bedarf eine extra Berechtigung die über [email protected] beantragt werden kann. Für diesen Usecase erstellen wir zuerst einen Sandbox-Zugang, damit man in einer Testumgebung Objekte anlegen und veröffentlichen kann. Auch dieser Zugang kann über die genannte E-Mailadresse angefragt werden.

Dokumentation

Einführung

In der Einführung werden grundlegende Einstellungen erklärt, die für die Nutzung des SDK nötig sind. Z.b. erfahren Sie wie man sich mit der Applikation verbindet, oder man eine Applikation zertifiziert um auf seine eignen Objekte zugreifen zu können.

Listen und Regionen

Dieser Bereich zeigt Möglichkeiten auf komplette Listen zuzugreifen. Das heißt es werden die Hauptinfos zu einer bestimmten Suche (z.B. nach einer Region) zurückgeliefert.

Objekte (Exposes)

Das Kapitel Objekte zeigt wie man alle Informationen oder auch Mediendaten zu einem einzelnen Objekt (Expose) erhält.

Anbieter

Methoden um Informationen rund um den Makler auszulesen finden Sie hier.

Objekte exportieren

Wie man Objekte direkt zu ImmoblienScout24 exportiert erfahren Sie hier. Außerdem werden Methoden zum Aktivieren und Deaktivieren der Objekte erklärt.