Authenticatie, invoer en resultaat
Headers
Content-Type
string
application/json
x-api-key*
string
Unieke API-sleutel van Altum. Verkrijg er een via Mopsus (https://mopsus.altum.ai)
Dit is de hoofdendpoint van de API. Deze haalt een lijst met subsidies op op basis van de postcode van een gebruiker en, indien opgegeven, hun persoonlijke en financiële gegevens voor leen-geschiktheid.
GET: https://api.altum.ai/market-trend
Request body
Markettrend Request Model
Veld
Type
Beschrijving
postcode*
string
Verplicht. De Nederlandse postcode (bijv. "3511 AA")
Example Complete Input
Een geldige POST-aanvraagtekst ziet er als volgt uit:
{
"postcode": "5258BA"
}Bij een succesvolle GET-aanvraag retourneert de API de status 200 OK met een JSON-object dat de resultaten bevat.
Market Trend API Response Model
Veld
Type
Beschrijving
postcode
String
De genormaliseerde Nederlandse postcode (bijv. "1011AB") die voor de query is gebruikt.
city
String
De plaatsnaam afgeleid van de adresstamgegevens.
neighbourhood
String
De specifieke buurtnaam (indien beschikbaar in Dataland-bron).
municipality
String
De administratieve gemeente waaronder het gebied valt.
averagePriceSingleFamilyHomes
Float
De gemiddelde transactieprijs voor eengezinswoningen (vrijstaand, twee-onder-een-kap, tussenwoningen).
averagePriceMultiFamilyHomes
Float
De gemiddelde transactieprijs voor meergezinswoningen (appartementen/flats).
pricePerSquareMeterSingleFamily
Float
De gemiddelde prijs per vierkante meter (€/m²) voor eengezinswoningen.
pricePerSquareMeterMultiFamily
Float
De gemiddelde prijs per vierkante meter (€/m²) voor appartementen.
annualPriceChange
Float
De jaarlijkse procentuele groei (CAGR) van vastgoedwaarden vergeleken met het voorgaande geregistreerde jaar.
fiveYearPriceChange
Float
De geprojecteerde procentuele waardeverandering over een periode van 5 jaar op basis van historische groeitrends.
totalSalesLast12Months
Integer
Het totaal aantal vastgoedtransacties dat de afgelopen 365 dagen in deze postcode is geregistreerd.
priceDistribution
Object
Een dictionary die dient als histogram, waarbij prijsklassen (bijv. "250-500k") worden gekoppeld aan het aantal verkochte panden in die categorie.
pricePerSquareMeterDistribution
Object
Een dictionary die dient als histogram, waarbij prijs-per-m²-klassen (bijv. "3000-3500") worden gekoppeld aan de verkoopfrekwentie in die categorie.
Output
Bij een succesvolle G-aanvraag retourneert de API een 200 OK en een JSON-object met de resultaten
Voorbeeld volledige output
Het postcodeformaat was onjuist (bijv. "12345")
Last updated