Plaats op uw website een kaart met daarop het aanbod in uw buurt.
Download PHP broncode
Plaats een galerij met het aanbod van koopwoningen in uw buurt in de huisstijl van uw eigen website.
Download PHP broncode
Titanstraat 7
9933 CE Delfzijl€ 165.000 |
Jachtlaan 16 B
9934 JB Delfzijl € 89.500 |
Stuurboordlaan 16
9934 JN Delfzijl € 125.000 | 
Zicht 31
9932 BL Delfzijl€ 117.500 | 
Burgemeester Buiskoolplein 19
9934 PA Delfzijl€ 135.000 | 
Sluis 32
9934 RW Delfzijl€ 275.000 | 
Midscheeps 34
9934 RS Delfzijl€ 289.000 |
Via de HuizenZoeker API kunt u het totale huizenaanbod van HuizenZoeker doorzoeken en de resultaten tonen op uw eigen website. U kunt zelf bepalen waar u naar zoekt en hoe u de resultaten weergeeft op uw website.
De HuizenZoeker API werkt via HTTP-requests. U stuurt een HTTP-request naar onze server waarbij u de gewenste GET-variabelen meestuurt (zie de voorbeelden onderaan de pagina).
De resultaten van uw aanvraag worden vervolgens weergeven in XML of JSON.
Om requests te kunnen versturen dient u in het bezit te zijn van een HuizenZoeker API-sleutel. Deze kunt u hier aanvragen.
Een request begint altijd met ' https://www.huizenzoeker.nl/api/v2/?apisleutel=...&module=...&get=... '.
De parameters apisleutel, module en get dienen verplicht meegestuurd te worden bij iedere request:
Standaard worden de resultaten weergegeven in XML. U kunt ook kiezen voor een uitvoer in JSON, welke met name geschikt is voor aanvragen via JavaScript.
Hiervoor dient u het volgende mee te geven aan de HTTP request: ' &output=json '
Onderaan deze pagina vindt u diverse voorbeelden hoe u informatie met de API kunt opvragen.
Hieronder staan de modulen van de HuizenZoeker API beschreven. Elke module bevat een bepaald soort informatie. Een module is opgedeeld in functies. De functie geeft aan welke informatie u uit de module wilt halen. U kunt deze informatie verder filteren door één of meer parameters mee te geven, welke staan beschreven achter de betreffende functie.
Bij sommige parameters kunt u zowel een naam als een id als waarde opgeven. Bijvoorbeeld aan de parameter provincie kunt u de waarde Friesland of FR meegeven. De namen en id's van provincies, gemeenten, plaatsen en wijken zijn op te vragen via de module 'Locaties'.
De module Locaties bevat o.a. de namen, id's, latitude en longitude coördinaten van provincies, gemeenten, plaatsen en wijken. Deze informatie kan gebruikt worden om informatie uit de module Objecten op te vragen. Als u de parameter ' &toon=statistiek ' meegeeft worden er eveneens statistieken (aantal objecten) meegestuurd met de resultaten.
| Functie | Omschrijving | Parameter | Waarde | Beschrijving |
|---|---|---|---|---|
| Provincies | Alle provincies van Nederland. | provincie | naam of id | informatie over deze provincie. |
| Gemeenten | Alle gemeenten van Nederland. | provincie | naam of id | gemeenten in deze provincie. |
| gemeente | naam of id | informatie over deze gemeente. | ||
| Plaatsen* | Alle plaatsen in een provincie. | provincie | naam of id | plaatsen in deze provincie. |
| gemeente | naam 1) of id | plaatsen in deze gemeente. | ||
| plaats | naam 1) of id | informatie over deze plaats. | ||
| Wijken* | Alle wijken in een plaats. | provincie | naam of id | plaatsen in deze provincie. |
| plaats | naam 1) of id | wijken van deze plaats. | ||
| wijk | naam 2) of id | informatie over deze wijk. | ||
| Query 3) | Haalt de locatie uit de tekst. | q | locatie | plaats of postcode met eventueel straatnaam en huisnummer. |
| at | 'koop' of 'huur' | type van aanbod bij een specifiek adres. |
* Deze functie vereist minimaal één parameter.
1) Indien u de naam van de gemeente/plaats opgeeft, dan dient u eveneens de naam of het id van de provincie mee te geven. Indien u het id van de gemeente/plaats opgeeft hoeft u de provincie niet op te geven. Voorbeelden:
2) Indien u de naam van de wijk opgeeft, dan dient u eveneens de naam of het id van de plaats mee te geven. Als u de naam van de plaats meegeeft, dient u ook de naam of het id van de provincie mee te geven. Indien u het id van de wijk opgeeft hoeft u de provincie niet op te geven. Voorbeelden:
3) Geeft de plaats met eventuele straat terug. Een lijst van plaatsen wordt getoond als een plaats vaker gevonden is. Bij een specifiek adres wordt (mits gevonden) het object getoond als de parameter ' at ' ook meegestuurd wordt. Alleen een straatnaam meesturen kan, maar de locatie wordt alleen gezien als de straatnaam uniek is, anders wordt de straatnaam als plaatnaam gezien. Voorbeelden:
De module Objecten bevat alle objecten (woningen, garages, kantoren, etc.) die op HuizenZoeker te vinden zijn. Als u de parameter ' &view=filters ' meegeeft worden er eveneens filters meegestuurd met de resultaten. Met deze filters kunt u de gevonden resultaten verder filteren.
| Functie | Omschrijving | Parameter | Waarde | Beschrijving |
|---|---|---|---|---|
| Koop | Alle koopwoningen in Nederland. | provincie* | naam of id | objecten in deze provincie. |
| gemeente* | naam of id | objecten in deze gemeente. | ||
| plaats* | naam 1) of id | objecten in deze plaats. | ||
| wijk | naam 2) of id | objecten in deze wijk. | ||
| pc* | 4 cijfers en 2 letters | objecten beginnend deze postcode (cijfers verplicht). | ||
| adr | naam | objecten met dit adres/in deze straat. | ||
| pv | numeriek | prijs vanaf. | ||
| pt | numeriek | prijs t/m. | ||
| wov | numeriek | woonoppervlakte vanaf. | ||
| wot | numeriek | woonoppervlakte tot. | ||
| pov | numeriek | perceeloppervlakte vanaf. | ||
| pot | numeriek | perceeloppervlakte tot. | ||
| bjv | numeriek | bouwjaar vanaf. | ||
| bjt | numeriek | bouwjaar t/m. | ||
| anbd | numeriek | aanbod sinds aantal dagen. | ||
| bs | 'nieuw' of 'bestaand' | nieuwbouw of bestaande bouw. | ||
| ka | numeriek | minimum aantal kamers. | ||
| so | id | soort object. | ||
| to | id | type object (parameter 'so' verplicht). | ||
| oh | 'j' | alleen objecten met openhuis. | ||
| pw | 'j' | alleen objecten met prijs wijziging. | ||
| ll | 'j' | alleen objecten met geolocatie (latitude en longitude). | ||
| lat 3) | numeriek | objecten rondom latitude geolocatie. | ||
| lng 3) | numeriek | objecten rondom longitude geolocatie. | ||
| strl 4) | numeriek | objecten rondom een geolocatie binnen een straal. | ||
| lm | numeriek | maximum aantal resultaten, maximum limiet is 100. | ||
| p | numeriek | paginanummer waarmee door de resultaten genavigeerd kan worden. | ||
| sort | id | sorteren op, zie functie Sortering voor de mogelijkheden. | ||
| Huur | Alle huurwoningen in Nederland. | Gelijk aan functie Koop. De parameters ' pv ' en ' pt ' zijn hierbij de huurprijzen per maand. | ||
| SoortType | Alle soorten en type objecten. | so | id | typen van deze soort. |
| to | id | alleen dit type. | ||
| Sortering | Sorterings mogelijkheden. | Sorteringsrichting kan aangepast worden door bij het id ' -a ' of ' -d ' te gebruiken. | ||
* Een provincie, gemeente, plaats of postcode is verplicht.
1) Indien u de naam van de plaats opgeeft, dan dient u eveneens de naam of het id van de provincie mee te geven. Indien u het id van de plaats opgeeft hoeft u de provincie niet op te geven. Voorbeelden:
2) Indien u de naam van de wijk opgeeft, dan dient u eveneens de naam of het id van de plaats mee te geven. Als u de naam van de plaats meegeeft, dient u ook de naam of het id van de provincie mee te geven. Indien u het id van de wijk opgeeft hoeft u de provincie niet op te geven. Voorbeelden:
3) Deze parameter werkt alleen als deze in de combinatie van de parameters ' lat ' en ' lng ' en ' strl ' gebruikt wordt. U kunt hiermee objecten rondom deze geolocatie opvragen. Voorbeelden:
4) Deze parameter kunt u gebruiken om in een straal van x aantal kilometers rondom een geolocatie te zoeken. Dit kan een plaats, postcode of een zelf opgegeven locatie (latitude en longitude) zijn. De straal mag maximaal 15 kilometer zijn. Voorbeelden:
