Your ads on Trovit Hong Kong

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. Send the URL link where we can read your XML feed to our contact email. (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:

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, 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 you can indicate the specific period you would like to use. (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”, “Rentals” 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 HK 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)
    • eco_score: information, in free-text format, about the property’s energy efficiency.
    • 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
    • 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.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 cannot 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.
        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>

         

        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[Victoria-Sai Ying Poon]]></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 Kennedy Town Road]]></address>
        <city><![CDATA[Victoria]]></city>
        <city_area><![CDATA[Sai Ying Poon]]></city_area>
        <postcode><![CDATA[W11]]></postcode>
        <region><![CDATA[Victoria]]></region>
        <latitude><![CDATA[(51.51310938435912]]></latitude>
        <longitude><![CDATA[ -0.20099401473999023]]></longitude>
        <pictures>
        <picture>
        <picture_url><![CDATA[http://www.yourdomain.co.hk/image.jpg]]></picture_url>
        <picture_title><![CDATA[living room]]></picture_title>
        </picture>
        </pictures>
        <virtual_tour><![CDATA[]]></virtual_tour>
        <date><![CDATA[31/07/2009 18:30]]></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.hk/ad/332A53BC2]]></url>
        <title><![CDATA[Semi-detached in Victoria]]></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.hk/image.jpg]]></picture_url>
        <picture_title><![CDATA[living room]]></picture_title>
        </picture>
        </pictures>
        <date><![CDATA[20/08/2008 17: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.

      Technical Specifications

      for more information please click here: see technical spécifications.

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