Realestate Specific Parameters

Radius Search

https://rest.immobilienscout24.de/restapi/api/search/v1.0/search/radius

Region Search

https://rest.immobilienscout24.de/restapi/api/search/v1.0/search/region

Example:

https://rest.immobilienscout24.de/restapi/api/search/v1.0/search/region?realestatetype=apartmentbuy&geocodes=1276003001046&newbuilding=true (search for apparmentBuy in Berlin Mitte with attribute "Neubau")


apartmentbuy

Parameter Values Comment
price ##.## - ##.##  
livingspace ##.## - ##.##  
numberofrooms ##.## - ##.##  
equipment builtInKitchen, parking, balcony, garden, lift, guestToilet, cellar, handicappedAccessible, assistedLiving you can use any order of the values. Lift means "passenger lift" in this context.
apartmenttypes apartment, groundfloor, halfbasement, loft, maisonette, other, penthouse, raisedgroundfloor, roofstorey, terracedflat you can use any order of the values
constructionyear #### - ####  
heatingtypes stove, selfcontainedcentral, central you can use any order of the values
rented true, false use you only one of this values; specifies the renting status of the apartment you want to buy. Returns only rented apartments if true, only unrented apartments if false and all apartments, if not given
freeofcourtageonly  true flag parameter. if given in the url, only real estates without courtage will be returned.
newbuilding true flag parameter. if given in the url, only buildings which have been build within the last 3 years will be returned
buildingproject true flag parameter. if given in the url, only buildings which are part of a project will be returned

 

 

apartmentrent

 

Parameter Values Comment
price** ##.## - ##.##  
pricetype** rentpermonth, budgetrent That values specify the meaning of the price parameter. If not specified in URL "rentpermonth" is implied. "budgetrent" is a calculated combination of all given price information which comes with this offer.
livingspace ##.## - ##.##  
numberofrooms ##.## - ##.##  
equipment builtInKitchen, parking, balcony, garden, lift, guestToilet, cellar, handicappedAccessible, assistedLiving you can use any order of the values
apartmenttypes apartment, groundfloor, halfbasement, loft, maisonette, other, penthouse, raisedgroundfloor, roofstorey, terracedflat you can use any order of the values
constructionyear #### - ####  
heatingtypes stove, selfcontainedcentral, central you can use any order of the values
haspromotion true, false use only one of this values. haspromotion means "certificate of eligibility for public housing" ("Wohnungsberechtigungsschein" WBS)
freeofcourtageonly (deprecated) true flag parameter. if given in the url, only real estates without courtage will be returned. From 1st June 2015, this filter is deprecated
newbuilding true flag parameter. if given in the url, only buildings which have been build within the last 3 years will be returned

 

assistedliving

 

Parameter Values Comment
additionalservices petsallowed, trialliving  
equipment balcony, cookingpossibility, garden, handicappedaccessible, ownfurnishing, parking  
medicalservices ambulantnursingservice  
pricetype buy, rent  

 

compulsoryauction

 

Parameter Values Comment
marketvalue ##.## - ##.##  
auctionobjecttypes freeholdflat, familyhouse, businessandyield, lot, garageandother comma seperated list of values
auctiontypes recurrenceappointment, splittingauction comma seperated list of values

 

flatshareroom

 

Parameter Values Comment
equipment cooker, dishwasher, fridge, handicappedaccessible, internet, oven, petsallowed you can use any order of the values
flatsharesize 2, 3, 4, 5, 6, 7, 8, 9, 10, greaterthenten one of these values
freeofcourtageonly (deprecated) true flag parameter. if given in the url, only real estates without courtage will be returned From 1st June 2015, this filter is deprecated
furniture true, false one of these values
gender female, male one of these values
price ##.## - ##.## monthly net rent range
livingspace ##.## - ##.## living space range
smokingallowed allowed, ownroomonly, unwanted one of these values
startrentaldate YYYY-MM-DD an ISO 8601 date
rentalduration ### integer number of months. Values from 1-100

 

garagebuy

 

Parameter Values Comment
price ##.## - ##.##
garagetypes garage, streetparking comma seperated list of values
freeofcourtageonly true flag parameter. if given in the url, only real estates without courtage will be returned

 

garagerent

 

Parameter Values Comment
price ##.## - ##.##  
garagetypes garage, streetparking comma seperated list of values
freeofcourtageonly true flag parameter. if given in the url, only real estates without courtage will be returned

 

gastronomy

 

Parameter Values Comment
gastronomytypes guestshouse, clubdisco, barlounge, cafe, hotelresidence, tavern, hotelgarni, hotel, restaurant, pension, bungalow comma separated list of values
equipment cellar  
totalfloorspace ###.### - ###.### range: double values; for the meaning of the totalfloorspace refer to the Area entry in the glossary
numberofbeds ### - ### range: integer values
numberofseats ### - ### range: integer values
price* ##.## - ##.##  
pricetype* lease, buy That values specify the meaning of the price parameter. If not specified in URL no filtering will be applied. So every result for every price type will be returned.
freeofcourtageonly true flag parameter. if given in the url, only real estates without courtage will be returned

 

housebuy

 

Parameter Values Comment
price ##.## - ##.##  
livingspace ##.## - ##.##  
ground ##.## - ##.##  
numberofrooms ##.## - ##.##  
equipment parking, guesttoilet, cellar, handicappedaccessible, lodgerflat you can use any order of the values
buildingtypes singlefamilyhouse, midterracehouse, endterracehouse, multifamilyhouse, bungalow, farmhouse, semidetachedhouse, villa, castlemanorhouse, specialrealestate, otherrealestate, terracehouse(only terracehouse DEPRECATED as it is covered by midterracehouse and endterracehouse) you can use any order of the values
constructionyear #### - ####  
heatingtypes stove, selfcontainedcentral, central you can use any order of the values
constructionphasetypes projected, underconstruction, completed, noinformation you can use any order of the values
rented true, false use you only one of this values; specifies the renting status of the house you want to buy
freeofcourtageonly true flag parameter. if given in the url, only real estates without courtage will be returned
newbuilding true flag parameter. if given in the url, only buildings which have been build within the last 3 years will be returned
buildingproject true flag parameter. if given in the url, only buildings which are part of a project will be returned

 

houserent

 

Parameter Values Comment
price** ##.## - ##.##  
pricetype** rentpermonth, budgetrent That values specify the meaning of the price parameter. If not specified in URL "rentpermonth" is implied. "budgetrent" is a calculated combination of all given price information which comes with this offer.
livingspace ##.## - ##.##  
ground ##.## - ##.##  
numberofrooms ##.## - ##.##  
equipment parking, guesttoilet, cellar, handicappedaccessible, builtinkitchen you can use any order of the values
buildingtypes singlefamilyhouse, midterracehouse, endterracehouse, multifamilyhouse, bungalow, farmhouse, semidetachedhouse, villa, castlemanorhouse, specialrealestate, otherrealestate, terracehouse(only terracehouse DEPRECATED as it is covered by midterracehouse and endterracehouse) you can use any order of the values
constructionyear #### - ####  
heatingtypes stove, selfcontainedcentral, central you can use any order of the values
freeofcourtageonly (deprecated) true flag parameter. if given in the url, only real estates without courtage will be returned From 1st June 2015, this filter is deprecated
newbuilding true flag parameter. if given in the url, only buildings which have been build within the last 3 years will be returned

 

housetype

the realestate type "housetype" can only be found using the region search

 

Parameter Values Comment
price ##.## - ##.##  
buildingtypes blockhouse,bungalow, semidetachedhouse,onefamilyhouse, familyhousewithlodgerflat,tudorhouse, woodenhouse,countryhouse, apartmentbuilding,nondetachedhouse, cityvilla, villa,semidetachedhousepair comma seperated list of values
livingspace ##.## - ##.##  

 

industry

 

Parameter Values Comment
industrytypes showroomspace,hall,highlackstorage,industryhall, industryhallwithopenarea,coldstorage, multideckcabinetstorage, storagewithopenarea,storagearea,storagehall, servicearea,shippingstorage,repairshop comma separated list of values
equipment lift,autolift,cranerunway,ramp. "Lift" means "goods lift" in this context.
totalfloorspace ###.### - ###.### range: double values; for the meaning of the totalfloorspace refer to the Area entry in the glossary
netfloorspace ###.### - ###.### range: double values; for the meaning of the netfloorspace refer to the Area entry in the glossary
price* ##.## - ##.##  
pricetype* rentpersqm, rentpermonth, buy That values specify the meaning of the price parameter. If not specified in URL no filtering will be applied. So every result for every price type will be returned.
freeofcourtageonly true flag parameter. if given in the url, only real estates without courtage will be returned

 

investment

 

Parameter Values Comment
price ##.## - ##.## range: double values
netfloorspace ###.## - ###.## range: double values
pricepersqm ##.## - ##.## range: double values
pricemultiplier ##.## - ##.## range: double values; it is the result of price / annual net cold rent
investmenttypes singlefamilyhouse, multifamilyhouse,freeholdflat,shoppingcentre, restaurant,hotel,leisurefacility, commercialunit,officebuilding, commercialbuilding,commercialproperty, hallstorage,industrialproperty, shopsalesfloor,servicecentre, other,supermarket,livingbusinesshouse, housingestate comma separated list of values
freeofcourtageonly true flag parameter. if given in the url, only real estates without courtage will be returned

 

livingbuysite

 

Parameter Values Comment
price ##.## - ##.##  
pricetype buy, longlease That values specify the meaning of the price parameter. If not specified in URL no filtering will be applied. So every result for every price type will be returned. note: if you search pricetype "longlease", you get the marketingtype "leasehold" as response
plotarea ###.### - ###.###  
shorttermconstructible true flag parameter. if given in the url, only sites that are short term constructible will be returned
buildingpermission true flag parameter. if given in the url, only sites that have a building permission will be returned
siteconstructibletypes externalarea, constructionplan, neighbourconstruction you can use any order of the values
sitedevelopmenttypes developed, developedpartially, notdeveloped you can use any order of the values
freeofcourtageonly true flag parameter. if given in the url, only real estates without courtage will be returned

 

livingrentsite

 

Parameter Values Comment
price ##.## - ##.##  
pricetype rent, lease That values specify the meaning of the price parameter. If not specified in URL no filtering will be applied. So every result for every price type will be returned.
plotarea ###.### - ###.###  
shorttermconstructible true flag parameter. if given in the url, only sites that are short term constructible will be returned
buildingpermission true flag parameter. if given in the url, only sites that have a building permission will be returned
siteconstructibletypes externalarea, constructionplan, neighbourconstruction you can use any order of the values
sitedevelopmenttypes developed, developedpartially, notdeveloped you can use any order of the values
freeofcourtageonly true flag parameter. if given in the url, only real estates without courtage will be returned

 

office

 

Parameter Values Comment
equipment highvoltage, airconditioning, lancables, handicappedaccessible you can use any order and any subset of the values
numberofparkingspaces ## - ## range: integer values
netfloorspace ###.### - ###.### range: double values; for the meaning of the netfloorspace refer to the Area entry in the glossary
officetypes loft, studio, office, officefloor, officebuilding, officecentre, officestoragebuilding, surgery, surgeryfloor, surgerybuilding, commercialcentre, livingandcommercialbuilding, officeandcommercialbuilding comma separated list of values
price* ##.## - ##.##  
     
freeofcourtageonly true flag parameter. if given in the url, only real estates without courtage will be returned
rentduration weekly, monthly, yearly, longterm comma separated list of values. Searches for shortterm or longterm rental contracts.

 

seniorcare

 

Parameter Values Comment
additionalservices petsallowed  
equipment balcony  
roomtype singlebedroom, sharedroom you can use any order of the values
caretype stationary, day, shortterm, respite you can use any order of the values
seniorcarelevel level1, level2, level3 you can use any order of the values
careof dementia, artificialrespiration, comavigil, stroke, parkinson, alzheimer, multiplesclerosis you can use any order of the values

 

shorttermaccommodation

 

Parameter Values Comment
shorttermaccommodationtype flat,house,room either one of these values
startrentaldate YYYY-MM-DD an ISO 8601 date
price ##.## - ##.## range: double values
equipment cellar,guesttoilet,parking comma seperated list of values
nonsmoker true, false  
furniture true, false  
freeduration number  
freeinterval month,week,day either one of these values

minnumberofpersons

replaced with:numberofrooms

number


number

deprecated
---------------

 

freeofcourtageonly (deprecated) true flag parameter. if given in the url, only real estates without courtage will be returned From 1st June 2015, this filter is deprecated

 

specialpurpose

 

Parameter Values Comment
specialpurposetypes residence,farm,horsefarm,vineyard,repairshop, leisurefacility,industrialarea,specialestate,commercialcentre comma separated list of values
equipment cellar
totalfloorspace ###.### - ###.### range: double values; for the meaning of the totalfloorspace refer to the Area entry in the glossary
price* ##.## - ##.##  
pricetype* rentpersqm, rentpermonth, buy That values specify the meaning of the price parameter. If not specified in URL no filtering will be applied. So every result for every price type will be returned.
freeofcourtageonly true flag parameter. if given in the url, only real estates without courtage will be returned

 

store

 

Parameter Values Comment
storetypes showroomspace,shoppingcentre,factoryoutlet,departmentstore, kiosk,store,selfservicemarket,salesarea,saleshall comma separated list of values
equipment cellar
totalfloorspace ###.### - ###.### range: double values; for the meaning of the totalfloorspace refer to the Area entry in the glossary
netfloorspace ###.### - ###.### range: double values; for the meaning of the netfloorspace refer to the Area entry in the glossary
price* ##.## - ##.##  
pricetype* rentpersqm, rentpermonth, buy That values specify the meaning of the price parameter. If not specified in URL no filtering will be applied. So every result for every price type will be returned.
locationclassification a, b, shoppingcentre comma separated list of values.
freeofcourtageonly true flag parameter. if given in the url, only real estates without courtage will be returned

 

tradesite

 

Parameter Values Comment
price* ##.## - ##.##  
pricetype* rent, buy, lease, longlease an unordered list of these values; if a price is given, only one value may be given here. note: if you search pricetype "longlease", you get the marketingtype "leasehold" as response
utilizationtradesites leisure, agricultureforestry, trade comma separated list of values
plotarea ###.### - ###.### range: double values
shorttermconstructible true flag parameter. if given in the url, only sites that are short term constructible will be returned
buildingpermission true flag parameter. if given in the url, only sites that have a building permission will be returned
siteconstructibletypes externalarea, constructionplan, neighbourconstruction comma separated list of values
sitedevelopmenttypes developed, developedpartially, notdeveloped comma seperated list of values
freeofcourtageonly true flag parameter. if given in the url, only real estates without courtage will be returned

 

 

Supplementary Notes

[*] If the request contains a parameter "price", then "pricetype" must be specified. With the "pricetype" parameter, commercial real estate indirectly hands out information on CommerzialisationType (Rent or Buy). The parameter "pricetype" can be used "solo" without price - but not vice versa.

For "price" ranges you may omit start or end value, like "12000-" or "-20000".

 

[**] ApartmentRent and HouseRent may use "pricetype" to search for "budgetrent". "pricetype" is optional and defaults to "rentpermonth" if omitted.