Tutorials, SDKs and Plugins

Region Complete

In diesem Tutorial zeigen wir dir wie du Regionen mit der Autovervollständigung erhälst.


In this tutorial we give you an insight to this resource. The complete documentation you can find here.

Get regions with autocomplete

  • Methode: GET

Request-URL:

http://rest.immobilienscout24.de/restapi/api/search/v1.0/region?realsEstateType={realEstateType}&q={q}


Example

Path Parameters

  • none


Query Parameters

  • realEstateType - the real estate type for what you are searching for
  • q - the Query for what you are searching for, minimum 2 characters

 

The listing from german regions that start with the searched sign {q} which geo coordinates and number of available real estate objects with a certain real estate type (realEstateType) is accesible with the resource "region" with query parameter "realEstateType" and "q". "realEstateType" is not mandatory, if it is not given, you automatically search for appartment rents. Consequently the complete URI looks like the following: 

http://rest.immobilienscout24.de/restapi/api/search/v1.0/region?realEstateType=HOUSE_RENT&q=Köl

 


XML

it's a get request: you don't have to send anything in the body.

 

 

 

Result:

 

 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<region:regions xmlns:region="http://rest.immobilienscout24.de/schema/search/region/1.0">

<region>

<name>Köln</name>

<geoCodeId>1276010028</geoCodeId>

<amount>2708</amount>

</region>

<region>

<name>Köln-Dellbrück</name>

<geoCodeId>1276010028017</geoCodeId>

<amount>71</amount>

</region>

<region>

<name>Köln-Nippes</name>

<geoCodeId>1276010028077</geoCodeId>

<amount>71</amount>

</region>

...

</region:regions>

 

 

 


JSON

it's a get request: you don't have to send anything in the body.

 

 

 

 

 

Result:

 

 

{

"region.regions": [{

"region": [{

"name":"Köln",

"geoCodeId":1276010028,

"amount":2708

},

{

"name":"Köln-Dellbrück",

"geoCodeId":1276010028017,

"amount":71

},

{

"name":"Köln-Nippes",

"geoCodeId":1276010028077,

"amount":71

},

{

...

}]

}]

}