Your ads on Trovit New Zealand

Cars feed

If you own a Classified Ads website with public advertisements, include your ads in Trovit! Follow these simple steps:

  1. Prepare a UTF-8 XML feed in the format specified for our Cars vertical (see below)
  2. Send the URL link where we can read your XML feed to Contact Trovit (Example: http://www.yourdomain.com/wp_feed.xml)

Please keep in mind that we only accept feeds containing vehicle listings. We do not include bikes, motorcycles, scooters, boats, car parts, etc… at least not yet!

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 so that we can include your ads in Trovit. If you would like additional information about the XML format, check out 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 the following fields:

You can also consult the Technical Specifications Sheet

REQUIRED FIELDS

Required 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)
  • date: date of the ad in one of the following formats: DD/MM/YYYY or DD/MM/YYYY HH:MM:SS

OPTIONAL FIELDS

You are not required to include optional fields. However, if you have the information, please use it! Trovit’s algorithm prioritizes higher-quality ads; therefore including more information will optimize 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)

Please don’t include any symbols such as £, $ or €. The price is specified in NZD by default. If the price is specified in a currency other than NZD on your website, a currency tag should be included. This tag enables Trovit to convert the price to NZD($).

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

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

  • make: make of the car
  • model: model of the car
  • color: colour of the car
  • year: year of the car
  • city: city/ town/district name
  • city_area: suburb/area name
  • postcode: postcode (optional)
  • region: region name
  • mileage: kilometers
  • doors: number of doors
  • fuel: fuel type (i.e. petrol, diesel, etc)
  • transmission: transmission of the car (manual/automatic)
  • engine_size: engine size of the car in c.c. (include only the number, do not include the unit)
  • power: power of the car; select one of the following:
    <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 in the car
  • gears: number of gears
  • pictures: URLs of the pictures for this ad. The ‘pictures’ element may contain one or more sets of ‘picture’ tags:picture
      : tag for each photo URL. The ‘picture’ element may contain:

    picture_title: title of the photo (optional)
    picture_url: URL link of the picture on your website. Please do not include corporate images with information such as “no image available.” If we detect this, Trovit reserves the right to block your listings.
    Once your ads are indexed in Trovit, the images associated to the ad can not be modified, this even includes if you modify the image in the feed.
    Please make sure that the new ads you include in your feed have the correct images. Images must be at least 186x186px and have a maximum size of 1MB.
    Please see example ‘pictures’ tag:

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

 

  • 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.
  • is_new: 0 if it is a used car, 1 if it is a new car (optional)
  • car_type: body type of the vehicle: sedan, van, truck, convertible, SUV, coupe etc (optional)
  • warranty : warranty conditions (optional)

 

The XML feed should look like this:

<?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><![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>
    <expiration_date><![CDATA[...]]></expiration_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.com/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 and CD autochanger, Steering wheel mounted controls, Body coloured bumpers, Electric door mirrors. ]]></content>
<price><![CDATA[30000]]></price>
<make><![CDATA[Toyota]]></make>
<model><![CDATA[Prius]]></model>
<color><![CDATA[Metallic Grey]]></color>
<year><![CDATA[2008]]></year>
<city><![CDATA[Auckland City]]></city>
<city_area><![CDATA[Avondale]]></city_area>
<region><![CDATA[Auckland]]></region>
<mileage><![CDATA[18000]]></mileage>
<doors><![CDATA[4]]></doors>
<fuel><![CDATA[petrol/hybrid]]></fuel>
<transmission><![CDATA[manual]]></transmission>
<engine_size><![CDATA[1798]]></engine_size>
<power><![CDATA[75]]></power>
<seats><![CDATA[5]]></seats>
<gears><![CDATA[6]]></gears>
<pictures>
<picture>
<picture_url><![CDATA[http://www.yourdomain.com/image1.jpg]]></picture_url>
<picture_title><![CDATA[front]]></picture_title>
</picture>
<picture>
<picture_url><![CDATA[http://www.yourdomain.com/image2.jpg]]></picture_url>
<picture_title><![CDATA[back]]></picture_title>
</picture>
</pictures>
<date><![CDATA[...]]></date>
        <expiration_date><![CDATA[...]]></expiration_date>
<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