Your ads on Trovit Ireland

Homes Feed

If you have a classified ads website you can include your ads in Trovit! Just follow these simple steps:

  1. Create a UTF-8 XML feed in the format specified for our homes vertical (see below).
  2. After creating the feed, download our XML Validator and test whether your feed is Trovit friendly. The Validator will confirm if we can index your content correctly.
  3. Use our contact form to send the URL link where we can read your XML feed.
    (For example: http://www.yourdomain.com/wp_feed.xml)

Upon receiving your feed, we will index your ads in Trovit as soon as possible.

If you have questions or concerns, please don’t hesitate to contact us!

XML feed format

Here are some simple guidelines for preparing an XML feed in order to include your ads in Trovit. You can use our XSD Schema as an example for the feed structure. If you would like additional information about the XML format, check Wikipedia.

The feed should be written in UTF-8.

The UTF-8 XML file has one ‘trovit’ tag, and one or more ‘ad’ elements. Each ‘ad’ element has basic and optional fields:

BASIC FIELDS

Basic fields have to be included in the feed as they contain the minimum amount of information necessary for our system to include your ads in Trovit.

  • id: id of the ad on your website (numeric or alphanumeric, it must be unique because we use it to avoid duplicate entries)
  • url: URL of the ad on your website
  • title: title of the ad (a concise summary of the listing which does not contain your website’s name or URL).
  • type: select the appropriate property type per ad:
    • For Rent property to let
      For Sale property for sale
  • content: description of the property (minimum of 30 characters). Please note that the quality of the description has a strong effect on the amount of visitors you will receive!

OPTIONAL FIELDS

You don’t have to fill out the optional fields. However, if you do have the information, don’t hesitate to include it. Trovit’s algorithm prioritises higher-quality ads, so including more information optimises your positioning!

  • mobile_url: URL of the ad on your site when a user is browsing on a mobile device. Useful when your website has a mobile version.
  • price: price of the property. Each property type has different settings:
    • For Rent: price of the property to let (integer value between 100 and 50000). The rental period is set as monthly by default, you can modify the rental period to weekly
    • For Sale: price of the property for sale (integer value between 10000 and 100000000)

    Please don’t include any symbols such as €, £ or $. For every property type, the price is set in EUR by default. If the price is specified in a currency other than EUR, a currency tag should be included. This tag enables Trovit to convert the price to EUR (€).

    <price currency="USD"><![CDATA[...]]></price>

    In this example, the price is specified in US dollars. Trovit will convert this to Euros.

  • property_type: property subtype; cottage, bungalow, flat, apartment, penthouse, garden flat, studio, loft, detached house, semi-detached house, terraced house or maisonette
  • floor_area: area of the property (set unit = feet, use an integer value)You can use also use meters, acres or hectares by applying the appropriate syntax:
    <floor_area unit="meters"><![CDATA[...]]></floor_area>
    <floor_area unit="acres"><![CDATA[...]]></floor_area>
    <floor_area unit="hectares"><![CDATA[...]]></floor_area>
  • rooms: number of bedrooms
  • bathrooms: number of bathrooms
  • parking: whether or not the property has parking (format: 0 = No, 1 = Yes)
  • address: property’s street address
  • postcode: property’s postcode
  • city: city where the property is located
  • city_area: city area where the property is located
  • neighborhood: neighborhood where the property is located
  • region: county where the property is located
  • latitude: latitude of property’s location
  • longitude: longitude of property’s location
  • plot_area: plot area / area of the land on which the property is located (integer value)
  • floor_number: floor number
  • floor_area: surface area of the property
  • foreclosure: whether or not the property is foreclosed (format: 0 = No, 1 = Yes)
  • is_furnished: whether or not the property is furnished (format: 0 = No, 1 = Yes)
  • is_new: whether or not the property is newly built (format: 0= No, 1 = Yes)
  • condition: condition of the property. Example: “conversion” or “second hand apartment”
  • year: year the property was built (format: YYYY)
  • agency: name of the advertising property agency
  • by_owner: whether or not the property is rent to own
  • is_rent_to_own: name of the advertising property agency
  • date: date and time the ad was published. Valid formats: DD/MM/YYYY or DD/MM/YYYY HH:MM:SS and YYYY/MM/DD or YYYY/MM/DD HH:MM:SS
  • expiration_date: date the ad will expire on. Valid formats: DD/MM/YYYY or DD/MM/YYYY HH:MM:SS and YYYY/MM/DD or YYYY/MM/DD HH:MM:SS
  • virtual_tour: URL of the property’s virtual tour
  • eco_score: Information, in free-text format, about the property’s energy efficiency
  • pictures: This tag includes the various images of the property

The field that defines an image in particular is:

  • picture: This tag includes the fields to specify the URL and the title of the image (the latter being optional). You can specify if the image should be the featured image using the attribute ‘featured’.
  • picture_url: Image URL.
  • picture_title: Image title.
<pictures>
    <picture>
        <picture_url><![CDATA[...]]></picture_url>
        <picture_title><![CDATA[...]]>/picture_title>
    </picture> 

</pictures>

The picture shown on Trovit is the first picture of the set of pictures included in the feed. Please select this picture carefully as it has a strong influence on the click through behaviour of our users.

Trovit doesn’t allow corporate images with information such as “No image available”.
If Trovit detects these kind of pictures, it has the right to stop the inclusion of your ads.

Once inserted for the first time, our system doesn’t modify or upload new pictures.
Please make sure that you include the correct picture(s) once you include the ad in the feed for the first time. The images should be 186×186 and should be no more than 1mb.

Example of the XML feed layout:

<?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>
    <expiration_date><![CDATA[...]]></expiration_date>
    <plot_area><![CDATA[...]]></plot_area>
    <floor_number><![CDATA[...]]></floor_number>
    <orientation><![CDATA[...]]></orientation>
    <foreclosure><![CDATA[...]]></forclosure>
    <is_furnished><![CDATA[...]]></is_furnished>
    <is_new><![CDATA[...]]></is_new>
    <condition><![CDATA[...]]></s_condition>
    <year><![CDATA[...]]></year>




</ad>

<ad>
    ....
</ad>

<ad>
    ....
</ad>

...

</trovit>

Example XML feed

<?xml version="1.0" encoding="utf-8"?>
<trovit>
<ad>
<id><![CDATA[7004578]]></id>
<url><![CDATA[http://www.yourdomain.co.uk/ad/7004578]]></url>
<title><![CDATA[London- Notting Hill]]></title>
<type><![CDATA[For rent]]></type>
<agency><![CDATA[Lettings Agency]]></agency>
<content><![CDATA[Flat, 3 bedrooms, 2 bathrooms, open-plan living room and kitchen.
        Spacious, perfect for a small family or for students. Utilities are not included in the
        rental price.]]></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[2]]></bathrooms>
<parking><![CDATA[0]]></parking>
<address><![CDATA[34 Portobello Road]]></address>
<city><![CDATA[London]]></city>
<city_area><![CDATA[Notting Hill]]></city_area>
<postcode><![CDATA[W11]]></postcode>
<region><![CDATA[London]]></region>
<latitude><![CDATA[(51.51310938435912]]></latitude>
<longitude><![CDATA[ -0.20099401473999023]]></longitude>
<pictures>
<picture>
   <picture_url><![CDATA[http://www.yourdomain.co.uk/image.jpg]]></picture_url>
   <picture_title><![CDATA[living room]]></picture_title>
</picture>
</pictures>
<virtual_tour><![CDATA[]]></virtual_tour>
<date><![CDATA[31/07/2009]]></date>
<time><![CDATA[18:30]]></time>
<expiration_date><![CDATA[31/12/2009]]></expiration_date>
<plot_area><![CDATA[]]></plot_area>
<floor_number><![CDATA[3]]></floor_number>
<orientation><![CDATA[south]]></orientation>
<foreclosure><![CDATA[]]></forclosure>
<is_furnished><![CDATA[0]]></is_furnished>
<is_new><![CDATA[0]]></is_new>
<condition><![CDATA[recently renovated]]></s_condition>
<year><![CDATA[1956]]></year>



</ad>
<ad>
<id><![CDATA[332A53BC2]]></id>
<url><![CDATA[http://www.yourdomain.co.uk/ad/332A53BC2]]></url>
<title><![CDATA[Semi-detached in Edinburgh]]></title>
<type><![CDATA[For sale]]></type>
<content><![CDATA[Semi-Detached on a quiet residential street, ten minutes from
        Edinburgh centre and Princes Street. 4 bedrooms, 4 bathrooms, small garden with
        a shed]]></content>
<price><![CDATA[209950]]></price>
<property_type><![CDATA[Flat]]></property_type>
<floor_area unit="feet"><![CDATA[300]]></floor_area>
<rooms><![CDATA[4]]></rooms>
<bathrooms><![CDATA[4]]></bathrooms>
<parking><![CDATA[1]]></parking>
<address><![CDATA[]]></address>
<city><![CDATA[Edinburgh]]></city>
<postcode><![CDATA[]]></postcode>
<region><![CDATA[Scotland]]></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[20/08/2008]]></date>
<time><![CDATA[17:17]]></time>
<expiration_date><![CDATA[]]></expiration_date>
<plot_area><![CDATA[400]]></plot_area>
<floor_number><![CDATA[]]></floor_number>
<orientation><![CDATA[]]></orientation>
<foreclosure><![CDATA[]]></forclosure>
<is_furnished><![CDATA[]]></is_furnished>
<is_new><![CDATA[]]></is_new>
<condition><![CDATA[]]></s_condition>
<year><![CDATA[]]></year>



</ad>
</trovit>

Technical Specifications

For more information, click here: technical specifications

Privacy policy · Legal Notice · Terms and conditions · Cookie policy