Reference Price (Deprecated)
We set some of our market analytics and valuation APIs to deprecated, because we stopped development there (exception: Target Rent API). However, their current stable state will be maintained until further notice. There’s no change needed from your side when you have access to the data.
Please be aware that due to this changed status of the concerned APIs, we won’t hand out new access rights.
reference-price represents a reference price for the given location. A location is represented by WGS84-coordinates (latitude and longitude). The result represents the reference prices for the neighbourhood and the quarter. Creating or modifying reference prices is not supported by the API.
This is version 3.0 of the API. See docs for the previous discontinued version here.
- latitude - the latitude of the point you wish to use for the request (WGS84 coordinate - required)
- longitude - the longitude of the point you wish to use for the request (WGS84 coordinate - required)
Query String Parameters
||number||Only for houses: area of the site (plot) in square meters. Minimum valid value is 0.|
||true||To make sure that new building prices are received although construction year is older than this year.|
||number||The size of the living area in square meters. If no
|17||semi detached house|
|18||single family house|
|24||single family house|
|119||special real estate|
|122||single family house (detached)|
|123||mid terrace house|
|124||end terrace house|
|127||raised ground floor|
||integer number||The year of construction of a real estate. This parameter is used to determine the age class of a real estate. The construction year must be a 4 digit number smaller or equals the current year and greater or equal than 0 (optional). If no constructionYear is given, portfolio real estate will be assumed.|
200 - OK
|averagePriceTotal||Average total price in EUR of comparison real estates|
|averagePricePerSqm||Average price in EUR per square meter of living area of comparison real estates|
|lowerSimpleStd||Price in EUR (houses) or EUR/sqm of living area (apartments) one standard deviation lower than the average|
|higherSimpleStd||Price in EUR (houses) or EUR/sqm of living area (apartments) one standard deviation higher than the average|
|lowerTwiceStd||Price in EUR (houses) or EUR/sqm of living area (apartments) two standard deviations lower than the average|
|higherTwiceStd||Price in EUR (houses) or EUR/sqm of living area (apartments) two standard deviations higher than the average|
|livingAreaAvg||Average living area of comparison real estates|
|siteAreaAvg||Average site area of comparison real estates (for houses only)|
|comparisonCount||Number of real estates used for comparison|
|radiusM||Distance to the furthest comparison real estate|
radiusM: Reference Price API looks for up to 500 comparison real estates in the radius up to 10km.
lower/higher Simple/Twice Std: standard deviation is calculated in log-space due to distribution of the prices of real estates.
lowerSimpleStd are considered cheap.
higherTwiceStd are considered expensive.
1 2 3 4 5 6 7 8 9 10 11
Notable changes from the previous version
twiceStd- removed to avoid confusion as standard deviation is calculated in log space
districtName- v3.0 is not aware of geo-hierarchy and uses only WGS84-coordinates
newBuilding- v3.0 has a single model for both new and old apartments and while building age is featured in the model, there is no significant distinction between old and new buildings
radiusM- radius of the search for comparison real estates in meters. The model looks for the nearest 500 comparable object in the radius up to 10km. In case
comparisonCountis less than 500,
radiusMis likely to be 10000.
204 - NO CONTENT
Reference price could not be calculated due to too few comparison real estates or other reason (indicated in response).