Your ads on Trovit UK

Cars 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 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. 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:

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, however it must be unique
  • 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 £1000000)When the price of the car is in a currency that’s different from the official currency of the country, you must use the ‘currency’ attribute. The values are determined by the standard ISO-4217. With this, Trovit can convert into the official currency.
        <price currency="USD"><![CDATA[...]]></price>

        This will specify the price of the car in dollars. Please don’t include any monetary symbols. See See the technical specifications for more information.

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

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

      • make: The car’s make (Ford, Toyota, etc)
      • model: The Car’s model (Mondeo, Yaris, etc)
      • color: Colour of the car
      • year: Year of manufacture (format: YYYY)
      • city: City, town or village where the car can be found (Birmingham , West Midlands )
      • city_area: City area from which the car is being sold
      • neighborhood: Neighbourhood from which the car is being sold (Kensington , London )
      • postcode**Postcode from which the car is being sold
      • region**County from which the car is being sold (Oxfordshire , Oxford )
      • 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: Whether or not the car is new (format: 0 = No, 1= Yes)
      • car_type: Body type of the vehicle (4×4, Coupé, Estate, Hatchback, Pickup, Convertible, Standard, MPV, Cabrio or Prestige)
      • dealer: Dealership from which the car is being sold.
      • warranty: Some text to explain if the car still has its warranty or not
      • 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.
      • pictures: This tag includes the various images of the property.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.
        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.

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>
    <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 doormirrors.]]></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/01/2011 14:30]]></date>
<is_new><![CDATA[0]]></is_new>
<car_type><![CDATA[hatchback]]></car_type>
<warranty><![CDATA[until 2011]]></warranty>



</ad>
</trovit>

For more information, click here: see technical specifications.

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