GeoMap logo
API docs by Redocly

GeoMap Public API - listing (1.4.0)

E-mail: kontakt@geomap.immo

Introduction

Documentation of the GeoMap API.

Changelog

API version 1.4.0

  • Offer Extended Detail: fix missing property level measureSizes in features.measurements

API version 1.3.0

  • constructionStatus: enum Angehalten renamed to InKlaerung
  • salesStatus added to Offer Extended Detail response
  • constructionStatus added to Offers request
  • salesStatus added to Offers request

API version 1.2.0

  • regionIds added to Offers request

API version 1.1.0

  • objectSubtypes added to Offers request

API version 1.0.0

  • first release

Listing

Real estate listings

Offers

Get IDs for offers in Austria, Germany and Switzerland by

  • location and surrounding area
  • postcode area(s)
  • administrative region(s)

The offers can optionally be filtered by e.g. date, category, price and so on.

The IDs can be used to request detailed information for each offer. Offer IDs are not stable over time!

A maximum number of offers defined by the size parameter is returned per query. The next offers can be retrieved by specifying a lastPageId until all totalResults offers have been transferred.

Authorizations:
BearerAuth
Request Body schema: application/json
One of
required
object

Geolocation defined by latitude and longitude

radiusInKm
number <double> ( 0 .. 50 ]
Default: 10

Radius in kilometer around the coordinate

airConditioningVentilation
boolean

Property is equipped with air conditioning and / or ventilation

balconyTerrace
boolean

Balcony and / or terrace available

barrierFree
boolean

Property is barrier-free

bathroomWithWindow
boolean

Bathroom with window

builtInKitchen
boolean

Built-in kitchen

cellar
boolean

Building has a cellar

constructionStatus
Array of strings
Items Enum: "Abgebrochen" "FertiggestelltBestand" "Idee" "ImBauInSanierung" "InKlaerung" "InPlanung" "Unbekannt"

Construction status of the property

  • Abgebrochen - Canceled
  • FertiggestelltBestand - Finished / existing
  • Idee - Idea
  • ImBauInSanierung - In Construction
  • InKlaerung - In clarification
  • InPlanung - Planned
  • Unbekannt - Unknown
object

Range for year of construction defined by from or to or both

developments
Array of strings
Items Enum: "erschlossen" "teilerschlossen" "unerschlossen"

State of property development

divisible
boolean

Useable space is divisible

elevator
boolean

Property is equipped with an elevator

object

Range of energy consumption in kWh/sqm*a defined by from or to or both

energyEfficiencyStandards
Array of strings
Items Enum: "KfwEffizienzhausDenkmal" "KfwEffizienzhaus115" "KfwEffizienzhaus100" "KfwEffizienzhaus85" "KfwEffizienzhaus70" "KfwEffizienzhaus60" "KfwEffizienzhaus55" "KfwEffizienzhaus40" "KfwEffizienzhaus40Plus" "Passivhaus" "Nullenergiehaus" "Plusenergiehaus"

Energy efficiency standard according to Germany’s Reconstruction Loan Corporation (KfW)

energyRatings
Array of strings (energyRatingLabel)
Items Enum: "A3Plus" "A2Plus" "APlus" "A" "B" "C" "D" "E" "F" "G" "H"

Energy efficiency rating

energySources
Array of strings
Items Enum: "Erdgas" "Erdwaerme" "Fernwaerme" "Fluessiggas" "Gas" "Holz" "Kohle" "Luftwaerme" "Nahwaerme" "Oel" "Pellets" "Solar" "Strom" "Wasserwaerme" "Alternativ"

Primary energy source for heating

fireplace
boolean

Property has a fireplace

object

Date range at which the offers were first seen online defined by from or to or both

firstTimeUse
boolean

First time use after refurbishment or new construction

freeOfCommission
boolean

Buying / renting is commission-free

furnished
boolean

Property is furnished

garden
boolean

A garden belongs to the property

guestToilet
boolean

Property is equipped with a guest toilet

heatingTypes
Array of strings
Items Enum: "Blockheizkraftwerk" "Etagenheizung" "Fernheizung" "Fussbodenheizung" "Kachelofen" "Kamin" "Nachtspeicher" "Ofenheizung" "Solarheizung" "Waermepumpe" "Zentralheizung"

Primary heating system

leased
boolean

Property is currently leased

modelHouseAdvertisement
boolean

Property is a model / show house or advertisement

object

Range for number of rooms defined by from or to or both

objectCategories
Array of strings
Items Enum: "Gewerbe" "Wohnen"

Object category of the offers (residential, commercial)

objectClasses
Array of strings
Items Enum: "BüroPraxis" "Einzelhandel" "Ferienobjekt" "Gastronomie" "Gewerbeeinheit" "Grundstueck" "HalleLagerProduktion" "Haus" "Hotel" "LandForst" "Microapartements" "Parkhaus" "PflegeAlter" "Sonstige" "StellplatzGarage" "Studenten" "Wohnung"

Object class of the offers (houses, ...)

objectTypes
Array of strings
Items Enum: "Altersheim" "Bauernhof" "Cafe" "Coworking" "Dachgeschosswohnung" "EinZweiFamilienhaus" "Erdgeschosswohnung" "Etagenwohnung" "Gaststaette" "Ladenlokal" "LoftStudio" "Maisonettenwohnung" "Mehrfamilienhaus" "Pension" "Penthouse" "Pflegeheim" "ReitanlageGestuet" "Restaurant" "Sonstige" "SonstigeWohnungen" "Terrassenhaus" "Terrassenwohnung" "WarenKaufhaus" "Werkstatt"

Object type of the offers (multifamilyhouses, ...)

objectSubtypes
Array of strings
Items Enum: "Einfamilienhaus" "Doppelhaushaelfte" "Zweifamilienhaus" "Reihenhaus" "ReiheneckEndhaus" "Reihenmittelhaus"

Object subtype of the offers (e.g. rowhouse as a subtype of object type EinZweiFamilienhaus, ...)

offerTypes
Array of strings
Items Enum: "Kauf" "Miete"

Type of the offers (purchase or rent)

object

Date range at which the offers were online available defined by from or to or both

parkingSpace
boolean

A parking lot belongs to the property

preservationOrder
boolean

Property is under a preservation order

priceChange
boolean

Price has changed since first publication

priceChangeDirection
string
Enum: "HOCH" "RUNTER"

Direction of price changes HOCH means higher price, RUNTER means property becomes cheaper. Only applicable if priceChange == true

priceChangeSince
string <date>

Price changes since the given date. Only applicable if priceChange == true. If no date is provided the current date will be assumed

object

Range of price per square meter in local currency defined by from or to or both

object

Range of price in local currency defined by from or to or both

object

Range of property space in m² defined by from or to or both

object

Range of reconstruction year defined by from or to or both

refurbished
boolean

Property is refurbished

salesStatus
Array of strings
Items Enum: "ImVerkauf" "Unbekannt" "Verkauft" "VorVerkauf"

Status of sales progress

  • ImVerkauf - On Sale
  • Unbekannt - Unknown
  • Verkauft - Sold
  • VorVerkauf - Not yet offered
searchString
string

Search for the given text within the offer descriptions, title, street name, city name, vendor name and vendor company name. Several search words are combined using OR

underfloorHeating
boolean

Underfloor heating is available

object

Range of useable space in m² defined by from or to or both

vendorIsCommercial
boolean

Vendor is an estate agent

object

Range of yield / cap rate in percent defined by from or to or both

lastPageId
string

Pagination ID to request the next results

size
integer <int32> [ 1 .. 1000 ]
Default: 1000

Number of results per response

sortField
string
Enum: "DATUM" "NUTZFLAECHE" "PREIS" "PREISAENDERUNG" "PREISPROQM" "RENDITE" "ZIMMER"

Attribute by which sorting is done. Must be specified together with sortOrder

sortOrder
string
Enum: "AUF" "AB"

Sorting order. Must be specified together with sortField

Responses

Request samples

Content type
application/json
Example
{
  • "coordinate": {
    },
  • "radiusInKm": 1.5,
  • "airConditioningVentilation": true,
  • "balconyTerrace": true,
  • "barrierFree": true,
  • "bathroomWithWindow": true,
  • "builtInKitchen": true,
  • "cellar": true,
  • "constructionStatus": [
    ],
  • "constructionYearRange": {
    },
  • "developments": [
    ],
  • "divisible": true,
  • "elevator": true,
  • "energyConsumptionRange": {
    },
  • "energyEfficiencyStandards": [
    ],
  • "energyRatings": [
    ],
  • "energySources": [
    ],
  • "fireplace": true,
  • "firstSeenDateRange": {
    },
  • "firstTimeUse": true,
  • "freeOfCommission": true,
  • "furnished": true,
  • "garden": true,
  • "guestToilet": true,
  • "heatingTypes": [
    ],
  • "leased": true,
  • "modelHouseAdvertisement": true,
  • "numberOfRoomsRange": {
    },
  • "objectCategories": [
    ],
  • "objectClasses": [
    ],
  • "objectTypes": [
    ],
  • "objectSubtypes": [
    ],
  • "offerTypes": [
    ],
  • "onlineDateRange": {
    },
  • "parkingSpace": true,
  • "preservationOrder": true,
  • "priceChange": true,
  • "priceChangeDirection": "HOCH",
  • "priceChangeSince": "2019-08-24",
  • "pricePerSqmRange": {
    },
  • "priceRange": {
    },
  • "propertySpaceRange": {
    },
  • "reconstructionYearRange": {
    },
  • "refurbished": true,
  • "salesStatus": [
    ],
  • "searchString": "string",
  • "underfloorHeating": true,
  • "usableSpaceRange": {
    },
  • "vendorIsCommercial": true,
  • "yieldRange": {
    },
  • "lastPageId": "WyJERV9HRVdfMkJhRXlzSzFjTnJiUS1Jc3dGUkVsMG50M0dnXzF2Il0=",
  • "size": 1000,
  • "sortField": "DATUM",
  • "sortOrder": "AUF"
}

Response samples

Content type
application/json
{
  • "lastPageId": "WyJERV9HRVdfMkJhRXlzSzFjTnJiUS1Jc3dGUkVsMG50M0dnXzF2Il0=",
  • "size": 1000,
  • "totalResults": 300,
  • "offerIds": [
    ]
}

Offer Detail

This endpoint provides details, i.e. characteristics of an offer requested via ID.

Only characteristics available for the offer are output.

Authorizations:
BearerAuth
path Parameters
offerId
required
string <byte>
Examples: REVfR0VXX1ZxSkVrbEJBNGpVcjBYUkRUcXVGRFB2S0wzd182dw== REVfR0VXXy0wN3ByLXN2WTkxTUZlY0d1V0tpV0FJY0REc185ZA== REVfR0VXXy0ydTAyc0tyZ3FDWWlBT3JjbjRGREFmVC1NRV8yZg== REVfR0VXXy05cGRnUFA4YlJYSm0xSFZJQWcteXdEZmxGUV85cg== REVfR0VXXy1JNUxfd1pkN0VhWmx2QVJCZHpSSTJQNThzRV85cg==

Offer ID for which to request detailed information

Responses

Response samples

Content type
application/json
{
  • "id": "string",
  • "address": {
    },
  • "features": {
    },
  • "firstSeenDate": "2019-08-24T14:15:22Z",
  • "lastSeenDate": "2019-08-24T14:15:22Z",
  • "objectCategory": "Gewerbe",
  • "objectClass": "BüroPraxis",
  • "objectType": "Altersheim",
  • "offerType": "Kauf",
  • "portalUrl": "http://www.immobilienscout24.de/expose/88406133",
  • "price": 0.1,
  • "pricePerSqm": 0.1,
  • "title": "Exklusives Wohnen im Süden",
  • "usableSpace": 0.1,
  • "vendor": {
    },
  • "years": {
    }
}

Offer Extended Detail

This endpoint provides extended details, i.e. characteristics of an offer requested via ID.

Only characteristics available for the offer are output.

Authorizations:
BearerAuth
path Parameters
offerId
required
string <byte>
Examples: REVfR0VXXzhFUG92TjZnZkRGdmFYaTZLeTN3dUEyNU5Sc185dQ== REVfR0VXX1ZxSkVrbEJBNGpVcjBYUkRUcXVGRFB2S0wzd182dw== REVfR0VXXy0wN3ByLXN2WTkxTUZlY0d1V0tpV0FJY0REc185ZA== REVfR0VXXy0ydTAyc0tyZ3FDWWlBT3JjbjRGREFmVC1NRV8yZg== REVfR0VXXy05cGRnUFA4YlJYSm0xSFZJQWcteXdEZmxGUV85cg== REVfR0VXXy1JNUxfd1pkN0VhWmx2QVJCZHpSSTJQNThzRV85cg==

Offer ID for which to request detailed information

Responses

Response samples

Content type
application/json
{
  • "additionalSources": [],
  • "address": {
    },
  • "constructionStatus": "Abgebrochen",
  • "daysOnline": 53,
  • "descriptions": {
    },
  • "energy": {
    },
  • "features": {
    },
  • "foreclosure": {
    },
  • "id": "123-abc",
  • "media": [],
  • "objectTypeText": "Reihenmittelhaus",
  • "online": true,
  • "onlineRanges": [
    ],
  • "priceChanges": [
    ],
  • "prices": {
    },
  • "spaces": {
    },
  • "vendor": {
    },
  • "years": {
    },
  • "yield": {
    }
}