中文   
中文DeutschEnglishEspañolFrançaisPortuguêsРусскийSvenskaУкраїнська
登录注册+ 发布免费广告

房地产代理XML批量上传服务：可自动输入房产列表至Gvanga

如果您是房地产代理，并有大量待发布的房产列表，那么欢迎您可至GVANGA.COM使用免费XML批量上传功能的房地产广告！**

连接服务的步骤：

步骤1：创建XML文件（Feed）- 使您的网站结构化，更新数据文件。 其支持的格式如下所述。

步骤2：在Gvanga.com上注册。 上传XML Feed前，您必需先前往我们的网站注册用户。 请注意，XML Feed导入服务仅适用于公司。

步骤3：提交XML Feed的网址。 您可以填写以下反馈表单，或者从“我的帐户”页面的“XML Feed”下面发送XML Feed的链接。

添加您的XML Feed后，它将由我们的审核者进行验证和检查。
批准后，您的XML Feed中的数据将每天自动上传并更新到我们的网站上。 在“我的帐户”页面的“来自XML文件的广告”标签下，您可以管理导入的广告。

 

Feed要求

请注意，从您的XML文件加载的所有广告都必须符合我们的发布政策。 避免重复广告文字（）中的联系信息和在线资源的链接，以及Feed中图片上的联系信息和水印的可用性。
相关性 - Feed只应包含广告的相关数据。
修改先前导入的广告必须通过更新之前存在的数据来实现。

您的Feed的技术要求

  • Feed网址必须是永久性的，并且可通过HTTP访阅。
  • Feed应以UTF-8创建。
  • 不允许使用HTML代码。
  • ASCII代码的前32个字符（数字9,10和13除外）不应在文本框中使用。
  • 此外，一些字符应该被替换为如下所示的代码：
字符代码
""
&           &
>>
<&lt;
'&apos;

 

XML Feed格式​

每个XML文档应以XML声明开头：
<?xml version="1.0" encoding="utf-8"?>

XML文件必须包含带有订阅源创建日期的根元素“catalog”：
<catalog generated="YYYY-MM-DD HH:mm+02:00">...</catalog>

每个广告由元素“offer”形成，您需要为其定义文件中的唯一ID。

 

必填字段

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 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'
'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 Feed的示例：

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

 

我们还接受其他格式的文件。 您可以向我们发送您的文件，我们将考虑以该格式导入数据的可能性。
如果您对于在GVANGA.COM上传XML广告有任何问题和建议，请通过下面的联系表单与我们联系。

 

**只有一个房地产代理的XML广告资源是免费的。 每个额外的feed是付费服务，其费用包括在相关费率计划中，并且每月可续订。
***信息聚合器和CMS系统有特殊的高级连接条件。 每月付款的费用取决于从XML feed中上传的广告总数。

反馈

必填字段标记为 *

⇧