So funktioniert die Angebots-Syndizierung zu ImmobilienScout24

Angebots-Syndizierung ist die Aufgabe, ein Objekt aus dem eigenen System auf ein Portal zu bringen und beide im Gleichschritt zu halten, bis die Einheit vermietet oder verkauft ist. In Deutschland ist das wichtigste Portal ImmobilienScout24, und es gibt genau zwei Wege dorthin: eine dateibasierte OpenImmo-Übertragung oder die REST-API des Portals. Beide verhalten sich unterschiedlich, scheitern unterschiedlich, und die meisten Teams brauchen am Ende beide, weil IS24 nicht das einzige Portal im Mediaplan ist.

Weg eins: OpenImmo, die Datei, die die meisten Portale erreicht

OpenImmo ist ein offener XML-Standard für deutsche Immobiliendaten, gepflegt von der OpenImmo-Initiative. Sie beschreiben jedes Objekt einmal in einem strukturierten XML-Dokument, packen es mit Fotos und Dokumenten in ein ZIP und legen dieses Paket in den Übertragungsordner des Portals, meist per FTP oder SFTP. Das Portal holt das Paket nach eigenem Zeitplan ab und importiert es.

Seine Stärke ist die Reichweite. Immowelt, Immonet und Dutzende regionale und spezialisierte Portale nehmen OpenImmo an, sodass ein Export viele Ziele bedient und ein weiteres Portal meist nur weitere Zugangsdaten bedeutet. Das Format transportiert Anlegen, Ändern und Löschen über ein Aktionskennzeichen je Objekt, unterstützt Vollimporte, bei denen das Paket die ganze Wahrheit ist, und Teilimporte, die nur Änderungen tragen, und bündelt die Medien im ZIP mit Titelbild und Reihenfolge im XML.

Seine Schwäche ist das Timing. Eine Dateiübertragung ist von Natur aus Stapelverarbeitung: Eine Preisänderung landet beim nächsten Importlauf des Portals, nicht im Moment des Speicherns, und ein zurückgenommenes Inserat kann stundenlang sichtbar bleiben. Für ein Portal, das Sie täglich aktualisieren, ist das akzeptabel. Für das eine Portal, von dem die meisten Anfragen kommen, meist nicht.

Weg zwei: die REST-API von ImmobilienScout24

ImmobilienScout24 bietet neben dem Dateiimport eine eigene REST-API. Statt eine Datei abzulegen, ruft der Konnektor direkt auf: Authentifizierung per OAuth, Anlegen oder Aktualisieren des Inserats, Hochladen jedes Fotos über einen separaten Anhang-Aufruf, dann Veröffentlichen. Weil jeder Schritt eine Anfrage mit Antwort ist, ist eine Änderung nahezu in Echtzeit live, ein Fehler kommt als konkrete Meldung zurück statt als stiller Nicht-Import, und Anfragen lassen sich über dieselbe Schnittstelle abholen.

Der Preis sind Reichweite und Aufwand. Die API erreicht nur IS24. Sie verlangt eine Anwendungsregistrierung und eine Zugangsfreigabe durch das Portal, Token-Handling und die Einhaltung von Ratenlimits. Es gibt einen Sandbox-Endpunkt zum Testen und einen Produktionsendpunkt für echte Inserate, und ein Konnektor, der die beiden nicht unterscheidet, veröffentlicht irgendwann Testdaten öffentlich. Behandeln Sie den Wechsel von Sandbox auf Produktion als bewussten, protokollierten Schritt.

Was ein Inserat braucht, bevor es irgendwohin kann

Beide Wege lehnen unvollständige Inserate ab oder stufen sie herab. Der Datensatz braucht Adresse und Geokoordinaten, die Vermarktungsart (Kauf oder Miete), den Objekttyp, Wohn- und Nutzfläche, Zimmerzahl, Preis oder Miete mit der richtigen Basis (kalt, warm, je Quadratmeter) und einen Mediensatz mit definiertem Titelbild und Reihenfolge. In Deutschland ist der Energieausweis keine Option: Das Gebäudeenergiegesetz verlangt Ausweisart, Energiebedarfs- oder Verbrauchswert, Energieträger und Baujahr in der Anzeige selbst, und die Portale setzen das durch. Eine Inseratspipeline, die ein Inserat ohne diese Felder zum Portal lässt, erzeugt ein Compliance-Problem, nicht nur einen abgelehnten Upload.

Der Zyklus: veröffentlichen, aktualisieren, zurücknehmen

Syndizierung ist kein einzelner Push. Sie ist ein Zyklus mit drei Übergängen, und an jedem bricht ein manueller Prozess.

• Veröffentlichen. Der Datensatz wird auf das Portalformat abgebildet und geht live. Das Portal liefert eine Kennung und eine Exposé-URL zurück; beide gehören an Ihren Datensatz, sonst finden Sie das Inserat aus dem eigenen System nie wieder.
• Aktualisieren. Eine Preisänderung, ein neuer Grundriss, eine korrigierte Fläche. Bei OpenImmo ist das ein geändertes Paket beim nächsten Import, bei der API ein sofortiger Aufruf. In beiden Fällen darf das Portalinserat nie von Hand in der Portaloberfläche bearbeitet werden, weil die nächste Synchronisation es überschreibt.
• Zurücknehmen. Die Einheit ist vermietet oder verkauft. Diesen Übergang vergessen Teams, und ein veraltetes Inserat kostet doppelt: Das Portal berechnet weiter, und die Anfragen kommen weiter, für etwas, das es nicht mehr gibt.

Leads kommen zurück, sonst war die Übung sinnlos

Der Grund zu veröffentlichen ist Nachfrage, und Nachfrage kommt als Kontaktanfrage. Jede sollte am Datensatz des Inserats landen, aus dem sie stammt, der Einheit zugeordnet, mit dem Suchprofil des Interessenten und mit einer Einwilligung, die im Moment des Eingangs protokolliert wird, weil die DSGVO ab der ersten Nachricht gilt. Zwei Dinge gehen hier in der Praxis schief. Derselbe Interessent schreibt zu drei Einheiten und wird zu drei Datensätzen, also muss die Deduplizierung beim Eingang laufen, nicht in einer vierteljährlichen Bereinigung. Und eine Anfrage, die in einem Sammelpostfach statt im System landet, wird spät oder doppelt beantwortet. Wenn Ihr Portalkonnektor nur sendet und nie abholt, fehlt die Hälfte der Integration.

Wie der Betrieb im Alltag aussieht

Ein Syndizierungsprozess, der tatsächlich betrieben und nicht nur vorgeführt wird, hat einige sichtbare Eigenschaften. Jedes Veröffentlichen, Aktualisieren und Zurücknehmen ist ein Job mit Status: wartend, in Verarbeitung, erfolgreich oder fehlgeschlagen mit dem Fehlertext des Portals. Fehlgeschlagene Jobs werden gezielt wiederholt, nicht verloren. Zugangsdaten für das Portal liegen in einem Geheimnisspeicher, nicht in einer Konfigurationstabelle, die jemand exportieren kann. Es gibt einen Ort, an dem man sieht, welche Portale verbunden sind, ob die Verbindung gesund ist und was mit den letzten fünfzig Jobs passiert ist. Und die Person, die ein Inserat veröffentlicht, tut das vom Objektdatensatz aus, nicht aus einem zweiten Werkzeug mit zweitem Login.

So macht es REPM

REPM deckt beide Wege aus einem Objektdatensatz ab. Für ImmobilienScout24 nutzt es die offizielle IS24-REST-API: Ein Klick auf Veröffentlichen im ListingCockpit legt die Veröffentlichung und einen Sync-Job an, ein persistenter Outbox-Mechanismus liefert ihn aus, und der Exposé-Link wird an das Inserat zurückgeschrieben. Jobs zeigen Wartend, In Verarbeitung, Erfolgreich oder Fehlgeschlagen mit dem Fehlertext des Portals und einer Wiederholung per Klick. Der Portal Hub übernimmt Verbindungsprüfung, OAuth-Zertifizierung mit IS24, den Aktiv-Schalter und das Job-Protokoll, gegen Sandbox oder Produktion, mit Zugangsdaten in Azure Key Vault. Für Immowelt und den Long Tail exportiert REPM OpenImmo 1.2.7. Anfragen kehren dedupliziert und mit protokollierter Einwilligung zum Datensatz zurück, der Einheit und dem Suchprofil zugeordnet. Wenn Sie ein Inserat vom Datensatz bis zur Portal-URL auf Ihren eigenen Daten sehen möchten, fordern Sie eine Demo an.

Zurück zum Blog