Ich bin vorhin durch einen kleinen Zufall auf eine Seite bei Immobilienscout24.de gestoßen, die Informationen zur Anmeldung und Nutzung der Immobilienscout24 API (Application Programming Interface) bereitstellt.
Ich war erstmal total überrascht, denn die API bietet einen standarisierten Zugriff auf große Teile der Immoscout-Services. Darunter sind u.a. Ergebnislisten nach frei definierbaren und kombinierbaren Suchkriterien über kombinierbare Scout-Accounts und Börsen, Exposes mit Zugriff auf alle Bilder, Kartenmaterial, Kontaktinformationen, Geodaten von deutschen Adressen, Zugriff auf die Länder-Hierarchien (Kontinent, Land, Region, Landkreis, Stadt, Stadtteil etc). Alle Zugriffe und Kontaktanfragen erscheinen in der Statistik im Immoscout-Anbieterbereich, es können sogar die Kontaktanfragen und Empfehlungen direkt über den Webservice abgewickelt werden.
Für den Anfang erhält man ein ZIP-Archiv mit drei PDF-Dateien und fünf XSD´s. Die PDF´s sind die Nutzungsbedingungen, die API-Dokumentation über 21 Seiten und die technische API-Dokumentation über 109 Seiten. Die XSD´s definieren diverse Datentypen. Außerdem gibt es zwei Codebeispiele als seperaten Download. Einmal in Java und einmal in PHP.
Um auf die Webservices zugreifen zu können, muß man sich erstmal registrieren. Mit der Bestätigung erhält man dann einen API-Key (wie bei Google, Amazon, Ebay, etc), der eine Anwendung eindeutig identifiziert. Zusätzlich wird man automatisch beim API-Newsletter angemeldet, der über Änderungen informiert. Innerhalb von 24 Stunden dürfen pro API-Key maximal 10.000 Requests ausgeführt werden. Zum Testen der fertigen Anwendung gibt es eine Sandbox.
Laut der History im API-Handbuch ist Version 1.0 bereits im November 2005 erstellt worden. Ich frage mich, ob die API schon die ganze Zeit öffentlich ist. Vielleicht ist das ja auch schon ein alter Hut. Das ist auf jeden Fall eine richtig gute Sache, die ich bei anderen deutschen Portalen noch nicht in diesem (auch nur ansatzweise) Umfang gesehen habe.
Alle Informationen und auch ein paar Referenzprojekte gibt es auf api.immobilienscout24.de
Die API ist noch nicht so lange öffentlich (seit Frühjahr dieses Jahres – müßte ich aber genau nachschauen… nagel mich nicht drauf fest).
Das von Dir genannte Zip-Archiv, also der API-Client mit den Beispiel-Implementierungen wird gerade überarbeitet – Wie meistens ist hier die Überarbeitung der Dokumentation der zäheste Teil 🙂
Danke für den Hinweis. Da bin ich gespannt, denn die jetzigen Beispiele sind ja etwas mau 🙂 Vielleicht koennt ihr ja auch die API-Doku irgendwo als HTML ablegen. Aber die API ansich finde ich einfach klasse.
Das Problem bei der API ist, das die PHP Beispiel Dateien mehr als lückenhaft sind. Es fehlt unter anderem eine Datei namens Request.php aus der wohl hervorgeht wie man einen einfachen Connect herstellt. 🙁 Die technische Dokumentation ist umfangreich, das eigentliche Handbuch ist aber leider auch nicht was ich erwartet hätte.
Fazit: Die API ist eine sehr gute Idee, aber zur Einbindung in eigene Projekte fehlen sehr wichtige Grundbausteine in den Beispielen und Dokumentationen. Auch sieht es eher so aus als ob hier versucht wird, Interessenten zu einem Immoscout Technologie Partner zu treiben und Ihnen Eigenentwicklungen unmöglich zu machen. 🙁
Die fehlende Request.php kriegst Du im PEAR-Package HTTP. Wenn Du Dir Xampp installierst, ist sie bereits dabei. Viel weiter bin ich allerdings auch noch nicht gekommen – schaue aber auch erst seit einer halben Stunde hinein. 🙂
[…] Ich habe nun mein erstes WordPress Plugin soweit funktionsfähig bekommen. Es benutzt die API von Immobilienscout24 um Objekte in statische Seiten zu importieren. Dazu werden im Backend die IS24-Mitgliedsnummer und der API-Key hinterlegt und die Vermarktungsarten (Mieten, Kaufen, Gewerbe etc..) ausgewählt. Für das Frontend wird dann eine statische Seite angelegt in der ein Platzhalter gesetzt wird, der dann durch die Objektliste ersetzt wird. Die Seite läßt sich dann in der Sidebar verlinken. Wie gesagt. Das ist mein erstes WordPress Plugin und die Umsetzung läßt sich sicher besser machen. Aber Hauptsache es funktioniert erstmal. Ich werde noch Suchfunktionen, Sortierung und Kategorien einbauen. Wenns mal soweit ist, wird der Code auch veröffentlicht. […]
Wir haben eine TYPO3-Extension auf Grundlage der API entwickelt, mit der Objekte per Frontend-Plugin in Webauftritte integriert werden können.
Weitere Informationen unter:
http://typo3.org/extensions/repository/view/lumoscoutexpose/0.1.0/
[…] Die Extension für das Open Source CMS Typo3, mit der Objekte über die API von Immobilienscout24 angezeigt werden können, ist nun live im Einsatz auf der Homepage von MaM-Immobilien zu sehen. Wer mehr (z.B. das Backend) sehen möchte, muss sich allerdings nach wie vor eine eigene Typo3-Installation aufsetzen. Mehr Infos gibt es beim Entwickler LumoNet und im Typo3 Extension Repository. […]
interessanter beitrag – befasse mich auch gerade mit der api und muss sagen, die doku und bsp dateien sind absolut nicht hilfreich. falsche bezeichungen und pfad angaben in der doku – leider.
denn die api ist aufjeden sehr interessant.
hat einer von euch mal einen request hinbekommen der sämtliche objektid’s eines anbieters listet. an der stelle hänge ich grade.
expose abfrage funzt leider nur mit einer gültigen objektid und diese zu ermitteln – tja daran hänge ich gerade.
gracie
[…] Von Immonet wird es anscheinend auch bald eine öffentliche API geben, die ähnlich wie die Immobilienscout24 API, Entwicklern den Zugriff auf Teile der Immobilendaten ermöglichen soll. Damit würde sich dann auch Immonet für Mashups und bessere Integrationen in Maklerhomepages öffnen. Wann das genau passieren wird und welche Funktionen zur Verfügung gestellt werden, steht wohl allerdings noch nicht fest. Diesen Artikel bookmarken Diese Icons verzweigen auf soziale Netzwerke bei denen Nutzer neue Inhalte finden und mit anderen teilen können. […]
bin auch vor kurzem mit der API von IS24 in verbindung gekommen. versuche nun schon seit mehreren tagen, genau wie resident_b, einen schlichten request hinzubekommen.
hab mir dazu ein lokalen server mit pear installiert und die bsp-dateien entsprechend angepasst. öffne ich nun zb. die „query.php“ im browser un klick auf den button, passiert rein gar nichts!
hab nun schon 2 mails an den api-tech-support(keine antwort) und 1 mail an support@is24(keine antwort) geschickt. aus verzweiflung hab ich nun auch schon dort angerufen obwohl ich weiß, dass es keinen telefonischen support hierzu gibt. die habn mich aber auch nur an den tech-support via mail weitergeleitet – ein teufelskreis ohne hilfe! es gibt ja nicht mal ein forum speziell zur is24-api.
hat es denn mittlerweile mal eine privatperson hinbekommen, die is24-api für seine webseite entsprechend einzurichten???
greetzys,
pommes
PS: warum kann ich den 3. schritt im api-center „api fertigstellen und testen“ nicht anklicken (kein link, nur text)??
[…] worden. Immoscout24 verfügt bereits seit längerem über eine solche Schnittstelle (Immobilienscout24 API) und konnte auch sonst die Daten an Partner herausgeben. Mit der Immonet-API entstehen vielleicht […]
[…] als z.B. bei der API von ImmobilienScout24 ist die Schnittstelle auch für Affiliates interessant, da keine Beschränkungen auf einzelne […]
Für die IS24-API wird nächste Woche das neue PHP SDK zur Verfügung stehen, bei dem vor allem die Dokumentation und die FAQ verbessert wurden.
[…] ImmobilienScout24-API ist schon einige Jahre alt. An einer moderneren REST-API wurde schon länger gearbeitet und nun […]