Referentiewoningen API

De Interactieve Referentie API retourneert maximaal 30 relevante vergelijkbare recente transacties voor het doelobject die vóór de opgegeven waarderingsdatum hebben plaatsgevonden.

Accuratesse Altum AI - Altum AI

Interactieve Referentie API

De Interactieve Referentie API van Altum AI retourneert voor het doelobject tot en met 30 relevante Kadaster transacties voor woonobjecten. Relevantie wordt bepaald aan de hand van vergelijkbaarheid t.a.v. woningtype, oppervlakte, locatie en meer variabelen. Het is mogelijk een gewijzigd woningtype op te geven als input of te vragen om strict gelijke woningtype als respons. 

Referentie API documentatie

Zoek interactief naar referentiewoningen

{
"postcode":"2771DS",
"housenumber":87,
"houseaddition": "",
"strict_energylabel": 0,
"energylabel": "A",
"valuationdate": 20220630,
"innersurfacearea": 160,
"buildyear": 1960,
"housetype": "Vrijstaande woning",
"reference_number": 3,
"strict_street": 0,
"strict_buurt": 0,
"strict_wijk": 0,
"comparable_housetype": 0,
"comparable_innersurfacearea": 0,
"comparable_buildyear": 0,
"comparable_distance": 0,
"weight_innersurfacearea": 0.9,
"weight_buildyear": 0.9,
"weight_transactiondate": 0.9,
"weight_distance": 0.9,
"date_limit": 18,
"time_for_sale": 1
}

De Interactieve Referentie API maakt gebruik van meerdere functies om tot de meest geschikte referente objecten te komen.

Identificatie woning (*) en gewenste output

Zoek op postcode, huisnummer en toevoeging via postcode, housenumber en houseaddition

Gewenste output

Geef het aantal gewenste referente objecten op via de functie reference_number.  De waarderingsdatum met transacties aan die datum gaat via de functie valuationdate. Geef aan tot hoeveel maanden terug gezocht mag worden t.o.v. de waarderingsdatum via date_limit. Het is mogelijk, als beschikbaar, het aantal dagen op te vragen dat de woning te koop heeft gestaan via de functie time_for_sale.

Woningdata

Overschrijf de waardes uit de Altum AI-database met eigen invoer voor oppervlakte, energielabel, bouwjaar en woningtype  via innersurfacearea, energylabel, buildyear en housetype.

Strikte zoekfuncties

Een strikte zoekfunctie sluit transacties uit die niet voldoen aan de criteria. Zoek op transacties uit dezelfde straat, wijk of buurt via strict_street, strict_buurt of strict_wijk. Als het energielabel bekend is of meegegeven als input is het mogelijk om te zoeken naar strikt vergelijkbare woningen met hetzelfde energielabel via de functie strict_energylabel.

Gewicht in relevantie

De resultaten van de API kunnen worden gesorteerd aan de hand van gewichten die worden meegegeven aan de zoekopdracht t.a.v. oppervlakte, bouwjaar, transactiedatum, recentheid weegt dan zwaarder en afstand. Dit kan met de functies weight_innersurfaceareaweight_buildyearweight_transactiondate en weight_distance.

Vergelijkbaarheid

Met de vergelijkbaarheidsfuncties is het mogelijk de mate van vergelijkbaarheid te definiëren t.a.v. de woning en in hoeverre transacties moeten worden uitgesloten. Vergelijkbaarheid aangeven kan voor woningtype, oppervlakte, bouwjaar en afstand via comparable_housetypecomparable_innersurfaceareacomparable_buildyear en comparable_distance.

* Vereist

Voorbeeld integratie

Scroll to Top