Hoe makelaarskantoren hun CRM-aanbod naar Seeki brengen

Laatst nagekeken: 2026-04-14

Makelaarskantoren kunnen hun volledige CRM-aanbod via de ingest-API naar Seeki overzetten. In het dashboard maak je een sleutel aan, je stuurt een batch objecten in een ondersteund formaat en elk object wordt verwerkt en gepubliceerd op de Europese markten die we bedienen, zonder dat je eigen code hoeft te schrijven. Het dashboard toont de voortgang per item, geeft de reden bij een fout en laat je rijen opnieuw proberen zonder de hele batch opnieuw te uploaden.

Dit stuk is de oriëntatie die we elke operationeel verantwoordelijke van een makelaarskantoor gunnen wanneer die voor het eerst naar Seeki kijkt. Het loopt de hele import door, van „we hebben duizenden objecten in het CRM" naar „ze staan live op het portaal in alle ondersteunde talen", en beschrijft wat je in elke stap kunt verwachten.

Onboarding in 5 stappen

1. Haal een API-sleutel. Log in op het makelaarsdashboard en maak onder API-sleutels een sleutel aan. De sleutel hoort bij jouw kantoor.
2. Formatteer de payload. Map je CRM-export naar een ondersteund feed-formaat. We accepteren Seeki-JSON (ons canonieke schema), OpenImmo (de Europese OASIS-standaard, breed gebruikt in DACH-CRMs) en Idealista XML-ML (gangbaar in Spanje en Portugal).
3. Verstuur de batch. Post het bestand naar de ingest-API. Zeer grote bestanden worden in delen verstuurd.
4. Volg het importdashboard. Elk object heeft een eigen regel met live status, foutreden bij mislukken en een knop om opnieuw te proberen.
5. Objecten worden gepubliceerd. Zodra een object verwerkt is, staat het live in alle ondersteunde talen en is het vindbaar op de landenpagina's en in de AI-zoekbalk.

Het meeste werk zit in stap 2. Stap 3 tot 5 draait aan de Seeki-kant.

Wat er gebeurt nadat een object binnenkomt

Een object verschijnt niet op het portaal op het moment dat je POST 200 teruggeeft. Elk item wordt asynchroon gevalideerd, aangevuld met afgeleide data, gescoord en gepubliceerd. De meeste objecten zijn in seconden klaar. Heeft een object een te herstellen probleem (ontbrekend verplicht veld, foto-URL die niet laadt, adres dat we niet op de kaart kunnen plaatsen), dan wordt het in het dashboard als mislukt gemarkeerd met de specifieke reden, en de rest van de batch loopt door.

Je hoeft niet te weten wat er onder de motorkap draait. Wat je wél moet weten: het dashboard zegt precies waar elk object staat, en het herstellen van één fout record vereist niet dat je de hele feed opnieuw uploadt.

Handmatige invoer, web-import en API-ingest

Drie manieren om op Seeki te publiceren, elk voor een heel andere schaal.

De keuze is meestal pragmatisch: exporteert je CRM al OpenImmo of heb je een ontwikkelaar die Seeki-JSON kan produceren, dan is de API-route het goedkoopst. Run je een boetiekkantoor met enkele tientallen premium objecten, dan is handmatige invoer prima.

Wat het importdashboard laat zien

In het dashboard brengen operationele medewerkers na de eerste batch de meeste tijd door. Bovenaan staat de samenvatting van elke import (totaal, geslaagd, lopend, mislukt) en de tabel daaronder zegt per record precies wat er gebeurt. Filter op mislukt, lees de reden-kolom, herstel de data in het CRM en druk op opnieuw proberen bij de betreffende rijen. De hele feed opnieuw uploaden voor een paar slechte records is niet nodig.

Wanneer een object publiceert, linkt de rij direct naar de openbare pagina, zodat je kunt controleren hoe het in de doeltaal wordt weergegeven.

Beheer je imports hier zodra je een sleutel hebt.

Abonnement en toegang

API-ingest is een betaalde functie voor makelaarskantoren. De onboarding bevat een abonnementsstap via Stripe. Je kiest een tarief, vult betaal- of factuurgegevens in en je API-sleutel wordt actief. Facturatie verloopt maandelijks, met de mogelijkheid van jaarlijkse vooruitbetaling. Vervalt het abonnement, dan wordt ingest gepauzeerd. Bestaande objecten blijven gepubliceerd, maar nieuwe imports worden afgewezen tot de facturatie weer in orde is. Het dashboard toont het huidige tarief, het verbruik en eventuele verlengingsmeldingen op het overzichtsscherm.

Bovenop het abonnement is er geen vergoeding per object. De doorvoer hangt af van het tarief. Heb je echt zeer hoge gelijktijdige doorvoer nodig, neem dan vooraf contact op zodat we het juiste plan kunnen dimensioneren.

Veelgestelde vragen

Welk payload-formaat wordt ondersteund?

Drie formaten. Seeki-JSON is ons canonieke schema, een plat, goed gedocumenteerd JSON-schema dat alle objectvelden en foto-URL's dekt. OpenImmo (de Europese OASIS-standaard, breed gebruikt in DACH-CRMs) wordt geaccepteerd als XML of als zip-pakket met de XML en de fotobestanden. Idealista XML-ML wordt geaccepteerd voor Spaanse en Portugese kantoren waarvan het CRM dat dialect al spreekt. De sectie API-sleutels in het dashboard linkt naar de volledige schemareferentie en een interactieve playground.

Hoe worden dubbele records afgehandeld?

Objecten worden geïdentificeerd op basis van jouw kantoor-ID plus het externe ID van het object, de identifier die je CRM al gebruikt. Als je een object met hetzelfde externe ID opnieuw verstuurt, behandelt Seeki het als een update, niet als een nieuw object. Routinematige aanbodsupdates (dagelijks, uurlijks of telkens wanneer je CRM een wijziging meldt) werken zo zonder eigen deduplicatielogica.

Kan ik objecten in bulk bijwerken?

Ja. Het ingest-endpoint is hetzelfde voor aanmaken en bijwerken. Een object opnieuw versturen met gewijzigde velden werkt het live record bij. Wil je alleen een deel bijwerken, stuur dan alleen die objecten. Seeki raakt objecten die niet in de batch staan, niet aan. Een object verwijderen doe je door het in je CRM op inactief te zetten en mee te sturen met de status verkocht of ingetrokken. Het wordt dan uit de zoekresultaten gearchiveerd.

En makelaarskantoren buiten de EU met EU-aanbod?

De API controleert niet waar je kantoor gevestigd is. Ze controleert of het land van het object bij de Europese markten hoort die Seeki bedient. Een kantoor in Londen of New York met Spaans of Tsjechisch aanbod gebruikt hetzelfde ingest-endpoint. Fiscale en contractuele structuur aan jouw kant blijft jouw verantwoordelijkheid. De overeenkomst met Seeki dekt de plaatsingsdienst.

Hoe snel verschijnen nieuwe objecten?

Een object is doorgaans in seconden klaar. De totale tijd van jouw POST tot een openbaar vindbaar object hangt af van de batchgrootte en de actuele belasting, maar kleine batches worden meestal end-to-end binnen een minuut per object gepubliceerd. Vertalingen naar andere talen worden bij de eerste weergave gegenereerd. Een object is dus direct volledig vindbaar in de brontaal en verschijnt in vertaalde vorm zodra iemand het voor het eerst in een andere lokalisatie opent.

Wat als een object de validatie niet haalt?

Het wordt in het dashboard gemarkeerd als mislukt met de specifieke reden: ontbrekend verplicht veld, foto-URL niet bereikbaar, prijs onder de aannemelijkheidsdrempel, enzovoort. De rest van de batch loopt door. Corrigeer de data in je CRM, exporteer opnieuw en verstuur ofwel de hele batch, ofwel probeer de mislukte rijen opnieuw vanuit het dashboard. Opnieuw proberen kost niets, en de deduplicatie op extern ID voorkomt onbedoelde duplicaten.

Volgende stappen

Is je kantoor klaar, dan is het pad kort: maak een sleutel aan, stuur een kleine testbatch uit een CRM-export, volg hem in het dashboard en zet daarna de volledige feed aan. We houden de afstand tussen „ik heb een CSV" en „de objecten staan live in heel Europa" bewust klein. Het platform vangt de operationele complexiteit op in plaats van die terug naar jou te schuiven.

Wanneer je zover bent, leidt de onboardingpagina je in één flow door sleutelaanmaak, betaling en de eerste import.