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.

https://rest.immobilienscout24.de/restapi/api/search/v1.0/statistic?geocode={geocode}&realestatetypes={realestatetypes}&customernumber={customernumber}&username={username}&channel={channel}

Supported media types

  • XML (Accept: application/xml)
  • JSON (Accept: application/json)

Authorization requirements

  • At least a System Key is required for this operation. See Authentication via Two-legged OAuth for further details.

Request

Path Parameters

  • none

Query Parameters

  • geocode - Required. 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.

Valid examples for Germany: 1 (Continent) or 1276 (Country) or 1276009 (Region) or 1276009039 (City).

Invalid example: Quarter 1276009039002 "Ahlerstedt", because it has no GIS-subregions. (In rural areas in Germany a GIS-City is a Landkreis and a GIS-Quarter is a Kleinstadt.)

  • realestatetypes - Optional. The real estate types for the request. This parameter is optional, the standard     value is all real estate types.
  • customernumber - Optional. Filter real estates by the publishing customer using her Immobilien Scout             customer number.
  • username - Optional. Filter real estates by the publishing customer using his Immobilien Scout login     user name.
  • channel - Optional. Filter real estates by channel (is24, hp or group-id) where it is published. See         Search_by_Channels.

Response

The following section includes the HTTP status code, a short description and examples for the response body content of a successful processed request.
Error responses as well as other simple message responses are described in detail within the common message responses.

  • Status 200 OK - The requested operation was successful.

Header

No special headers.

Body

XML

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

<?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

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