Your ads on Trovit Ireland

Cars feed

Updated: [last-modified]

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 cars vertical (see below).
  2. 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, however 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).
  • content: description of the car (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 car (integer value, between €200 and €10,000,000)

Please don’t include any symbols such as €, £ or $. 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 Euro’s.

  • make: make of the car
  • model: model of the car
  • color: color of the car
  • year: year of manufacture (format: YYYY)
  • city: city where the car can be found
  • city_area: city area where the car can be found
  • neighborhood: neighborhood where the car can be found
  • postcode: postcode where the car can be found
  • region: county name where the car can be found (state abbreviations are okay)
  • mileage: mileage (integer value); select the appropriate syntax:
    <area unit="miles"><![CDATA[...]]></mileage>
    <area unit="kilometers"><![CDATA[...]]></mileage>
  • doors: number of doors (between 2 and 5)
  • fuel: fuel type (petrol or diesel)
  • transmission: transmission of the car (manual / automatic)
  • engine_size: engine size of the car, in c.c. (integer value)
  • power: power of the car (integer value); select the appropriate syntax:
    <power unit="kw"><![CDATA[...]]></power>
    <power unit="cv"><![CDATA[...]]></power>
    <power unit="ch"><![CDATA[...]]></power>
    <power unit="km"><![CDATA[...]]></power>
    <power unit="hp"><![CDATA[...]]></power>
    <power unit="ps"><![CDATA[...]]></power>
    <power unit="pk"><![CDATA[...]]></power>
    <power unit="cp"><![CDATA[...]]></power>
  • fuel_consumption: Car’s combined fuel consumption. If no unit measure is specified, l/100km will be used as the default unit. You can specify the unit measure used with the ‘unit’ attribute:
    <fuel_consumption unit="km/l"><![CDATA[...]]></fuel_consumption>

    Accepted unit measures: “l/100km”, “km/l”, “mpg”, “gal/mi”.

  • co2_emissions: Car’s CO2 emissions. If no unit measure is specified, g/km will be used as the default unit. You can specify the unit measure used with the “unit” attribute:
    <co2_emissions unit="g/mi"><![CDATA[...]]></co2_emissions>

    Accepted unit measures: “g/km”, “g/mi”.

  • eco_score: Free-text information about the car’s eco score.
  • seats: number of seats
  • gears: number of gears
  • is_new (new): whether or not the car is new (format: 0 = No, 1= Yes)
  • car_type (new): body type of the vehicle (4×4, Coupé, Estate, Hatchback, Pickup, Convertible, Standard, MPV, Cabrio or Prestige)
  • warranty (new): whether or not the car is still under warranty (format: 0= No, 1= Yes)
  • date: publication date of the ad (format: DD/MM/YYYY)
  • time: time the ad was published (format: HH:MM)
  • expiration_date (new): expiration date of the ad (format: DD/MM/YYYY)
  • pictures: The ‘pictures’ element may contain a set of ‘picture’ tags, each of which contains the following elements:
      • pictures: This tag includes the various images of the car.
        The field that defines an image in particular is <picture>:

        • 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 featured="true"><![CDATA[...]]></picture>

          The available values for “featured” are: “true” o “false”.

          The fields to be defined within the element <picture> are:

          • picture_url: The image URL.
          • picture_title: Image title.
        <pictures>
            <picture>
                <picture_url><![CDATA[...]]></picture_url>
                <picture_title><![CDATA[...]]>/picture_title>
            </picture> 
        
            <picture featured="true">
                <picture_url><![CDATA[...]]></picture_url>
                <picture_title><![CDATA[...]]>/picture_title>
            </picture>
                ...
        </pictures>

        The image displayed in Trovit for a listing will be the first in the set of images for that particular listing.
        Choose the most appropriate image as this can greatly influence the user’s clicks.

        Trovit doesn’t allow the use of corporate images with the message “Image not available”.
        In the case of this being detected, Trovit reserves the right to block your listings.

        Once your ads are included in Trovit, the images associated with the listings wont be able to be modified even in the following reading of your feed.
        Be sure that the new listings added to your feed include the correct images. The images should be 186×186 and should be no more than 1mb.

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

         

    Example of the XML feed layout:

    <?xml version="1.0" encoding="utf-8"?>
    <trovit>
    
    <ad>
        <id><![CDATA[...]]></id>
        <url><![CDATA[...]]></url>
        <title><![CDATA[...]]></title>
    
        <content><![CDATA[...]]></content>
    
        <price><![CDATA[...]]></price>
    
        <make><![CDATA[...]]></make>
        <model><![CDATA[...]]></model>
        <color><![CDATA[...]]></color>
    
        <year><![CDATA[...]]></year>
    
        <city><![CDATA[...]]></city>
        <city_area><![CDATA[...]]></city_area>
        <postcode><![CDATA[...]]></postcode>
    
        <region><![CDATA[...]]></region>
        <mileage unit="kilometers"><![CDATA[...]]></mileage>
        <doors><![CDATA[...]]></doors>
        <fuel><![CDATA[...]]></fuel>
        <transmission><![CDATA[...]]></transmission>
        <engine_size><![CDATA[...]]></engine_size>
        <power><![CDATA[...]]></power>
        <seats><![CDATA[...]]></seats>
        <gears><![CDATA[...]]></gears>
    
        <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>
    
        <date><![CDATA[...]]></date>
        <time><![CDATA[...]]></time>
        <is_new><![CDATA[...]]></is_new>
        <car_type><![CDATA[...]]></car_type>
        <warranty><![CDATA[...]]></warranty>
    
    
    
    
    </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[2008 Toyota Prius Hybrid]]></title>
    <content><![CDATA[Cruise control, Climate control, Front passenger airbag and side airbags, Front and rear head airbags, Anti-lock brakes, Traction control, Remote central door locking, Remote control alarm, Immobiliser, Front and rear electric windows, 16" alloy wheels, Front fog lights, Radio cassette and CD autochanger, Steering wheel mounted controls, Body coloured bumpers, Electric door mirrors.]]></content>
    <price><![CDATA[10000]]></price>
    <make><![CDATA[Toyota]]></make>
    <model><![CDATA[Prius]]></model>
    <color><![CDATA[Metallic Grey]]></color>
    <year><![CDATA[2008]]></year>
    <city><![CDATA[Bristol]]></city>
    <city_area><![CDATA[Bristol]]></city_area>
    <postcode><![CDATA[]]></postcode>
    <region><![CDATA[Bristol]]></region>
    <mileage unit="kilometers"><![CDATA[10000]]></mileage>
    <doors><![CDATA[5]]></doors>
    <fuel><![CDATA[petrol/ hybrid]]></fuel>
    <transmission><![CDATA[manual]]></region>
    <engine_size><![CDATA[1781]]></engine_size>
    <power><![CDATA[75]]></power>
    <seats><![CDATA[5]]></seats>
    <gears><![CDATA[6]]></gears>
    <pictures>
    <picture>
    <picture_url><![CDATA[http://www.yourdomain.co.uk/image1.jpg]]></picture_url>
    <picture_title><![CDATA[front]]></picture_title>
    </picture>
    <picture>
    <picture_url><![CDATA[http://www.yourdomain.co.uk/image2.jpg]]></picture_url>
    <picture_title><![CDATA[interior]]></picture_title>
    </picture>
    </pictures>
    <date><![CDATA[20/09/2009]]></date>
    <time><![CDATA[18:30]]></time>
    <is_new><![CDATA[0]]></is_new>
    <car_type><![CDATA[hatchback]]></car_type>
    <warranty><![CDATA[until 2011]]></warranty>
    
    
    
    </ad>
    </trovit>
Privacy policy · Legal Notice · Terms and conditions · Cookie policy