XML-Massen-Upload für Immobilienagenturen: Automatischer Import von Immobilienanzeigen auf Gvanga

Wenn Sie eine Immobilienagentur repräsentieren und eine große Menge an Immobilienanzeigen zum Aufgeben haben, dann steht Ihnen die kostenlose Funktion des XML-Massen-Uploads für Immobilienanzeigen zur Verfügung* auf GVANGA.COM

Schritte zum Einrichten dieses Services:

Schritt 1: Erstellen Sie eine XML-Datei (Feed), eine strukturierte, aktualisierende Datei auf Ihrer Seite. Das unterstützte Format ist unten spezifiziert.

Schritt 2: Registrierung auf Gvanga.com. Um den XML-Feed hochzuladen, müssen Sie ein registrierter Benutzer auf unserer Website sein. Bitte beachten Sie, dass der Import von XML-Feeds nur Unternehmen zur Verfügung steht.

Schritt 3: Übermitteln Sie die URL Ihres XML-Feeds. Sie können das Feedback-Formular unten ausfüllen oder den Link zu Ihrem XML-Feed auf der „Mein Account“-Seite unter „XML-Feeds“ absenden.

Nachdem Sie Ihren XML-Feed hinzugefügt haben, wird er durch unsere Moderatoren verifiziert und überprüft.
Wenn er angenommen wird, wird der Inhalt Ihres XML-Feeds automatisch hochgeladen und auf unserer Website einmal pro Tag aktualisiert. In der “Mein Account”-Seite unter „Anzeigen vom XML-Feed” können Sie die importierten Anzeigen verwalten.

 

Anforderungen an den Feed

Bitte beachten Sie, dass alle Anzeigen, die von Ihrer XML-Datei importiert werden, unseren Inhaltsrichtlinien entsprechen müssen. Vermeiden Sie sowohl doppelte Kontaktinformationen und Links in Ihrem Anzeigentext () als auch Kontaktdetails und Watermarks auf Bildern in Ihrem Feed.
Relevanz – Der Feed sollte nur relevante Informationen über die Anzeigen enthalten.
Erstellen Sie keine neue Anzeige, wenn Sie lediglich eine bereits existierende Anzeige bearbeiten möchten. Aktualisieren Sie stattdessen die bereits vorhandene Anzeige.

Technische Anforderungen an Ihren Feed

  • Der URL des Feeds muss permanent sein und via HTTP zugänglich sein.
  • Der Feed sollte in UTF-8 kodiert sein.
  • HTML-Code ist nicht erlaubt.
  • Die ersten 32 ASCII-Zeichen (außer die Zeichen Nummer 9, 10 und 13) sollten nicht in den Textfeldern benutzt werden.
  • Außerdem sollten bestimmte Zeichen durch Codes ersetzt werden:
ZeichenCode
""
&           &
>>
<&lt;
'&apos;

 

Format des XML-Feeds

Each XML document should begin with an XML declaration: 
<?xml version="1.0" encoding="utf-8"?>

XML file must contain the root element 'catalog' with the feed creation date:
<catalog generated="YYYY-MM-DD HH:mm+02:00">...</catalog>

Each ad is formed by the element 'offer', for which you need to define a unique ID in the file.

 

Required Fields

Element Name

Description

<id>

a unique ID for a particular ad

<categoryId>

Specify a Category ID for each offer from the following:

  • 925 – for “Apartments & Condos”
  • 926 – for “Rooms & Roommates”
  • 927 – for “Houses & Vacation Homes”
  • 928 – for “Land”
  • 929 – for “Car Storage & Parking”
  • 930 – for “Commercial & Offices”
  • 931 – for “Luxury Real Estate”
  • 932 – for “Other Real Estate”
<propertyType>

Required field only for the following categories: 925, 926, 927, 930, 931, 932.

Fixed text string. Select a property type from the list:

  • 'Apartment'
  • 'House'
  • 'Cottage'
  • 'Townhouse'
  • 'Vacation home'
  • 'Office space'
  • 'Commercial shops, showrooms'
  • 'Hotels, hostels'
  • 'Cafes, bars, restaurants'
  • 'Warehouse'
  • 'Industrial premises'
  • 'Multipurpose rooms'
  • 'Buildings, facilities'
  • 'Co-working'

<listingType>

 Specify a type of a listing. Fixed text string: "for sale" or "for rent"

<title>

Ad title

<description>

Ad description – the text information

<price>

Price: an integer > 0 (without spaces)

<currency>

Currency: an alphabetic currency code from the ISO 4217 code list

<url>

A single URL for each ad

<seller>

Parent element for the contact details of the agent:

<seller>
    <companyName>Agency</companyName>
    <name>Philip</name>
    <phone>123-465-789</phone>
    <email>agent@agency.org</email>
</seller>

Required field is marked below with an asterisk.

<company-name>

Company name

<name>

Contact name

<phone>

Phone number

<email>*

E-mail address

<location>

Parent element used to describe the property location:

<location>
    <country>USA</country>
    <region>New Jersey</region>
    <city>Jersey City</city>
    <address>New street, 1</address>
    <zipcode>123</zipcode>
    <latitude>40.704130</latitude>
    <longitude>74.052483</longitude>
    <subwayName>Liberty State Park</subwayName>
    <distanceToSubway unit="m">50</distanceToSubway>
    <distanceToCity unit="km">1</distanceToCity>
</location>

Required field is marked below with an asterisk.

<country>*

<region>

<city>*

<address>

<zipcode>

<latitude>

<longitude>

<subwayName>

<distanceToSubway>

 

<distanceToCity>

The name of the country

The name of the region, district, state

The name of the city

Address where the property is located 

Postal code

Latitude 

Longitude 

The name of the subway station 

The distance to the subway station in metersan integer > 0 (without spaces). You can define another length unit by the attribute 'unit'. 

The distance to the city in km: an integer > 0 (without spaces). You can define another length unit by the attribute 'unit'. 

 

Additional Fields​

It is recommended to include more elements in each offer for a better conversion and ranking in our search results.

Element Name

Description

<updateDate>

Date last update of the ad (the date format: YYYY-MM-DDTHH:mm+02:00)

<creationDate>

Creation date of the ad (the date format: YYYY-MM-DDTHH:mm+02:00)

<imageUrl>

URL to a photo of the property (tag single element should be added for each image, up to 4 tags can be added for each offer). 

<rentalTerms>

Rental period (Fixed text value: 'Daily', 'Short term' or 'Long-term')

<isNewBuild>

Element name for the property in new buildings (a boolean value. If YES use one of the values: 'yes', '1', '+', 'true', if NO use one of the values: 'no', '0', '-', 'false')

<constructionType>

Construction Type. Fixed text value from the list:

'Panel'
'Monolith-brick'
'Monolithic'
'Prefabricated'
'Brick'
'Wooden'
'Other'

<landStatus>

Land status. Fixed text value from the list:

'Residential'
'Partnership community'
'Agricultural'
'Commercial & industrial'

<garageType>

Garage type. Fixed text value:

'Reinforced concrete'
'Metal'
'Brick'

<buildingClass>

Building class for commercial properties ('A', 'B', 'C', 'D')

<isElite>

Luxury (a boolean value. If YES use one of the values: 'yes', '1', '+', 'true', if NO use one of the values: 'no', '0', '-', 'false')

<floor>

Floor number (an integer > 0)

<floorsTotal>

Total number of floors (an integer > 0)

<roomsTotal>

Number of rooms (an integer > 0)

<bedroomsTotal>

Number of  bedrooms (an integer > 0)

<bathroomsTotal>

Number of bathrooms (an integer > 0)

<parkingSpaces>

Number of parking spaces (an integer > 0)

<floorArea>

Total gross floor area (an integer and fractional part with two decimal digits (hundredths), e.g., 10.26). You can define the unit of area by the attribute 'unit': 'sq.m' or 'sq.ft'. The default is square meters.

<useableFloorArea>

Usable floor area (an integer and fractional part with two decimal digits (hundredths), e.g., 10.26). You can define the unit of area by the attribute 'unit': 'sq.m' or 'sq.ft'. The default is square meters.

<kitchenArea>

Kitchen size (an integer and fractional part with two decimal digits (hundredths), e.g., 10.26). You can define the unit of area by the attribute 'unit': 'sq.m' or 'sq.ft'. The default is square meters.

<roomArea>

Sq area of the room (an integer and fractional part with two decimal digits (hundredths), e.g., 10.26). You can define the unit of area by the attribute 'unit': 'sq.m' or 'sq.ft'. The default is square meters.

Tag single element should be added for each room.

<lotSize>

Land size (an integer and fractional part with two decimal digits (hundredths), e.g., 10.26). You can define the unit of area by the attribute 'unit': 'hundred part', 'acre', 'hectare'. The default is hundred parts (1 hundred part = 100 sq.m).

<ceilingHeight>

Ceiling height in meters (an integer and fractional part with two decimal digits (hundredths), e.g., 10.26 - use a dot as delimiter). You can define the unit of height by the attribute 'unit': 'm' or 'ft'. The default is meters.

<sunroom>

Sunroom (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<balcony>

Balcony (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<elevator>

Elevator (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<garbageChute>

Garbage chute (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<roomFurniture>

Furniture for rooms (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<kitchenFurniture>

Kitchen furniture (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<phoneline>

Phone line availability (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<internet>       

Internet availability (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<tv>

TV (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<washer>

Washing machine (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<fridge>

Refrigerator (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<dishwasher>

Dishwasher (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<airConditioning>

Air conditioning (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<centralHeating>

Central heating supply (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<sewage>

Sewerage supply (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<gasSupply>

Gas line (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<waterSupply>

Water supply (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<electricitySupply>

Electricity supply (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<petsAllowed>

Pets are allowed (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<concierge>

Concierge (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<parkingSpace>

Parking space availability (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<security>

Security (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<securityAlarm>

Security alarm (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<gatedArea>

Gated area (a boolean value: 'yes', '1', '+', 'true' or 'no', '0', '-', 'false')

<paymentMethod>

Method of payment. Free text string.

 

<?xml version="1.0" encoding="UTF-8"?>
  <catalog generated="2016-11-29 17:24">
    <offers>
      <offer>
        <id>1</id>
        <categoryId>925</categoryId>
        <propertyType>Apartment</propertyType>
        <listingType>For sale</listingType>
        <title>Apartment for sale</title>
        <description>New apartment 3 bedrooms for sale, 400 meters from the beach, 220 sq. m, unfurnished.</description>
        <price>700000</price>
        <currency>USD</currency>
        <seller>
           <companyName>Real Estate Agency</companyName>
           <name>Seller</name>
           <phone>+1(727)777-7777</phone>
           <email>info@agency.com</email>
        </seller>
        <location>
           <country>USA</country>
           <region>Florida</region>
           <city>Saint Petersburg</city>
           <address>2nd Avenue South</address>
           <zipcode>33777</zipcode>
           <latitude>27.712203</latitude>
           <longitude>82.653092</longitude>
        </location>
        <url>http://site.com/apartment-for-sale/</url>
        <paymentMethod>bank transfer</paymentMethod>
        <imageUrl>http://site.com/imageUrl1/</imageUrl>
        <imageUrl>http://site.com/imageUrl2/</imageUrl>
        <imageUrl>http://site.com/imageUrl3/</imageUrl>
        <imageUrl>http://site.com/imageUrl4/</imageUrl>
        <updateDate>2016-11-29 15:40</updateDate>
        <isNewBuild>1</isNewBuild>
        <constructionType>Monolithic</constructionType>
        <floor>2</floor>
        <floorsTotal>16</floorsTotal>
        <roomsTotal>2</roomsTotal>
        <bedroomsTotal>1</bedroomsTotal>
        <bathroomsTotal>1</bathroomsTotal>
        <parkingSpaces>1</parkingSpaces>
        <floorArea unit="sq.m">220</floorArea>
        <useableFloorArea unit="sq.m">180</useableFloorArea>
        <kitchenArea unit="sq.m">15.50</kitchenArea>
        <ceilingHeight unit="m">2.50</ceilingHeight>
        <balcony>1</balcony>
        <elevator>1</elevator>
        <garbageChute>1</garbageChute>
        <phoneline>1</phoneline>
        <airConditioning>1</airConditioning>
        <centralHeating>1</centralHeating>
        <sewage>1</sewage>
        <gasSupply>1</gasSupply>
        <concierge>1</concierge>
        <waterSupply>1</waterSupply>
        <parkingSpace>true</parkingSpace>
      </offer>
      <offer>
        <id>2</id>
        <categoryId>930</categoryId>
        <propertyType>Office space</propertyType>
        <listingType>For rent</listingType>
        <title>Office space for rent</title>
        <description>Office space for rent right in the city centre, 20 sq.ft, unfurnished, for long term.</description>
        <price>1000</price>
        <currency>USD</currency>
        <seller>
           <companyName>Real Estate Agency</companyName>
           <name>Seller</name>
           <phone>+1(727)777-7777</phone>
           <email>info@agency.com</email>
        </seller>
        <location>
           <country>USA</country>
           <region>Florida</region>
           <city>Saint Petersburg</city>
           <address>2nd Avenue South</address>
           <zipcode>33777</zipcode>
           <latitude>27.712203</latitude>
           <longitude>82.653092</longitude>
        </location>
        <url>http://site.com/office-for-rent/</url>
        <paymentMethod>bank transfer</paymentMethod>
        <imageUrl>http://site.com/offices/imageUrl1/</imageUrl>
        <updateDate>2016-11-29 15:40</updateDate>
        <buildingClass>A</buildingClass>
        <floor>4</floor>
        <floorsTotal>10</floorsTotal>
        <roomsTotal>1</roomsTotal>
        <floorArea unit="sq.ft">20</floorArea>
        <elevator>1</elevator>
        <internet>1</internet>
      </offer>
      <offer>
        <id>3</id>
        <categoryId>929</categoryId>
        <listingType>For sale</listingType>
        <title>Lock Up Garage for sale</title>
        <description>Lock Up Garage for sale in city centre: 4.75m deep 2.85m wide. </description>
        <price>3000</price>
        <currency>USD</currency>
        <seller>
           <companyName>Real Estate Agency</companyName>
           <name>Seller</name>
           <phone>+1(727)777-7777</phone>
           <email>info@agency.com</email>
        </seller>
        <location>
           <country>USA</country>
           <region>Florida</region>
           <city>Saint Petersburg</city>           
        </location>
        <url>http://site.com/lock-up-garage-for-sale/</url>
        <imageUrl>http://site.com/lock-up-garage-for-sale/imageUrl1/</imageUrl>
        <garageType>Brick</garageType>
        <floorArea unit="sq.m">13.50</floorArea>
        <securityAlarm>1</securityAlarm>
      </offer>
      <offer>
        <id>4</id>
        <categoryId>927</categoryId>
        <propertyType>Cottage</propertyType>
        <listingType>For rent</listingType>
        <title>Cottage for rent</title>
        <description>New cottage 3 bedrooms for rent for short term, 400 meters from the beach, 150 sq. m.</description>
        <price>500</price>
        <currency>USD</currency>
        <seller>
           <companyName>Real Estate Agency</companyName>
           <name>Seller</name>
           <phone>+1(727)777-7777</phone>
           <email>info@agency.com</email>
        </seller>
        <location>
           <country>USA</country>
           <region>Florida</region>
           <city>Saint Petersburg</city>
           <address>2nd Avenue South</address>
        </location>
        <url>http://site.com/cottage-for-rent/</url>
        <paymentMethod>bank transfer</paymentMethod>
        <imageUrl>http://site.com/cottage-for-rent/imageUrl1/</imageUrl>
        <rentalTerms>Short term</rentalTerms>
        <constructionType>Wooden</constructionType>
        <floorsTotal>2</floorsTotal>
        <roomsTotal>5</roomsTotal>
        <bedroomsTotal>3</bedroomsTotal>
        <bathroomsTotal>2</bathroomsTotal>
        <parkingSpaces>2</parkingSpaces>
        <floorArea unit="sq.m">150</floorArea>
        <useableFloorArea unit="sq.m">120</useableFloorArea>
        <roomArea unit="sq.m">20</roomArea>
        <roomArea unit="sq.m">25</roomArea>
        <roomArea unit="sq.m">28</roomArea>
        <balcony>1</balcony>
        <roomFurniture>1</roomFurniture>
        <kitchenFurniture>1</kitchenFurniture>
        <phoneline>1</phoneline>
        <internet>1</internet>
        <tv>1</tv>
        <fridge>1</fridge>
        <washer>1</washer>
        <airConditioning>1</airConditioning>
        <centralHeating>1</centralHeating>
        <sewage>1</sewage>
        <gasSupply>1</gasSupply>
        <electricitySupply>1</electricitySupply>
        <petsAllowed>1</petsAllowed>
        <security>1</security>
        <dishwasher>1</dishwasher>
        <waterSupply>1</waterSupply>
        <securityAlarm>1</securityAlarm>
        <gatedArea>1</gatedArea>
        <parkingSpace>1</parkingSpace>
      </offer>
      <offer>
        <id>5</id>
        <categoryId>928</categoryId>
        <listingType>For sale</listingType>
        <title>Land for sale</title>
        <description>Land for sale, 1000 acres in a prosperous farming neighborhood.</description>
        <price>700000</price>
        <currency>USD</currency>
        <seller>
           <companyName>Real Estate Agency</companyName>
           <name>Seller</name>
           <phone>+1(727)777-7777</phone>
           <email>info@agency.com</email>
        </seller>
        <location>
           <country>USA</country>
           <region>Florida</region>
           <city>Saint Petersburg</city>
           <latitude>27.712203</latitude>
           <longitude>82.653092</longitude>
           <distanceToCity unit="mile">10</distanceToCity>
        </location>
        <url>http://site.com/land-for-sale/</url>
        <landStatus>Agricultural</landStatus>
        <lotSize unit="acre">1000</lotSize>
      </offer>
    </offers>
  </catalog>

 

Wir nehmen auch Dateien in anderen Formaten an. Sie können uns Ihre Datei senden und wir werden die Möglichkeit des Datenimports in dem entsprechenden Format in Betracht ziehen.
Falls Sie Fragen oder Vorschläge bezüglich des Massen-Uploads von XML-Anzeigen auf GVANGA.COM haben, kontaktieren Sie uns bitte über das nachfolgende Kontaktformular.

 

** Nur ein XML-Anzeigen-Feed ist für Immobilienagenturen kostenlos. Jeder zusätzliche Feed ist ein bezahlter Service, dessen Preis im entsprechenden Tarifplan enthalten sind und der monatlich erneuerbar ist.
*** Anzeigenaggregatoren und CMS-Systeme haben besondere Premium-Bedingungen. Der monatliche Preis hängt von der Gesamtzahl der hochgeladenen Anzeigen vom XML-Feed ab.

Feedback

Pflichtfelder sind mit * markiert