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
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
Character | Code |
" | " |
& | & |
> | > |
< | < |
' | ' |
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:
|
<propertyType> | Required field only for the following categories: 925, 926, 927, 930, 931, 932. Fixed text string. Select a property type from the list:
|
<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> 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> 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 meters: an 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' |
<landStatus> | Land status. Fixed text value from the list: 'Residential' |
<garageType> | Garage type. Fixed text value: 'Reinforced concrete' |
<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.