Price History

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"
}