Target Rent

This endpoint returns the competing target rent price, demand rent price, and market situation based on the number of rooms of a rental apartment, the given address and the regional sociodemographics.

Supported media types:
JSON

GET https://rest.immobilienscout24.de/restapi/api/targetrent/v1.0/?city={city_name}&street={street_name}&postcode={postcode_number}&housenumber={house_number}

Things you need to know

  • At least a System Key is required for this operation. See Authentication via Two-legged OAuth for further details.
  • If the endpoint doesn't provide data or returns incomplete data, it is because of no available data points in the recent period for the given address.
  • Please keep in mind that the data is refreshed once a month.

Request

Path Parameters

The complete address is necessary to retrieve any information, otherwise an error message will be returned. The following path parameters are mandatory.

Parameter Description
city* The city of the location.
postalcode* The postal coed of the location.
street* The street of the location.
housenumber* The house number of the location.

Response

Body Description

JSON Array name Description
supply-data Rent apartments cold rent prices, that have been online in the last 3 months grouped by room size in a specific radius around the given params.
demand-data Demanded prices for the rent apartments that have been online in the last 3 months grouped by room size in a specific radius around the given params.
demographic-data Describes the social demographic situation of the last year on a district community level.
market-data Describes the rental demand on a postal code level for different room sized flats in comparison to the German market situation.
factor Is the factor in percentage for additional value for a sophisticated interior quality.
objects Are the relevant objects that where used for the supply data with object relevant information and the active time in days with min and max dates.

JSON

   "supply-data":[
      {
         "id":"c1cf3a770929efd8d97afc0ea821f3e7",
         "radius":500,
         "_1_room_sqm_rent":14.87,
         "_1_room_number":18,
         "_2_room_sqm_rent":15.07,
         "_2_room_number":44,
         "_3_room_sqm_rent":13.99,
         "_3_room_number":34,
         "_4_room_sqm_rent":14.24,
         "_4_room_number":19,
         "_5_room_sqm_rent":13.88,
         "_5_room_number":4
      }
   ],
   "demand-data":[
      {
         "room_group":"1",
         "median_demand_price":12.51,
         "avg_demand_price":12.31
      },
      {
         "room_group":"2",
         "median_demand_price":11.26,
         "avg_demand_price":11.59
      },
      {
         "room_group":"3",
         "median_demand_price":12.0,
         "avg_demand_price":11.73
      },
      {
         "room_group":"4",
         "median_demand_price":11.99,
         "avg_demand_price":12.87
      },
      {
         "room_group":"5+",
         "median_demand_price":10.0,
         "avg_demand_price":10.0
      }
   ],
   "demographic-data":[
      {
         "population":126764,
         "percent__15_29_years":0.208,
         "percent__30_44_years":0.352,
         "percent__45_59_years":0.188,
         "percent__60_64_years":0.031,
         "household_number":78287,
         "percent__one_person_households":0.0,
         "percent__two_person_households":0.0,
         "percent__multi_person_households":0.0,
         "percent__not_classified_households":0.0,
         "purchasing_power_per_inhabitant":21050,
         "percent__households_with_monthly_net_income_from_0_1000_euro":0.0,
         "percent__households_with_monthly_net_income_from_1000_1500_euro":0.032,
         "percent__households_with_monthly_net_income_from_1500_2500_euro":0.307,
         "percent__households_with_monthly_net_income_from_2500_3500_euro":0.311,
         "percent__households_with_monthly_net_income_from_3500_5000_euro":0.223,
         "percent__households_with_monthly_net_income_from_5000_euro":0.127
      }
   ],
   "market-data":[
      {
         "room_group":"1",
         "market_situation":"starker Angebotsmarkt"
      },
      {
         "room_group":"2",
         "market_situation":"starker Angebotsmarkt"
      },
      {
         "room_group":"3",
         "market_situation":"starker Angebotsmarkt"
      },
      {
         "room_group":"4",
         "market_situation":"ausgewogener Markt"
      },
      {
         "room_group":"5+",
         "market_situation":"Angebotsmarkt"
      }
   ],
   "factor":[
      {
         "floor":16.0
      }
   ],
   "objects":[
      {
         "object_id":"092db11c4e0da03862ed7e559838b99a",
         "state":"Berlin",
         "district":"None",
         "postal_code":"10247",
         "street":"Andreasstraße",
         "house_number":"37",
         "condition":"NO INFORMATION",
         "interior_quality":"NO_INFORMATION",
         "construction_year":2019,
         "last_refurbishment":"None",
         "living_space":103.86,
         "floor":"None",
         "number_of_floors":"None",
         "base_rent":1479.93,
         "service_costs":207.71,
         "total_rent":1787.7,
         "heating_costs":"none",
         "has_elevator":true,
         "has_balcony":false,
         "has_kitchen":false,
         "has_garden":false,
         "has_cellar":false,
         "has_parking":false,
         "heating_type":"none",
         "efficiency_class":"",
         "efficiency_value":"None",
         "number_of_rooms":4.0,
         "min_date":"2019-07-20",
         "max_date":"2019-07-31",
         "duration_in_days":11
      },
      {
         "object_id":"95719fcb8c890a107e3cbad24498274c",
         "state":"Berlin",
         "district":"None",
         "postal_code":"10247",
         "street":"Andreasstraße",
         "house_number":"37",
         "condition":"NO INFORMATION",
         "interior_quality":"NO_INFORMATION",
         "construction_year":2019,
         "last_refurbishment":"none",
         "living_space":110.81,
         "floor":"None",
         "number_of_floors":"none",
         "base_rent":1523.64,
         "service_costs":221.62,
         "total_rent":1851.83,
         "heating_costs":"none",
         "has_elevator":true,
         "has_balcony":false,
         "has_kitchen":false,
         "has_garden":false,
         "has_cellar":false,
         "has_parking":true,
         "heating_type":"none",
         "efficiency_class":"",
         "efficiency_value":"none",
         "number_of_rooms":4.0,
         "min_date":"2019-05-17",
         "max_date":"2019-06-19",
         "duration_in_days":33
      }
   ]
}

HTTP Status Codes

HTTP Code Description
200 OK. The requested operation was successful .
204 de - Es können keine Daten zur angegebenen Adresse gefunden werden.
en - There is no data available for the given address.
400 Authorization invalid OR no user identifiable OR query param is missing