Skip to content

Statistic

Returns a list of resources identified by the following URL. A list of geo hierarchy elements. These contain the number of published real estates in the specified region and its direct subregions. For each real estate type the number is shown separateley. This list can be narrowed further by specifying real estate types, channel, customer number, and username.

GET /search/v1.0/statistic?geocode={geocode}&realestatetypes={realestatetypes}&customernumber={customernumber}&username={username}&channel={channel}

Supported media types:
JSON

Request

Query parameters

PARAMETER DESCRIPTION MANDATORY
geocode One GeoCodeId (same as in Region Search in encoded form like 1276009039 for the region "Stade (Kreis)". Only GeoCodeIds are valid for which subregions exist in is24's GIS yes
realestatetypes The real estate types for the request no
customernumber Filter real estates by the publishing customer using her Immobilien Scout customer number no
username Filter real estates by the publishing customer using his Immobilien Scout login user name no
channel Filter real estates by channel (is24, hp or group-id) where it is published no

Response

XML:

GET https://rest.immobilienscout24.de/restapi/api/search/v1.0/statistic?geocode=1276004008&realestatetypes=specialpurpose,housebuy

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<common:geoHierarchyElementsStatistic xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:gis="http://rest.immobilienscout24.de/schema/platform/gis/1.0" xmlns:common="http://rest.immobilienscout24.de/schema/common/1.0">
    <parent xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="common:City">
        <name>Märkisch-Oderland (Kreis)</name>
        <geoCodeId>1276004008</geoCodeId>
        <statistics>
            <GeoHierarchyStatistic realEstateType="SPECIAL_PURPOSE" count="147"/>
            <GeoHierarchyStatistic realEstateType="HOUSE_BUY" count="4671"/>
        </statistics>
    </parent>
    <children>
        <geoHierarchyElement xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="common:Quarter">
            <name>Alt Tucheband</name>
            <geoCodeId>1276004008002</geoCodeId>
            <statistics>
                <GeoHierarchyStatistic realEstateType="SPECIAL_PURPOSE" count="0"/>
                <GeoHierarchyStatistic realEstateType="HOUSE_BUY" count="6"/>
            </statistics>
        </geoHierarchyElement>
        <geoHierarchyElement xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="common:Quarter">
            <name>Neuhardenberg</name>
            <geoCodeId>1276004008003</geoCodeId>
            <statistics>
                <GeoHierarchyStatistic realEstateType="SPECIAL_PURPOSE" count="0"/>
                <GeoHierarchyStatistic realEstateType="HOUSE_BUY" count="4"/>
            </statistics>
        </geoHierarchyElement>
        [...some more geoHierarchyElements...]
   </children>
</common:geoHierarchyElementsStatistic>

JSON:

GET https://rest.immobilienscout24.de/restapi/api/search/v1.0/statistic?geocode=1276004008&realestatetypes=specialpurpose,housebuy

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
{
  "common.geoHierarchyElementsStatistic":{
    "parent":{
      "@xsi.type":"common:City",
      "name":"Märkisch-Oderland (Kreis)",
      "geoCodeId":1276004008,
      "statistics":{
        "GeoHierarchyStatistic":[
          {
            "@realEstateType":"SPECIAL_PURPOSE",
            "@count":"147"
          },
          {
            "@realEstateType":"HOUSE_BUY",
            "@count":"4673"
          }
        ]
      }

    },
    "children":{
      "geoHierarchyElement":[
        {
          "@xsi.type":"common:Quarter",
          "name":"Alt Tucheband",
          "geoCodeId":1276004008002,
          "statistics":{
            "GeoHierarchyStatistic":[
              {
                "@realEstateType":"SPECIAL_PURPOSE",
                "@count":"0"
              },
              {
                "@realEstateType":"HOUSE_BUY",
                "@count":"6"
              }
            ]
          }

        },
        {
          "@xsi.type":"common:Quarter",
          "name":"Neuhardenberg",
          "geoCodeId":1276004008003,
          "statistics":{
            "GeoHierarchyStatistic":[
              {
                "@realEstateType":"SPECIAL_PURPOSE",
                "@count":"0"
              },
              {
                "@realEstateType":"HOUSE_BUY",
                "@count":"4"
              }
            ]
          }

        },
       [...some more geoHierarchyElements...]
      ]
    }
  }
}