Price History (Deprecated)

Information

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.

The GET method of this resource retrieves the pricetrend for one realestateType for the given location. The location is specified with the path parameters. This call is idempotent.

with path parameters cityId:

GET /marketdata/v1.0/pricehistory/region/{regionId}/city/{cityId}?realEstateType={realEstateType}&ageClass={ageClass}&startDate={startDate}

with path parameters cityId + districtId:

GET /marketdata/v1.0/pricehistory/region/{regionId}/city/{cityId}/district/{districtId}?realEstateType={realEstateType}&ageClass={ageClass}&startDate={startDate}

with path parameters cityId + districtId + nhoodId:

GET /marketdata/v1.0/pricehistory/region/{regionId}/city/{cityId}/district/{districtId}/nhood/{nhoodId}?realEstateType={realEstateType}&ageClass={ageClass}&startDate={startDate}

Supported media types:

XML

JSON

Request

Path parameters

For the request with IS24 GeoHierarchy:

PARAMETER	VALUE
regionId	id of a federal state of the IS24-Geo-Hierarchy
cityId	id of a city of the IS24-Geo-Hierarchy
districtId	id of a district of the IS24-Geo-Hierarchy

For the request with WGS84 coordinates:

PARAMETER	VALUE
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 parameters

PARAMETER	VALUE	DESCRIPTION
realEstateType	0	APARTMENT_RENT
	1	HOUSE_RENT
	2	APARTMENT_BUY
	3	HOUSE_BUY
siteArea	minimum valid value is 0	only for houses. the size of the siteArea as integer.
firstTimeUse	If no firstTimeUse is given, portfolio real estate will be assumed	to make sure that new building prices are received although construction year is older than this year
livingArea	minimum valid value is 0,	the size of the livingArea. If no livingArea is available the service assumes 100 sqm
price	minimum valid value is 1	the price of the real estate in EUR. For realEstateType APARTMENT_* the price is per sqm and for HOUSE_* is the price is the total price
objectCategory	0	no information
	3	roof storey
	7	maisonette
	15	bungalow
	17	semi detached house
	18	single family house
	20	country house
	24	villa
	25	terrace house
	27	wooden house
	38	freehold flat
	40	terraced flat
	117	ground floor
	118	apartment
	119	special real estate
	122	single family house (detached)
	123	mid terrace house
	124	end terrace house
	126	apartment (other)
	127	raised ground floor
	128	half basement

Response

Possible statuses

Query parameters

STATUS	DESCRIPTION
200	OK
204	No Content. No comparison real estates where found. The real estate price is greater than higherTwiceStd or lower than lowerTwiceStd. --> Please display message: Für diese Berechnung liegen zu wenige Angebotspreise vor
400	Bad Request. Input Parameter validation failed (including invalid objectCategory) or geoCoding failed. --> No QuickCheck info should be displayed at all, i.e. no place holder
500	Internal Server Error. An internal Server error has occurred

XML:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<pricetrend:offeringPriceTrendResponse xmlns:priceindex="http://rest.immobilienscout24.de/schema/priceIndex/2.0" xmlns:pricetrend="http://rest.immobilienscout24.de/schema/offeringPriceTrend/2.0" xmlns:valuation="http://rest.immobilienscout24.de/schema/valuation/2.0" xmlns:cockpit="http://rest.immobilienscout24.de/schema/cockpit/2.0" xmlns:ns6="http://rest.immobilienscout24.de/schema/productpermission/1.0" xmlns:referenceprice="http://rest.immobilienscout24.de/schema/referencePrice/2.0" xmlns:ns8="http://rest.immobilienscout24.de/schema/customer/2.0" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:demographic="http://rest.immobilienscout24.de/schema/demographic/2.0">
    <avgOfferingPrice>
        <quarterOfYear>20091</quarterOfYear>
        <avgPrice>8.30</avgPrice>
    </avgOfferingPrice>
    <avgOfferingPrice>
        <quarterOfYear>20092</quarterOfYear>
        <avgPrice>8.50</avgPrice>
    </avgOfferingPrice>
    <avgOfferingPrice>
        <quarterOfYear>20093</quarterOfYear>
        <avgPrice>8.40</avgPrice>
    </avgOfferingPrice>
    <avgOfferingPrice>
        <quarterOfYear>20094</quarterOfYear>
        <avgPrice>8.20</avgPrice>
    </avgOfferingPrice>
    <avgOfferingPrice>
        <quarterOfYear>20101</quarterOfYear>
        <avgPrice>9.10</avgPrice>
    </avgOfferingPrice>
    <avgOfferingPrice>
        <quarterOfYear>20102</quarterOfYear>
        <avgPrice>10.00</avgPrice>
    </avgOfferingPrice>
    <avgOfferingPrice>
        <quarterOfYear>20103</quarterOfYear>
        <avgPrice>9.80</avgPrice>
    </avgOfferingPrice>
    <avgOfferingPrice>
        <quarterOfYear>20104</quarterOfYear>
        <avgPrice>10.10</avgPrice>
    </avgOfferingPrice>
    <avgOfferingPrice>
        <quarterOfYear>20111</quarterOfYear>
        <avgPrice>9.50</avgPrice>
    </avgOfferingPrice>
    <avgOfferingPrice>
        <quarterOfYear>20112</quarterOfYear>
        <avgPrice>9.70</avgPrice>
    </avgOfferingPrice>
    <avgOfferingPrice>
        <quarterOfYear>20113</quarterOfYear>
        <avgPrice>9.40</avgPrice>
    </avgOfferingPrice>
    <avgOfferingPrice>
        <quarterOfYear>20114</quarterOfYear>
        <avgPrice>9.90</avgPrice>
    </avgOfferingPrice>
<percentualChange>-1.9800</percentualChange>
</pricetrend:offeringPriceTrendResponse>

JSON:

{
"avgOfferingPrice":[
    {"quarterOfYear":20081,"avgPrice":6.24},
    {"quarterOfYear":20082,"avgPrice":6.22},
    {"quarterOfYear":20083,"avgPrice":6.27},
    {"quarterOfYear":20084,"avgPrice":6.38},
    {"quarterOfYear":20091,"avgPrice":6.50},
    {"quarterOfYear":20092,"avgPrice":6.49},
    {"quarterOfYear":20093,"avgPrice":6.60},
    {"quarterOfYear":20094,"avgPrice":6.77},
    {"quarterOfYear":20101,"avgPrice":6.90},
    {"quarterOfYear":20102,"avgPrice":6.97},
    {"quarterOfYear":20103,"avgPrice":7.03},
    {"quarterOfYear":20104,"avgPrice":7.23}],
"percentualChange":"15.7800"
}