Target Rent API

Returns the competing target rent price, demand rent price, market situation based on rooms for apartmen rent for the provided address and sociodemographichs data of the region.

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

Supported media types

  • JSON(Accept: application/json)

Note:

  • A complete address is necessary to retrieve any information otherwise an error message will be returned.
  • If the API doesn't provide data or incomplete data it is because of no available data points in the recent time period.
  • data refreshing frequency is each month

Authorization requirements

  • At least a System Key is required for this operation. See Authentication via Three-legged OAuth for further details.
  • In order to use this API you need to request a permission here

Request

Path Parameters

  • city - The city of the location. This parameters is required.
  • postalcode - The postal coed of the location. This parameter is required.
  • street - The street of the location. This parameter is required.
  • housenumber - The house number of the location. This parameter is required.

Response

The following section includes the HTTP status code, a short description and examples for the response body content of a successful processed request.

Status 200 OK.

The requested operation was successful

Body

The body consists out of:

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.

demend-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.

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

Status 204 Es können keine Daten zur angegebenen Adresse gefunden werden.

no available data for the given address

Status 400 Authorization invalid  OR  no user identifiable  OR  query param is missing