Skip to content

Real Estate Listings APIs

The Import/Export API is the most used and most powerful API in our assortment. You can create, change, delete, and publish real estate objects. Furthermore, you can view analytics around your published real estate and attach an on top placement to the real estate.

In order to increase the visibility of your listings within our search results on www.ImmobilienScout24.de and increase the number of seeker leads, we ask you to make sure that you provide us with the correct geocodes. See our Geo Services APIs.

We've created a few exemplary real estate types to help you quickly try out some requests, xml files or json files

For more detailed information on the data types, please view our XSD files.

General

  • contact person, multimedia attachments and publishing an object are not part of the real estate data, these are separate endpoints:
    • CONTACT ADDRESS: create/change/call/delete contact data
    • ATTACHMENT: create/change/call/delete multimedia attachments (pictures, videos, PDFs, URLs)
    • PUBLISHCHANNEL: List of the publish channels, the realtor is entitled to publish in.
  • The element "assistedLiving" will be ignored. This concerns appartmentRent, appartmentBuy, houseRent. There is an extra estate type "AssistedLiving".
  • Please Note: We don't support GMT params in date fields! If you send us such a date field we ignore the whole field completely!

Real Estate Types

Please find here a list of all our supported real estate types and their attributes for the resource realestate.

Wohnung (apartment)

Wohnung Miete (apartmentRent)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen?* showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Wohnungskategorie apartmentType enum ROOF_STOREY (Dachgeschoss), LOFT (Loft), MAISONETTE (Maisonette), PENTHOUSE (Penthouse), TERRACED_FLAT (Terrassenwohnung), GROUND_FLOOR (Erdgeschosswohnung), APARTMENT (Etagenwohnung), RAISED_GROUND_FLOOR (Hochparterre), HALF_BASEMENT (Souterrain), OTHER (Sonstige), NO_INFORMATION (Keine Angabe)
Etage floor int 1 - 999
Aufzug lift boolean true, false
Keller cellar enum YES, NOT_APPLICABLE (keine Angabe)
Barrierefrei handicappedAccessible enum YES, NOT_APPLICABLE (keine Angabe)
Parkflächenanzahl numberOfParkingSpaces String 0 - 99999
Objektzustand condition enum NO_INFORMATION (keine Angabe), FIRST_TIME_USE (Erstbezug), FIRST_TIME_USE_AFTER_REFURBISHMENT (Erstbezug nach Sanierung), MINT_CONDITION (Neuwertig), REFURBISHED (Saniert), MODERNIZED (Modernisiert), FULLY_RENOVATED (VollstaendigReonviert), WELL_KEPT (Gepflegt), NEED_OF_RENOVATION (Renovierungsbedürftig), NEGOTIABLE (NachVereinbarung), RIPE_FOR_DEMOLITION (Abbruchreif)
Letzte Modernisierung lastRefurbishment String 1000 - 9999
Qualität der Ausstattung interiorQuality enum NO_INFORMANTION (keine Angabe), LUXURY (luxus), SOPHISTICATED (gehoben), NORMAL, SIMPLE (einfach)
Baujahr constructionYear String 4 Stellen, 0 - 9999
Frei ab freeFrom String Max. 50 characters
Heizungsart heatingType enum NO_INFORMATION (keine Angabe), SELF_CONTAINED_CENTRAL_HEATING (Etagenheizung), STOVE_HEATING (Ofenheizung), CENTRAL_HEATING (Zentralheizung) For using the new enum fields: COMBINED_HEAT_AND_POWER_PLANT (Blockheizkraftwerk), ELECTRIC_HEATING (Elektro-Heizung),DISTRICT_HEATING (Fernwärme),FLOOR_HEATING (Fußbodenheizung), GAS_HEATING (Gas-Heizung), WOOD_PELLET_HEATING (Holz-Pelletheizung), NIGHT_STORAGE_HEATER (Nachtspeicherofen), OIL_HEATING (Öl-Heizung), SOLAR_HEATING (Solar-Heizung), HEAT_PUMP (Wärmepumpe) you'll need the query param "usenewenergysourceenev2014values=true"
Befeuerungsarten firingType enum NO_INFORMANTION (keine Angabe), GEOTHERMAL (Erdwärme), SOLAR_HEATING (Solarheizung), \PELLET_HEATING (Pelletheizung), GAS, OIL (Öl), DISTRICT_HEATING (Fernwärme), ELECTRICITY (Strom), COAL (Kohle)
Energieausweistyp BuildingEnergyRatingType enum NO_INFORMATION (Keine Angabe), ENERGY_REQUIRED (Endenergiebedarf), ENERGY_CONSUMPTION (Energieverbrauchskennwert). Wählen sie den Ausweistyp aus, zu dem Sie einen Kennwert angeben möchten. Ein Energieausweis wird in Endenergiebedarf (bedarfsorientierter Ausweis) und Energieverbrauchskennwert (verbrauchsorientierter Ausweis) unterschieden. Der bedarfsorientierte Energieausweis orientiert sich am errechneten Bedarf des Gebäudes. Der verbrauchsorientierte Ausweis am tatsächlichen Verbrauch der Nutzer. Bitte beachten Sie bei der Angabe des Energieverbrauchskennwert, ob der Warmwasserverbrauch mit eingerechnet ist.
Etagenzahl numberOfFloors int 0 - 999
Nutzfläche usableFloorSpace double 0 - 99999999,99
Anzahl Schlafzimmer numberOfBedRooms double 0-99
Anzahl Badezimmer numberOfBathRooms double 0-99
Gäste-WC guestToilet enum YES, NOT_APPLICABLE (keine Angabe)
Parkplatz parkingSpaceType enum NO_INFORMATION (keine Angabe), GARAGE (Garage), OUTSIDE (Außenstellplatz), CARPORT (Carport), DUPLEX (Duplex), CAR_PARK (Parkhaus), UNDERGROUND_GARAGE (Tiefgarage)
Kaltmiete* baseRent double 0 - 9999999999999,99
Warmmiete totalRent double 0 - 9999999999999,99
Nebenkosten serviceCharge double 0 - 9999999999999,99
Kaution deposit String max. 50 characters
Heizkosten heatingCosts double 0 - 9999999999999,99
Heizkosten sind in Nebenkosten enthalten. heatingCostsInServiceCharge enum NOT_APPLICABLE, YES, NO ("NO" is available from 29.1.2014). If you've entered a value for "heating costs", than NOT_APPLICABLE is not allowed for this attribute.
Haustiere petsAllowed enum NO_INFORMATION, YES, NO, NEGOTIABLE
StellplatzMiete parkingSpacePrice double 0 - 9999999999999,99
Wohnfläche* livingSpace double 0 - 99999999,99
Zimmerzahl* numberOfRooms double 1-999,99
Einbauküche builtInKitchen boolean true, false
Balkon/Terrasse balcony boolean true, false
WBS-Schein erforderlich certificateOfEligibilityNeeded boolean true, false
Gartenbenutzung garden boolean true, false
Provisionspflichtig* hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag* courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Provisionshinweis courtageNote String Max. 500 characters (will be enhanced on 1.800 characters
Multimedia Anhang "video" - Multimedia files, such as pictures, videos, PDFs, and URLs. are decoupled from this resource. Please add a reference to the multimedia files that you previously added. You can create, read, update, delete multimedia files by using the [attachment](/api-docs/import-export/attachment/overview/) endpoint.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung StatusVBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung StatusIS24 eigener Webservice
Objektveröffentlichung StatusHP eigener Webservice
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Energieausweis energyPerformanceCertificate boolean true, false
ImmobilienScout24-Objektnummer id Bemerkung: optional, da sie automatisch vergeben wird. Wird beim GET ausgegeben

XML schema:

<xs:complexType name="ApartmentRent">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>  
      <!-- Basiselemente -->  
      <xs:element minOccurs="0" name="externalId" type="xs:string"/>
      <xs:element name="title" type="xs:string"/>
      <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
      <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
      <xs:element name="address" type="tns:Wgs84Address"/>
      <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
      <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
      <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
      <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
      <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
      <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
      <xs:element default="false" name="showAddress" type="xs:
      <!-- Immobilientyp spezifische Elemente -->  
      <xs:element minOccurs="0" name="apartmentType" type="ns1:ApartmentType"/>
      <xs:element minOccurs="0" name="floor" type="xs:string"/>
      <xs:element minOccurs="0" name="lift" type="xs:boolean"/>
      <xs:element minOccurs="0" name="cellar" type="ns1:YesNotApplicableType"/>
      <xs:element minOccurs="0" name="handicappedAccessible" type="ns1:YesNotApplicableType"/>
      <xs:element minOccurs="0" name="numberOfParkingSpaces" type="xs:string"/>
      <xs:element minOccurs="0" name="condition" type="ns1:RealEstateCondition"/>
      <xs:element minOccurs="0" name="lastRefurbishment" type="xs:string"/>
      <xs:element minOccurs="0" name="interiorQuality" type="ns1:InteriorQuality"/>
      <xs:element minOccurs="0" name="constructionYear" type="xs:string"/>
      <xs:element minOccurs="0" name="freeFrom" type="xs:string"/>
      <xs:element minOccurs="0" name="heatingType" type="ns1:HeatingType"/>
      <xs:element minOccurs="0" name="firingTypes" type="ns1:FiringTypes"/>
      <xs:element minOccurs="0" name="buildingEnergyRatingType" type="ns1:BuildingEnergyRatingType"/>
      <xs:element minOccurs="0" name="thermalCharacteristic" type="xs:string"/>
      <xs:element minOccurs="0" name="energyConsumptionContainsWarmWater" type="ns1:YesNotApplicableType"/>
      <xs:element minOccurs="0" name="numberOfFloors" type="xs:string"/>
      <xs:element minOccurs="0" name="usableFloorSpace" type="xs:double"/>
      <xs:element minOccurs="0" name="numberOfBedRooms" type="xs:string"/>
      <xs:element minOccurs="0" name="numberOfBathRooms" type="xs:string"/>
      <xs:element minOccurs="0" name="guestToilet" type="ns1:YesNotApplicableType"/>
      <xs:element minOccurs="0" name="parkingSpaceType" type="ns1:ParkingSpaceType"/>
      <xs:element name="baseRent" type="xs:double"/>
      <xs:element minOccurs="0" name="totalRent" type="xs:double"/>
      <xs:element minOccurs="0" name="serviceCharge" type="xs:double"/>
      <xs:element minOccurs="0" name="deposit" type="xs:string"/>
      <xs:element minOccurs="0" name="heatingCosts" type="xs:double"/>
      <xs:element minOccurs="0" name="heatingCostsInServiceCharge" type="ns1:YesNotApplicableType"/>
      <xs:element minOccurs="0" name="petsAllowed" type="ns1:PetsAllowedType"/>
      <xs:element minOccurs="0" name="parkingSpacePrice" type="xs:double"/>
      <xs:element minOccurs="0" name="price" type="ns1:Price"/>
      <xs:element name="livingSpace" type="xs:double"/>
      <xs:element name="numberOfRooms" type="xs:double"/>
      <xs:element minOccurs="0" name="energyPerformanceCertificate" type="xs:boolean"/>
      <xs:element minOccurs="0" name="builtInKitchen" type="xs:boolean"/>
      <xs:element minOccurs="0" name="balcony" type="xs:boolean"/>
      <xs:element minOccurs="0" name="certificateOfEligibilityNeeded" type="xs:boolean"/>
      <xs:element minOccurs="0" name="garden" type="xs:boolean"/>
      <xs:element name="courtage" type="ns1:CourtageInfo"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Wohnung Kauf (apartmentBuy)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Wohnungskategorie apartmentType enum ROOF_STOREY (Dachgeschoss), LOFT (Loft), MAISONETTE (Maisonette), PENTHOUSE (Penthouse), TERRACED_FLAT (Terrassenwohnung), GROUND_FLOOR (Erdgeschosswohnung), APARTMENT (Etagenwohnung), RAISED_GROUND_FLOOR (Hochparterre), HALF_BASEMENT (Souterrain), OTHER (Sonstige), NO_INFORMATION (Keine Angabe)
Etage floor int 1 - 999
Aufzug lift boolean true, false
Keller cellar enum YES, NOT_APPLICABLE (keine Angabe)
Barrierefrei handicappedAccessible enum YES, NOT_APPLICABLE (keine Angabe)
Parkflächenanzahl numberOfParkingSpaces String 0 - 99999
Objektzustand condition enum NO_INFORMATION (keine Angabe), FIRST_TIME_USE (Erstbezug), FIRST_TIME_USE_AFTER_REFURBISHMENT (Erstbezug nach Sanierung), MINT_CONDITION (Neuwertig), REFURBISHED (Saniert), MODERNIZED (Modernisiert), FULLY_RENOVATED (VollstaendigReonviert), WELL_KEPT (Gepflegt), NEED_OF_RENOVATION (Renovierungsbedürftig), NEGOTIABLE (NachVereinbarung), RIPE_FOR_DEMOLITION (Abbruchreif)
Letzte Modernisierung lastRefurbishment String 1000 - 9999
Qualität der Ausstattung interiorQuality enum NO_INFORMANTION (keine Angabe), LUXURY (luxus), SOPHISTICATED (gehoben), NORMAL, SIMPLE (einfach)
Baujahr constructionYear String 4 Stellen, 0 - 9999
Frei ab freeFrom String Max. 50 characters
Heizungsart heatingType enum NO_INFORMATION (keine Angabe), SELF_CONTAINED_CENTRAL_HEATING (Etagenheizung), STOVE_HEATING (Ofenheizung), CENTRAL_HEATING (Zentralheizung) For using the new enum fields: COMBINED_HEAT_AND_POWER_PLANT (Blockheizkraftwerk), ELECTRIC_HEATING (Elektro-Heizung),DISTRICT_HEATING (Fernwärme),FLOOR_HEATING (Fußbodenheizung), GAS_HEATING (Gas-Heizung), WOOD_PELLET_HEATING (Holz-Pelletheizung), NIGHT_STORAGE_HEATER (Nachtspeicherofen), OIL_HEATING (Öl-Heizung), SOLAR_HEATING (Solar-Heizung), HEAT_PUMP (Wärmepumpe) you'll need the query param "usenewenergysourceenev2014values=true"
Befeuerungsarten firingType enum NO_INFORMANTION (keine Angabe), GEOTHERMAL (Erdwärme), SOLAR_HEATING (Solarheizung), \PELLET_HEATING (Pelletheizung), GAS, OIL (Öl), DISTRICT_HEATING (Fernwärme), ELECTRICITY (Strom), COAL (Kohle)
Energieausweistyp BuildingEnergyRatingType enum NO_INFORMATION (Keine Angabe), ENERGY_REQUIRED (Endenergiebedarf), ENERGY_CONSUMPTION (Energieverbrauchskennwert). Wählen sie den Ausweistyp aus, zu dem Sie einen Kennwert angeben möchten. Ein Energieausweis wird in Endenergiebedarf (bedarfsorientierter Ausweis) und Energieverbrauchskennwert (verbrauchsorientierter Ausweis) unterschieden. Der bedarfsorientierte Energieausweis orientiert sich am errechneten Bedarf des Gebäudes. Der verbrauchsorientierte Ausweis am tatsächlichen Verbrauch der Nutzer. Bitte beachten Sie bei der Angabe des Energieverbrauchskennwert, ob der Warmwasserverbrauch mit eingerechnet ist.
Energieverbrauchskennwert thermalCharacteristic double 0-1999,99. Bitte geben Sie den "Kennwert" (Zahlen) der Immobilie nach dem ausgewählten "Energieausweistyp" in kWh/(m²*a) an.
Energieverbrauch enthält Warmwasser energyConsumptionContainsWarmWater enum YES, NOT_APPLICABLE. Bitte setzen Sie diesen Wert nur dann, wenn Ihr angegebener "Kennwert" ein "Energieverbrauchskennwert" ist und dieser den "Energieverbrauch für Warmwasser" enthält.
Etagenzahl numberOfFloors int 0 - 999
Nutzfläche usableFloorSpace double 0 - 99999999,99
Anzahl Schlafzimmer numberOfBedRooms double 0-99
Anzahl Badezimmer numberOfBathRooms double 0-99
Gäste-WC guestToilet enum YES, NOT_APPLICABLE (keine Angabe)
Parkplatz parkingSpaceType enum NO_INFORMATION (keine Angabe), GARAGE (Garage), OUTSIDE (Außenstellplatz), CARPORT (Carport), DUPLEX (Duplex), CAR_PARK (Parkhaus), UNDERGROUND_GARAGE (Tiefgarage)
Vermietet rented enum YES, NOT_APPLICABLE
Mieteinnahmen pro Monat rentalIncome double 0 - 9999999999999,99
Denkmalschutzobjekt listed enum YES, NOT_APPLICABLE
Stellplatz Kaufpreis parkingSpacePrice double 0 - 9999999999999,99
Als Ferienwohnung geeignet summerResidencePractical enum YES, NOT_APPLICABLE
Kaufpreis* value double 0 - 9999999999999,99
Währung* currency enum EUR
Wohnfläche* livingSpace double 0 - 99999999,99
Zimmerzahl* numberOfRooms double 1-999,99
Einbauküche builtInKitchen boolean true, false
Balkon balcony boolean true, false
WBS-Schein erforderlich certificateOfEligibilityNeeded boolean true, false
Garten garden boolean true, false
Provisionspflichtig* hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag* courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Provisionshinweis courtageNote String Max. 500 characters (will be enhanced on 1.800 characters
Multimedia Anhang "video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung VBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung IS24 eigener Webservice
Objektveröffentlichung HP eigener Webservice
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Vermarktungsart marketingType enum PURCHASE
Zahlungsintervall priceIntervalType enum ONE_TIME_CHARGE
Energieausweis energyPerformanceCertificate boolean true, false
Wohngeld serviceCharge double 0 - 9999999999999,99

XML schema: 

<xs:complexType name="ApartmentBuy">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>  
        <!-- Basiselemente -->  
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>  
        <!-- Immobilientyp spezifische Elemente -->  
        <xs:element minOccurs="0" name="apartmentType" type="ns1:ApartmentType"/>
        <xs:element minOccurs="0" name="floor" type="xs:string"/>
        <xs:element minOccurs="0" name="lift" type="xs:boolean"/>
        <xs:element minOccurs="0" name="cellar" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="handicappedAccessible" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="numberOfParkingSpaces" type="xs:string"/>
        <xs:element minOccurs="0" name="condition" type="ns1:RealEstateCondition"/>
        <xs:element minOccurs="0" name="lastRefurbishment" type="xs:string"/>
        <xs:element minOccurs="0" name="interiorQuality" type="ns1:InteriorQuality"/>
        <xs:element minOccurs="0" name="constructionYear" type="xs:string"/>
        <xs:element minOccurs="0" name="freeFrom" type="xs:string"/>
        <xs:element minOccurs="0" name="heatingType" type="ns1:HeatingType"/>
        <xs:element minOccurs="0" name="firingTypes" type="ns1:FiringTypes"/>
        <xs:element minOccurs="0" name="buildingEnergyRatingType" type="ns1:BuildingEnergyRatingType"/>
        <xs:element minOccurs="0" name="thermalCharacteristic" type="xs:string"/>
        <xs:element minOccurs="0" name="energyConsumptionContainsWarmWater" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="numberOfFloors" type="xs:string"/>
        <xs:element minOccurs="0" name="usableFloorSpace" type="xs:double"/>
        <xs:element minOccurs="0" name="numberOfBedRooms" type="xs:string"/>
        <xs:element minOccurs="0" name="numberOfBathRooms" type="xs:string"/>
        <xs:element minOccurs="0" name="guestToilet" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="parkingSpaceType" type="ns1:ParkingSpaceType"/>
        <xs:element minOccurs="0" name="rented" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="rentalIncome" type="xs:double"/>
        <xs:element minOccurs="0" name="listed" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="parkingSpacePrice" type="xs:double"/>
        <xs:element minOccurs="0" name="summerResidencePractical" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="price" type="ns1:Price"/>
        <xs:element name="livingSpace" type="xs:double"/>
        <xs:element name="numberOfRooms" type="xs:double"/>
        <xs:element minOccurs="0" name="energyPerformanceCertificate" type="xs:boolean"/>
        <xs:element minOccurs="0" name="builtInKitchen" type="xs:boolean"/>
        <xs:element minOccurs="0" name="balcony" type="xs:boolean"/>
        <xs:element minOccurs="0" name="certificateOfEligibilityNeeded" type="xs:boolean"/>
        <xs:element minOccurs="0" name="garden" type="xs:boolean"/>
        <xs:element name="courtage" type="ns1:CourtageInfo"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Haus (House)

Haus Miete (houseRent)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Wohnfläche* livingSpace double 0 - 99999999,99
Grundstücksfläche* plotArea double 0 - 99999999,99
Zimmerzahl* numberOfRooms double 1-999,99
Provisionspflichtig* hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag* courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Provisionshinweis courtageNote String Max. 500 characters (will be enhanced on 1.800 characters
Haustyp* buildingType enum NO_INFORMATION (keineAngabe), SINGLE_FAMILY_HOUSE (Einfamilienhaus), MID_TERRACE_HOUSE (Reihenmittelhaus), END_TERRACE_HOUSE (Reiheneckhaus), MULTI_FAMILY_HOUSE (Mehrfamilienhaus), BUNGALOW (Bungalow), FARMHOUSE (Bauernhaus), SEMIDETACHED_HOUSE (Doppelhaushaelfte), VILLA (Villa), CASTLE_MANOR_HOUSE (BurgSchloss), SPECIAL_REAL_ESTATE (BesondereImmobilie), OTHER (Sonstiges)
Keller cellar enum YES, NOT_APPLICABLE (keine Angabe)
Barrierefrei handicappedAccessible enum YES, NOT_APPLICABLE (keine Angabe)
Anzahl Stellplätze numberOfParkingSpaces String 0 - 99999
Objektzustand condition enum NO_INFORMATION (keine Angabe), FIRST_TIME_USE (Erstbezug), FIRST_TIME_USE_AFTER_REFURBISHMENT (Erstbezug nach Sanierung), MINT_CONDITION (Neuwertig), REFURBISHED (Saniert), MODERNIZED (Modernisiert), FULLY_RENOVATED (VollstaendigReonviert), WELL_KEPT (Gepflegt), NEED_OF_RENOVATION (Renovierungsbedürftig), NEGOTIABLE (NachVereinbarung), RIPE_FOR_DEMOLITION (Abbruchreif)
Letzte Modernisierung lastRefurbishment String 1000 - 9999
Qualität der Ausstattung interiorQuality enum NO_INFORMANTION (keine Angabe), LUXURY (luxus), SOPHISTICATED (gehoben), NORMAL, SIMPLE (einfach)
Baujahr constructionYear String 4 Stellen, 0 - 9999
Frei ab freeFrom String Max. 50 characters
Heizungsart heatingType enum NO_INFORMATION (keine Angabe), SELF_CONTAINED_CENTRAL_HEATING (Etagenheizung), STOVE_HEATING (Ofenheizung), CENTRAL_HEATING (Zentralheizung) For using the new enum fields: COMBINED_HEAT_AND_POWER_PLANT (Blockheizkraftwerk), ELECTRIC_HEATING (Elektro-Heizung),DISTRICT_HEATING (Fernwärme),FLOOR_HEATING (Fußbodenheizung), GAS_HEATING (Gas-Heizung), WOOD_PELLET_HEATING (Holz-Pelletheizung), NIGHT_STORAGE_HEATER (Nachtspeicherofen), OIL_HEATING (Öl-Heizung), SOLAR_HEATING (Solar-Heizung), HEAT_PUMP (Wärmepumpe) you'll need the query param "usenewenergysourceenev2014values=true"
Befeuerungsarten firingType enum NO_INFORMANTION (keine Angabe), GEOTHERMAL (Erdwärme), SOLAR_HEATING (Solarheizung), \PELLET_HEATING (Pelletheizung), GAS, OIL (Öl), DISTRICT_HEATING (Fernwärme), ELECTRICITY (Strom), COAL (Kohle)
Energieausweistyp BuildingEnergyRatingType enum NO_INFORMATION (Keine Angabe), ENERGY_REQUIRED (Endenergiebedarf), ENERGY_CONSUMPTION (Energieverbrauchskennwert). Wählen sie den Ausweistyp aus, zu dem Sie einen Kennwert angeben möchten. Ein Energieausweis wird in Endenergiebedarf (bedarfsorientierter Ausweis) und Energieverbrauchskennwert (verbrauchsorientierter Ausweis) unterschieden. Der bedarfsorientierte Energieausweis orientiert sich am errechneten Bedarf des Gebäudes. Der verbrauchsorientierte Ausweis am tatsächlichen Verbrauch der Nutzer. Bitte beachten Sie bei der Angabe des Energieverbrauchskennwert, ob der Warmwasserverbrauch mit eingerechnet ist.
Energieverbrauchskennwert thermalCharacteristic double 0-1999,99. Bitte geben Sie den "Kennwert" (Zahlen) der Immobilie nach dem ausgewählten "Energieausweistyp" in kWh/(m²*a) an.
Energieverbrauch enthält Warmwasser energyConsumptionContainsWarmWater enum YES, NOT_APPLICABLE. Bitte setzen Sie diesen Wert nur dann, wenn Ihr angegebener "Kennwert" ein "Energieverbrauchskennwert" ist und dieser den "Energieverbrauch für Warmwasser" enthält.
Etagenzahl numberOfFloors int 0 - 999
Nutzfläche usableFloorSpace double 0 - 99999999,99
Anzahl Schlafzimmer numberOfBedRooms double 0-99
Anzahl Badezimmer numberOfBathRooms double 0-99
Gäste-WC guestToilet enum YES, NOT_APPLICABLE (keine Angabe)
Parkplatz parkingSpaceType enum NO_INFORMATION (keine Angabe), GARAGE (Garage), OUTSIDE (Außenstellplatz), CARPORT (Carport), DUPLEX (Duplex), CAR_PARK (Parkhaus), UNDERGROUND_GARAGE (Tiefgarage)
Kaltmiete* baseRent double 0 - 9999999999999,99
Warmmiete totalRent double 0 - 9999999999999,99
Nebenkosten serviceCharge double 0 - 9999999999999,99
Kaution deposit String max. 50 characters
Heizkosten heatingCosts double 0 - 9999999999999,99
Heizkosten sind in Nebenkosten enthalten. heatingCostsInServiceCharge enum NOT_APPLICABLE, YES, NO ("NO" is available from 29.1.2014). If you've entered a value for "heating costs", than NOT_APPLICABLE is not allowed for this attribute.
Haustiere petsAllowed enum NO_INFORMATION, YES, NO, NEGOTIABLE
StellplatzMiete parkingSpacePrice double 0 - 9999999999999,99
Einbauküche builtInKitchen boolean true, false
Multimedia Anhang "video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung VBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung IS24 eigener Webservice
Objektveröffentlichung HP eigener Webservice
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Energieausweis energyPerformanceCertificate boolean true, false

XML schema: 

<xs:complexType name="HouseRent">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>  
        <!-- Basiselemente -->  
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>  
        <!-- Immobilientyp spezifische Elemente -->  
        <xs:element minOccurs="0" name="price" type="ns1:Price"/>
        <xs:element name="livingSpace" type="xs:double"/>
        <xs:element name="plotArea" type="xs:double"/>
        <xs:element name="numberOfRooms" type="xs:string"/>
        <xs:element minOccurs="0" name="energyPerformanceCertificate" type="xs:boolean"/>
        <xs:element name="courtage" type="ns1:CourtageInfo"/>
        <xs:element default="NO_INFORMATION" name="buildingType" type="ns1:BuildingType"/>
        <xs:element minOccurs="0" name="cellar" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="handicappedAccessible" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="numberOfParkingSpaces" type="xs:string"/>
        <xs:element minOccurs="0" name="condition" type="ns1:RealEstateCondition"/>
        <xs:element minOccurs="0" name="lastRefurbishment" type="xs:string"/>
        <xs:element minOccurs="0" name="interiorQuality" type="ns1:InteriorQuality"/>
        <xs:element minOccurs="0" name="constructionYear" type="xs:string"/>
        <xs:element minOccurs="0" name="freeFrom" type="xs:string"/>
        <xs:element minOccurs="0" name="heatingType" type="ns1:HeatingType"/>
        <xs:element minOccurs="0" name="firingTypes" type="ns1:FiringTypes"/>
        <xs:element minOccurs="0" name="buildingEnergyRatingType" type="ns1:BuildingEnergyRatingType"/>
        <xs:element minOccurs="0" name="thermalCharacteristic" type="xs:string"/>
        <xs:element minOccurs="0" name="energyConsumptionContainsWarmWater" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="numberOfFloors" type="xs:string"/>
        <xs:element minOccurs="0" name="usableFloorSpace" type="xs:double"/>
        <xs:element minOccurs="0" name="numberOfBedRooms" type="xs:string"/>
        <xs:element minOccurs="0" name="numberOfBathRooms" type="xs:string"/>
        <xs:element minOccurs="0" name="guestToilet" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="parkingSpaceType" type="ns1:ParkingSpaceType"/>
        <xs:element name="baseRent" type="xs:double"/>
        <xs:element minOccurs="0" name="totalRent" type="xs:double"/>
        <xs:element minOccurs="0" name="serviceCharge" type="xs:double"/>
        <xs:element minOccurs="0" name="deposit" type="xs:string"/>
        <xs:element minOccurs="0" name="heatingCosts" type="xs:double"/>
        <xs:element minOccurs="0" name="heatingCostsInServiceCharge" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="petsAllowed" type="ns1:PetsAllowedType"/>
        <xs:element minOccurs="0" name="parkingSpacePrice" type="xs:double"/>
        <xs:element minOccurs="0" name="builtInKitchen" type="xs:boolean"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Haus Kauf (houseBuy)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Mit Einliegerwohnung constructionPhase enum YES, NOT_APPLICABLE
Bauphase lodgerFlat enum PROJECTED (HausInPlanung), UNDER_CONSTRUCTION (HausImBau), COMPLETED (HausFertigGestellt), NO_INFORMATION (keineAngabe)
Haustyp* buildingType enum NO_INFORMATION (keineAngabe), SINGLE_FAMILY_HOUSE (Einfamilienhaus), MID_TERRACE_HOUSE (Reihenmittelhaus), END_TERRACE_HOUSE (Reiheneckhaus), MULTI_FAMILY_HOUSE (Mehrfamilienhaus), BUNGALOW (Bungalow), FARMHOUSE (Bauernhaus), SEMIDETACHED_HOUSE (Doppelhaushaelfte), VILLA (Villa), CASTLE_MANOR_HOUSE (BurgSchloss), SPECIAL_REAL_ESTATE (BesondereImmobilie), OTHER (Sonstiges)
Keller cellar enum YES, NOT_APPLICABLE (keine Angabe)
Barrierefrei handicappedAccessible enum YES, NOT_APPLICABLE (keine Angabe)
Anzahl Stellplätze numberOfParkingSpaces String 0 - 99999
Objektzustand condition enum NO_INFORMATION (keine Angabe), FIRST_TIME_USE (Erstbezug), FIRST_TIME_USE_AFTER_REFURBISHMENT (Erstbezug nach Sanierung), MINT_CONDITION (Neuwertig), REFURBISHED (Saniert), MODERNIZED (Modernisiert), FULLY_RENOVATED (VollstaendigReonviert), WELL_KEPT (Gepflegt), NEED_OF_RENOVATION (Renovierungsbedürftig), NEGOTIABLE (NachVereinbarung), RIPE_FOR_DEMOLITION (Abbruchreif)
Letzte Modernisierung lastRefurbishment String 1000 - 9999
Qualität der Ausstattung interiorQuality enum NO_INFORMANTION (keine Angabe), LUXURY (luxus), SOPHISTICATED (gehoben), NORMAL, SIMPLE (einfach)
Baujahr constructionYear String 4 Stellen, 0 - 9999
Frei ab freeFrom String Max. 50 characters
Heizungsart heatingType enum NO_INFORMATION (keine Angabe), SELF_CONTAINED_CENTRAL_HEATING (Etagenheizung), STOVE_HEATING (Ofenheizung), CENTRAL_HEATING (Zentralheizung) For using the new enum fields: COMBINED_HEAT_AND_POWER_PLANT (Blockheizkraftwerk), ELECTRIC_HEATING (Elektro-Heizung),DISTRICT_HEATING (Fernwärme),FLOOR_HEATING (Fußbodenheizung), GAS_HEATING (Gas-Heizung), WOOD_PELLET_HEATING (Holz-Pelletheizung), NIGHT_STORAGE_HEATER (Nachtspeicherofen), OIL_HEATING (Öl-Heizung), SOLAR_HEATING (Solar-Heizung), HEAT_PUMP (Wärmepumpe) you'll need the query param "usenewenergysourceenev2014values=true"
Befeuerungsarten firingType enum NO_INFORMANTION (keine Angabe), GEOTHERMAL (Erdwärme), SOLAR_HEATING (Solarheizung), \PELLET_HEATING (Pelletheizung), GAS, OIL (Öl), DISTRICT_HEATING (Fernwärme), ELECTRICITY (Strom), COAL (Kohle)
Energieausweistyp BuildingEnergyRatingType enum NO_INFORMATION (Keine Angabe), ENERGY_REQUIRED (Endenergiebedarf), ENERGY_CONSUMPTION (Energieverbrauchskennwert). Wählen sie den Ausweistyp aus, zu dem Sie einen Kennwert angeben möchten. Ein Energieausweis wird in Endenergiebedarf (bedarfsorientierter Ausweis) und Energieverbrauchskennwert (verbrauchsorientierter Ausweis) unterschieden. Der bedarfsorientierte Energieausweis orientiert sich am errechneten Bedarf des Gebäudes. Der verbrauchsorientierte Ausweis am tatsächlichen Verbrauch der Nutzer. Bitte beachten Sie bei der Angabe des Energieverbrauchskennwert, ob der Warmwasserverbrauch mit eingerechnet ist.
Energieverbrauchskennwert thermalCharacteristic double 0-1999,99. Bitte geben Sie den "Kennwert" (Zahlen) der Immobilie nach dem ausgewählten "Energieausweistyp" in kWh/(m²*a) an.
Energieverbrauch enthält Warmwasser energyConsumptionContainsWarmWater enum YES, NOT_APPLICABLE. Bitte setzen Sie diesen Wert nur dann, wenn Ihr angegebener "Kennwert" ein "Energieverbrauchskennwert" ist und dieser den "Energieverbrauch für Warmwasser" enthält.
Etagenzahl numberOfFloors int 0 - 999
Nutzfläche usableFloorSpace double 0 - 99999999,99
Anzahl Schlafzimmer numberOfBedRooms double 0-99
Anzahl Badezimmer numberOfBathRooms double 0-99
Gäste-WC guestToilet enum YES, NOT_APPLICABLE (keine Angabe)
Parkplatz parkingSpaceType enum NO_INFORMATION (keine Angabe), GARAGE (Garage), OUTSIDE (Außenstellplatz), CARPORT (Carport), DUPLEX (Duplex), CAR_PARK (Parkhaus), UNDERGROUND_GARAGE (Tiefgarage)
Vermietet rented enum YES, NOT_APPLICABLE
Mieteinnahmen pro Monat rentalIncome double 0 - 9999999999999,99
Denkmalschutzobjekt listed enum YES, NOT_APPLICABLE
Stellplatz Kaufpreis parkingSpacePrice double 0 - 9999999999999,99
Als Ferienwohnung geeignet summerResidencePractical enum YES, NOT_APPLICABLE
Kaufpreis* value double 0 - 9999999999999,99
Währung* currency enum EUR
Wohnfläche* livingSpace double 0 - 99999999,99
Grundstücksfläche* plotArea double 0 - 99999999,99
Zimmerzahl* numberOfRooms double 1-999,99
Provisionspflichtig* hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag* courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Provisionshinweis courtageNote String Max. 500 characters (will be enhanced on 1.800 characters
Multimedia Anhang "video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung VBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung IS24 eigener Webservice
Objektveröffentlichung HP eigener Webservice
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Vermarktungsart marketingType enum PURCHASE
Zahlungsintervall priceIntervalType enum ONE_TIME_CHARGE
Energieausweis energyPerformanceCertificate boolean true, false

XML schema: 

<xs:complexType name="HouseBuy">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>  
        <!-- Basiselemente -->  
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>  
        <!-- Immobilientyp spezifische Elemente -->
        <xs:element minOccurs="0" name="lodgerFlat" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="constructionPhase" type="ns1:ConstructionPhaseType"/>
        <xs:element default="NO_INFORMATION" name="buildingType" type="ns1:BuildingType"/>
        <xs:element minOccurs="0" name="cellar" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="handicappedAccessible" type="ns1:
        <xs:element minOccurs="0" name="numberOfParkingSpaces" type="xs:string"/>
        <xs:element minOccurs="0" name="condition" type="ns1:RealEstateCondition"/>
        <xs:element minOccurs="0" name="lastRefurbishment" type="xs:string"/>
        <xs:element minOccurs="0" name="interiorQuality" type="ns1:InteriorQuality"/>
        <xs:element minOccurs="0" name="constructionYear" type="xs:string"/>
        <xs:element minOccurs="0" name="freeFrom" type="xs:string"/>
        <xs:element minOccurs="0" name="heatingType" type="ns1:HeatingType"/>
        <xs:element minOccurs="0" name="firingTypes" type="ns1:FiringTypes"/>
        <xs:element minOccurs="0" name="buildingEnergyRatingType" type="ns1:BuildingEnergyRatingType"/>
        <xs:element minOccurs="0" name="thermalCharacteristic" type="xs:string"/>
        <xs:element minOccurs="0" name="energyConsumptionContainsWarmWater" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="numberOfFloors" type="xs:string"/>
        <xs:element minOccurs="0" name="usableFloorSpace" type="xs:double"/>
        <xs:element minOccurs="0" name="numberOfBedRooms" type="xs:string"/>
        <xs:element minOccurs="0" name="numberOfBathRooms" type="xs:string"/>
        <xs:element minOccurs="0" name="guestToilet" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="parkingSpaceType" type="ns1:ParkingSpaceType"/>
        <xs:element minOccurs="0" name="rented" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="rentalIncome" type="xs:double"/>
        <xs:element minOccurs="0" name="listed" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="parkingSpacePrice" type="xs:double"/>
        <xs:element minOccurs="0" name="summerResidencePractical" type="ns1:YesNotApplicableType"/>
        <xs:element name="price" type="ns1:Price"/>
        <xs:element name="livingSpace" type="xs:double"/>
        <xs:element name="plotArea" type="xs:double"/>
        <xs:element name="numberOfRooms" type="xs:string"/>
        <xs:element minOccurs="0" name="energyPerformanceCertificate" type="xs:boolean"/>
        <xs:element name="courtage" type="ns1:CourtageInfo"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Grundstück (Site)

Grundstück Miete (livingRentSite)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Vermarktungsart* commercialization Type enum RENT, LEASE
Empfohlene Nutzungsarten recommended UseTypes enum NO_INFORMATION (KeineAngabe), FUTURE_ DEVELOPMENT_ LAND (Bauerwartungsland), TWINHOUSE (Doppelhaus), SINGLE_ FAMILY_ HOUSE (Einfamilienhaus), GARAGE (Garagen), GARDEN (Garten), NO_ DEVELOPMENT (KeineBebauung), APARTMENT_ BUILDING (Mehrfamilienhaus), ORCHARD (Obstpflanzung), TERRACE_ HOUSE (Reihenhaus), PARKING_ SPACE (Stellplaetze), VILLA (Villa), FORREST (Wald)
Heimfall nach ... Jahren (Pachtdauer) tenancy int 0 - 999
Preis (Miete / Pacht pro Jahr)* value double 0 -9999999999999,99. If "0" is entered, the object will be shown with "Preis auf Anfrage" (price on application) in the result list and expose
Währung* currency enum EUR
Grundstücksfläche* plotArea double 0 - 99999999,99
Teilbar Ab minDivisible double 0 - 99999999,4
Provisionspflichtig* hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag* courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Provisionshinweis courtageNote String Max. 500 characters (will be enhanced on 1.800 characters
Frei ab freeFrom String Max. 50 characters
Kurzfristig bebaubar shortTerm Constructible boolean true, false
Baugenehmigung buildingPermission boolean true, false
Abriss demolition boolean true, false
Erschliessungs- zustand siteDevelopment Type enum DEVELOPED (Erschlossen), DEVELOPED_PARTIALLY (Teilerschlossen), NOT_DEVELOPED (Unerschlossen), NO_INFORMATION (Unbekannt)
Bebaubar nach siteConstructibleType enum CONSTRUCTION PLAN (Bebauung nach Bebauungsplan), NEIGHBOUR CONSTRUCTION (Nachbarbebauung), EXTERNALAREA (Aussengebiet), NO_INFORMATION (Unbekannt)
grz grz double 0 - 9,99
gfz gfz double 0 - 9,99
Multimedia Anhang "video"/td> - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung VBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung IS24 eigener Webservice
Objektveröffentlichung HP eigener Webservice
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Vermarktungsart marketingType enum RENT, LEASE
Zahlungsintervall priceIntervalType enum YEAR
Leaseintervall leaseInterval enum YEAR

XML schema: 

<xs:complexType name="LivingRentSite">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>  
      <!-- Basiselemente -->  
      <xs:element minOccurs="0" name="externalId" type="xs:string"/>
      <xs:element name="title" type="xs:string"/>
      <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
      <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
      <xs:element name="address" type="tns:Wgs84Address"/>
      <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
      <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
      <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
      <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
      <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
      <xs:element default="false" name="showAddress" type="xs:boolean"/>
        <!-- Immobilientyp spezifische Elemente -->  
      <xs:element name="commercializationType" type="ns1:CommercializationType"/>
      <xs:element minOccurs="0" name="recommendedUseTypes" type="ns1:SiteRecommendedUseTypes"/>
      <xs:element minOccurs="0" name="tenancy" type="xs:int"/>
      <xs:element name="price" type="ns1:Price"/>
      <xs:element name="plotArea" type="xs:double"/>
      <xs:element minOccurs="0" name="minDivisible" type="xs:double"/>
      <xs:element name="courtage" type="ns1:CourtageInfo"/>
      <xs:element minOccurs="0" name="freeFrom" type="xs:string"/>
      <xs:element minOccurs="0" default="false" name="shortTermConstructible" type="xs:boolean"/>
      <xs:element minOccurs="0" default="false" name="buildingPermission" type="xs:boolean"/>
      <xs:element minOccurs="0" default="false" name="demolition" type="xs:boolean"/>
      <xs:element minOccurs="0" name="siteDevelopmentType" type="ns1:SiteDevelopmentType"/>
      <xs:element minOccurs="0" name="siteConstructibleType" type="ns1:SiteConstructibleType"/>
      <xs:element minOccurs="0" name="grz" type="xs:double"/>
      <xs:element minOccurs="0" name="gfz" type="xs:double"/>
      <xs:element minOccurs="0" name="leaseInterval" type="ns1:LeaseIntervalType"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Grundstück Kauf (livingBuySite)







description REST-API Field details Value details
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift title String Max. 100 characters
Straße street String Max. 100 characters
Hausnummer houseNumber String Max. 10 characters
PLZ postcode String Max. 5 characters
Ort city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Vermarktungsart commercializationType enum BUY, LEASEHOLD
Empfohlene Nutzungsarten recommendedUseTypes enum NO_INFORMATION (KeineAngabe), FUTURE_DEVELOPMENT_LAND (Bauerwartungsland), TWINHOUSE (Doppelhaus), SINGLE_FAMILY_HOUSE (Einfamilienhaus), GARAGE (Garagen), GARDEN (Garten), NO_DEVELOPMENT (KeineBebauung), APARTMENT_BUILDING (Mehrfamilienhaus), ORCHARD (Obstpflanzung), TERRACE_HOUSE (Reihenhaus), PARKING_SPACE (Stellplaetze), VILLA (Villa), FORREST (Wald)
Heimfall nach... Jahren(Pachtdauer) tenancy int 0 - 999
Preis(Kaufpreis / Erbpacht pro Jahr) value double 0 - 9999999999999,99. If "0" is entered, the object will be shown with "Preis auf Anfrage" (price on application) in the result list and expose
Währung currency enum EUR
Grundstücksfläche plotArea double 0 - 99999999,99
Teilbar Ab minDivisible double 0 - 99999999,4999
Provisionspflichtig Provisionspflichtig hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag* Provision courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Provisionshinweis Provisionshinweis courtageNote String Max. 500 characters (will be enhanced on 1.800 characters
Frei ab FreiAb freeFrom String Max. 50 characters
Kurzfristig bebaubar KurzfristigBebaubar shortTerm Constructible boolean true, false
Baugenehmigung Baugenehmigung Vorhanden buildingPermission boolean true, false
Abriss AbrissErforderlich demolition boolean true, false
Erschliessungs- zustand Erschliessungs zustand siteDevelopment Type enum DEVELOPED (Erschlossen), DEVELOPED_PARTIALLY (Teilerschlossen), NOT_DEVELOPED (Unerschlossen), NO_INFORMATION (Unbekannt)
Bebaubar nach BebaubarNach siteConstructibleType enum CONSTRUCTION PLAN (Bebauung nach Bebauungsplan), NEIGHBOUR CONSTRUCTION (Nachbarbebauung), EXTERNALAREA (Aussengebiet), NO_INFORMATION (Unbekannt)
grz GRZ grz double 0 - 9,99
gfz GFZ gfz double 0 - 9,99
Multimedia Anhang AnhangArt="video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang AnhangArt="bild" - same as video
Objektveröffentlichung StatusVBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung StatusIS24 eigener Webservice
Objektveröffentlichung StatusHP eigener Webservice
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Vermarktungsart marketingType enum PURCHASE
Zahlungsintervall priceIntervalType enum ONE_TIME_CHARGE

XML schema: 

<xs:complexType name="LivingBuySite">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>  
        <!-- Basiselemente -->  
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>
        <!-- Immobilientyp spezifische Elemente -->
        <xs:element name="commercializationType" type="ns1:CommercializationType"/>
        <xs:element minOccurs="0" name="recommendedUseTypes" type="ns1:SiteRecommendedUseTypes"/>
        <xs:element minOccurs="0" name="tenancy" type="xs:int"/>
        <xs:element name="price" type="ns1:Price"/>
        <xs:element name="plotArea" type="xs:double"/>
        <xs:element minOccurs="0" name="minDivisible" type="xs:double"/>
        <xs:element name="courtage" type="ns1:CourtageInfo"/>
        <xs:element minOccurs="0" name="freeFrom" type="xs:string"/>
        <xs:element minOccurs="0" default="false" name="shortTermConstructible" type="xs:boolean"/>
        <xs:element minOccurs="0" default="false" name="buildingPermission" type="xs:boolean"/>
        <xs:element minOccurs="0" default="false" name="demolition" type="xs:boolean"/>
        <xs:element minOccurs="0" name="siteDevelopmentType" type="ns1:SiteDevelopmentType"/>
        <xs:element minOccurs="0" name="siteConstructibleType" type="ns1:SiteConstructibleType"/>
        <xs:element minOccurs="0" name="grz" type="xs:double"/>
        <xs:element minOccurs="0" name="gfz" type="xs:double"/>
        <xs:element minOccurs="0" name="leaseInterval" type="ns1:LeaseIntervalType"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Garage/Stellplatz (Garage)

Garage Miete (garageRent)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Preis* value double 0 - 9999999999999,99
Währung* currency enum EUR
Nutzfläche usableFloorSpace double 0 - 99999999,99
Provisionspflichtig* hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag* courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Provisionshinweis courtageNote String Max. 500 characters (will be enhanced on 1.800 characters
Frei ab freeFrom date jjjj-mm-tt
Frei bis freeUntil date jjjj-mm-tt
Garagentyp* garageType enum NO_INFORMATION (keineAngabe), GARAGE (Garage), STREET_PARKING (Aussenstellplatz), CARPORT (Carport), DUPLEX (Duplex), CAR_PARK (Parkhaus), UNDERGROUND_GARAGE (Tiefgarage)
Baujahr constructionYear string 0 - 9999
Länge lengthGarage double 0 - 99,99
Breite widthGarage double 0 - 99,99
Höhe heightGarage double 0 - 99,99
Objektzustand condition enum NO_INFORMATION (keine Angabe), FIRST_TIME_USE (Erstbezug), FIRST_TIME_USE_AFTER_REFURBISHMENT (Erstbezug nach Sanierung), MINT_CONDITION (Neuwertig), REFURBISHED (Saniert), MODERNIZED (Modernisiert), FULLY_RENOVATED (VollstaendigReonviert), WELL_KEPT (Gepflegt), NEED_OF_RENOVATION (Renovierungsbedürftig), NEGOTIABLE (NachVereinbarung), RIPE_FOR_DEMOLITION (Abbruchreif)
Letzte Modernisierung lastRefurbishment int 0 - 9999
Multimedia Anhang "video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung StatusVBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung StatusIS24 eigener Webservice
Objektveröffentlichung StatusHP eigener Webservice
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0

XML schema:

<xs:complexType name="GarageRent">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>  
        <!-- Basiselemente -->
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>
        <!-- Immobilientyp spezifische Elemente -->
        <xs:element name="price" type="ns1:Price"/>
        <xs:element minOccurs="0" name="usableFloorSpace" type="xs:double"/>
        <xs:element name="courtage" type="ns1:CourtageInfo"/>
        <xs:element minOccurs="0" name="freeFrom" type="xs:date"/>
        <xs:element minOccurs="0" name="freeUntil" type="xs:date"/>
        <xs:element name="garageType" type="ns1:GarageType"/>
        <xs:element minOccurs="0" name="constructionYear" type="xs:string"/>
        <xs:element minOccurs="0" name="lengthGarage" type="xs:double"/>
        <xs:element minOccurs="0" name="widthGarage" type="xs:double"/>
        <xs:element minOccurs="0" name="heightGarage" type="xs:double"/>
        <xs:element minOccurs="0" name="condition" type="ns1:RealEstateCondition"/>
        <xs:element minOccurs="0" name="lastRefurbishment" type="xs:int" />
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Garage Kauf (garageBuy)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Preis* value double 0 - 9999999999999,99
Währung* currency enum EUR
Nutzfläche usableFloorSpace double 0 - 99999999,99
Provisionspflichtig* hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag* courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Provisionshinweis courtageNote String Max. 500 characters (will be enhanced on 1.800 characters
Garagentyp* garageType enum NO_INFORMATION (keineAngabe), GARAGE (Garage), STREET_PARKING (Aussenstellplatz), CARPORT (Carport), DUPLEX (Duplex), CAR_PARK (Parkhaus), UNDERGROUND_GARAGE (Tiefgarage)
Baujahr constructionYear string 0 - 9999
Länge lengthGarage double 0 - 99,99
Breite widthGarage double 0 - 99,99
Höhe heightGarage double 0 - 99,99
Objektzustand condition enum NO_INFORMATION (keine Angabe), FIRST_TIME_USE (Erstbezug), FIRST_TIME_USE_AFTER_REFURBISHMENT (Erstbezug nach Sanierung), MINT_CONDITION (Neuwertig), REFURBISHED (Saniert), MODERNIZED (Modernisiert), FULLY_RENOVATED (VollstaendigReonviert), WELL_KEPT (Gepflegt), NEED_OF_RENOVATION (Renovierungsbedürftig), NEGOTIABLE (NachVereinbarung), RIPE_FOR_DEMOLITION (Abbruchreif)
Letzte Modernisierung lastRefurbishment int 0 - 9999
Multimedia Anhang "video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung VBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung IS24 eigener Webservice
Objektveröffentlichung HP eigener Webservice
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0

XML schema:

<xs:complexType name="GarageBuy">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>  
        <!-- Basiselemente -->  
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>
        <!-- Immobilientyp spezifische Elemente -->  
        <xs:element name="price" type="ns1:Price"/>
        <xs:element minOccurs="0" name="usableFloorSpace" type="xs:double"/>
        <xs:element name="courtage" type="ns1:CourtageInfo"/>
        <xs:element name="garageType" type="ns1:GarageType"/>
        <xs:element minOccurs="0" name="constructionYear" type="xs:string"/>
        <xs:element minOccurs="0" name="lengthGarage" type="xs:double"/>
        <xs:element minOccurs="0" name="widthGarage" type="xs:double"/>
        <xs:element minOccurs="0" name="heightGarage" type="xs:double"/>
        <xs:element minOccurs="0" name="condition" type="ns1:RealEstateCondition"/>
        <xs:element minOccurs="0" name="lastRefurbishment" type="xs:int"/>  
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Gewerbeobjekt (Commercial Real Estate)

Büro/Praxis (office)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Bürotyp* officeType enum LOFT (Loft), STUDIO (Atelier), OFFICE (Buero), OFFICE_FLOOR (BueroEtage), OFFICE_BUILDING (Buerohaus), OFFICE_CENTRE (Buerozentrum), OFFICE_STORAGE_BUILDING (BueroUndLagerGebaeude), SURGERY (Praxis), SURGERY_FLOOR (PraxisEtage), SURGERY_BUILDING (PraxisHaus), COMMERCIAL_CENTRE (GewerbeZentrum), LIVING_AND_COMMERCIAL_BUILDING (WohnUndGeschaeftsgebaeude), OFFICE_AND_COMMERCIAL_BUILDING (BueroUndGeschaeftsgebaeude)
Aufzug lift boolean true, false
Keller cellar enum YES, NOT_APPLICABLE (keine Angabe)
Barrierefrei handicappedAccessible enum YES, NOT_APPLICABLE (keine Angabe)
Bodenbelag flooringType enum NO_INFORMATION (keineAngabe), CONCRETE (Beton), EPOXY_RESIN (Epoxidharz), TILES(Fliesen), PLANKS (Dielen), LAMINATE (Laminat), PARQUET (Parkett), PVC (PVC), CARPET (Teppichboden), ANTISTATIC_FLOOR (TeppichbodenAntistatisch), OFFICE_CARPET (TeppichfliesenStuhlrollenfest), STONE (Stein), CUSTOMIZABLE (NachWunsch), WITHOUT (OhneBodenbelag)
Kaution deposit string Max. 50 characters
Kantine hasCanteen enum YES, NOT_APPLICABLE
Datenverkabelung lanCables enum NO_INFORMATION, YES, NO, BY_APPOINTMENT
Starkstrom highVoltage enum YES, NOT_APPLICABLE
Küche kitchenComplete enum YES, NOT_APPLICABLE
Denkmalschutzobjekt listed enum YES, NOT_APPLICABLE
Klimaanlage airConditioning enum NO_INFORMATION, YES, NO, BY_APPOINTMENT
Fahrzeit zum nächsten Bahnhof distanceToMRS int 0-99
Fahrzeit zur nächsten Autobahn distanceToFM int 0-99
Laufzeit zum Öffentl. Personennahverkehr distanceToPT int 0-99
Fahrzeit zum nächsten Flughafen distanceToAirport int 0 - 99
Objektzustand condition enum NO_INFORMATION (keine Angabe), FIRST_TIME_USE (Erstbezug), FIRST_TIME_USE_AFTER_REFURBISHMENT (Erstbezug nach Sanierung), MINT_CONDITION (Neuwertig), REFURBISHED (Saniert), MODERNIZED (Modernisiert), FULLY_RENOVATED (VollstaendigReonviert), WELL_KEPT (Gepflegt), NEED_OF_RENOVATION (Renovierungsbedürftig), NEGOTIABLE (NachVereinbarung), RIPE_FOR_DEMOLITION (Abbruchreif)
Anzahl Parkplätze numberOfParkingSpaces int 0 - 99999
Preis pro Parkfläche parkingSpacePrice double 0 - 9999999999999,99
Letzte Modernisierung lastRefurbishment String 1000 - 9999
Qualität der Ausstattung interiorQuality enum NO_INFORMANTION (keine Angabe), LUXURY (luxus), SOPHISTICATED (gehoben), NORMAL, SIMPLE (einfach)
Baujahr constructionYear String 4 Stellen, 0 - 9999
Frei ab freeFrom String Max. 50 characters
Heizungsart heatingType enum NO_INFORMATION (keine Angabe), SELF_CONTAINED_CENTRAL_HEATING (Etagenheizung), STOVE_HEATING (Ofenheizung), CENTRAL_HEATING (Zentralheizung) For using the new enum fields: COMBINED_HEAT_AND_POWER_PLANT (Blockheizkraftwerk), ELECTRIC_HEATING (Elektro-Heizung),DISTRICT_HEATING (Fernwärme),FLOOR_HEATING (Fußbodenheizung), GAS_HEATING (Gas-Heizung), WOOD_PELLET_HEATING (Holz-Pelletheizung), NIGHT_STORAGE_HEATER (Nachtspeicherofen), OIL_HEATING (Öl-Heizung), SOLAR_HEATING (Solar-Heizung), HEAT_PUMP (Wärmepumpe) you'll need the query param "usenewenergysourceenev2014values=true"
Befeuerungsarten firingType enum NO_INFORMANTION (keine Angabe), GEOTHERMAL (Erdwärme), SOLAR_HEATING (Solarheizung), \PELLET_HEATING (Pelletheizung), GAS, OIL (Öl), DISTRICT_HEATING (Fernwärme), ELECTRICITY (Strom), COAL (Kohle)
Energieausweistyp BuildingEnergyRatingType enum NO_INFORMATION (Keine Angabe), ENERGY_REQUIRED (Endenergiebedarf), ENERGY_CONSUMPTION (Energieverbrauchskennwert). Wählen sie den Ausweistyp aus, zu dem Sie einen Kennwert angeben möchten. Ein Energieausweis wird in Endenergiebedarf (bedarfsorientierter Ausweis) und Energieverbrauchskennwert (verbrauchsorientierter Ausweis) unterschieden. Der bedarfsorientierte Energieausweis orientiert sich am errechneten Bedarf des Gebäudes. Der verbrauchsorientierte Ausweis am tatsächlichen Verbrauch der Nutzer. Bitte beachten Sie bei der Angabe des Energieverbrauchskennwert, ob der Warmwasserverbrauch mit eingerechnet ist.
Energieverbrauchskennwert thermalCharacteristic double 0-1999,99. Bitte geben Sie den "Kennwert" (Zahlen) der Immobilie nach dem ausgewählten "Energieausweistyp" in kWh/(m²*a) an.
Energieverbrauch enthält Warmwasser energyConsumptionContainsWarmWater enum YES, NOT_APPLICABLE. Bitte setzen Sie diesen Wert nur dann, wenn Ihr angegebener "Kennwert" ein "Energieverbrauchskennwert" ist und dieser den "Energieverbrauch für Warmwasser" enthält.
Anzahl Etagen numberOfFloors int 0 - 999
Nebenkosten serviceCharge double 0 - 9999999999999,99
Vermarktungsart* commercializationType enum BUY, RENT
Preis* value double 0 - 9999999999999,99. If "0" is entered, the object will be shown with "Preis auf Anfrage" (price on application) in the result list and expose
Währung* currency enum Euro
Preis gilt für Fläche/ Zeitraum * marketingType string Has to be compatible to commercializationType! If commercializationType = "RENT", than RENT or RENT_PER_SQM. If "BUY", than "PURCHASE".
Preis inkl. Zusatzservices additionalServicesIncluded enum Is only valid for commercializationType = "RENT", then YES, NOT_APPLICABLE. If not provided, NOT_APPLICABLE is default.
Büro-/Praxisfläche* netFloorSpace double 0 - 99999999,99
Gesamtfläche* totalFloorSpace double 0 - 99999999,99
Teilbar Ab minDivisible double 0 - 99999999,4999
Provisionspflichtig* hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag* courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Multimedia Anhang "video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung StatusVBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung StatusIS24 eigener Webservice
Objektveröffentlichung StatusHP eigener Webservice
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Zahlungsintervall priceIntervalType enum DAY, WEEK, MONTH, YEAR, ONE_TIME_CHARGE
Mietdauer officeRentDurations enum WEEKLY, MONTHLY, YEARLY, LONG_TERM. This attribute enables publishing an office in the new category "Büros auf Zeit" ("short-term rent offices"). LONG_TERM represents an ordinary rental contract. WEEKLY, MONTHLY and YEARLY represent atypical rental contracts for short term usage. If the field is not sent, LONG_TERM will be used as default value.

XML schema: 

<xs:complexType name="Office">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>
        <!-- Basiselemente -->  
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>
        <!-- Immobilientyp spezifische Elemente -->
        <xs:element name="officeType" type="ns1:OfficeType"/>
        <xs:element default="NOT_APPLICABLE" minOccurs="0" name="lift" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="cellar" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="handicappedAccessible" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="flooringType" type="ns1:FlooringType"/>
        <xs:element minOccurs="0" name="deposit" type="xs:string"/>
        <xs:element minOccurs="0" name="hasCanteen" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="lanCables" type="ns1:ItInfrastructureType"/>
        <xs:element minOccurs="0" name="highVoltage" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="kitchenComplete" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="listed" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="airConditioning" type="ns1:AirConditioningType"/>
        <xs:element minOccurs="0" name="distanceToMRS" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToFM" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToPT" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToAirport" type="xs:int"/>
        <xs:element minOccurs="0" name="condition" type="ns1:RealEstateCondition"/>
        <xs:element minOccurs="0" name="numberOfParkingSpaces" type="xs:int"/>
        <xs:element minOccurs="0" name="parkingSpacePrice" type="xs:double"/>
        <xs:element minOccurs="0" name="lastRefurbishment" type="xs:int"/>
        <xs:element minOccurs="0" name="interiorQuality" type="ns1:InteriorQuality"/>
        <xs:element minOccurs="0" name="constructionYear" type="xs:int"/>
        <xs:element minOccurs="0" name="freeFrom" type="xs:string"/>
        <xs:element minOccurs="0" name="heatingType" type="ns1:HeatingType"/>
        <xs:element minOccurs="0" name="firingTypes" type="ns1:FiringTypes"/>
        <xs:element minOccurs="0" name="thermalCharacteristic" type="xs:double"/>
        <xs:element minOccurs="0" name="energyConsumptionContainsWarmWater" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="buildingEnergyRatingType" type="ns1:BuildingEnergyRatingType"/>
        <xs:element minOccurs="0" name="additionalArea" type="xs:double"/>
        <xs:element minOccurs="0" name="numberOfFloors" type="xs:string"/>
        <xs:element minOccurs="0" minOccurs="0" name="additionalCosts" type="ns1:Price"/>
        <xs:element name="commercializationType" type="ns1:CommercializationType"/>
        <xs:element name="price" type="ns1:Price"/>
        <xs:element minOccurs="0" name="calculatedPrice" type="ns1:Price"/>
        <xs:element name="netFloorSpace" type="xs:double"/>
        <xs:element minOccurs="0" name="minDivisible" type="xs:double"/>
        <xs:element name="courtage" type="ns1:CourtageInfo"/>
                           <xs:element minOccurs="0" name="OfficeRentDuration" type="ns1:OfficeRentDuration"/>                     
                           <xs:element name=“energyCertificate” type=“EnergyPerformanceCertificate” minOccurs=“0” />   
                           <xs:element name=“additionalServicesIncluded” type=“YesNotApplicableType” default=“NOT_APPLICABLE” minOccurs=“0” />        
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Einzelhandel (store)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Ladentyp storeType enum SHOWROOM_SPACE (Ausstellungsflaeche), SHOPPING_CENTRE (Einkaufszentrum), FACTORY_OUTLET (FactoryOutlet), DEPARTMENT_STORE (Kaufhaus), KIOSK (Kiosk), STORE (Laden), SELF_SERVICE_MARKET (SBMarkt), SALES_AREA (Verkaufsflaeche), SALES_HALL (Verkaufshalle)
Lageart locationClassificationType enum NO_INFORMATION (keineAngabe), CLASSIFICATION_A (ALage), CLASSIFICATION_B (BLage), SHOPPING_CENTRE (Einkaufszentrum)
Schaufensterfront shopWindowLength double 0 - 999,99
Denkmalschutzobjekt listed enum YES, NOT_APPLICABLE
Aufzug lift enum YES, NOT_APPLICABLE
Lastenaufzug goodsLift enum YES, NOT_APPLICABLE
Lastenaufzug Tragkraft goodsLiftLoad double 0 - 99999,99
Deckenlast floorLoad double 0 - 99999,99
Rampe ramp enum YES, NOT_APPLICABLE
Keller cellar enum YES, NOT_APPLICABLE (keine Angabe)
Zulieferungsart supplyType enum NO_INFORMATION (keineAngabe), DIRECT_APPROACH (DirekterZugang), NO_DIRECT_APPROACH (KeineDirekteAnfahrt), CAR_APPROACH (PKW-Zufahrt), APPROACH_TO_THE_FRONT (VonVorn), APPROACH_TO_THE_BACK (VonHinten), FULL_TIME (Ganztaegig), FORENOON (Vormittags)
Bodenbelag flooringType enum NO_INFORMATION (keineAngabe), CONCRETE (Beton), EPOXY_RESIN (Epoxidharz), TILES(Fliesen), PLANKS (Dielen), LAMINATE (Laminat), PARQUET (Parkett), PVC (PVC), CARPET (Teppichboden), ANTISTATIC_FLOOR (TeppichbodenAntistatisch), OFFICE_CARPET (TeppichfliesenStuhlrollenfest), STONE (Stein), CUSTOMIZABLE (NachWunsch), WITHOUT (OhneBodenbelag)
Kaution deposit string Max. 50 characters
Vermarktungsart* commercializationType enum BUY, RENT
Preis* value double 0 - 9999999999999,99. If "0" is entered, the object will be shown with "Preis auf Anfrage" (price on application) in the result list and expose
Währung* currency enum Euro
Preis gilt für Fläche/ Zeitraum * marketingType string Has to be compatible to commercializationType! If commercializationType = "RENT", than RENT or RENT_PER_SQM. If "BUY", than "PURCHASE".
Gesamtfläche* totalFloorSpace double 0 - 99999999,99
Verkaufsfläche* netFloorSpace double 0 - 99999999,99
Teilbar Ab minDivisible double 0 - 99999999,4999
Provisionspflichtig* hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag* courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Provisionshinweis courtageNote String Max. 500 characters
Fahrzeit zum nächsten Bahnhof distanceToMRS int 0-99
Fahrzeit zur nächsten Autobahn distanceToFM int 0-99
Laufzeit zum Öffentl. Personennahverkehr distanceToPT int 0-99
Fahrzeit zum nächsten Flughafen distanceToAirport int 0 - 99
Objektzustand condition enum NO_INFORMATION (keine Angabe), FIRST_TIME_USE (Erstbezug), FIRST_TIME_USE_AFTER_REFURBISHMENT (Erstbezug nach Sanierung), MINT_CONDITION (Neuwertig), REFURBISHED (Saniert), MODERNIZED (Modernisiert), FULLY_RENOVATED (VollstaendigReonviert), WELL_KEPT (Gepflegt), NEED_OF_RENOVATION (Renovierungsbedürftig), NEGOTIABLE (NachVereinbarung), RIPE_FOR_DEMOLITION (Abbruchreif)
Anzahl Parkplätze numberOfParkingSpaces int 0 - 99999
Preis pro Parkfläche parkingSpacePrice double 0 - 9999999999999,99
Letzte Modernisierung lastRefurbishment String 1000 - 9999
Qualität der Ausstattung interiorQuality enum NO_INFORMANTION (keine Angabe), LUXURY (luxus), SOPHISTICATED (gehoben), NORMAL, SIMPLE (einfach)
Baujahr constructionYear String 4 Stellen, 0 - 9999
Frei ab freeFrom String Max. 50 characters
Heizungsart heatingType enum NO_INFORMATION (keine Angabe), SELF_CONTAINED_CENTRAL_HEATING (Etagenheizung), STOVE_HEATING (Ofenheizung), CENTRAL_HEATING (Zentralheizung) For using the new enum fields: COMBINED_HEAT_AND_POWER_PLANT (Blockheizkraftwerk), ELECTRIC_HEATING (Elektro-Heizung),DISTRICT_HEATING (Fernwärme),FLOOR_HEATING (Fußbodenheizung), GAS_HEATING (Gas-Heizung), WOOD_PELLET_HEATING (Holz-Pelletheizung), NIGHT_STORAGE_HEATER (Nachtspeicherofen), OIL_HEATING (Öl-Heizung), SOLAR_HEATING (Solar-Heizung), HEAT_PUMP (Wärmepumpe) you'll need the query param "usenewenergysourceenev2014values=true"
Befeuerungsarten firingType enum NO_INFORMANTION (keine Angabe), GEOTHERMAL (Erdwärme), SOLAR_HEATING (Solarheizung), \PELLET_HEATING (Pelletheizung), GAS, OIL (Öl), DISTRICT_HEATING (Fernwärme), ELECTRICITY (Strom), COAL (Kohle)
Energieausweistyp BuildingEnergyRatingType enum NO_INFORMATION (Keine Angabe), ENERGY_REQUIRED (Endenergiebedarf), ENERGY_CONSUMPTION (Energieverbrauchskennwert). Wählen sie den Ausweistyp aus, zu dem Sie einen Kennwert angeben möchten. Ein Energieausweis wird in Endenergiebedarf (bedarfsorientierter Ausweis) und Energieverbrauchskennwert (verbrauchsorientierter Ausweis) unterschieden. Der bedarfsorientierte Energieausweis orientiert sich am errechneten Bedarf des Gebäudes. Der verbrauchsorientierte Ausweis am tatsächlichen Verbrauch der Nutzer. Bitte beachten Sie bei der Angabe des Energieverbrauchskennwert, ob der Warmwasserverbrauch mit eingerechnet ist.
Energieverbrauchskennwert thermalCharacteristic double 0-1999,99. Bitte geben Sie den "Kennwert" (Zahlen) der Immobilie nach dem ausgewählten "Energieausweistyp" in kWh/(m²*a) an.
Energieverbrauch enthält Warmwasser energyConsumptionContainsWarmWater enum YES, NOT_APPLICABLE. Bitte setzen Sie diesen Wert nur dann, wenn Ihr angegebener "Kennwert" ein "Energieverbrauchskennwert" ist und dieser den "Energieverbrauch für Warmwasser" enthält.
Nebenfläche additionalArea double 0 - 99999999,99
Anzahl Etagen numberOfFloors int 0 - 999
Nebenkosten serviceCharge double 0 - 9999999999999,99
Multimedia Anhang "video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung StatusVBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung StatusIS24 eigener Webservice
Objektveröffentlichung StatusHP eigener Webservice
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Zahlungsintervall priceIntervalType enum DAY, WEEK, MONTH, YEAR, ONE_TIME_CHARGE

XML schema: 

<xs:complexType name="Store">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>  
        <!-- Basiselemente -->  
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>
        <!-- Immobilientyp spezifische Elemente -->  
        <xs:element minOccurs="0" name="storeType" type="ns1:StoreType"/>
        <xs:element minOccurs="0" name="locationClassificationType" type="ns1:LocationClassificationType"/>
        <xs:element minOccurs="0" name="areaDivisibleFrom" type="xs:double"/>
        <xs:element minOccurs="0" name="shopWindowLength" type="xs:double"/>
        <xs:element minOccurs="0" name="listed" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="lift" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="goodsLift" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="goodsLiftLoad" type="xs:double"/>
        <xs:element minOccurs="0" name="floorLoad" type="xs:double"/>
        <xs:element minOccurs="0" name="ramp" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="cellar" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="supplyType" type="ns1:SupplyType"/>
        <xs:element minOccurs="0" name="flooringType" type="ns1:FlooringType"/>
        <xs:element minOccurs="0" name="deposit" type="xs:string"/>
        <xs:element name="commercializationType" type="ns1:CommercializationType"/>
        <xs:element name="price" type="ns1:Price"/>
        <xs:element minOccurs="0" name="calculatedPrice" type="ns1:Price"/>
        <xs:element name="totalFloorSpace" type="xs:double"/>
        <xs:element name="netFloorSpace" type="xs:double"/>
        <xs:element minOccurs="0" name="minDivisible" type="xs:double"/>
        <xs:element name="courtage" type="ns1:CourtageInfo"/>
        <xs:element minOccurs="0" name="distanceToMRS" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToFM" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToPT" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToAirport" type="xs:int"/>
        <xs:element minOccurs="0" name="condition" type="ns1:RealEstateCondition"/>
        <xs:element minOccurs="0" name="numberOfParkingSpaces" type="xs:int"/>
        <xs:element minOccurs="0" name="parkingSpacePrice" type="xs:double"/>
        <xs:element minOccurs="0" name="lastRefurbishment" type="xs:int"/>
        <xs:element minOccurs="0" name="interiorQuality" type="ns1:InteriorQuality"/>
        <xs:element minOccurs="0" name="constructionYear" type="xs:int"/>
        <xs:element minOccurs="0" name="freeFrom" type="xs:string"/>
        <xs:element minOccurs="0" name="heatingType" type="ns1:HeatingType"/>
        <xs:element minOccurs="0" name="firingTypes" type="ns1:FiringTypes"/>
        <xs:element minOccurs="0" name="thermalCharacteristic" type="xs:double"/>
        <xs:element minOccurs="0" name="energyConsumptionContainsWarmWater" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="buildingEnergyRatingType" type="ns1:BuildingEnergyRatingType"/>
        <xs:element minOccurs="0" name="additionalArea" type="xs:double"/>
        <xs:element minOccurs="0" name="numberOfFloors" type="xs:string"/>
        <xs:element minOccurs="0" name="additionalCosts" type="ns1:Price"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Gastronomie/Hotel (gastronomy)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Gastronomietyp* gastronomyType enum BAR_LOUNGE (Barbetrieb), CAFE (Caffee), CLUB_DISCO (Diskothek), GUESTS_HOUSE (Gaestehaus), TAVERN (), HOTEL (Hotel), HOTEL_RESIDENCE (Hotelanwesen), HOTEL_GARNI (HotelGarni), PENSION (Pension), RESTAURANT (Restaurant), BUNGALOW (Ferienbungalow)
Denkmalschutzobjekt listed enum YES, NOT_APPLICABLE
Aufzug lift enum YES, NOT_APPLICABLE
Terrasse terrace enum YES, NOT_APPLICABLE
Anzahl der Sitzplätze numberSeats int 0 - 99999
Anzahl der Betten numberBeds int 0 - 99999
Keller cellar enum YES, NOT_APPLICABLE (keine Angabe)
Kaution deposit string Max. 50 characters
Vermarktungsart* commercializationType enum BUY, RENT
Preis* value double 0 - 9999999999999,99. If "0" is entered, the object will be shown with "Preis auf Anfrage" (price on application) in the result list and expose
Währung* currency enum Euro
Preis gilt für Fläche/ Zeitraum * marketingType string Has to be compatible to commercializationType! If commercializationType = "RENT", than RENT or RENT_PER_SQM. If "BUY", than "PURCHASE".
Gesamtfläche* totalFloorSpace double 0 - 99999999,99
Gastraumfläche netFloorSpace double 0 - 99999999,99
Teilbar Ab minDivisible double 0 - 99999999,4999
Provisionspflichtig* hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag* courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Provisionshinweis courtageNote String Max. 500 characters
Fahrzeit zum nächsten Bahnhof distanceToMRS int 0-99
Fahrzeit zur nächsten Autobahn distanceToFM int 0-99
Laufzeit zum Öffentl. Personennahverkehr distanceToPT int 0-99
Fahrzeit zum nächsten Flughafen distanceToAirport int 0 - 99
Objektzustand condition enum NO_INFORMATION (keine Angabe), FIRST_TIME_USE (Erstbezug), FIRST_TIME_USE_AFTER_REFURBISHMENT (Erstbezug nach Sanierung), MINT_CONDITION (Neuwertig), REFURBISHED (Saniert), MODERNIZED (Modernisiert), FULLY_RENOVATED (VollstaendigReonviert), WELL_KEPT (Gepflegt), NEED_OF_RENOVATION (Renovierungsbedürftig), NEGOTIABLE (NachVereinbarung), RIPE_FOR_DEMOLITION (Abbruchreif)
Anzahl Parkplätze numberOfParkingSpaces int 0 - 99999
Preis pro Parkfläche parkingSpacePrice double 0 - 9999999999999,99
Letzte Modernisierung lastRefurbishment String 1000 - 9999
Qualität der Ausstattung interiorQuality enum NO_INFORMANTION (keine Angabe), LUXURY (luxus), SOPHISTICATED (gehoben), NORMAL, SIMPLE (einfach)
Baujahr constructionYear String 4 Stellen, 0 - 9999
Frei ab freeFrom String Max. 50 characters
Heizungsart heatingType enum NO_INFORMATION (keine Angabe), SELF_CONTAINED_CENTRAL_HEATING (Etagenheizung), STOVE_HEATING (Ofenheizung), CENTRAL_HEATING (Zentralheizung) For using the new enum fields: COMBINED_HEAT_AND_POWER_PLANT (Blockheizkraftwerk), ELECTRIC_HEATING (Elektro-Heizung),DISTRICT_HEATING (Fernwärme),FLOOR_HEATING (Fußbodenheizung), GAS_HEATING (Gas-Heizung), WOOD_PELLET_HEATING (Holz-Pelletheizung), NIGHT_STORAGE_HEATER (Nachtspeicherofen), OIL_HEATING (Öl-Heizung), SOLAR_HEATING (Solar-Heizung), HEAT_PUMP (Wärmepumpe) you'll need the query param "usenewenergysourceenev2014values=true"
Befeuerungsarten firingType enum NO_INFORMANTION (keine Angabe), GEOTHERMAL (Erdwärme), SOLAR_HEATING (Solarheizung), \PELLET_HEATING (Pelletheizung), GAS, OIL (Öl), DISTRICT_HEATING (Fernwärme), ELECTRICITY (Strom), COAL (Kohle)
Energieausweistyp BuildingEnergyRatingType enum NO_INFORMATION (Keine Angabe), ENERGY_REQUIRED (Endenergiebedarf), ENERGY_CONSUMPTION (Energieverbrauchskennwert). Wählen sie den Ausweistyp aus, zu dem Sie einen Kennwert angeben möchten. Ein Energieausweis wird in Endenergiebedarf (bedarfsorientierter Ausweis) und Energieverbrauchskennwert (verbrauchsorientierter Ausweis) unterschieden. Der bedarfsorientierte Energieausweis orientiert sich am errechneten Bedarf des Gebäudes. Der verbrauchsorientierte Ausweis am tatsächlichen Verbrauch der Nutzer. Bitte beachten Sie bei der Angabe des Energieverbrauchskennwert, ob der Warmwasserverbrauch mit eingerechnet ist.
Energieverbrauchskennwert thermalCharacteristic double 0-1999,99. Bitte geben Sie den "Kennwert" (Zahlen) der Immobilie nach dem ausgewählten "Energieausweistyp" in kWh/(m²*a) an.
Energieverbrauch enthält Warmwasser energyConsumptionContainsWarmWater enum YES, NOT_APPLICABLE. Bitte setzen Sie diesen Wert nur dann, wenn Ihr angegebener "Kennwert" ein "Energieverbrauchskennwert" ist und dieser den "Energieverbrauch für Warmwasser" enthält.
Nebenfläche additionalArea double 0 - 99999999,99
Anzahl Etagen numberOfFloors String 0 - 999
Nebenkosten serviceCharge double 0 - 9999999999999,99
Multimedia Anhang "video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung StatusVBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung StatusIS24 eigener Webservice
Objektveröffentlichung StatusHP eigener Webservice
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Zahlungsintervall priceIntervalType enum DAY, WEEK, MONTH, YEAR, ONE_TIME_CHARGE

XML schema: 

<xs:complexType name="Gastronomy">
  <xs:complexContent>
    <xs:extension base="tns:RealEstateForList">
      <xs:sequence>
        <!-- Basiselemente -->
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>+
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>
        <!-- Immobilientyp spezifische Elemente -->
        <xs:element name="gastronomyType" type="ns1:GastronomyType"/>
        <xs:element minOccurs="0" name="listed" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="lift" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="terrace" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="numberSeats" type="xs:int"/>
        <xs:element minOccurs="0" name="numberBeds" type="xs:int"/>
        <xs:element minOccurs="0" name="cellar" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="deposit" type="xs:string"/>
        <xs:element name="commercializationType" type="ns1:CommercializationType"/>
        <xs:element name="price" type="ns1:Price"/>
        <xs:element minOccurs="0" name="calculatedPrice" type="ns1:Price"/>
        <xs:element name="totalFloorSpace" type="xs:double"/>
        <xs:element minOccurs="0" name="netFloorSpace" type="xs:double"/>
        <xs:element minOccurs="0" name="minDivisible" type="xs:double"/>
        <xs:element name="courtage" type="ns1:CourtageInfo"/>
        <xs:element minOccurs="0" name="distanceToMRS" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToFM" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToPT" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToAirport" type="xs:int"/>
        <xs:element minOccurs="0" name="condition" type="ns1:RealEstateCondition"/>
        <xs:element minOccurs="0" name="numberOfParkingSpaces" type="xs:int"/>
        <xs:element minOccurs="0" name="parkingSpacePrice" type="xs:double"/>
        <xs:element minOccurs="0" name="lastRefurbishment" type="xs:int"/>
        <xs:element minOccurs="0" name="interiorQuality" type="ns1:InteriorQuality"/>
        <xs:element minOccurs="0" name="constructionYear" type="xs:int"/>
        <xs:element minOccurs="0" name="freeFrom" type="xs:string"/>
        <xs:element minOccurs="0" name="heatingType" type="ns1:HeatingType"/>
        <xs:element minOccurs="0" name="firingTypes" type="ns1:FiringTypes"/>
        <xs:element minOccurs="0" name="thermalCharacteristic" type="xs:double"/>
        <xs:element minOccurs="0" name="energyConsumptionContainsWarmWater" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="buildingEnergyRatingType" type="ns1:BuildingEnergyRatingType"/>
        <xs:element minOccurs="0" name="additionalArea" type="xs:double"/>
        <xs:element minOccurs="0" name="numberOfFloors" type="xs:string"/>
        <xs:element minOccurs="0" name="additionalCosts" type="ns1:Price"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Halle/Produktion (industry)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Objekttyp* industryType enum SHOWROOM_SPACE (Ausstellungsflaeche), HALL (Halle), HIGH_LACK_STORAGE (Hochregallager), INDUSTRY_HALL (Industriehalle), INDUSTRY_HALL_WITH_OPEN_AREA (IndustriehalleMitFreiflaeche), COLD_STORAGE (Kuehlhaus), MULTIDECK_CABINET_STORAGE (Kuehlregallager), STORAGE_WITH_OPEN_AREA (LagerMitFreiflaeche), STORAGE_AREA (Lagerflaeche), STORAGE_HALL (Lagerhalle), SERVICE_AREA (Serviceflaeche), SHIPPING_STORAGE (Speditionslager), REPAIR_SHOP (Werkstatt)
Grundstücksfläche plotArea double 0 - 99999999,99
Hallen-/Geschosshöhe hallHeight double 0 - 999,99
Bodenbelag flooringType enum NO_INFORMATION (keineAngabe), CONCRETE (Beton), EPOXY_RESIN (Epoxidharz), TILES(Fliesen), PLANKS (Dielen), LAMINATE (Laminat), PARQUET (Parkett), PVC (PVC), CARPET (Teppichboden), ANTISTATIC_FLOOR (TeppichbodenAntistatisch), OFFICE_CARPET (TeppichfliesenStuhlrollenfest), STONE (Stein), CUSTOMIZABLE (NachWunsch), WITHOUT (OhneBodenbelag)
Rampe ramp enum YES, NOT_APPLICABLE
Hebebühne autoLift enumn YES, NOT_APPLICABLE
Lastenaufzug goodsLift enum YES, NOT_APPLICABLE (keine Angabe)
Lastenaufzugtragkraft goodsLiftLoad double 0 - 99999,99
Kranbahn craneRunway enum YES, NOT_APPLICABLE (keine Angabe)
Kranbahn Tragkraft (tonnen) craneRunwayLoad double 0 - 99999,99
Stromanschlusswert (kVA) connectedLoad double 0 - 99999,99
Bodenbelastung floorLoad double 0 - 99999,99
Kaution deposit string Max. 50 characters
Vermarktungsart* commercializationType enum BUY, RENT
Preis* value double 0 - 9999999999999,99. If "0" is entered, the object will be shown with "Preis auf Anfrage" (price on application) in the result list and expose
Währung* currency enum Euro
Preis gilt für Fläche/ Zeitraum * marketingType string Has to be compatible to commercializationType! If commercializationType = "RENT", than RENT or RENT_PER_SQM. If "BUY", than "PURCHASE".
Gesamtfläche* totalFloorSpace double 0 - 99999999,99
Lager-/Produktionsfläche * netFloorSpace double 0 - 99999999,99
Teilbar Ab minDivisible String 0 - 99999999,99
Provisionspflichtig* hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag* courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Provisionshinweis courtageNote String Max. 500 characters
Fahrzeit zum nächsten Bahnhof distanceToMRS int 0-99
Fahrzeit zur nächsten Autobahn distanceToFM int 0-99
Laufzeit zum Öffentl. Personennahverkehr distanceToPT int 0-99
Fahrzeit zum nächsten Flughafen distanceToAirport int 0 - 99
Objektzustand condition enum NO_INFORMATION (keine Angabe), FIRST_TIME_USE (Erstbezug), FIRST_TIME_USE_AFTER_REFURBISHMENT (Erstbezug nach Sanierung), MINT_CONDITION (Neuwertig), REFURBISHED (Saniert), MODERNIZED (Modernisiert), FULLY_RENOVATED (VollstaendigReonviert), WELL_KEPT (Gepflegt), NEED_OF_RENOVATION (Renovierungsbedürftig), NEGOTIABLE (NachVereinbarung), RIPE_FOR_DEMOLITION (Abbruchreif)
Anzahl Parkplätze numberOfParkingSpaces int 0 - 99999
Preis pro Parkfläche parkingSpacePrice double 0 - 9999999999999,99
Letzte Modernisierung lastRefurbishment String 1000 - 9999
Qualität der Ausstattung interiorQuality enum NO_INFORMANTION (keine Angabe), LUXURY (luxus), SOPHISTICATED (gehoben), NORMAL, SIMPLE (einfach)
Baujahr constructionYear String 4 Stellen, 0 - 9999
Frei ab freeFrom String Max. 50 characters
Heizungsart heatingType enum NO_INFORMATION (keine Angabe), SELF_CONTAINED_CENTRAL_HEATING (Etagenheizung), STOVE_HEATING (Ofenheizung), CENTRAL_HEATING (Zentralheizung) For using the new enum fields: COMBINED_HEAT_AND_POWER_PLANT (Blockheizkraftwerk), ELECTRIC_HEATING (Elektro-Heizung),DISTRICT_HEATING (Fernwärme),FLOOR_HEATING (Fußbodenheizung), GAS_HEATING (Gas-Heizung), WOOD_PELLET_HEATING (Holz-Pelletheizung), NIGHT_STORAGE_HEATER (Nachtspeicherofen), OIL_HEATING (Öl-Heizung), SOLAR_HEATING (Solar-Heizung), HEAT_PUMP (Wärmepumpe) you'll need the query param "usenewenergysourceenev2014values=true"
Befeuerungsarten firingType enum NO_INFORMANTION (keine Angabe), GEOTHERMAL (Erdwärme), SOLAR_HEATING (Solarheizung), \PELLET_HEATING (Pelletheizung), GAS, OIL (Öl), DISTRICT_HEATING (Fernwärme), ELECTRICITY (Strom), COAL (Kohle)
Energieausweistyp BuildingEnergyRatingType enum NO_INFORMATION (Keine Angabe), ENERGY_REQUIRED (Endenergiebedarf), ENERGY_CONSUMPTION (Energieverbrauchskennwert). Wählen sie den Ausweistyp aus, zu dem Sie einen Kennwert angeben möchten. Ein Energieausweis wird in Endenergiebedarf (bedarfsorientierter Ausweis) und Energieverbrauchskennwert (verbrauchsorientierter Ausweis) unterschieden. Der bedarfsorientierte Energieausweis orientiert sich am errechneten Bedarf des Gebäudes. Der verbrauchsorientierte Ausweis am tatsächlichen Verbrauch der Nutzer. Bitte beachten Sie bei der Angabe des Energieverbrauchskennwert, ob der Warmwasserverbrauch mit eingerechnet ist.
Energieverbrauchskennwert thermalCharacteristic double 0-1999,99. Bitte geben Sie den "Kennwert" (Zahlen) der Immobilie nach dem ausgewählten "Energieausweistyp" in kWh/(m²*a) an.
Energieverbrauch enthält Warmwasser energyConsumptionContainsWarmWater enum YES, NOT_APPLICABLE. Bitte setzen Sie diesen Wert nur dann, wenn Ihr angegebener "Kennwert" ein "Energieverbrauchskennwert" ist und dieser den "Energieverbrauch für Warmwasser" enthält.
Nebenfläche additionalArea double 0 - 99999999,99
Anzahl Etagen numberOfFloors int 0 - 999
Nebenkosten serviceCharge double 0 - 9999999999999,99
Multimedia Anhang "video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung StatusVBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung StatusIS24 eigener Webservice
Objektveröffentlichung StatusHP eigener Webservice
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Zahlungsintervall priceIntervalType enum DAY, WEEK, MONTH, YEAR, ONE_TIME_CHARGE 
<xs:complexType name="Industry">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>
        <!-- Basiselemente -->
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>
        <!-- Immobilientyp spezifische Elemente -->
        <xs:element name="industryType" type="ns1:IndustryType"/>
        <xs:element minOccurs="0" name="areaDivisibleFrom" type="xs:double"/>
        <xs:element minOccurs="0" name="plotArea" type="xs:double"/>
        <xs:element minOccurs="0" name="hallHeight" type="xs:double"/>
        <xs:element minOccurs="0" name="flooringType" type="ns1:FlooringType"/>
        <xs:element minOccurs="0" name="ramp" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="lift" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="autoLift" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="goodsLift" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="goodsLiftLoad" type="xs:double"/>
        <xs:element minOccurs="0" name="craneRunway" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="craneRunwayLoad" type="xs:double"/>
        <xs:element minOccurs="0" name="floorLoad" type="xs:double"/>
        <xs:element minOccurs="0" name="connectedLoad" type="xs:int"/>
        <xs:element minOccurs="0" name="deposit" type="xs:string"/>
        <xs:element name="commercializationType" type="ns1:CommercializationType"/>
        <xs:element name="price" type="ns1:Price"/>
        <xs:element minOccurs="0" name="calculatedPrice" type="ns1:Price"/>
        <xs:element name="totalFloorSpace" type="xs:double"/>
        <xs:element name="netFloorSpace" type="xs:double"/>
        <xs:element minOccurs="0" name="minDivisible" type="xs:double"/>
        <xs:element name="courtage" type="ns1:CourtageInfo"/>
        <xs:element minOccurs="0" name="distanceToMRS" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToFM" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToPT" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToAirport" type="xs:int"/>
        <xs:element minOccurs="0" name="condition" type="ns1:RealEstateCondition"/>
        <xs:element minOccurs="0" name="numberOfParkingSpaces" type="xs:int"/>
        <xs:element minOccurs="0" name="parkingSpacePrice" type="xs:double"/>
        <xs:element minOccurs="0" name="lastRefurbishment" type="xs:int"/>
        <xs:element minOccurs="0" name="interiorQuality" type="ns1:InteriorQuality"/>
        <xs:element minOccurs="0" name="constructionYear" type="xs:int"/>
        <xs:element minOccurs="0" name="freeFrom" type="xs:string"/>
        <xs:element minOccurs="0" name="heatingType" type="ns1:HeatingType"/>
        <xs:element minOccurs="0" name="firingTypes" type="ns1:FiringTypes"/>
        <xs:element minOccurs="0" name="thermalCharacteristic" type="xs:double"/>
        <xs:element minOccurs="0" name="energyConsumptionContainsWarmWater" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="buildingEnergyRatingType" type="ns1:BuildingEnergyRatingType"/>
        <xs:element minOccurs="0" name="additionalArea" type="xs:double"/>
        <xs:element minOccurs="0" name="numberOfFloors" type="xs:string"/>
        <xs:element minOccurs="0" name="additionalCosts" type="ns1:Price"/>  
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Gewerbegrundstück (tradeSite)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Vermarktungsart* commercializationType enum RENT, BUY, LEASE, LEASEHOLD
Empfohlene Nutzungsarten recommendedUseTypes enum NO_INFORMATION (keineAngabe), FARMLAND (Ackerland), FUTURE_DEVELOPMENT_LAND (Bauerwartungsland), MOORAGE (Bootsstaende), OFFICE (Buero), CAMPING (Camping), BIG_STORE (Einzelhandel-gross), LITTLE_STORE (Einzelhandel-klein), GARAGE (Garagen), GARDEN (Garten), GASTRONOMY (Gastronomie), BUSINESS (Gewerbe), HOTEL (Hotel), INDUSTRY (Industrie), NO_DEVELOPMENT (keineBebauung), SMALL_BUSINESS (Kleingewerbe), STOCK (Lager), ORCHARD (Obstgarten), CAR_PARK (Parkhaus), PRODUCTION (Produktion), PARKING_SPACE (Stellplaetze), FORREST (Wald)
Grundstückskategorie* utilizationTradeSite enum LEISURE (Freizeit), AGRICULTURE_FORESTRY (LandForstwirtschaft), TRADE (Gewerbe)
Heimfall nach... Jahren(Pachtdauer) tenancy int 0 - 999
Preis* value double 0 - 9999999999999,99. If "0" is entered, the object will be shown with "Preis auf Anfrage" (price on application) in the result list and expose
Währung* currency enum Euro
Vermarktungsarten* MarketingType enum PURCHASE, PURCHASE_PER_SQM, RENT, RENT_PER_SQM, LEASE, LEASEHOLD, BUDGET_RENT
Grundstücksfläche* plotArea double 0 - 99999999,99
Teilbar Ab minDivisible double 0 - 99999999,4999
Provisionspflichtig* hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag* courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Provisionshinweis courtageNote String Max. 500 characters
Frei ab freeFrom String Max. 50 characters
Kurzfristig bebaubar shortTermConstructible boolean true, false
Baugenehmigung buildingPermission boolean true, false
Abriss demolition boolean true, false
Erschliessungszustand siteDevelopmentType enum DEVELOPED (Erschlossen), DEVELOPED_PARTIALLY (Teilerschlossen), NOT_DEVELOPED (Unerschlossen), NO_INFORMATION (Unbekannt)
Bebaubar nach siteConstructibleType enum CONSTRUCTIONPLAN (Bebauung nach Bebauungsplan), NEIGHBOURCONSTRUCTION (Nachbarbebauung), EXTERNALAREA (Aussengebiet), NO_INFORMATION (Unbekannt)
grz grz double 0 - 9,99
gfz gfz double 0 - 9,99
Multimedia Anhang "video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung StatusVBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung StatusIS24 eigener Webservice
Objektveröffentlichung StatusHP eigener Webservice
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Zahlungsintervall priceIntervalType enum DAY, WEEK, MONTH, YEAR, ONE_TIME_CHARGE
Leaseintervall leaseInterval enum MONTH, YEAR

XML schema: 

<xs:complexType name="Industry">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>
        <!-- Basiselemente -->
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>
        <!-- Immobilientyp spezifische Elemente -->
        <xs:element name="industryType" type="ns1:IndustryType"/>
        <xs:element minOccurs="0" name="areaDivisibleFrom" type="xs:double"/>
        <xs:element minOccurs="0" name="plotArea" type="xs:double"/>
        <xs:element minOccurs="0" name="hallHeight" type="xs:double"/>
        <xs:element minOccurs="0" name="flooringType" type="ns1:FlooringType"/>
        <xs:element minOccurs="0" name="ramp" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="lift" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="autoLift" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="goodsLift" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="goodsLiftLoad" type="xs:double"/>
        <xs:element minOccurs="0" name="craneRunway" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="craneRunwayLoad" type="xs:double"/>
        <xs:element minOccurs="0" name="floorLoad" type="xs:double"/>
        <xs:element minOccurs="0" name="connectedLoad" type="xs:int"/>
        <xs:element minOccurs="0" name="deposit" type="xs:string"/>
        <xs:element name="commercializationType" type="ns1:CommercializationType"/>
        <xs:element name="price" type="ns1:Price"/>
        <xs:element minOccurs="0" name="calculatedPrice" type="ns1:Price"/>
        <xs:element name="totalFloorSpace" type="xs:double"/>
        <xs:element name="netFloorSpace" type="xs:double"/>
        <xs:element minOccurs="0" name="minDivisible" type="xs:double"/>
        <xs:element name="courtage" type="ns1:CourtageInfo"/>
        <xs:element minOccurs="0" name="distanceToMRS" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToFM" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToPT" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToAirport" type="xs:int"/>
        <xs:element minOccurs="0" name="condition" type="ns1:RealEstateCondition"/>
        <xs:element minOccurs="0" name="numberOfParkingSpaces" type="xs:int"/>
        <xs:element minOccurs="0" name="parkingSpacePrice" type="xs:double"/>
        <xs:element minOccurs="0" name="lastRefurbishment" type="xs:int"/>
        <xs:element minOccurs="0" name="interiorQuality" type="ns1:InteriorQuality"/>
        <xs:element minOccurs="0" name="constructionYear" type="xs:int"/>
        <xs:element minOccurs="0" name="freeFrom" type="xs:string"/>
        <xs:element minOccurs="0" name="heatingType" type="ns1:HeatingType"/>
        <xs:element minOccurs="0" name="firingTypes" type="ns1:FiringTypes"/>
        <xs:element minOccurs="0" name="thermalCharacteristic" type="xs:double"/>
        <xs:element minOccurs="0" name="energyConsumptionContainsWarmWater" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="buildingEnergyRatingType" type="ns1:BuildingEnergyRatingType"/>
        <xs:element minOccurs="0" name="additionalArea" type="xs:double"/>
        <xs:element minOccurs="0" name="numberOfFloors" type="xs:string"/>
        <xs:element minOccurs="0" name="additionalCosts" type="ns1:Price"/>  
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Spezialgewerbe (specialPurpose)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Immobilientyp* specialPurposePropertyType enum RESIDENCE (Anwesen), FARM (Bauernhof), HORSE_FARM (Reiterhof), VINEYARD (Weingut), REPAIR_SHOP (Werkstatt), LEISURE_FACILITY (Freizeitanlage), INDUSTRIAL_AREA (Gewerbeflaeche), SPECIAL_ESTATE (Spezialobjekt), COMMERCIAL_CENTRE (Gewerbepark)
Grundstücksfläche plotArea double 0 - 99999999,99
Denkmalschutzobjekt listed enum YES, NOT_APPLICABLE
Aufzug lift enum YES, NOT_APPLICABLE
Keller basement enum YES, NOT_APPLICABLE
Bodenbelag flooringType enum NO_INFORMATION (keineAngabe), CONCRETE (Beton), EPOXY_RESIN (Epoxidharz), TILES(Fliesen), PLANKS (Dielen), LAMINATE (Laminat), PARQUET (Parkett), PVC (PVC), CARPET (Teppichboden), ANTISTATIC_FLOOR (TeppichbodenAntistatisch), OFFICE_CARPET (TeppichfliesenStuhlrollenfest), STONE (Stein), CUSTOMIZABLE (NachWunsch), WITHOUT (OhneBodenbelag)
Kaution deposit String Max. 50 Zeichen
Vermarktungsart* commercializationType enum RENT, BUY, LEASE, LEASEHOLD
Preis* value double 0 - 9999999999999,99. If "0" is entered, the object will be shown with "Preis auf Anfrage" (price on application) in the result list and expose
Währung* currency enum Euro
Preis gilt für Fläche/ Zeitraum * marketingType string Has to be compatible to commercializationType! If commercializationType = "RENT", than RENT or RENT_PER_SQM. If "BUY", than "PURCHASE".
Gesamtfläche* totalFloorSpace double 0 - 99999999,99
Hauptfläche* netFloorSpace double 0 - 99999999,99
Teilbar Ab minDivisible double 0 - 99999999,4999
Provisionspflichtig* hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag* courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Provisionshinweis courtageNote String Max. 500 characters
Fahrzeit zum nächsten Bahnhof distanceToMRS int 0-99
Fahrzeit zur nächsten Autobahn distanceToFM int 0-99
Laufzeit zum Öffentl. Personennahverkehr distanceToPT int 0-99
Fahrzeit zum nächsten Flughafen distanceToAirport int 0 - 99
Objektzustand condition enum NO_INFORMATION (keine Angabe), FIRST_TIME_USE (Erstbezug), FIRST_TIME_USE_AFTER_REFURBISHMENT (Erstbezug nach Sanierung), MINT_CONDITION (Neuwertig), REFURBISHED (Saniert), MODERNIZED (Modernisiert), FULLY_RENOVATED (VollstaendigReonviert), WELL_KEPT (Gepflegt), NEED_OF_RENOVATION (Renovierungsbedürftig), NEGOTIABLE (NachVereinbarung), RIPE_FOR_DEMOLITION (Abbruchreif)
Anzahl Parkplätze numberOfParkingSpaces int 0 - 99999
Preis pro Parkfläche parkingSpacePrice double 0 - 9999999999999,99
Letzte Modernisierung lastRefurbishment String 1000 - 9999
Qualität der Ausstattung interiorQuality enum NO_INFORMANTION (keine Angabe), LUXURY (luxus), SOPHISTICATED (gehoben), NORMAL, SIMPLE (einfach)
Baujahr constructionYear String 4 Stellen, 0 - 9999
Frei ab freeFrom String Max. 50 characters
Heizungsart heatingType enum NO_INFORMATION (keine Angabe), SELF_CONTAINED_CENTRAL_HEATING (Etagenheizung), STOVE_HEATING (Ofenheizung), CENTRAL_HEATING (Zentralheizung) For using the new enum fields: COMBINED_HEAT_AND_POWER_PLANT (Blockheizkraftwerk), ELECTRIC_HEATING (Elektro-Heizung),DISTRICT_HEATING (Fernwärme),FLOOR_HEATING (Fußbodenheizung), GAS_HEATING (Gas-Heizung), WOOD_PELLET_HEATING (Holz-Pelletheizung), NIGHT_STORAGE_HEATER (Nachtspeicherofen), OIL_HEATING (Öl-Heizung), SOLAR_HEATING (Solar-Heizung), HEAT_PUMP (Wärmepumpe) you'll need the query param "usenewenergysourceenev2014values=true"
Befeuerungsarten firingType enum NO_INFORMANTION (keine Angabe), GEOTHERMAL (Erdwärme), SOLAR_HEATING (Solarheizung), \PELLET_HEATING (Pelletheizung), GAS, OIL (Öl), DISTRICT_HEATING (Fernwärme), ELECTRICITY (Strom), COAL (Kohle)
Energieausweistyp BuildingEnergyRatingType enum NO_INFORMATION (Keine Angabe), ENERGY_REQUIRED (Endenergiebedarf), ENERGY_CONSUMPTION (Energieverbrauchskennwert). Wählen sie den Ausweistyp aus, zu dem Sie einen Kennwert angeben möchten. Ein Energieausweis wird in Endenergiebedarf (bedarfsorientierter Ausweis) und Energieverbrauchskennwert (verbrauchsorientierter Ausweis) unterschieden. Der bedarfsorientierte Energieausweis orientiert sich am errechneten Bedarf des Gebäudes. Der verbrauchsorientierte Ausweis am tatsächlichen Verbrauch der Nutzer. Bitte beachten Sie bei der Angabe des Energieverbrauchskennwert, ob der Warmwasserverbrauch mit eingerechnet ist.
Energieverbrauchskennwert thermalCharacteristic double 0-1999,99. Bitte geben Sie den "Kennwert" (Zahlen) der Immobilie nach dem ausgewählten "Energieausweistyp" in kWh/(m²*a) an.
Energieverbrauch enthält Warmwasser energyConsumptionContainsWarmWater enum YES, NOT_APPLICABLE. Bitte setzen Sie diesen Wert nur dann, wenn Ihr angegebener "Kennwert" ein "Energieverbrauchskennwert" ist und dieser den "Energieverbrauch für Warmwasser" enthält.
Nebenfläche additionalArea double 0 - 99999999,99
Anzahl Etagen numberOfFloors int 0 - 999
Nebenkosten additionalCosts double 0 - 9999999999999,99. Monatliche Nebenkosten, die zu Ihrer Kaltmiete für Ihr Objekt anfallen, wie z.B. Müllabfuhr, Hausreinigung, Hausmeisterkosten, Hausversicherungskosten,..
Multimedia Anhang "video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung StatusVBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung StatusIS24 eigener Webservice
Objektveröffentlichung StatusHP eigener Webservice
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Zahlungsintervall priceIntervalType enum DAY, WEEK, MONTH, YEAR, ONE_TIME_CHARGE

XML schema: 

<xs:complexType name="SpecialPurpose">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>  
        <!-- Basiselemente -->  
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>  
        <!-- Immobilientyp spezifische Elemente -->  
        <xs:element name="specialPurposePropertyType" type="ns1:SpecialPurposeType"/>
        <xs:element minOccurs="0" name="areaDivisibleFrom" type="xs:double"/>
        <xs:element minOccurs="0" name="plotArea" type="xs:double"/>
        <xs:element minOccurs="0" name="listed" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="lift" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="basement" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="flooringType" type="ns1:FlooringType"/>
        <xs:element minOccurs="0" name="deposit" type="xs:string"/>
        <xs:element name="commercializationType" type="ns1:CommercializationType"/>
        <xs:element name="price" type="ns1:Price"/>
        <xs:element minOccurs="0" name="calculatedPrice" type="ns1:Price"/>
        <xs:element name="totalFloorSpace" type="xs:double"/>
        <xs:element name="netFloorSpace" type="xs:double"/>
        <xs:element minOccurs="0" name="minDivisible" type="xs:double"/>
        <xs:element name="courtage" type="ns1:CourtageInfo"/>
        <xs:element minOccurs="0" name="distanceToMRS" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToFM" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToPT" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToAirport" type="xs:int"/>
        <xs:element minOccurs="0" name="condition" type="ns1:RealEstateCondition"/>
        <xs:element minOccurs="0" name="numberOfParkingSpaces" type="xs:int"/>
        <xs:element minOccurs="0" name="parkingSpacePrice" type="xs:double"/>
        <xs:element minOccurs="0" name="lastRefurbishment" type="xs:int"/>
        <xs:element minOccurs="0" name="interiorQuality" type="ns1:InteriorQuality"/>
        <xs:element minOccurs="0" name="constructionYear" type="xs:int"/>
        <xs:element minOccurs="0" name="freeFrom" type="xs:string"/>
        <xs:element minOccurs="0" name="heatingType" type="ns1:HeatingType"/>
        <xs:element minOccurs="0" name="firingTypes" type="ns1:FiringTypes"/>
        <xs:element minOccurs="0" name="thermalCharacteristic" type="xs:double"/>
        <xs:element minOccurs="0" name="energyConsumptionContainsWarmWater" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="buildingEnergyRatingType" type="ns1:BuildingEnergyRatingType"/>
        <xs:element minOccurs="0" name="additionalArea" type="xs:double"/>
        <xs:element minOccurs="0" name="numberOfFloors" type="xs:string"/>
        <xs:element minOccurs="0" name="additionalCosts" type="ns1:Price"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Sonstige (Miscellaneous)

Anlageimmobilie (investment)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Kaufpreis* value double 0 - 9999999999999,99
Währung* currency enum Euro
Gewerbefläche industrialArea double 0 - 99999999,99
Grundstücksfläche plotArea double 0 - 99999999,99
Vermietbare Fläche* netFloorSpace double 0 - 99999999,99
Anlagetyp* investmentType enum SINGLE_FAMILY_HOUSE (Einfamilienhaus), MULTI_FAMILY_HOUSE (Mehrfamilienhaus), FREEHOLD_FLAT (Eigentumswohnung), SHOPPING_CENTRE (Einkaufszentrum), RESTAURANT (Restaurant), HOTEL (Hotel), LEISURE_FACILITY (Freizeitanlage), COMMERCIAL_UNIT (Gewerbeeinheit), OFFICE_BUILDING (Bürogebäude), COMMERCIAL_BUILDING, COMMERCIAL_PROPERTY, HALL_STORAGE (Halle/Lager), INDUSTRIAL_PROPERTY (Industrieanwesen), SHOP_SALES_FLOOR (Laden/Verkaufsfläche), SERVICE_CENTRE (Servicecenter), OTHER (Sonstige), SUPERMARKET (Supermarkt), LIVING_BUSINESS_HOUSE (Wohn/Geschäftshaus), HOUSING_ESTATE (Wohnanlage)
Provisionspflichtig* hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag* courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Provisionshinweis courtageNote String Max. 500 characters
Gesamtfläche totalFloorSpace double 0 - 99999999,99
Wohnfläche livingSpace double 0 - 99999999,99
Preis pro qm² pricePerSQM price 0 - 9999999999999,99
x-fache Mieteinnahmen priceMultiplier double 0 - 99,9
Mieteinnahmen Ist rentalIncomeActual price 0 - 9999999999999,99
Mieteinnahmen Soll rentalIncomeTarget price 0 - 9999999999999,99
Nicht umlegbare Kosten otherCosts price 0 - 9999999999999,99
Denkmalschutzobjekt listed enum YES, NOT_APPLICABLE
Aufzug lift enum YES, NOT_APPLICABLE
Fahrzeit zum nächsten Bahnhof distanceToMRS int 0-99
Fahrzeit zur nächsten Autobahn distanceToFM int 0-99
Laufzeit zum Öffentl. Personennahverkehr distanceToPT int 0-99
Fahrzeit zum nächsten Flughafen distanceToAirport int 0 - 99
Objektzustand condition enum NO_INFORMATION (keine Angabe), FIRST_TIME_USE (Erstbezug), FIRST_TIME_USE_AFTER_REFURBISHMENT (Erstbezug nach Sanierung), MINT_CONDITION (Neuwertig), REFURBISHED (Saniert), MODERNIZED (Modernisiert), FULLY_RENOVATED (VollstaendigReonviert), WELL_KEPT (Gepflegt), NEED_OF_RENOVATION (Renovierungsbedürftig), NEGOTIABLE (NachVereinbarung), RIPE_FOR_DEMOLITION (Abbruchreif)
Letzte Modernisierung lastRefurbishment String 1000 - 9999
Qualität der Ausstattung interiorQuality enum NO_INFORMANTION (keine Angabe), LUXURY (luxus), SOPHISTICATED (gehoben), NORMAL, SIMPLE (einfach)
Baujahr* constructionYear String 4 Stellen, 0 - 9999
Frei ab freeFrom String Max. 50 characters
Heizungsart heatingType enum NO_INFORMATION (keine Angabe), SELF_CONTAINED_CENTRAL_HEATING (Etagenheizung), STOVE_HEATING (Ofenheizung), CENTRAL_HEATING (Zentralheizung) For using the new enum fields: COMBINED_HEAT_AND_POWER_PLANT (Blockheizkraftwerk), ELECTRIC_HEATING (Elektro-Heizung),DISTRICT_HEATING (Fernwärme),FLOOR_HEATING (Fußbodenheizung), GAS_HEATING (Gas-Heizung), WOOD_PELLET_HEATING (Holz-Pelletheizung), NIGHT_STORAGE_HEATER (Nachtspeicherofen), OIL_HEATING (Öl-Heizung), SOLAR_HEATING (Solar-Heizung), HEAT_PUMP (Wärmepumpe) you'll need the query param "usenewenergysourceenev2014values=true"
Befeuerungsarten firingType enum NO_INFORMANTION (keine Angabe), GEOTHERMAL (Erdwärme), SOLAR_HEATING (Solarheizung), \PELLET_HEATING (Pelletheizung), GAS, OIL (Öl), DISTRICT_HEATING (Fernwärme), ELECTRICITY (Strom), COAL (Kohle)
Energieausweistyp BuildingEnergyRatingType enum NO_INFORMATION (Keine Angabe), ENERGY_REQUIRED (Endenergiebedarf), ENERGY_CONSUMPTION (Energieverbrauchskennwert). Wählen sie den Ausweistyp aus, zu dem Sie einen Kennwert angeben möchten. Ein Energieausweis wird in Endenergiebedarf (bedarfsorientierter Ausweis) und Energieverbrauchskennwert (verbrauchsorientierter Ausweis) unterschieden. Der bedarfsorientierte Energieausweis orientiert sich am errechneten Bedarf des Gebäudes. Der verbrauchsorientierte Ausweis am tatsächlichen Verbrauch der Nutzer. Bitte beachten Sie bei der Angabe des Energieverbrauchskennwert, ob der Warmwasserverbrauch mit eingerechnet ist.
Energieverbrauchskennwert thermalCharacteristic double 0-1999,99. Bitte geben Sie den "Kennwert" (Zahlen) der Immobilie nach dem ausgewählten "Energieausweistyp" in kWh/(m²*a) an.
Energieverbrauch enthält Warmwasser energyConsumptionContainsWarmWater enum YES, NOT_APPLICABLE. Bitte setzen Sie diesen Wert nur dann, wenn Ihr angegebener "Kennwert" ein "Energieverbrauchskennwert" ist und dieser den "Energieverbrauch für Warmwasser" enthält.
Sonstige Fläche additionalArea double 0 - 99999999,99
Anzahl Etagen numberOfFloors int 0 - 999
Betriebskosten additionalCosts price 0 - 9999999999999,99
Multimedia Anhang "video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung StatusVBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung StatusIS24 eigener Webservice
Objektveröffentlichung StatusHP eigener Webservice
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Energieausweis energyPerformanceCertificate boolean true, false
Zahlungsintervall priceIntervalType enum DAY, WEEK, MONTH, YEAR, ONE_TIME_CHARGE

XML schema: 

<xs:complexType name="Investment">
  <xs:complexContent>
   <xs:extension base="tns:RealEstate">
      <xs:sequence>  
        <!-- Basiselemente -->  
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>  
        <!-- Immobilientyp spezifische Elemente -->  
        <xs:element name="price" type="ns1:Price"/>
        <xs:element minOccurs="0" name="industrialArea" type="xs:double"/>
        <xs:element minOccurs="0" name="plotArea" type="xs:double"/>
        <xs:element minOccurs="0" name="netFloorSpace" type="xs:double"/>
        <xs:element name="investmentType" type="ns1:InvestmentType"/>
        <xs:element minOccurs="0" name="energyPerformanceCertificate" type="xs:boolean"/>
        <xs:element name="courtage" type="ns1:CourtageInfo"/>
        <xs:element minOccurs="0" name="totalFloorSpace" type="xs:double"/>
        <xs:element minOccurs="0" name="livingSpace" type="xs:double"/>
        <xs:element minOccurs="0" name="pricePerSQM" type="ns1:Price"/>
        <xs:element minOccurs="0" name="priceMultiplier" type="xs:double"/>
        <xs:element minOccurs="0" name="rentalIncomeActual" type="ns1:Price"/>
        <xs:element minOccurs="0" name="rentalIncomeTarget" type="ns1:Price"/>
        <xs:element minOccurs="0" name="otherCosts" type="ns1:Price"/>
        <xs:element minOccurs="0" name="listed" type="ns1:YesNotApplicableType"/>
        <xs:element default="NOT_APPLICABLE" minOccurs="0" name="lift" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="distanceToMRS" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToFM" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToPT" type="xs:int"/>
        <xs:element minOccurs="0" name="distanceToAirport" type="xs:int"/>
        <xs:element minOccurs="0" name="condition" type="ns1:RealEstateCondition"/>
        <xs:element minOccurs="0" name="numberOfParkingSpaces" type="xs:int"/>
        <xs:element minOccurs="0" name="parkingSpacePrice" type="xs:double"/>
        <xs:element minOccurs="0" name="lastRefurbishment" type="xs:int"/>
        <xs:element minOccurs="0" name="interiorQuality" type="ns1:InteriorQuality"/>
        <xs:element name="constructionYear" type="xs:int"/>
        <xs:element minOccurs="0" name="freeFrom" type="xs:string"/>
        <xs:element minOccurs="0" name="heatingType" type="ns1:HeatingType"/>
        <xs:element minOccurs="0" name="firingTypes" type="ns1:FiringTypes"/>
        <xs:element minOccurs="0" name="thermalCharacteristic" type="xs:double"/>
        (AB VORAUSS. MITTE MAI KEIN PFLICHTFELD MEHR)
        <xs:element minOccurs="0" name="energyConsumptionContainsWarmWater" type="ns1:YesNotApplicableType"/>
        (AB VORAUSS. MITTE MAI KEIN PFLICHTFELD MEHR)
        <xs:element minOccurs="0" name="buildingEnergyRatingType" type="ns1:BuildingEnergyRatingType"/>
        (AB VORAUSS. MITTE MAI KEIN PFLICHTFELD MEHR)
        <xs:element minOccurs="0" name="additionalArea" type="xs:double"/>
        <xs:element minOccurs="0" name="numberOfFloors" type="xs:string"/>
        <xs:element minOccurs="0" name="additionalCosts" type="ns1:Price"/>      
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

WG-Zimmer (FlatShareRoom)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer* externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Zimmerfläche * roomSize double -
Bodenbelag Bodenbelag enum NO_INFORMATION keine Angabe, CONCRETE Beton, EPOXY_RESIN Epoxydharzboden, TILES Fliesen, PLANKS Dielen, LAMINATE Laminat, PARQUET Parkett, PVC, CARPET Teppichboden, ANTISTATIC_FLOOR antistatischer Teppichboden, OFFICE_CARPET stuhlrollenfeste Teppichfliesen, STONE Stein, CUSTOMIZABLE nach Mieterwunsch, WITHOUT ohne Bodenbelag
Anzahl Räume numberOfRooms double Min. 0
Wohnungstyp apartmentType enum ROOF_STOREY Dachgeschoss, LOFT, MAISONETTE Maisonette, PENTHOUSE Penthouse, TERRACED_FLAT Terrassenwohnung, GROUND_FLOOR Erdgeschosswohnung, APARTMENT Etagenwohnung, RAISED_GROUND_FLOOR Hochparterre, HALF_BASEMENT Souterrain, OTHER Sonstige, NO_INFORMATION Keine Angabe (wird zusammen mit OTHER verwendet)
Keller verfügbar cellar enum YES, NO
Benutze heatingTypeEnev2014 Heizungsart heatingType enum NO_INFORMATION Keine Angabe, SELF_CONTAINED_CENTRAL_HEATING Etagenheizung, STOVE_HEATING Ofenheizung, CENTRAL_HEATING Zentralheizung
Heizungsart heatingTypeEnev2014 enum NO_INFORMATION Keine Angabe, SELF_CONTAINED_CENTRAL_HEATING Etagenheizung, STOVE_HEATING Ofenheizung, CENTRAL_HEATING Zentralheizung, COMBINED_HEAT_AND_POWER_PLANT Blockheizkraftwerk, ELECTRIC_HEATING Elektro-Heizung, DISTRICT_HEATING Fernwärmedampf, FLOOR_HEATING Fußbodenheizung, GAS_HEATING Gas-Heizung, WOOD_PELLET_HEATING Holz-Pelletheizung, NIGHT_STORAGE_HEATER Nachtspeicherofen, OIL_HEATING Ölheizung, SOLAR_HEATING Solar-Heizung, HEAT_PUMP Wärmepumpe
Barrierefrei barrierFree enum YES,NO
Provisionselemente * courtage String Max. 1900 characters
Energieausweis energyCertificate - -
Wesentliche Energieträger energySourcesEnev2014 - -
Energieausweistyp buildingEnergyRatingType enum NO_INFORMATION Keine Angabe, ENERGY_REQUIRED Endenergiebedarf, ENERGY_CONSUMPTION Energieverbrauchskennwert
Energieverbrauchskennwert thermalCharacteristic double Min. 0 - Max. 1999.99
Energieverbrauch für Warmwasser enthalten energyConsumptionContainsWarmWater enum YES,NO
Baujahr constructionYear int Min. 0 - Max. 9999
Baujahr ist unbekannt constructionYearUnknown boolean true, false
Kaltmiete * baseRent double Min. 0 - Max. 9999.99
Warmmiete totalRent double Min. 0 - Max. 9999.99
Nebenkosten serviceCharge double Min. 0 - Max. 9999.99
Kaution deposit String Max. 50 characters
Heizungskosten heatingCosts double Min. 0 - Max. 9999.99
Heizkosten in Nebenkosten enthalten heatingCostsInServiceCharge enum Yes,No
Warmmiete calculatedTotalRent double Min. 0 - Max. 9999.99
Berechnungsdetails der Warmmiete calculatedTotalRentScope enum NET_RENT Netto Kaltmiete ohne irgendwelche Betriebskosten, GROSS_RENT Netto Kaltmiete plus Betriebskosten Kalt, INCONSISTENT_WARM_RENT Netto Kaltmiete plus Betriebskosten Kalt und Warm, mit Inkonsistenzen, WARM_RENT Netto Kaltmiete plus Betriebskosten Kalt und Warm
Verfügbar ab freeFrom Date Datum
Verfügbar bis freeUntil Date Datum
Mindest Mietdauer in Monaten minimumTermOfLease int Min. 0
Gesamtfläche totalSpace double Min. 0
Anzahl der männlichen Mitbewohner numberOfMaleFlatMates int Min. 0
Anzahl der weiblichen Mitbewohner numberOfFemaleFlatMates int Min. 0
Alter Mitbewohner von ageOfFlatMatesFrom int Min. 0
Alter Mitbewohner bis ageOfFlatMatesTo int Min. 0
Alter gesuchter Mitbewohner von ageOfRequestedFrom int Min. 0
Alter gesuchter Mitbewohner bis ageOfRequestedTo int Min. 0
Anzahl gesuchter Mitbewohner numberOfRequestedFlatMates int Min. 0
Etage in der sich die WG befindet floor int Min. -1
Anzahl Etagen numberOfFloors int Min. 0
Anzahl Badezimmer numberOfBathRooms int Min. 0
Balkon balcony enum Yes, No
Garten garden enum Yes, No
Aufzug lift enum Yes, No
Backofen oven enum Yes, No
Kühlschrank refrigerator enum Yes, No
Herd stove enum Yes, No
Spülmaschine dishwasher enum Yes, No
Waschmaschine washingMachine enum Yes, No
Bad enthält ein Klo bathHasWc enum Yes, No
Bad enthält eine Dusche bathHasShower enum Yes, No
Bad enthält eine Badewanne bathHasTub enum Yes, No
Gästeklo guestToilet enum Yes, No
Haustiere erlaubt * petsAllowed enum NO_INFORMATION Keine Angabe, NEGOTIABLE Nach Vereinbarung, YES Ja, NO Nein
Art des Internetanschlusses * internetConnection enum NO_INFORMATION, DSL, DSL_FLATRATE
Rauchen erlaubt * smokingAllowed enum NO_INFORMATION, ALLOWED Erlaubt, UNWANTED Unerwünscht, OWN_ROOM_ONLY Nur im eigenem Zimmer
Geschlecht des gesuchten Mitbewohners * requestedGender enum MALE_OR_FEMALE Männlich oder weiblich, MALE Männlich, FEMALE Weiblich,
Art der Möblierung * furnishing enum Yes, No
Art des Fernsehanschlusses * tvConnection enum NO_INFORMATION Keine Angabe, CABLE Kabel, SATELLITE Satellit, CABLE_AND_SATELLITE Kabel und Satellit
Art des Telefonanschlusses * telephoneConnection enum NO_INFORMATION Keine Angabe, ANALOG Analog, ISDN, NOT_AVAILABLE nicht verfügbar,
Parktplatzsituation * parkingSituation enum NO_INFORMATION Keine Angabe, GOOD Gut, BAD schlecht, RESIDENT_PARKING Anwohnerparkplatz verfügbar, OWN_PARKING_SPACE eigener Parkplatz verfügbar
WG-Größe. (11 bedeuted alle WGs die größer als 10 sind!) * flatShareSize int Min. 2 - Max. 11

XML schema: 

<xs:complexType name="FlatShareRoom">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>
        <!--ExtendedFlatShareRoom-->
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>
        <xs:element name="roomSize" type="xs:double"/>
        <xs:element name="Bodenbelag" type="FlooringType" minOccurs="0"/>
        <xs:element name="numberOfRooms" type="xs:double" minOccurs="0"/>
        <xs:element name="apartmentType" type="ApartmentType" minOccurs="0"/>
        <xs:element name="cellar" type="YesNotApplicableType" minOccurs="0"/>
        <xs:element name="heatingType" type="HeatingType" minOccurs="0"/>
        <xs:element name="heatingTypeEnev2014" type="HeatingTypeEnev2014" minOccurs="0"/>
        <xs:element name="barrierFree" type="YesNotApplicableType" minOccurs="0"/>
        <xs:element name="courtage" type="CourtageInfo" minOccurs="1" />
        <xs:element name="energyCertificate" type="EnergyPerformanceCertificate" minOccurs="0"/>
        <xs:element name="energySourcesEnev2014" type="" minOccurs="0"/>
        <xs:element name="buildingEnergyRatingType" type="BuildingEnergyRatingType" minOccurs="0"/>
        <xs:element name="thermalCharacteristic" minOccurs="0"/>
        <xs:element name="energyConsumptionContainsWarmWater" type="YesNotApplicableType" minOccurs="0"/>
        <xs:element name="constructionYear" minOccurs="0"/>
        <xs:element name="constructionYearUnknown" type="xs:boolean" minOccurs="0"/>
        <!--BaseLivingRent-->
        <xs:element name="baseRent" type="xs:double"/>
        <xs:element name="totalRent" type="xs:double" minOccurs="0"/>
        <xs:element name="serviceCharge" type="xs:double" minOccurs="0"/>
        <xs:element name="deposit" type="depositField" minOccurs="0"/>
        <xs:element name="heatingCosts" type="xs:double" minOccurs="0"/>
        <xs:element name="heatingCostsInServiceCharge" type="YesNoNotApplicableType" minOccurs="0"/>
        <xs:element name="calculatedTotalRent" type="xs:double" minOccurs="0"/>
        <xs:element name="calculatedTotalRentScope" type="RentScopeType" minOccurs="0"/>
        <!--FlatShareAdditionalInformation-->
        <xs:element name="freeFrom" type="xs:date" minOccurs="0"/>
        <xs:element name="freeUntil" type="xs:date" minOccurs="0"/>
        <xs:element name="minimumTermOfLease" type="xs:int" minOccurs="0"/>
        <xs:element name="totalSpace" type="xs:double" minOccurs="0"/>
        <xs:element name="numberOfMaleFlatMates" type="xs:int" minOccurs="0"/>
        <xs:element name="numberOfFemaleFlatMates" type="xs:int" minOccurs="0"/>
        <xs:element name="ageOfFlatMatesFrom" type="xs:int" minOccurs="0"/>
        <xs:element name="ageOfFlatMatesTo" type="xs:int" minOccurs="0"/>
        <xs:element name="ageOfRequestedFrom" type="xs:int" minOccurs="0"/>
        <xs:element name="ageOfRequestedTo" type="xs:int" minOccurs="0"/>
        <xs:element name="numberOfRequestedFlatMates" type="xs:int" minOccurs="0"/>
        <xs:element name="floor" minOccurs="0"/>
        <xs:element name="numberOfFloors" type="xs:int" minOccurs="0"/>
        <xs:element name="numberOfBathRooms" type="xs:int" minOccurs="0"/>
        <xs:element name="balcony" type="YesNotApplicableType" minOccurs="0"/>
        <xs:element name="garden" type="YesNotApplicableType" minOccurs="0"/>
        <xs:element name="lift" type="YesNotApplicableType" minOccurs="0"/>
        <xs:element name="oven" type="YesNotApplicableType" minOccurs="0"/>
        <xs:element name="refrigerator" type="YesNotApplicableType" minOccurs="0"/>
        <xs:element name="stove" type="YesNotApplicableType" minOccurs="0"/>
        <xs:element name="dishwasher" type="YesNotApplicableType" minOccurs="0"/>
        <xs:element name="washingMachine" type="YesNotApplicableType" minOccurs="0"/>
        <xs:element name="bathHasWc" type="YesNotApplicableType" minOccurs="0"/>
        <xs:element name="bathHasShower" type="YesNotApplicableType" minOccurs="0"/>
        <xs:element name="bathHasTub" type="YesNotApplicableType" minOccurs="0"/>
        <xs:element name="guestToilet" type="YesNotApplicableType" minOccurs="0"/>
        <xs:element name="petsAllowed" type="PetsAllowedType"/>
        <xs:element name="internetConnection" type="InternetConnectionType"/>
        <xs:element name="smokingAllowed" type="SmokingAllowedType"/>
        <xs:element name="requestedGender" type="FlatMateGenderType"/>
        <xs:element name="furnishing" type="YesNoNotApplicableType"/>
        <xs:element name="tvConnection" type="TvConnectionType"/>
        <xs:element name="telephoneConnection" type="TelephoneConnectionType"/>
        <xs:element name="parkingSituation" type="ParkingSituationType"/>
        <xs:element name="flatShareSize" type="FlatShareSearchSize"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Typenhaus (houseType)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Kaufpreis* value double 0 - 9999999999999,99
Währung* currency enum Euro
Vermarktungsart* marketingType enum PURCHASE, PURCHASE_PER_SQM, RENT, RENT_PER_SQM, LEASE, LEASEHOLD, BUDGET_RENT, RENT_AND_BUY
Zahlungsintervall* priceIntervalType enum DAY, WEEK, MONTH, YEAR, ONE_TIME_CHARGE
Wohnfläche* livingSpace double 0 - 99999999,99
Gesamtfläche totalArea double 0 - 99999999,99
Anzahl der Zimmer numberofRooms double 1 - 999,99
Provisionspflichtig* hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag* courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Provisionshinweis courtageNote String Max. 500 characters
Bauweise constructionMethod enum UNSPECIFIED (nicht geneuer genannt), PREFABRICATED (vorgefertigt), WOOD_PREFABRICATED (Holzvorgefertigt), SOLID (solide), SOLID_PREFABRICATED (solide vorgefertigt)
Haustyp* buildingType enum NO_INFORMATION (keine Angabe), BLOCKHOUSE (Blockhaus), BUNGALOW (Bungalow), SEMI_DETACHED_HOUSE (Doppelhaushälfte), ONE_FAMILY_HOUSE (Einfamilienhaus), FAMILY_HOUSE_WITH_LODGER_FLAT (Einfamilienhaus mit Einliegerwohnung), TUDOR_HOUSE (), WOODEN_HOUSE (Holzhaus), COUNTRY_HOUSE (Landhaus), APARTMENT_BUILDING (Mehrfamilienhaus), NON_DETACHED_HOUSE, CITY_VILLA (Stadtvilla), VILLA (Villa), SEMI_DETACHED_HOUSE_PAIR (Reihenhaus)
Ausbaustufe stageOfCompletionType enum UNSPECIFIED (nicht genauer genannt), CONSTRUCTIONKIT (Bausatzhaus), UPGRADING (Ausbauhaus), TURNKEYWITHCELLAR (SchluesselfertigMitKeller), TURNKEYWITHOUTFLOORSLAP (SchluesselfertigOhneBodenplatte), TURNKEYWITHFLOORSLAP (SchluesselfertigMitBodenplatte)
Energiestandard energyStandardType enum UNSPECIFIED (KeineAngabe), LOW_ENERGY_40 (NiedrigenergiehausKfW40), LOW_ENERGY_60 (NiedriegenergiehausKfW60), PASSIVE_HOUSE (Passivhaus), ENERGY_EFFICIENT_40, ENERGY_EFFICIENT_55, ENERGY_EFFICIENT_70, LOW_ENERGY_HOUSE, NULL_ENERGY_HOUSE, PLUS_ENERGY_HOUSE
U-Wert uValue double 0 - 9,99
Haustypinfo typeInformationNote String Max. 2000 Zeichen
Baureihe modelInformationNote String Max. 2000 Zeichen
Preis Pro Bauleistung constructionPriceInformationNote String Max. 2000 Zeichen
Wohngeschossinfo floorInformationNote String Max. 2000 Zeichen
Dachform roofInformationNote String Max. 2000 Zeichen
Multimedia Anhang "video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung StatusVBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung StatusIS24 eigener Webservice
Objektveröffentlichung StatusHP eigener Webservice
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert

XML schema: 

<xs:complexType name="HouseType">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>  
        <!-- Basiselemente -->  
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>  
        <!-- Immobilientyp spezifische Elemente -->  
        <xs:element name="price" type="ns1:Price"/>
        <xs:element name="livingSpace" type="xs:double"/>
        <xs:element minOccurs="0" name="totalArea" type="xs:double"/>
        <xs:element minOccurs="0" name="baseArea" type="xs:double"/>
        <xs:element minOccurs="0" name="numberOfRooms" type="xs:double"/>
        <xs:element name="courtage" type="ns1:CourtageInfo"/>
        <xs:element minOccurs="0" name="constructionMethod" type="ns1:HouseTypeConstructionMethodType"/>
        <xs:element name="buildingType" type="ns1:HouseTypeBuildingType"/>
        <xs:element minOccurs="0" name="stageOfCompletionType" type="ns1:HouseTypeStageOfCompletionType"/>
        <xs:element minOccurs="0" name="energyStandardType" type="ns1:HouseTypeEnergyStandardType"/>
        <xs:element minOccurs="0" name="uValue" type="xs:double"/>
        <xs:element minOccurs="0" name="typeInformationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="modelInformationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="contructionPriceInformationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="floorInformationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="roofInformationNote" type="xs:string"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Zwangsversteigerung (compulsoryAuction)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Marktpreis* marketValue price 0 - 9999999999999,99
Mindestgebot lowestBid price 0 - 9999999999999,99 [Achtung: Dies ist ein reiner "read only" Wert (Lesefeld) d.h. ein etwaig übermittelter Wert wird beim anlegen/ editieren ignoriert! Wir geben immer 50% vom Marktpreises aus.]
Wiederholungstermin recurrenceAppointment boolean true,false
Versteigerungstermin* dateOfAuction date jjjj-mm-tt
Datum der letzten Änderung lastChangeDate date jjjj-mm-tt
Aufhebungsdatum cancellationDate date jjjj-mm-tt
Erfassungsdatum recordationDate date jjjj-mm-tt
Fläche* area double 0-99999999,99
Objekttyp* auctionObjectType enum FREEHOLD_FLAT (Eigentumswohnung), FAMILY_HOUSE (Ein/Mehrfamilienhaus), BUSINESS_AND_YIELD (Gewerbe/Anlage), LOT (Grundstueck), GARAGE_AND_OTHER (Garage/Sonstige)
Amtsgericht countyCourt String -
Aktenzeichen fileReferenceAtCountyCourt String -
Grundbuchsblatt-Nummer number of folio String -
Teilversteigerung splittingAuction boolean true, false
Eigentümer owner String -
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Energieausweis energyPerformanceCertificate boolean true, false
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Vermarktungsart marketingType enum PURCHASE, PURCHASE_PER_SQM, RENT, RENT_PER_SQM, LEASE, LEASEHOLD, BUDGET_RENT, RENT_AND_BUY
Zahlungsintervall priceIntervalType enum DAY, WEEK, MONTH, YEAR, ONE_TIME_CHARGE

XML schema: 

<xs:complexType name="CompulsoryAuction">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>      
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>      
        <xs:element name="marketValue" type="ns1:Price"/>
        <xs:element minOccurs="0" name="lowestBid" type="ns1:Price"/>
        <xs:element default="false" minOccurs="0" name="recurrenceAppointment" type="xs:boolean"/>
        <xs:element name="dateOfAuction" type="xs:date"/>
        <xs:element minOccurs="0" name="lastChangeDate" type="xs:date"/>
        <xs:element minOccurs="0" name="cancellationDate" type="xs:date"/>
        <xs:element name="recordationDate" type="xs:date"/>
        <xs:element name="area" type="xs:double"/>
        <xs:element name="auctionObjectType" type="ns1:CompulsoryAuctionType"/>
        <xs:element name="countyCourt" type="ns1:CountyCourt"/>
        <xs:element name="fileReferenceAtCountyCourt" type="xs:string"/>
        <xs:element name="numberOfFolio" type="xs:string"/>
        <xs:element default="false" minOccurs="0" name="splittingAuction" type="xs:boolean"/>
        <xs:element name="owner" type="xs:string"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Betreutes Wohnen (assistedLiving)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kurzbeschreibung shortDescription String Max. 260 Zeichen
Haustiere* petsAllowed enum NO_INFORMATION, YES, NO, NEGOTIABLE
Probewohnen möglich* trialLivingPossible enum YES, NOT_APPLICABLE
Vermarktungsart* marketingType enum PURCHASE, RENT, RENT_AND_BUY
Einrichtungstyp* facilityType enum ASSISTED_LIVING, RESIDENCE, SENIOR_PARK
Mietpreis ab* minBaseRent double 0 - 9999999999999,99
Kaufpreis ab minPurchasePrice double 0 - 9999999999999,99
Baujahr constructionYear String 0 - 9999
Zimmer von... roomAvailableFrom double 0 - 99
Zimmer bis... roomAvailableTo double 0 - 99
eigene Kochmöglichkeit cookingPossibility enum YES, NOT_APPLICABLE
Parkmöglichkeit parkingAvailable enum YES, NOT_APPLICABLE
Gemeinschaftsräume vorhanden commonRoomsAvailable enum YES, NOT_APPLICABLE
Garten gardenAvailable enum YES, NOT_APPLICABLE
Fittnessraum fitnessAvailable enum YES, NOT_APPLICABLE
Schwimmbad poolAvailable enum YES, NOT_APPLICABLE
öffentl. Verkehrsmittel fußläufig erreichbar publicTransportationAvailable enum YES, NOT_APPLICABLE
Ambulanter Pflegedienst ambulantNursingServiceAvailable enum YES, NOT_APPLICABLE
Bewohnernotruf im Zimmer emergencyCallInRoomAvailable enum YES, NOT_APPLICABLE
Durchgehend besetzter Empfang receptionManned enum YES, NOT_APPLICABLE
Medizinische Betreuung vor Ort medicalAssistanceAvailable enum YES, NOT_APPLICABLE
Haushaltshilfen homeHelpAvailable enum YES, NOT_APPLICABLE
Seelsorgische Betreuung counselingAvailable enum YES, NOT_APPLICABLE
Wohndarlehen loansAvailable enum YES, NOT_APPLICABLE
Barrierefrei barrierFree enum YES, NOT_APPLICABLE
Anzahl Wohnungen / Apartments numberOfLookedAfterApartments int 0 - 9999
Anzahl Pflegeplätze numberOfNursingPlaces int 0 - 9999
Wohnfläche von ... livingSpaceFrom double 0 - 99999,9
Wohnfläche bis ... livingSpaceTo double 0 - 99999,9
Behindertengerecht handicappedAccessible enum YES, NOT_APPLICABLE
Gästeappartments guestApartmentsAvailable enum YES, NOT_APPLICABLE
Restaurant restaurantAvailable enum YES, NOT_APPLICABLE
Mitnahme eigener Möbel möglich ownFurniturePossible enum YES, NOT_APPLICABLE
Reinigungsservice cleaningServiceAvailable enum YES, NOT_APPLICABLE
Einkaufsmöglichkeiten shoppingFacilitiesAvailable enum YES, NOT_APPLICABLE
24 h Sicherheit security24Hours enum YES, NOT_APPLICABLE
Kulturangebot culturalProgramAvailable enum YES, NOT_APPLICABLE
Freizeitaktivitäten leisureActivitiesAvailable enum YES, NOT_APPLICABLE
Religiöse Angebote religiousOfferingsAvailable enum YES, NOT_APPLICABLE
Balkon balconyAvailable enum YES, NOT_APPLICABLE
Multimedia Anhang "video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung StatusVBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung StatusIS24 eigener Webservice
Objektveröffentlichung StatusHP eigener Webservice

XML schema: 

<xs:complexType name="AssistedLiving">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>  
        <!-- Basiselemente -->  
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>
        <!-- Immobilientyp spezifische Elemente -->  
        <xs:element minOccurs="0" name="shortDescription" type="xs:string"/>
        <xs:element name="petsAllowed" type="ns1:PetsAllowedType"/>
        <xs:element name="trialLivingPossible" type="ns1:YesNotApplicableType"/>
        <xs:element name="marketingType" type="ns1:MarketingType"/>
        <xs:element name="facilityType" type="ns1:FacilityType"/>
        <xs:element minOccurs="0" name="minBaseRent" type="ns1:Price"/>
        <xs:element minOccurs="0" name="minPurchasePrice" type="ns1:Price"/>
        <xs:element minOccurs="0" name="constructionYear" type="xs:int"/>
        <xs:element minOccurs="0" name="roomAvailableFrom" type="xs:double"/>
        <xs:element minOccurs="0" name="roomAvailableTo" type="xs:double"/>
        <xs:element minOccurs="0" name="cookingPossibilty" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="parkingAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="commonRoomsAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="gardenAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="fitnessAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="poolAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="publicTransportationAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="ambulantNursingServiceAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="emergencyCallInRoomAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="receptionManned" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="medicalAssistanceAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="homeHelpAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="counselingAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="loansAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="numberOfRoomsFrom" type="xs:decimal"/>
        <xs:element minOccurs="0" name="numberOfRoomsTo" type="xs:decimal"/>
        <xs:element minOccurs="0" name="barrierFree" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="numberOfLookedAfterApartments" type="xs:int"/>
        <xs:element minOccurs="0" name="numberOfNursingPlaces" type="xs:int"/>
        <xs:element minOccurs="0" name="livingSpaceFrom" type="xs:double"/>
        <xs:element minOccurs="0" name="livingSpaceTo" type="xs:double"/>
        <xs:element minOccurs="0" name="handicappedAccessible" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="guestApartmentsAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="restaurantAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="ownFurniturePossible" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="cleaningServiceAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="shoppingFacilitiesAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="security24Hours" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="culturalProgramAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="leisureActivitiesAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="religiousOfferingsAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="balconyAvailable" type="ns1:BalconyAvailableType"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Altenpflegeeinrichtungen (seniorCare)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kurzbeschreibung shortDescription String Max. 260 Zeichen
Haustiere* petsAllowed enum NO_INFORMATION, YES, NO, NEGOTIABLE
Probewohnen möglich* trialLivingPossible enum YES, NOT_APPLICABLE
Pflegeplatztyp* careTypes enum STATIONARY_CARE (Vollstationäre Pflege), DAY_CARE (Tagespflege), SHORT_TERM_CARE (Kurzzeitpflege), RESPITE_CARE (Verhinderungspflege)
Pflegestufe* careLevel enum CARE_LEVEL_1 (Pflegestufe 1), CARE_LEVEL_2 (Pflegestufe 2), CARE_LEVEL_3 (Pflegestufe 3), CARE_LEVEL_1_AND_2 (Pflegestufe 1 und 2), CARE_LEVEL_2_AND_3 (Pflegestufe 2 und 3), ALL (Alle Pflegestufen)
Preis price double 0 - 9999999999999,99
Anzahl Betten numberOfBeds int 0 - 9999
Eröffnung / Bezug opening date jjjj-mm-tt
Pflege Demenzkranker careOfDementia enum YES, NOT_APPLICABLE
Pflege Beatmungspflichtiger Menschen careOfArtificialRespiration enum YES, NOT_APPLICABLE
Pflege von Wachkomapatienten careOfComaVigil enum YES, NOT_APPLICABLE
Pflege von Schlaganfallpatienten careOfStroke enum YES, NOT_APPLICABLE
Pflege Pakinsonsche Krankheit careOfParkinson enum YES, NOT_APPLICABLE
Pflege von Alzheimerpatienten careOfAlzheimer enum YES, NOT_APPLICABLE
Pflege Multiple Sklerose Patienten careOfMultipleSclerosis enum YES, NOT_APPLICABLE
Küche vorhanden (in Gästeapartments) kitchenAvailable enum YES, NOT_APPLICABLE
Zimmer roomType enum SINGLE (Einzelzimmer), SHARED (Mehrbettzimmer), SINGLE_AND_SHARED (Einzel- und Mehrbettzimmer)
Therapieangebot therapyOfferingsAvailable enum YES, NOT_APPLICABLE
Barrierefrei barrierFree enum YES, NOT_APPLICABLE
Anzahl betreute Wohnungen numberOfLookedAfterApartments int 0 - 9999
Anzahl Pflegeplätze numberOfNursingPlaces int 0 - 9999
Wohnfläche von ... livingSpaceFrom double 0 - 99999,9
Wohnfläche bis ... livingSpaceTo double 0 - 99999,9
Behindertengerecht handicappedAccessible enum YES, NOT_APPLICABLE
Gästeappartments guestApartmentsAvailable enum YES, NOT_APPLICABLE
Restaurant restaurantAvailable enum YES, NOT_APPLICABLE
Eigene Kochmöglichkeit cookingFacilitiesAvailable enum YES, NOT_APPLICABLE
Mitnahme eigener Möbel möglich ownFurniturePossible enum YES, NOT_APPLICABLE
Reinigungsservice cleaningServiceAvailable enum YES, NOT_APPLICABLE
Einkaufsmöglichkeiten shoppingFacilitiesAvailable enum YES, NOT_APPLICABLE
24 h Sicherheit security24Hours enum YES, NOT_APPLICABLE
Kulturprogramm culturalProgramAvailable enum YES, NOT_APPLICABLE
Freizeitaktivitäten leisureActivitiesAvailable enum YES, NOT_APPLICABLE
Religiöse Angebote religiousOfferingsAvailable enum YES, NOT_APPLICABLE
Balkon balconyAvailable enum YES, NOT_APPLICABLE
Multimedia Anhang "video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung StatusVBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung StatusIS24 eigener Webservice
Objektveröffentlichung StatusHP eigener Webservice

XML schema: 

<xs:complexType name="SeniorCare">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>  
        <!-- Basiselemente -->  
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>  
        <!-- Immobilientyp spezifische Elemente -->  
        <xs:element minOccurs="0" name="shortDescription" type="xs:string"/>
        <xs:element name="petsAllowed" type="ns1:PetsAllowedType"/>
        <xs:element name="trialLivingPossible" type="ns1:YesNotApplicableType"/>
        <xs:element name="careTypes" type="ns1:CareTypes"/>
        <xs:element name="careLevel" type="ns1:CareLevelExpose"/>
        <xs:element minOccurs="0" name="price" type="ns1:Price"/>
        <xs:element minOccurs="0" name="numberOfBeds" type="xs:int"/>
        <xs:element minOccurs="0" name="opening" type="xs:date"/>
        <xs:element minOccurs="0" name="careOfDementia" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="careOfArtificialRespiration" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="careOfComaVigil" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="careOfStroke" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="careOfParkinson" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="careOfAlzheimer" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="careOfMultipleSclerosis" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="kitchenAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="roomType" type="ns1:RoomType"/>
        <xs:element minOccurs="0" name="therapyOfferingsAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="barrierFree" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="numberOfLookedAfterApartments" type="xs:int"/>
        <xs:element minOccurs="0" name="numberOfNursingPlaces" type="xs:int"/>
        <xs:element minOccurs="0" name="livingSpaceFrom" type="xs:double"/>
        <xs:element minOccurs="0" name="livingSpaceTo" type="xs:double"/>
        <xs:element minOccurs="0" name="handicappedAccessible" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="guestApartmentsAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="restaurantAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="cookingFacilitiesAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="ownFurniturePossible" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="cleaningServiceAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="shoppingFacilitiesAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="security24Hours" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="culturalProgramAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="leisureActivitiesAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="religiousOfferingsAvailable" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="balconyAvailable" type="ns1:BalconyAvailableType"/>  
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>

Wohnen auf Zeit (shortTermAccomodation)

Description Field Name Field Type Allowed Values
Anbieterobjektnummer externalId String 50 characters. "/" and "\" are allowed
Exposeüberschrift* title String Max. 100 characters
Straße* street String Max. 100 characters
Hausnummer* houseNumber String Max. 10 characters
PLZ* postcode String Max. 5 characters
Ort* city String Max. 50 characters
API-Suche-Felder searchField1, 2, 3 String Diese Felder können in der Suche-REST-API als Suchefilter verwendet werden. Somit kann man selber Werte definieren, die in der Objekterfassung nicht als Feld vorhanden sind. Erlaubte Werte: 1-16 characters. Erlaubte Werte: [0-9 a-z A-Z]*
Objektgruppierung groupNumber int Max. 10 characters, 0 - 2147483647
Objektbeschreibung descriptionNote String Max. 3.999 characters
Ausstattung furnishingNote String Max. 3.999 characters
Lage locationNote String Max. 3.999 characters
Sonstige Angaben otherNote String Max. 3.999 characters
Objektadresse veröffentlichen? * showAddress boolean true,false
Kontaktperson contact id String Please add a reference to a contact person (contactID). Use the contact endpoint to create, read, update, or delete a contact resource. If this field is left empty, then we will use the default contact address.
Kontaktperson Anrede - String
Kontaktperson Nachname - String
Kaltmiete baseRent double 0 - 9999999999999,99
Keller cellar enum YES, NOT_APPLICABLE (keine Angabe)
Objektzustand condition enum NO_INFORMATION (keine Angabe), FIRST_TIME_USE (Erstbezug), FIRST_TIME_USE_AFTER_REFURBISHMENT (Erstbezug nach Sanierung), MINT_CONDITION (Neuwertig), REFURBISHED (Saniert), MODERNIZED (Modernisiert), FULLY_RENOVATED (VollstaendigReonviert), WELL_KEPT (Gepflegt), NEED_OF_RENOVATION (Renovierungsbedürftig), NEGOTIABLE (NachVereinbarung), RIPE_FOR_DEMOLITION (Abbruchreif)
Kaution deposit String max. 50 characters
Frei ab* startRentalDate date jjjj-mm-tt
Frei Bis endRentalDate date jjjj-mm-tt
Energieausweistyp BuildingEnergyRatingType enum NO_INFORMATION (Keine Angabe), ENERGY_REQUIRED (Endenergiebedarf), ENERGY_CONSUMPTION (Energieverbrauchskennwert). Wählen sie den Ausweistyp aus, zu dem Sie einen Kennwert angeben möchten. Ein Energieausweis wird in Endenergiebedarf (bedarfsorientierter Ausweis) und Energieverbrauchskennwert (verbrauchsorientierter Ausweis) unterschieden. Der bedarfsorientierte Energieausweis orientiert sich am errechneten Bedarf des Gebäudes. Der verbrauchsorientierte Ausweis am tatsächlichen Verbrauch der Nutzer. Bitte beachten Sie bei der Angabe des Energieverbrauchskennwert, ob der Warmwasserverbrauch mit eingerechnet ist.
Energieverbrauchskennwert thermalCharacteristic double 0-1999,99. Bitte geben Sie den "Kennwert" (Zahlen) der Immobilie nach dem ausgewählten "Energieausweistyp" in kWh/(m²*a) an.
Energieverbrauch enthält Warmwasser energyConsumptionContainsWarmWater enum YES, NOT_APPLICABLE. Bitte setzen Sie diesen Wert nur dann, wenn Ihr angegebener "Kennwert" ein "Energieverbrauchskennwert" ist und dieser den "Energieverbrauch für Warmwasser" enthält.
Befeuerungsarten firingType enum NO_INFORMANTION (keine Angabe), GEOTHERMAL (Erdwärme), SOLAR_HEATING (Solarheizung), \PELLET_HEATING (Pelletheizung), GAS, OIL (Öl), DISTRICT_HEATING (Fernwärme), ELECTRICITY (Strom), COAL (Kohle)
Etage floor int 1 - 999
Geschlecht gender enum MALE_OR_FEMALE, MALE, FEMALE
GästeWC guestToilet boolean true, false
Barrierefrei handicappedAccessible boolean true, false
Möbiliert hasFurniture enum YES, NO, NOT_APPLICABLE
Heizungsart heatingType enum NO_INFORMATION (keine Angabe), SELF_CONTAINED_CENTRAL_HEATING (Etagenheizung), STOVE_HEATING (Ofenheizung), CENTRAL_HEATING (Zentralheizung) For using the new enum fields: COMBINED_HEAT_AND_POWER_PLANT (Blockheizkraftwerk), ELECTRIC_HEATING (Elektro-Heizung),DISTRICT_HEATING (Fernwärme),FLOOR_HEATING (Fußbodenheizung), GAS_HEATING (Gas-Heizung), WOOD_PELLET_HEATING (Holz-Pelletheizung), NIGHT_STORAGE_HEATER (Nachtspeicherofen), OIL_HEATING (Öl-Heizung), SOLAR_HEATING (Solar-Heizung), HEAT_PUMP (Wärmepumpe) you'll need the query param "usenewenergysourceenev2014values=true"
Aufzug lift boolean true, false
Maximale Anzahl an Personen maxNumberOfPersons int 0 - 999
Maximale Mietdauer maxRentalTime double 0 - 999,99
Mindest Mietdauer minRentalTime double 0 - 999,99
Anzahl Etagen numberOfFloors int 0 - 999
Anzahl Garagen/ Stellplätze numberOfParkingSpaces int 0 - 99999
Garage/ Stellplatz-Miete ParkingSpacePrice double 0 - 9999999999999,99
Haustiere petsAllowed enum NO_INFORMATION, YES, NO, NEGOTIABLE
Nebenkosten serviceCharge double 0 - 9999999999999,99
Pauschalmiete totalRent double 0 - 9999999999999,99
Preis* price price 0 - 9999999999999,99
Wohnfläche livingSpace double 0 - 9999999999999,99
Zimmerzahl numberOfRooms double 1-999,99
Balkon balcony boolean true, false
Garten garten boolean true, false
Nicht-Raucher nonSmoker boolean true, false
Gebäudeart* shortTermAccomodationType enum APARTMENT, ROOM, HOUSE, FLAT
Provisionspflichtig* hasCourtage enum YES,NO,NOT_APPLICABLE
Provisionsbetrag courtage String max. 100 characters. Only mandatory, if hasCourtage=true
Provisionshinweis courtageNote String Max. 500 characters
Multimedia Anhang "video" - In der REST-API sind die Multimediadateien losgelöst von der Immobilie. Die Immobilie enthält lediglich einen Verweis (ID) auf die Multimediaanhänge. Nutze den Attachments-Webservice (http://api.immobilienscout24.de/api-docs/import-export/Attachment/overview/) für das Anlegen/Ändern/Aufrufen/Löschen von Bilder, Videos, PDF, URLs.
Multimedia Anhang "bild" - same as video
Objektveröffentlichung StatusVBM entfaelt In der REST-API gibt es einen eigenen Webservice (http://api.immobilienscout24.de/api-docs/import-export/publish/overview/) für die Objektveröffentlichung auf den Kanälen IS24, Homepage, Gruppen/Börsen.
Objektveröffentlichung StatusIS24 eigener Webservice
Objektveröffentlichung StatusHP eigener Webservice
Expose-Erstellungsdatum creationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Expose-Änderungsdatum LastModificationDate Datum jjjj-mm-tt:hh:mm:ss wird automatisch generiert
Geokoordinaten latitude double min. -90.0, max. 90.0
Geokoordinaten longitude double min. -90.0, max. 90.0
Vermarktungsart MarketingType enum RENT
Zahlungsintervall priceIntervalType enum DAY, WEEK, MONTH

XML schema: 

<xs:complexType name="ShortTermAccommodation">
  <xs:complexContent>
    <xs:extension base="tns:RealEstate">
      <xs:sequence>  
        <!-- Basiselemente -->  
        <xs:element minOccurs="0" name="externalId" type="xs:string"/>
        <xs:element name="title" type="xs:string"/>
        <xs:element minOccurs="0" name="creationDate" type="xs:dateTime"/>
        <xs:element minOccurs="0" name="lastModificationDate" type="xs:dateTime"/>
        <xs:element name="address" type="tns:Wgs84Address"/>
        <xs:element minOccurs="0" name="apiSearchData" type="tns:ApiSearchData"/>
        <xs:element minOccurs="0" name="groupNumber" type="xs:string"/>
        <xs:element minOccurs="0" name="descriptionNote" type="xs:string"/>
        <xs:element minOccurs="0" name="furnishingNote" type="xs:string"/>
        <xs:element minOccurs="0" name="locationNote" type="xs:string"/>
        <xs:element minOccurs="0" name="otherNote" type="xs:string"/>
        <xs:element default="false" name="showAddress" type="xs:boolean"/>  
        <!-- Immobilientyp spezifische Elemente -->  
        <xs:element minOccurs="0" name="baseRent" type="xs:double"/>
        <xs:element minOccurs="0" name="buildingEnergyRatingType" type="ns1:BuildingEnergyRatingType"/>
        <xs:element name="cellar" type="xs:boolean"/>
        <xs:element minOccurs="0" name="companyName" type="xs:string"/>
        <xs:element minOccurs="0" name="condition" type="ns1:RealEstateCondition"/>
        <xs:element minOccurs="0" name="deposit" type="xs:string"/>
        <xs:element name="endRentalDate" type="xs:date"/>
        <xs:element name="energyConsumptionContainsWarmWater" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="firingTypes" type="ns1:FiringTypes"/>
        <xs:element minOccurs="0" name="floor" type="xs:string"/>
        <xs:element minOccurs="0" name="gender" type="ns1:FlatMateGenderType"/>
        <xs:element name="guestToilet" type="xs:boolean"/>
        <xs:element name="handicappedAccessible" type="xs:boolean"/>
        <xs:element minOccurs="0" name="hasFurniture" type="ns1:YesNotApplicableType"/>
        <xs:element minOccurs="0" name="heatingType" type="ns1:HeatingType"/>
        <xs:element name="lift" type="xs:boolean"/>
        <xs:element minOccurs="0" name="maxNumberOfPersons" type="xs:int"/>
        <xs:element minOccurs="0" name="maxRentalTime" type="xs:double"/>
        <xs:element minOccurs="0" name="minRentalTime" type="xs:double"/>
        <xs:element minOccurs="0" name="numberOfFloors" type="xs:int"/>
        <xs:element minOccurs="0" name="numberOfParkingSpaces" type="xs:int"/>
        <xs:element minOccurs="0" name="parkingSpacePrice" type="xs:double"/>
        <xs:element minOccurs="0" name="parkingSpaceType" type="ns1:ParkingSpaceType"/>
        <xs:element minOccurs="0" name="petsAllowed" type="ns1:PetsAllowedType"/>
        <xs:element minOccurs="0" name="serviceCharge" type="xs:double"/>
        <xs:element minOccurs="0" name="thermalCharacteristic" type="xs:double"/>
        <xs:element minOccurs="0" name="totalRent" type="xs:double"/>
        <xs:element name="price" type="ns1:Price"/>
        <xs:element minOccurs="0" name="livingSpace" type="xs:double"/>
        <xs:element minOccurs="0" name="numberOfRooms" type="xs:double"/>
        <xs:element name="startRentalDate" type="xs:date"/>
        <xs:element name="balcony" type="xs:boolean"/>
        <xs:element name="garden" type="xs:boolean"/>
        <xs:element name="nonSmoker" type="xs:boolean"/>
        <xs:element name="shortTermAccomodationType" type="ns1:ShortTermAccommodationType"/>
        <xs:element name="courtage" type="ns1:CourtageInfo"/>
      </xs:sequence>
    </xs:extension>
  </xs:complexContent>
</xs:complexType>