Your ads on Trovit Malaysia

Homes 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 homes vertical (see below).
    2. After creating the feed, download our XML Validator and test whether your feed is Trovit friendly. The Validator will confirm if we can index your content correctly.
    3. 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

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

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, 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).
  • type: select the appropriate property type per ad:
    • For Rent: property to let
    • For Sale: property for sale
  • content: description of the property (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 property. Default price is monthly but we can also indicate the specific period you have chosen: strong>monthly, daily o weekly by applying the appropriate syntax:
    <price period="monthly"><![CDATA[...]]></price>
    <price period="weekly"><![CDATA[...]]></price>
    <price period="daily"><![CDATA[...]]></price>
        • Depending on the type of ad, it’s not always necessary to apply it. Take a look at the

      technical specifications

        • to find out what restrictions each type of ad has.

      When the specified price is in a currency that is different from the official currency of the country you will have to use the attribute ‘currency’. Each currency value will be determined by the standard ISO-4217. With this, Trovit will convert to the oficial currency.

        • The automatic period is monthly, but you can also set it to weekly. The syntax would be the following:
      <price period="weekly" currency="CAD"><![CDATA[...]]></price>
        • property_type (only applicable if you filled out “For rent”, “For sale” in the “type” tag): property subtype; cottage, bungalow, flat, apartment, penthouse, garden flat, studio, loft, detached house, semi-detached house, terraced house or maisonette
        • floor_area: area of the property in square feet (set unit = feet, use an integer value)

      You can use also use meters, acres or hectares by applying the appropriate syntax:

      <floor_area unit="meters"><![CDATA[...]]></floor_area>
      <floor_area unit="acres"><![CDATA[...]]></floor_area>
      <floor_area unit="hectares"><![CDATA[...]]></floor_area>
      • rooms: number of bedrooms
      • bathrooms: number of bathrooms
      • parking: whether or not the property has parking (format: 0 = No, 1 = Yes)
      • address: address
      • postcode: postcode
      • city: city where the property is located
      • city_area: city area where the property is located
      • neighborhood: neighborhood where the property is located
      • region: county where the property is located
      • country(only applicable to overseas property): country where the overseas property is located, country is set as MY by default
      • latitude: latitude of where the property can be found See technical specifications for more details.
      • longitude: longitude of where the property can be found See technical specifications for more details.
      • orientation: orientation of the property; north, south, east or west
      • plot_area : plot area / area of the land on which the property is located (integer value)
      • floor_number: floor number
      • foreclosure: whether or not the property is foreclosed (format: 0 = No, 1 = Yes)
      • is_furnished: whether or not the property is furnished (format: 0 = No, 1 = Yes)
      • is_new: whether or not the property is newly built (format: 0= No, 1 = Yes)
      • condition: condition of the property. Example: “conversion” or “second hand apartment”
      • year: year the property was built (format: YYYY)
      • agency: name of the agency
      • by_owner: whether or not the property is for sale by owner (format: 0 = No, 1 = Yes, it’s not necessary to include this field if the property is being marketed by an Estate Agent)
      • is_rent_to_own: whether or not the property is rent to own.
      • 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.
      • virtual_tour: URL of the property’s virtual tour
      • eco_score: information, in free-text format, about the property’s energy efficiency.
      • 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 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.
          <?xml version="1.0" encoding="utf-8"?>
          <trovit>
          
          <ad>
              <id><![CDATA[...]]></id>
              <url><![CDATA[...]]></url>
              <title><![CDATA[...]]></title>
              <type><![CDATA[...]]></type>
          
              <agency><![CDATA[...]]></agency>
              <content><![CDATA[...]]></content>
          
              <price><![CDATA[...]]></price>
          
              <property_type><![CDATA[...]]></property_type>
          
              <floor_area unit="feet"><![CDATA[...]]></floor_area>
              <rooms><![CDATA[...]]></rooms>
              <bathrooms><![CDATA[...]]></bathrooms>
              <parking><![CDATA[...]]></parking>
          
              <address><![CDATA[...]]></address>
              <city><![CDATA[...]]></city>
              <city_area><![CDATA[...]]></city_area>
              <postcode><![CDATA[...]]></postcode>
          
              <region><![CDATA[...]]></region>
          
              <latitude><![CDATA[...]]></latitude>
              <longitude><![CDATA[...]]></longitude>
          
              <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>
          
              <virtual_tour><![CDATA[...]]></virtual_tour>
          
              <date><![CDATA[...]]></date>
              <expiration_date><![CDATA[...]]></expiration_date>
              <plot_area><![CDATA[...]]></plot_area>
              <floor_number><![CDATA[...]]></floor_number>
              <orientation><![CDATA[...]]></orientation>
              <foreclosure><![CDATA[...]]></forclosure>
              <is_furnished><![CDATA[...]]></is_furnished>
              <is_new><![CDATA[...]]></is_new>
              <condition><![CDATA[...]]></s_condition>
              <year><![CDATA[...]]></year>
          
          
          
          
          </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.my/ad/7004578]]></url>
        <title><![CDATA[Johor-Johor Bahru]]></title>
        <type><![CDATA[For rent]]></type>
        <agency><![CDATA[Lettings Agency]]></agency>
        <content><![CDATA[Flat, 3 bedrooms, 2 bathrooms, open-plan living room and kitchen. Spacious, perfect for a small family or for students. Utilities are not included in the rental price.]]></content>
        <price><![CDATA[800]]></price>
        <property_type><![CDATA[Flat]]></property_type>
        <floor_area unit="feet"><![CDATA[300]]></floor_area>
        <rooms><![CDATA[3]]></rooms>
        <bathrooms><![CDATA[2]]></bathrooms>
        <parking><![CDATA[0]]></parking>
        <address><![CDATA[34 Juru Road]]></address>
        <city><![CDATA[Johor]]></city>
        <city_area><![CDATA[Juru]]></city_area>
        <postcode><![CDATA[W11]]></postcode>
        <region><![CDATA[Johor]]></region>
        <latitude><![CDATA[(51.51310938435912]]></latitude>
        <longitude><![CDATA[ -0.20099401473999023]]></longitude>
        <pictures>
        <picture>
        <picture_url><![CDATA[http://www.yourdomain.co.my/image.jpg]]></picture_url>
        <picture_title><![CDATA[living room]]></picture_title>
        </picture>
        </pictures>
        <virtual_tour><![CDATA[]]></virtual_tour>
        <date><![CDATA[31/07/2009]]></date>
        <expiration_date><![CDATA[31/12/2009]]></expiration_date>
        <plot_area><![CDATA[]]></plot_area>
        <floor_number><![CDATA[3]]></floor_number>
        <orientation><![CDATA[south]]></orientation>
        <foreclosure><![CDATA[]]></forclosure>
        <is_furnished><![CDATA[0]]></is_furnished>
        <is_new><![CDATA[0]]></is_new>
        <condition><![CDATA[recently renovated]]></s_condition>
        <year><![CDATA[1956]]></year>
        </ad>
        <ad>
        <id><![CDATA[332A53BC2]]></id>
        <url><![CDATA[http://www.yourdomain.co.my/ad/332A53BC2]]></url>
        <title><![CDATA[Semi-detached in Johor]]></title>
        <type><![CDATA[For sale]]></type>
        <content><![CDATA[Semi-Detached on a quiet residential street, ten minutes from the centre. 4 bedrooms, 4 bathrooms, small garden with a shed]]></content>
        <price><![CDATA[209950]]></price>
        <property_type><![CDATA[Flat]]></property_type>
        <floor_area unit="feet"><![CDATA[300]]></floor_area>
        <rooms><![CDATA[4]]></rooms>
        <bathrooms><![CDATA[4]]></bathrooms>
        <parking><![CDATA[1]]></parking>
        <address><![CDATA[]]></address>
        <city><![CDATA[Edinburgh]]></city>
        <postcode><![CDATA[]]></postcode>
        <region><![CDATA[Scotland]]></region>
        <pictures>
        <picture>
        <picture_url><![CDATA[http://www.yourdomain.co.my/image.jpg]]></picture_url>
        <picture_title><![CDATA[living room]]></picture_title>
        </picture>
        </pictures>
        <date><![CDATA[01/01/2011 18:30]]></date>
        <expiration_date><![CDATA[]]></expiration_date>
        <plot_area><![CDATA[400]]></plot_area>
        <floor_number><![CDATA[]]></floor_number>
        <orientation><![CDATA[]]></orientation>
        <foreclosure><![CDATA[]]></forclosure>
        <is_furnished><![CDATA[]]></is_furnished>
        <is_new><![CDATA[]]></is_new>
        <condition><![CDATA[]]></s_condition>
        <year><![CDATA[]]></year>
        
        
        
        </ad>
        </trovit>

Please don’t include any symbols such as £, $ or €. For every property type, the price is set in HDK by default. If the price is specified in a currency other than HDK, a currency tag should be included. This tag enables Trovit to convert the price to HDK.

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

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

Technical specifications

For more information, please click here: see technical specifications.

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