Get Started




The following flyer shows the official IS24 naming of the areas of commercial properties( click to enlarge):

Areas, Office



Note that in the search all REST parameters are lowercased.


Attachment refers to a multimedia object that is attached to an real estate object (e. g. a picture or floorplan of an real estate object) or a shortlist entry. German: Anhang, Multimediaobjekt (MMO)

To retrieve or upload an attachment using the RESTful API, we suggest to use a binary encoding format as representation (e. g. multipart).

Supported attachment types: Image/Picture, Document (PDF), Video, Streaming Video. Images/Pictures and PDF documents can be used to provide a floorplan (Grundriss).

PENDING: first/title picture, description

User attachments This kind of attachment is related to user created content (e. g pictures taken with a mobile phone and stored with an user's shortlist entry).


Budget Rent

Budget Rent is the ammount of money which has to be payed periodically to the owner of the real estate. This may be the plain net rent, the net rent plus service charges or the net rent plus service charges plus heating costs. When searching for "budgetrent", the price will contain the best guess of a sum of rent, service charges and heating costs. It will also contain a marker, which information was available to do this guess. A result list has to conain a visual information depending on this marker to let the user distinguish the different types of data which lead to the sum in price.

The budget rent will be delivered in the calculated price element of the result list. These are the possible "rentScope" facets:


only net rent information is available


net rent plus service charges without heating costs are available


net rent, service charges and heating costs are available, but the given information is inconsistent. E.g the renter can't charge one for heating costs when the heating is a kind of individual heating like oven or individual gas heating.


net rent plus service charges plus heating costs. There is no information in the data, that let us assume, that more charges have to be payed.

Example Results for Budget Rent



An internal unique identifier to identify an element in a geohierarchy. The following categories of geohierarchy elements are supported: continent, country, region, city, district. For example, the geocode of the continent Europe is 1, the geocode of the country Germany is 276. An qualified geocode consist of the id 1 (for Europe) and the id 276 (for Germany): "1276" (as an encoded representation).

A valid geocode id could be: /geocode/continent/1/country/276/region/.../city/.../quarter/...

  • /geocode: the root resource
  • /continent/1: a path parameter representing the continent in the geocode hierarchy
  • /country/276: a path parameter representing the country within a continent in the geocode hierarchy
  • /region/...: a path parameter representing the region (e.g. federal state) within a country in the geocode hierarchy
  • /city/...: a path parameter representing an city within a region in the geocode hierarchy
  • /quarter/...: a path parameter representing a district within a city in the geocode hierarchy

It is suggested to use id's where ever a name is not unique. You can use sub resources instead of path parameters, if required.



Imprint (German Impressum) contains the information that the realtor is bound by the law to uncover to his customers


Real Estate Type

The following real estate types are supported on our platform:


  • Not all of these real estate types might be supported by all services.
  • If these real estate types are used as query parameters in the search context they have to be lowercased without '_', e.g. apartmentbuy instead of APARTMENT_BUY, see the Search Query Parameters Page for further details.


in output/schemas 
numerical value in resultlistEntries    as URL parameter value   
APARTMENT_BUY (Wohnung zum Kauf) 2 apartmentbuy
APARTMENT_RENT (Mietwohnung) 0 apartmentrent
ASSISTED_LIVING (Betreutes Wohnen) 20 assistedliving
COMPULSORY_AUCTION (Zwangsversteigerung) 13 compulsoryauction
FLAT_SHARE_ROOM (WG-Zimmer) 19 flatshareroom
GARAGE_BUY (Garage zum Kauf) 17 garagebuy
GARAGE_RENT (Garage zur Miete) 18 garagerent
GASTRONOMY (Gastronomie und Hotel) 9 gastronomy
HOUSE_BUY (Haus zum Kauf) 3 housebuy
HOUSE_RENT (Haus zur Miete) 1 houserent
HOUSE_TYPE (Typenhaus) 6 housetype
INDUSTRY (Halle und Produktion) 10 industry
INVESTMENT (Anlageimmobilie) 12 investment
LIVING_BUY_SITE (Wohngrundstück zum Kauf) 14 livingbuysite
LIVING_RENT_SITE (Wohngrundstück zur Miete) 15 livingrentsite
OFFICE (Büro und Praxis) 7 office
SENIOR_CARE (Altenpflege) 21 seniorcare
SHORT_TERM_ACCOMMODATION (Wohnen auf Zeit) 4 shorttermaccommodation
SPECIAL_PURPOSE (Spezialgewerbe) 11 specialpurpose
STORE (Einzelhandel) 8 store
TRADE_SITE (Gewerbegrundstück) 16 tradesite


A realtor (e. g. a real estate agent) offers real estate objects. German: Anbieter


Saved Search

A saved search is a persited search query (gespeichertes Gesuch). A saved search can have a name and specific search criteria of the search query. A customer with the role searcher can load and re-execute the query, he can modify specific search criteria or he can delete the saved search.

Scout ID

Scout ID refers to the ID of an real estate object. Note: The Scout ID is the Immobilien Scout 24 specific object number, not the foreign or custom object number of the customer.

Sometimes the term Scout ID it can refer to an internal customer number.


A customer with the role "searcher" (seeker, Nachfrager). A customer is getting this role if he has a saved search (a persisted search query) or if he has an entry in his shortlist. Even a realtor can have this role.


A customer with the role searcher can save real estate objects and additional information (visitation date, address of the real estate, own pictures) in his shortlist.

Alias names: memo, leaflet, Merkzettel



The acronym TUK means The URI is the King. It's one approach to provide additional information the select a representation of a resource instead of using standard HTTP headers. It's important not to mix both approaches.