Your ads on Trovit Vietnam

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. Send the URL link to our contact email 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

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:

REQUIRED 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

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

  • 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: 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 where the car is located .
  • warranty: some text to explain if the car still has warrant 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: 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.
        <?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>
      • 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.

    Example XML feed

    <?xml version="1.0" encoding="utf-8"?>
    <trovit>
    <ad>
    <id><![CDATA[7004578]]></id>
    <url><![CDATA[http://www.yourdomain.co.hk/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[Johor]]></city>
    <city_area><![CDATA[Johor Bahru]]></city_area>
    <postcode><![CDATA[]]></postcode>
    <region><![CDATA[Johor]]></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.vn/image1.jpg]]></picture_url>
    <picture_title><![CDATA[front]]></picture_title>
    </picture>
    <picture>
    <picture_url><![CDATA[http://www.yourdomain.co.vn/image2.jpg]]></picture_url>
    <picture_title><![CDATA[interior]]></picture_title>
    </picture>
    </pictures>
    <date><![CDATA[20/09/2009 18:30]]></date>
    <is_new><![CDATA[0]]></is_new>
    <car_type><![CDATA[hatchback]]></car_type>
    <warranty><![CDATA[until 2011]]></warranty>
    
    
    
    </ad>
    </trovit>

    Technical Specifications

    For more information, see our: technical specifications

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