Your ads on Trovit South Africa

Homes 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 Homes vertical (see below)
    2. Download our XML Validator to ensure that your feed is Trovit friendly. The Validator will confirm that we can index your content correctly
    3. 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 property listings for sale or for rent. We do not include rooms for rent, garages, plots of land, vacation rentals, commercial properties… 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 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:

You can also view our Technical Specifications Sheet for more details.

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: type of listing:
    • “For Rent”: residential property for rent
    • “For Sale”: residential property 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 period="monthly"><![CDATA[...]]></price>
    <price period="weekly"><![CDATA[...]]></price>

    Please do not include any symbols such as $ or €. 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 period="monthly" currency="EUR"><![CDATA[...]]></price>

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

  • property_type: apartment, house, villa, bungalow, etc.
  • floor_area: area of the property in square feet (integer value)
  • rooms: number of bedrooms
  • bathrooms: number of bathrooms
  • parking: Whether or not the property has parking (format: 0 = No, 1 = Yes)
  • address: street address where the property is located. (23 Example Street , Cape Town )
  • city_area: City area where the property is located. (Beacon Bay, East London )
  • city: City where the property is located. (Johannesburg , Gauteng )
  • region: Province where the property is located. (KwaZulu-Natal , Durban )
  • postcode: postcode
  • agency: name of the agency
  • latitude: latitude
  • longitude: longitude
  • 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 186x186px and have a maximum size of 1MB.

  • virtual_tour: URL to the virtual tour of the property
  • eco_score: information, in free-text format, about the property’s energy efficiency.
  • plot_area: lot area / area of the land on which the property is located (integer value); select one of the following:
    <plot_area unit="feet"><![CDATA[...]]></plot_area>
    <plot_area unit="acres"><![CDATA[...]]></plot_area>
  • floor_number: floor number
  • orientation: orientation of the property: north, south, east or west
  • 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)
  • condition: condition of the property e.g.: “remodeled”, “second hand apartment” ot “new construction”
  • year: year the property was built in the format: YYYY
  • 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.

 

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>
    <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="feet"><![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>

<ad>
    ....
</ad>

...

</trovit>

Example XML feed

<?xml version="1.0" encoding="utf-8"?>
<trovit>
<ad>
<id><![CDATA[7004559]]></id>
<url><![CDATA[http://www.yourdomain.com/ad/7004559]]></url>
<title><![CDATA[Spacious 4 bedroom Apartment - Johannesburg]]></title>
<type><![CDATA[For sale]]></type>
<agency><![CDATA[Jozi Properties]]></agency>
<content><![CDATA[4 bedroom, american kitchen,2 bathrooms and a terrace]]></content>
<price><![CDATA[7500000]]></price>
<property_type><![CDATA[Apartment]]></property_type>
<floor_area><![CDATA[2000]]></floor_area>
<rooms><![CDATA[4]]></rooms>
<bathrooms><![CDATA[4]]></bathrooms>
<parking><![CDATA[0]]></parking>
<address><![CDATA[Ridgeway,Johannesburg South]]]></address>
<city><![CDATA[Johannesburg]]></city>
<city_area><![CDATA[Benrose]]></city_area>
<postcode><![CDATA[560076]]></postcode>
<region><![CDATA[Gauteng]]></region>
<pictures>
<picture>
<picture_url><![CDATA[http://www.domain.com/image.jpg]]></picture_url>
<picture_title><![CDATA[living room]]></picture_title>
</picture>
</pictures>
<virtual_tour><![CDATA[]]></virtual_tour>
<plot_area unit="meters"><![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[2006]]></year>
        <by_owner><![CDATA[1]]></by_owner> 



</ad>
<ad>
<id><![CDATA[332A53BC2]]></id>
<url><![CDATA[http://www.yourdomain.com/ad/332A53BC2]]></url>
<title><![CDATA[ Luxurious Condo-Durban]]></title>
<type><![CDATA[For sale]]></type>
<content><![CDATA[Fully furnished condo with equiped kitchen.]]></content>
<price><![CDATA[3700000]]></price>
<property_type><![CDATA[Condo]]></property_type>
<floor_area><![CDATA[2800]]></floor_area>
<rooms><![CDATA[2]]></rooms>
<bathrooms><![CDATA[2]]></bathrooms>
<parking><![CDATA[1]]></parking>
<address><![CDATA[60 Diakonia Avenue]]></address>
<city><![CDATA[Durban]]></city>
<city_area><![CDATA[Durban North]]></city_area>
<postcode><![CDATA[411016]]></postcode>
<region><![CDATA[KwaZulu-Natal]]></region>
<pictures>
<picture>
<picture_url><![CDATA[http://www.doman.com/image.jpg]]></picture_url>
<picture_title><![CDATA[view from front]]></picture_title>
</picture>
</pictures>
<virtual_tour><![CDATA[]]></virtual_tour>
<plot_area unit="meters"><![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[2008]]></year>
        <by_owner><![CDATA[0]]></by_owner>



</ad>
</trovit>
Privacy policy · Legal Notice · Terms and conditions · Cookie policy