Wie Maklerbüros ihren CRM-Bestand auf Seeki bringen

Zuletzt geprüft: 2026-04-14

Maklerbüros können einen kompletten CRM-Bestand über die Ingest-API auf Seeki bringen. Im Dashboard wird ein Key erzeugt, eine Charge von Anzeigen in einem unterstützten Format gesendet, und jede Anzeige wird auf den europäischen Märkten, die wir bedienen, verarbeitet und veröffentlicht, ohne dass eigener Code geschrieben werden muss. Das Dashboard zeigt den Fortschritt pro Item, weist auf Fehler hin und erlaubt das gezielte Wiederholen einzelner Zeilen, ohne die ganze Charge erneut hochzuladen.

Dieser Beitrag ist die Orientierung, die wir jedem Operations-Lead eines Maklerbüros wünschen, wenn er sich Seeki zum ersten Mal anschaut. Er führt durch den vollständigen Import, vom „wir haben tausende Objekte im CRM" bis „sie sind im Portal in allen unterstützten Sprachen sichtbar", und beschreibt, was in jedem Schritt zu erwarten ist.

Onboarding in 5 Schritten

1. API-Key holen. Im Maklerbüro-Dashboard anmelden und unter API-Keys einen Schlüssel erzeugen. Der Key ist an Ihr Büro gebunden.
2. Daten aufbereiten. Den CRM-Export auf ein unterstütztes Feed-Format abbilden. Wir akzeptieren Seeki-JSON (unser kanonisches Schema), OpenImmo (der europäische OASIS-Standard, weit verbreitet in DACH-CRMs) und Idealista XML-ML (gängig in Spanien und Portugal).
3. Charge senden. Die Datei an die Ingest-API posten. Sehr große Bestände werden in Blöcken übertragen.
4. Im Import-Dashboard verfolgen. Jede Anzeige hat eine eigene Zeile mit Live-Status, Fehlergrund bei Misserfolg und einer Wiederholen-Schaltfläche.
5. Anzeigen gehen live. Sobald eine Anzeige fertig verarbeitet ist, ist sie in allen unterstützten Sprachen sichtbar und in den Länderseiten sowie der KI-Suche auffindbar.

Der Hauptaufwand liegt in Schritt 2. Die Schritte 3 bis 5 laufen auf Seeki-Seite.

Was nach Eingang einer Anzeige passiert

Eine Anzeige erscheint nicht in der Sekunde, in der Ihr POST 200 zurückgibt. Jedes Item wird asynchron validiert, um abgeleitete Daten ergänzt, bewertet und veröffentlicht. Die meisten Anzeigen sind in Sekunden fertig. Hat eine Anzeige ein behebbares Problem (fehlendes Pflichtfeld, eine Foto-URL, die nicht lädt, eine Adresse, die wir nicht auf der Karte verorten können), wird sie im Dashboard mit konkretem Grund als gescheitert markiert, und der Rest der Charge läuft weiter.

Was unter der Haube läuft, müssen Sie nicht kennen. Wichtig ist: Das Dashboard sagt Ihnen genau, wo jede Anzeige steht, und das Beheben eines fehlerhaften Datensatzes verlangt nicht, den ganzen Feed neu einzuspielen.

Manuelle Eingabe, Web-Import und API-Ingest

Drei Wege, auf Seeki zu publizieren, für deutlich verschiedene Größenordnungen.

Die Entscheidung ist meist pragmatisch: Wenn Ihr CRM ohnehin OpenImmo exportiert oder Sie einen Entwickler haben, der Seeki-JSON erzeugen kann, ist der API-Weg am günstigsten. Wer ein Boutique-Büro mit ein paar Dutzend Premium-Objekten betreibt, kommt mit manueller Eingabe gut zurecht.

Was das Import-Dashboard zeigt

Im Dashboard verbringen Operations-Mitarbeiter nach dem ersten Import die meiste Zeit. Oben steht die Zusammenfassung des Imports (Gesamt, erfolgreich, in Bearbeitung, gescheitert) und die Tabelle darunter zeigt pro Datensatz exakt, was passiert. Sie filtern auf gescheitert, lesen die Spalte mit dem Grund, korrigieren die Daten im CRM und drücken bei den betroffenen Zeilen Wiederholen. Es ist nicht nötig, den gesamten Feed wegen einer Handvoll fehlerhafter Datensätze neu einzuspielen.

Wenn eine Anzeige veröffentlicht wird, verlinkt die Zeile direkt auf die öffentliche Seite, sodass Sie die Darstellung in der Zielsprache prüfen können.

Importe verwalten Sie hier, sobald ein Key erzeugt ist.

Abo und Zugang

API-Ingest ist eine kostenpflichtige Funktion für Maklerbüros. Das Onboarding enthält einen Abo-Schritt über Stripe: Sie wählen einen Tarif, geben Zahlungs- oder Rechnungsdaten ein, und Ihr API-Key wird aktiv. Abgerechnet wird monatlich, eine jährliche Vorauszahlung ist möglich. Läuft das Abo aus, wird Ingest pausiert. Bestehende Anzeigen bleiben veröffentlicht, neue Importe werden bis zur Klärung der Abrechnung abgelehnt. Aktuellen Tarif, Verbrauch und etwaige Verlängerungshinweise sehen Sie auf der Übersichtsseite.

Zusätzlich zum Abo fällt keine Gebühr pro Anzeige an. Der Durchsatz hängt vom Tarif ab. Bei wirklich hohem parallelem Durchsatzbedarf sprechen Sie uns vor Vertragsabschluss an, damit wir den passenden Plan dimensionieren.

Häufige Fragen

Welche Datenformate werden unterstützt?

Drei Formate. Seeki-JSON ist unser kanonisches Schema, ein flaches, gut dokumentiertes JSON-Schema, das alle Anzeigenfelder und Foto-URLs abdeckt. OpenImmo (der europäische OASIS-Standard, weit verbreitet in DACH-CRMs) wird als XML oder als Zip-Paket mit XML und Fotodateien angenommen. Idealista XML-ML ist für spanische und portugiesische Büros vorgesehen, deren CRM diesen Dialekt bereits spricht. Im API-Keys-Bereich des Dashboards finden Sie die vollständige Schema-Referenz und eine interaktive Spielwiese.

Wie werden Duplikate behandelt?

Anzeigen werden über Ihre Maklerbüro-ID plus die externe ID der Anzeige identifiziert, also die Kennung, die Ihr CRM ohnehin verwendet. Wird eine Anzeige mit derselben externen ID erneut gesendet, behandelt Seeki sie als Aktualisierung, nicht als neue Anzeige. Tägliche, stündliche oder ereignisgetriebene Bestandsaktualisierungen funktionieren so ohne eigene Deduplizierungslogik.

Kann ich Anzeigen in großer Menge aktualisieren?

Ja. Der Ingest-Endpunkt ist für Anlegen und Aktualisieren identisch. Schicken Sie eine Anzeige mit geänderten Feldern erneut, wird der Live-Datensatz aktualisiert. Wollen Sie nur eine Teilmenge aktualisieren, senden Sie nur diese Anzeigen. Seeki rührt Anzeigen, die nicht in der Charge enthalten sind, nicht an. Zum Entfernen markieren Sie die Anzeige im CRM als inaktiv und übermitteln sie mit Status verkauft oder zurückgezogen. Sie wird dann aus der Suche archiviert.

Was ist mit Büros außerhalb der EU mit EU-Bestand?

Die API prüft nicht, wo Ihr Maklerbüro seinen Sitz hat. Sie prüft, ob das Land der Anzeige zu den europäischen Märkten gehört, die Seeki bedient. Ein Büro in London oder New York mit spanischem oder tschechischem Bestand nutzt denselben Ingest-Endpunkt. Die steuerliche und vertragliche Gestaltung auf Ihrer Seite liegt in Ihrer Verantwortung. Der Vertrag mit Seeki gilt der Inseratsleistung.

Wie schnell tauchen neue Anzeigen auf?

Eine Anzeige ist typischerweise in Sekunden fertig. Die Gesamtzeit von Ihrem POST bis zur öffentlich auffindbaren Anzeige hängt von Chargengröße und aktueller Auslastung ab, kleine Chargen werden aber meist unter einer Minute pro Anzeige End-to-End veröffentlicht. Übersetzungen in andere Sprachen entstehen beim ersten Aufruf. Die Anzeige ist also in der Quellsprache sofort vollständig suchbar und erscheint in übersetzter Form, sobald sie jemand zum ersten Mal in einer anderen Lokalisierung öffnet.

Was passiert, wenn eine Anzeige die Validierung nicht besteht?

Sie wird im Dashboard mit konkretem Grund als gescheitert markiert: fehlendes Pflichtfeld, Foto-URL nicht erreichbar, Preis unterhalb der Plausibilitätsschwelle und so weiter. Der Rest der Charge läuft weiter. Korrigieren Sie die Daten im CRM, exportieren Sie erneut und schicken Sie entweder die ganze Charge oder wiederholen Sie die gescheiterten Zeilen aus dem Dashboard. Wiederholungen kosten nichts, und die Deduplizierung über die externe ID verhindert versehentliche Dubletten.

Nächste Schritte

Wenn Ihr Maklerbüro bereit ist, ist der Weg kurz: Key erzeugen, eine kleine Testcharge aus dem CRM-Export senden, im Dashboard verfolgen, dann den Vollfeed scharf schalten. Wir halten den Abstand zwischen „ich habe eine CSV" und „die Anzeigen sind in ganz Europa live" bewusst klein. Die Plattform soll die Betriebskomplexität auffangen, nicht an Sie zurückreichen.

Sind Sie soweit, führt Sie die Onboarding-Seite durch Key-Erstellung, Zahlung und ersten Import in einem Flow.