Your ads on Trovit South Africa

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.

You can also consult the Technical Specifications Sheet

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

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)

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 auto (integer value) Please see our Technical Specifications Sheet for more details.Please don’t include any symbols such as $ or R. The price is specified in “ZAR (R)” by default. If the price is specified in a currency other than ZAR (R) on your website, a currency tag should be included. This tag enables Trovit to convert the price to ZAR (R). Each currency value will be determined by the standard ISO-4217.
    <price currency="EUR"><![CDATA[...]]></price>

    In this example, the price is specified in Euros. Trovit will convert this to ZAR (R).

  • make: make of the car
  • model: model of the car
  • color: colour of the car
  • year: year of the car, format YYYY
  • city: city name
  • city_area: city area or neighbourhood
  • postcode: postcode
  • region: State
  • mileage: kilometres
  • 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 liters or c.c. (include only the number, do not include the unit) (decimal values accepted); select one of the following:
    <engine_size unit="liters"><![CDATA[...]]></engine_size>
    <engine_size unit="cc"><![CDATA[...]]></engine_size>
  • power: power of the car; select one of the following:
    <power unit="hp"><![CDATA[...]]></power>
    <power unit="kw"><![CDATA[...]]></power>
    <power unit="ps"><![CDATA[...]]></power>
    <power unit="cv"><![CDATA[...]]></power>
    <power unit="ch"><![CDATA[...]]></power>
    <power unit="km"><![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.” Please see example ‘pictures’ tag:

      <pictures>
      <picture>
      <picture_url><![CDATA[...]]></picture_url>
      <picture_title><![CDATA[...]]></picture_title>
      </picture>
      </pictures>
        1. The first photo URL you display in the ‘pictures’ tag will be the photo shown on Trovit. Please select this picture carefully as it has a strong influence on the click through behavior of our users.

      Once a picture is inserted for the first time, our system does not modify or upload new pictures. Please make sure that you include the correct picture(s) each time you include a new ad in the feed.Images must be at least 186x186px and have a maximum size of 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.
    • is_new:whether or not the car is new; (format: 0 = No, 1 =Yes)
    • car_type: body style of the vehicle: sedan, coupe, truck, convertible, SUV, 4×4 etc
    • warranty: warranty conditions

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 unit = hp><![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[0]]></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[2007 Honda Civic]]></title>
<content><![CDATA[Front passenger airbag,central door locking,front and rear electric windows,radio.]]></content>
<price><![CDATA[450000]]></price>
<make><![CDATA[Honda]]></make>
<model><![CDATA[Civic]]></model>
<color><![CDATA[Metallic Grey]]></color>
<year><![CDATA[2007]]></year>
<city><![CDATA[Johannesburg]]></city>
<city_area><![CDATA[BTM Layout]]></city_area>
<postcode><![CDATA[560076]]></postcode>
<region><![CDATA[Gauteng]]></region>
<mileage><![CDATA[30000]]></mileage>
<doors><![CDATA[5]]></doors>
<fuel><![CDATA[petrol]]></fuel>
<transmission><![CDATA[manual]]></region>
<engine_size><![CDATA[1781]]></engine_size>
<power unit = hp><![CDATA[75]]></power>
<seats><![CDATA[5]]></seats>
<gears><![CDATA[6]]></gears>
<pictures>
<picture>
<picture_url><![CDATA[http://www.domain.com/image1.jpg]]></picture_url>
<picture_title><![CDATA[front]]></picture_title>
</picture>
<picture>
<picture_url><![CDATA[http://www.domain.com/image2.jpg]]></picture_url>
<picture_title><![CDATA[interior]]></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