Your ads on Trovit UK

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. If you would like additional information about the XML format, please see 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:

OBLIGATORY 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
    • Overseas: Overseas property for sale (must be targeted at UK buyers)
    • Roommate: Flatshare
    • Office For Rent: Office to let
    • Parking for Rent: Parking to let
    • Land for sale: Land 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 50 and 30000). 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 5000 and 500000000)

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

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

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

    • property_type: (only applicable if you filled out ‘For rent’, ‘For sale’, ‘Rentals’ or ‘Overseas’ in the ‘type’ tag): 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>
    • 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. By default the price will be considered as ‘monthly’ but you can specify any of the following payment terms: monthly, weekly or daily by applying the appropriate syntax:
      <price period="weekly"><![CDATA[...]]></price>

      Depending on the type of ad, it’s not always necessary to apply it. Take a look at the technical specifications to find out what restrictions each type of ad has. When the specified price is in a currency that is different from the official currency of the country you will have to use the attribute ‘currency’. Each currency value will be determined by the standard ISO-4217. With this, Trovit will convert to the oficial currency.
      The default payment period is monthly, but you can also set it to weekly. The full syntax would be the following:

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

      This would specify the price as weekly, in US Dollars. The currency symbol (£, $, € etc) musn’t be included.

    • rooms: Number of bedrooms
    • bathrooms: Number of bathrooms
    • address: Street address where the property is located. (162 Example Street , Manchester )
    • postcode: Property’s postcode
    • city: City, town or village where the property is located. (Birmingham , West Midlands )
    • city_area: City area where the property is located
    • neighborhood: Neighbourhood where the property is located. (Kensington , London )
    • region: County where the property is located. (Oxfordshire , Oxford )
    • country: (only applicable to overseas property) country where the overseas property is located, country is set as UK by default
    • latitude: latitude of property’s location
      See technical specifications for more details
    • longitude: longitude of property’s location
      See technical specifications for more details
    • plot_area: plot area / area of the land on which the property is located (integer value)
      <plot_area unit="hectares"><![CDATA[...]]></plot_area>

      The unit measurements available are: ‘meters’, ‘feet’, ‘acres’ or ‘hectares’

    • floor_number: floor number
    • floor_area: Surface area of the property

You can specify the measurement of the floor area by applying the appropriate syntax:

<floor_area unit="meters"><![CDATA[...]]></floor_area>

The unit measurements available are: ‘meters’ or ‘feet’

  • 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
  • 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’.

 

The fields to define within the element <picture> are:

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.

The following fields must be completed according to whether or not they are true or false. See technical specifications to know which values represent true or false.

  • is_rent_to_own: whether or not the property is rent to own
  • parking: Whether or not the property is for sale by owner
  • foreclosure: Whether or not the property is foreclosed
  • is_furnished: Whether or not the property is furnished
  • is_new: Whether or not the property is newly built

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>
    <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[Greater 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[01/01/2011 13:40]]></date>
<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 
        Manchester centre and the airport.
        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[Manchester]]></city>
<postcode><![CDATA[]]></postcode>
<region><![CDATA[Greater Manchester]]></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/03/2011 18:30]]></date>
<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: see technical specifications.

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