Homes

If you want Trovit to include ads from your site in our search results you only have to follow these steps:

  • Setup a XML file with the format described below
  • Download our validator to ensure that your XML feed is trovit friendly
  • Send us an email using our contact form with the URL where we can read the XML file you just created, for example: http://www.yourdomain.com/trovit_feed.xml
  • Keep in mind that we only accept feeds with listings of homes for sale or for rent. We don’t include rooms for rent, garages, plots of land, offices, … at least not yet!

In case you have any problem or question please don’t hesitate to contact us.

XML feed format

These are some simple guidelines for the creation of a XML file to include ads from your site in Trovit. If you need more information about the XML format you can check the Wikipedia.

The XML file has one ‘trovit’ tag, and one or more ‘ad’ elements. Each ‘ad’ element has the following fields:

  • id: id of the ad in your website (numeric or alphanumeric, but has to be unique because we use it to avoid duplicate entries)
  • url: URL of the ad on your website
  • title: title of the ad
  • type: type of the ad: “For rent” or “For sale”
  • agency: name of the agency (optional)
  • content: content of the ad
  • price: sale or rent price of the home. In the case of rent you can indicate the period of the rent: weekly or monthly
  • property_type: appartment, loft, house, etc. (optional)
  • floor_area: area of the property, either in square feet (set unit=”feet”) or square meters (unit=”meters”). (optional).
  • rooms: number of bedrooms (optional)
  • bathrooms: number of bathrooms (optional)
  • parking: number of parking places (optional)
  • address: address (optional)
  • city: city name
  • city_area: city area or neighbourhood where the property is located (optional)
  • postcode: postcode (optional)
  • region: name of the region/county/state (optional)
  • latitude: latitude (optional)
  • longitude: longitude (optional)
  • pictures: URLs of the pictures for this ad, see information below
  • virtual_tour: URLs of the virtual tour of the property (optional)
  • date: date of the ad in the following format: DD/MM/YYYY
  • time: time of the ad in the following format: HH:MM (optional)

pictures: the ‘ad’ element may containt a set of ‘picture’ fields a part of the ‘pictures’ tag.
The tags of each ‘picture’ element are:

  • picture_title: title of the picture (optional)
  • picture_url: URL of the picture on your site

The XML feed would look like this:

<?xml version=”1.0″ encoding=”utf-8″?>
<trovit>

<ad>
    <id><![CDATA[...]]></id>
    <url><![CDATA[...]]></url>
    <title><![CDATA[...]]></title>
    <type><![CDATA[...]]></type>

    <agency><![CDATA[...]]></agency>
    <content><![CDATA[...]]></content>

    <price><![CDATA[...]]></price>

    <property_type><![CDATA[...]]></property_type>

    <floor_area unit=”feet”><![CDATA[...]]></floor_area>
    <rooms><![CDATA[...]]></rooms>
    <bathrooms><![CDATA[...]]></bathrooms>
    <parking><![CDATA[...]]></parking>

    <address><![CDATA[...]]></address>
    <city><![CDATA[...]]></city>
    <city_area><![CDATA[...]]></city_area>
    <postcode><![CDATA[...]]></postcode>

    <region><![CDATA[...]]></region>

    <latitude><![CDATA[...]]></latitude>
    <longitude><![CDATA[...]]></longitude>

    <pictures>

        <picture>
            <picture_url><![CDATA[...]]></picture_url>
            <picture_title><![CDATA[...]]></picture_title>
        </picture>
        <picture>

            <picture_url><![CDATA[...]]></picture_url>
            <picture_title><![CDATA[...]]></picture_title>
        </picture>
        …
    </pictures>

    <virtual_tour><![CDATA[...]]></virtual_tour>

    <date><![CDATA[...]]></date>
    <time><![CDATA[...]]></time>

</ad>

<ad>
    ….
</ad>

<ad>
    ….
</ad>

…

</trovit>

You can copy and paste the previous code and use it as a template for your XML file

Example XML feed

<?xml version=”1.0″ encoding=”utf-8″?>
<trovit>

<ad>
	<id><![CDATA[7004578]]></id>
	<url><![CDATA[http://www.yourdomain.com/ad/7004578]]></url>
	<title><![CDATA[Chelsea Gate, London, SW1W]]></title>
	<type><![CDATA[For rent]]></type>

	<agency><![CDATA[Agencia Inmobiliaria]]></agency>
	<content><![CDATA[A very spacious three bedroom flat
        on a modern development]]></content>

	<price><![CDATA[800]]></price>

	<property_type><![CDATA[Flat]]></property_type>
	<floor_area unit=”feet”><![CDATA[300]]></floor_area>
	<rooms><![CDATA[3]]></rooms>

	<bathrooms><![CDATA[1]]></bathrooms>
	<parking><![CDATA[0]]></parking>

	<address><![CDATA[]]></address>
	<city><![CDATA[London]]></city>

	<city_area><![CDATA[South Kensigton]]></city_area>
	<postcode><![CDATA[SW1W]]></postcode>
	<region><![CDATA[London]]></region>

	<latitude><![CDATA[51.496401]]></latitude>

            <longitude><![CDATA[-0.179]]></longitude>

	<pictures>
            <picture>
                <picture_url><![CDATA[http://www.yourdomain.co.uk/image.jpg]]></picture_url>
                <picture_title><![CDATA[living room]]></picture_title>

            </picture>
	</pictures>

	<date><![CDATA[31/10/2005]]></date>
	<time><![CDATA[18:30]]></time>

</ad>

<ad>
	<id><![CDATA[332A53BC2]]></id>
	<url><![CDATA[http://www.yourdomain.com/ad/332A53BC2]]></url>
	<title><![CDATA[Brand new flat in Shadwell, London]]></title>

	<type><![CDATA[For sale]]></type>
	<content><![CDATA[A brand new flat, located on the third floor
        of a sought after apartment building]]></content>

	<price><![CDATA[209950]]></price>

	<address><![CDATA[]]></address>
	<city><![CDATA[London]]></city>
	<postcode><![CDATA[]]></postcode>
	<region><![CDATA[London]]></region>

	<pictures>
            <picture>
                <picture_url><![CDATA[http://www.yourdomain.co.uk/image.jpg]]></picture_url>
                <picture_title><![CDATA[living room]]></picture_title>

            </picture>
	</pictures>

	<date><![CDATA[31/10/2005]]></date>
	<time><![CDATA[17:30]]></time>

</ad>

</trovit>