Serviço de Upload em massa de XML para agências imobiliárias: Importação automática de imóveis para o Gvanga

Se você é uma agência imobiliária e tem um grande volume de anúncios imobiliários para postar, então tento a ferramenta grátis para Upload em massa para imóveis!** no GVANGA.COM

Siga os passos para começar a usar o serviço:

Passo 1: Crie um arquivo (feed) - um arquivo de dados estruturados em seu site. O formato suportado é especificado abaixo.

Passo 2: Registre-se no Gvanga.com. Para carregar o feed XML, você precisa ser um usuário registrado do nosso site. Por favor, note que o serviço de importação de XML só está disponível para empresas.

Passo 3: Envie um URL do feed XML. Você pode preencher o formulário abaixo ou enviar um link em "Minha conta" na opção "Feeds XML".

Depois que você adicionar o seu feed XML, ele será verificado por nossos moderadores.
Quando aprovados, os dados de seu feed XML serão automaticamente carregados e atualizados em nosso site uma vez por dia. Na página "Minha conta" sob a aba "Anúncios de Feed XML", você pode gerenciar os anúncios importados.

 

Requisitos de Feed

Por favor, note que todos os anúncios carregados a partir de seu arquivo XML devem cumprir com nossas Políticas de Postagem. Evite duplicar suas informações de contato ou links para outros sites em seus anúncios (description), ou outras formas de marcação como marcas d'água.
Relevância – o feed deve conter dados relevantes do seu anúncio.
Editar anúncios previamente importados através do arquivo XML deve ser feita atualizando os dados já existentes.

Requisitos técnicos para feeds

  • URL do feed deve ser permanente e acessível via HTTP.
  • O feed deve ser criado em UTF-8.
  • Código HTML não é permitido.
  • Os primeiros 32 caracteres de código ASCII (exceto para os números 9, 10 e 13) não devem ser usados nas caixas de texto.
  • Além disso, alguns caracteres devem ser substituído por códigos como observado abaixo:
CharacterCode
""
&           &
>>
<&lt;
'&apos;

 

Formato do feed XML

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.

 

Exemplo de um feed XML válido

<?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>

 

Também aceitamos arquivos em outros formatos. Você pode nos enviar seu arquivo e vamos considerar a possibilidade da importação de dados nesse formato.
Se você tiver dúvidas e sugestões sobre upload de anúncios XML no GVANGA.COM, entre em contato conosco através do formulário de contato abaixo.

 

** Apenas um feed de anúncios XML para agências de imobiliárias é gratuito. Cada feed adicional é pago, o custo está incluído no painel de feeds XML e é renovado mensalmente.
*** Agregadores de informação e sistemas CMS tem condições especiais e condições premium. O custo do pagamento mensal depende do número total de anúncios carregados do feed XML.

Feedback

Campos obrigatórios são marcados com *