Bijna elke websitebouwer voor makelaars belooft dat je aanbod “automatisch” op je site staat. De vraag die zelden beantwoord wordt: hoe snel, en wat gebeurt er als het een keer misgaat? Daar gaat deze pagina over.

Ik ben Jasper Frumau, WordPress-developer sinds 2009. Ik bouwde en onderhield de Realworks-koppeling van een makelaarskantoor, en bij mij spreek je direct de developer, zonder bureau ertussen.

Hoe je aanbod van Realworks op je site komt

1. Je activeert de API in Realworks. Dat doe je zelf, via de Servicedesk en de Marketplace in Realworks. Vraag daar ook na of de API-module extra kost in jouw contract.
2. Je geeft mij toegang. Ik registreer de koppeling als developer, jij keurt hem goed en geeft de gegevens vrij die op de site mogen.
3. Ik haal je aanbod op. De lijst met woningen komt via de Realworks API op je site. Elke woning krijgt een eigen pagina met een leesbaar adres, zoals /aanbod/polderstraat-30/, zodat Google en je bezoekers hem kunnen vinden en delen.
4. Ik richt de meldingen in. Realworks stuurt bij elke wijziging een bericht (een webhook) naar je site. Daarover hieronder meer.

Je houdt je eigen WordPress-site, je eigen ontwerp en je eigen hosting. De koppeling komt erbij, je hoeft niet over naar een ander platform.

Direct online met webhooks, niet pas bij de volgende ronde

Er zijn twee manieren om je aanbod actueel te houden. De eenvoudige: je site vraagt Realworks om de zoveel tijd of er iets veranderd is. Zet je om tien uur een woning op verkocht, dan kan het tot de volgende ronde duren voordat je site dat laat zien. Intussen belt er misschien iemand over een huis dat al weg is.

De betere manier: Realworks meldt het zelf. Bij elke wijziging in een object of een status stuurt Realworks een webhook naar je site. Je site gooit de oude gegevens weg en haalt de nieuwe op, zodat de wijziging binnen enkele minuten online staat.

Die twee werken samen. In de koppeling die ik bouwde ververste de site het aanbod tijdens kantooruren (7 tot 19 uur) elke 10 minuten en daarbuiten elk uur. De webhook zorgde dat een wijziging daar niet op hoefde te wachten. Zo blijft je site snel, en vraagt hij Realworks niet onnodig vaak om gegevens.

Wat er misgaat bij een Realworks-koppeling (en hoe je het merkt)

Een koppeling die werkt, merk je niet. Een koppeling die stuk is ook niet altijd, en dat is het probleem. Dit zijn de fouten die je tegenkomt, een paar ervan uit eigen ervaring:

• Er komt helemaal geen aanbod door. Meestal is de API niet geactiveerd in Realworks, of is het datalevel niet vrijgegeven voor de koppeling. Ontbreekt één woning, kijk dan of die woning zelf is vrijgegeven voor publicatie via de API.
• Het werkte, en na een verhuizing van de site niet meer. Bij de koppeling kun je in Realworks vastleggen van welke server-adressen verzoeken zijn toegestaan. Is dat ingesteld, zoals bij de koppeling waar ik aan werkte, en verhuist je site naar een nieuwe hosting, dan moet het nieuwe adres eerst worden toegevoegd. Anders blijft het aanbod leeg.
• Een storing bij Realworks maakt je aanbodpagina leeg. Als de API even niet antwoordt, moet je site de laatste goede versie blijven tonen. Doet hij dat niet, dan zien bezoekers een lege pagina tot de volgende ronde, ook als er niets veranderd is.
• Wijzigingen komen pas uren later door. Dan draait de koppeling zonder webhooks, of komen de meldingen niet aan.
• Realworks verandert iets aan zijn kant. Op 29 juli 2026 veranderde Realworks de opbouw van zijn webhook-berichten. Elke melding mislukte daarna, en na 25 mislukte meldingen op rij zette Realworks de webhook zelf uit. Het aanbod werd nog wel ververst, maar alleen op de vaste momenten. Eerder dat jaar moest elke koppeling vóór 6 mei over van API v1 naar v3, en v3 levert sommige adresgegevens anders aan, wat zonder aanpassing pagina’s laat vastlopen. Zulke wijzigingen komen niet bij jou binnen, maar bij je developer, als die het logboek in de gaten houdt.
• De meldingen worden niet gecontroleerd. Een webhook-adres hoort alleen berichten te accepteren die echt van Realworks komen, met een geheime sleutel die bij elk bericht wordt meegestuurd. Zonder die controle kan iedereen je site laten verversen.

De koppeling die ik bouwde hield een logboek bij van de API-verzoeken en de meldingen. Gaat er iets mis, dan zie ik wanneer en waarom, in plaats van te gokken. Zo vond ik de fout van 29 juli: in het logboek, niet via een klacht van een bezoeker.

Voor ontwikkelaars: hoe de koppeling technisch in elkaar zit

Voor wie wil weten wat er onder de motorkap zit, in de koppeling die ik bouwde:

• Bron: Realworks Wonen API v3 (/wonen/v3/objecten), met paginering.
• Cache: een JSON-bestand met een vervaltijd, 10 minuten tussen 07:00 en 19:00 en 1 uur daarbuiten. Een lock-bestand van 30 seconden voorkomt dat meerdere bezoekers tegelijk de API aanroepen als de cache verloopt.
• Webhooks: een eigen endpoint (/realworks-webhook/) voor object- en statuswijzigingen. Het controleert de signature-header die Realworks meestuurt, kan optioneel op IP-adres filteren en wist bij een geldige melding de cache, inclusief de LiteSpeed-paginacache van die woning en van het overzicht.
• Woningpagina’s: WordPress rewrite rules zetten /aanbod/{straat}-{huisnummer}/ om naar het juiste Realworks-object.
• Tests: PHPUnit voor de cache, de webhooks en de verwerking van de API-gegevens.

Je bestaande makelaarswebsite overnemen

Heb je al een WordPress-site met een Realworks-koppeling, maar is je bouwer gestopt, onbereikbaar of te duur geworden? Dan neem ik hem over zoals hij is. Ik begin met een back-up en een check van de koppeling: komen alle woningen door, werken de meldingen, en wat gebeurt er bij een storing. Je hoort wat ik vind en wat het kost om het op te lossen, voordat ik iets verander. Meer over hoe dat gaat lees je in zo werken wij.

Ik werk als vaste WordPress-developer vanuit Jakarta, terwijl Nederland slaapt. Updates en aanpassingen aan de koppeling gebeuren buiten kantoortijd, als er weinig bezoekers zijn.

Voorbeeld: Rob Disbergen Makelaars

Voor Rob Disbergen Makelaars deed ik het API-werk op hun bestaande WordPress-thema, en een aantal aanpassingen aan het thema zelf. Het aanbod komt rechtstreeks uit Realworks, elke woning heeft een eigen pagina, en wijzigingen komen via webhooks binnen. Ik onderhield de koppeling tot november 2026. Dat jaar zette ik hem over naar API v3, vóór de deadline van 6 mei, en paste ik hem aan toen Realworks in juli de opbouw van de webhook-berichten veranderde. Lees de case study (Engels).

Wat kost een Realworks-koppeling?

Elke koppeling krijgt vooraf een vaste prijs. Wat die prijs bepaalt: of je al een WordPress-site hebt, hoeveel soorten aanbod er op moeten (wonen, bedrijfsmatig, nieuwbouw), en hoe de woningpagina’s eruit moeten zien. Aanpassingen en onderhoud daarna reken ik af per uur, €65. Geen abonnement en geen contract.

Eventuele kosten van Realworks zelf voor de API-module lopen via je eigen contract met Realworks.

Veelgestelde vragen

• Hoe activeer ik de Realworks API voor mijn website? Dat doe je zelf in Realworks, via de Servicedesk en de Marketplace. Daarna keur je de koppeling van je developer goed en geef je de gegevens vrij die op je site mogen.
• Hoe snel staat een nieuw object of een wijziging op mijn site? Met webhooks binnen enkele minuten, omdat Realworks elke wijziging zelf aan je site meldt. Zonder webhooks hangt het af van hoe vaak je site Realworks raadpleegt, en dat kan oplopen tot een uur of langer.
• Waarom komt mijn aanbod niet door, terwijl de developer-ID klopt? Vaak is de API niet geactiveerd of is het datalevel niet vrijgegeven. Is je site onlangs verhuisd en staan er toegestane IP-adressen bij de koppeling, dan moet het nieuwe server-adres daar eerst bij.
• Kan ik mijn huidige makelaarswebsite houden en alleen de koppeling laten verbeteren? Ja. Ik neem je bestaande WordPress-site over zoals hij is, check de koppeling en vertel je wat er beter kan voordat ik iets verander.
• Wat kost een Realworks-koppeling op WordPress? Je krijgt vooraf een vaste prijs, afhankelijk van je huidige site, de soorten aanbod en de woningpagina’s. Aanpassingen daarna kosten €65 per uur, zonder abonnement.