Your ads on Trovit Australia

Homes Feed

If you own a Classified Ads Portal with public advertisements, include your ads in Trovit!

You only need to follow these simple steps:

  1. Prepare 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 (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 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:

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).
  • type: select the appropriate property type per ad:
    • “For Rent”: property to let
    • “For Sale”: property for sale
    • “Roommate”: flatshare
    • “Land For Sale”: land for sale
  • content: content of the ad (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 property for sale or for rent (integer value). For rental listings, you can indicate the period of rent (weekly or monthly) by selecting one of the following:
    <price><![CDATA[...]]></price>
    <price period="monthly"><![CDATA[...]]></price>
    <price period="weekly"><![CDATA[...]]></price>

    Please do not include any symbols such as $ or €. The price is specified in “AUD” by default. If the price is specified in a currency other than AUD, a currency tag should be included. This tag enables Trovit to convert the price to AUD. Each currency value will be determined by the standard ISO-4217.

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

    In this example, the price is specified in USD. Trovit will convert this to AUD.

  • property_type: apartment, home, studio, condo, etc.
  • rooms: number of bedrooms
  • bathrooms: number of bathrooms, decimal values permitted (ex. 2.5)
  • address: street address where the property is located. (23 Example Street , Sydney )
  • city_area: City area where the property is located. (Burnside, Adelaide )
  • city: City where the property is located. (Brisbane , Queensland )
  • region: State where the property is located. (Western Australia , Perth )
  • postcode: postcode
  • date: date of the ad in one of the following formats: DD/MM/YYYY or DD/MM/YYYY HH:MM:SS
  • floor_number: floor number/storys
  • latitude: latitude of the property
  • longitude: longitude of the property
  • orientation: orientation of the property: north, south, east or west
  • agency: name of the listing agency
  • mls_database: MLS ID#
  • floor_area: area of the property in metres squared (integer value)
  • plot_area: lot area / area of the land on which the property is located (integer value); select one of the following:
    <plot_area unit="metres"><![CDATA[...]]></plot_area>
    <plot_area unit="acres"><![CDATA[...]]></plot_area>>
  • condition: condition of the home. e.g.: “renovated” or “development”
  • year: year the property was built in the format: YYYY
  • virtual_tour: URL to the virtual tour of the property
  • eco_score: information, in free-text format, about the property’s energy efficiency.
  • picture: This tag includes the fields to specify the URL and the title of the image (title is optional). You are able to specify if the image is featured with the attribute ‘featured’.
    <picture featured="true"><![CDATA[...]]></picture>

    The values available for ‘featured’ are: “true” or “false”.

    The fields to define within the element <picture> are:

    • picture_url: Image URL.
    • picture_title: Image title.
<pictures>
    <picture>
        <picture_url><![CDATA[...]]></picture_url>
        <picture_title><![CDATA[...]]>/picture_title>
    </picture> 

    <picture featured="true">
        <picture_url><![CDATA[...]]></picture_url>
        <picture_title><![CDATA[...]]>/picture_title>
    </picture>
        ...
</pictures>

The image shown in Trovit for a particular ad will be the first in the set of images for the ad, except if one of them is marked as ‘featured’.
Choose the adequate image as this largely influences the user’s clicks.

Trovit does not allow corporate photos with the message “Image not 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 160x160px and have a maximum size of 5MB.

  • by_owner: whether or not the property is For Sale By Owner (format: 0 = No, 1 = Yes.) It’s not necessary to populate this field if the property is being marketed by a Real Estate Agent.
  • is_rent_to_own: whether or not the property is rent to own.
  • parking: whether or not the property has parking. (format: 0 = No, 1 = Yes)
  • foreclosure: whether or not the property is in foreclosure; (format: 0 = No, 1 = Yes)
  • is_furnished: whether or not the property is furnished (format: 0 = No, 1 = Yes)
  • 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 property is new (format: 0 = No, 1 = Yes)

UTF-8 XML FORMAT

<?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><![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>

    <plot_area unit="acres"><![CDATA[...]]></plot_area>
    <floor_number><![CDATA[...]]></floor_number>
    <orientation><![CDATA[...]]></orientation>
    <foreclosure><![CDATA[...]]></foreclosure>
    <is_furnished><![CDATA[...]]></is_furnished>
    <date><![CDATA[...]]></date>
    <expiration_date><![CDATA[...]]></expiration_date>    
    <is_new><![CDATA[...]]></is_new>
    <condition><![CDATA[...]]></condition>
    <year><![CDATA[...]]></year>
    <by_owner><![CDATA[...]]></by_owner>




</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[Magnificent Family House - Sydney]]></title>
<type><![CDATA[For Rent]]></type>
<agency><![CDATA[Ocean Properties]]></agency>
<content><![CDATA[Spacious and spotlessly maintained open plan 3 bedroom brick home, 2 bathrooms. Gas heating & air conditioning are also available.]]></content>
<price><![CDATA[800]]></price>
<property_type><![CDATA[House]]></property_type>
<floor_area><![CDATA[85]]></floor_area>
<rooms><![CDATA[3]]></rooms>
<bathrooms><![CDATA[2]]></bathrooms>
<parking><![CDATA[1]]></parking>
<address><![CDATA[44 Salisbury Rd]]]></address>
<city><![CDATA[Sydney]]></city>
<city_area><![CDATA[Kensington]]></city_area>
<region><![CDATA[NSW]]></region>
<pictures>
<picture>
<picture_url><![CDATA[http://www.yourdomain.com/image.jpg]]></picture_url>
<picture_title><![CDATA[bedroom]]></picture_title>
</picture>
</pictures>
<virtual_tour><![CDATA[]]></virtual_tour>
<floor_number><![CDATA[2]]></floor_number>
<orientation><![CDATA[]]></orientation>
<is_furnished><![CDATA[]]></is_furnished>
<date><![CDATA[...]]></date>
        <expiration_date><![CDATA[...]]></expiration_date>
        <is_new><![CDATA[]]></is_new>
<condition><![CDATA[]]></condition>
<year><![CDATA[2006]]></year>



</ad>
<ad>
<id><![CDATA[332A53BC2]]></id>
<url><![CDATA[http://www.yourdomain.com/ad/332A53BC2]]></url>
<title><![CDATA[ 1 bedroom, 1 batroom Unit - Melbourne]]></title>
<type><![CDATA[For Sale]]></type>
<content><![CDATA[Garden level 1 bdrm. Cozy living room with plenty of sunlight. Newly remodeled master bath.]]></content>
<price><![CDATA[289950]]></price>
<property_type><![CDATA[Unit]]></property_type>
<floor_area><![CDATA[60]]></floor_area>
<rooms><![CDATA[1]]></rooms>
<bathrooms><![CDATA[1]]></bathrooms>
<parking><![CDATA[0]]></parking>
<address><![CDATA[7 McLister St]]></address>
<city><![CDATA[Melbourne]]></city>
<city_area><![CDATA[Spotswood]]></city_area>
<region><![CDATA[VIC]]></region>
<pictures>
<picture>
<picture_url><![CDATA[http://www.yourdomain.com/image.jpg]]></picture_url>
<picture_title><![CDATA[bedroom]]></picture_title>
</picture>
</pictures>
<virtual_tour><![CDATA[]]></virtual_tour>
<floor_number><![CDATA[]]></floor_number>
<orientation><![CDATA[]]></orientation>
<is_furnished><![CDATA[]]></is_furnished>
<date><![CDATA[31/02/2011 17:30]]></date>
        <expiration_date><![CDATA[01/06/2012]]></expiration_date>
        <is_new><![CDATA[]]></is_new>
<condition><![CDATA[]]></condition>
<year><![CDATA[1998]]></year>
        <by_owner><![CDATA[1]]></by_owner>



</ad>
</trovit>

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