XML Bulk Upload Service for Real Estate agencies: Automatic Import Property Listings into Gvanga

If you are a Real Estate agency and have a large volume of property listings to post then there is a free XML Bulk Upload feature for real estate ads! * on GVANGA.COM 

Steps for connection to the service:

Step 1: Create an XML file (feed) - a structured, updated data file on your site. The supported format is specified below. 

Step 2: Registration on Gvanga.com. To upload the XML feed, you need to be a registered user of our site. Please note that the XML Feed Import service is only available for companies.

Step 3: Submit a URL of the XML feed. You can fill out the feedback form below or send a link to your XML feed from the “My Account” page under “XML Feeds”.

After you add your XML feed, it will be verified and checked by our moderators.
When approved, the data from your XML feed will be automatically uploaded and updated on our website once per day. In “My Account” page under “Ads from XML file” tab, you can manage the imported ads.

 

Feed Requirements 

Please note that all ads loaded from your XML file must comply with our Posting Policy. Avoid duplicating contact information and links to online resources in your ad text (<description>), and the availability of contact information and watermarks on images in your feed.
Relevance - feed should contain only relevant data on ads.
Editing previously imported ads should be implemented by updating previously existing data. 

Technical requirements for your feed

  • Feed URL must be permanent and accessible via HTTP.
  • Feed should be created in UTF-8.
  • HTML-code is not allowed.
  • The first 32 characters of the ASCII codes (except for the numbers 9, 10 and 13) should not be used in the text boxes.
  • In addition, some character should be replaced by codes as noted below:
CharacterCode
"&quot;
&           &amp;
>&gt;
<&lt;
'&apos;

 

XML Feed format​

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>

 

We also accept files in other formats. You can send us your file and we will consider the possibility of the data import in that format.
If you have questions and suggestions regarding upload of XML ads on GVANGA.COM, please contact us via contact form below.

 

** Only one XML ad feed for real estate agencies is free of charge. Each additional feed is paid service, the cost of which is included in the relevant tariff plan and is renewable monthly.
*** Information aggregators and CMS systems have special premium connection conditions. The cost of the monthly payment depends on the total number of uploaded ads from the XML feed.


Feedback

Required fields are marked *