Articles in this section

See more

United Arab Emirates - Homes Feed

Avatar
Thribee Help Center
  • Updated
Follow

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. Send the URL link where we can read your XML feed to Contact Trovit (Example: http://www.yourdomain.com/wp_feed.xml)

Upon receiving your feed, we will index your ads in Trovit, Mitula, Nestoria, Nuroa 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. You can use our Technical Specifications to see value restrictions for each tag. If you would like additional information about the XML format, check out Wikipedia.

*The feed should be written in UTF-8. The file has one ‘trovit’ tag, and one or more ‘ad’ elements. Each ‘ad’ element has the following fields:

REQUIRED FIELDS

The following fields are required 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 for rent
    • “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

Optional fields are not required in the feed. However, if you have the information, it’s best to include it! Trovit’s algorithm prioritizes higher-quality ads, so including more information will optimize your positioning in our search engine!

    • 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. The default payment term is monthly but you can indicate alternative payment terms (weekly or daily) by applying the appropriate syntax: 
      <price period="weekly"><![CDATA[...]]></price>
<price period="daily"><![CDATA[...]]></price>

      Please do not include symbols such as $ or €. If the price is specified in a currency other than the official currency (AED), please apply the appropriate syntax within the ‘price’ tag using ISO-4217. This will enable Trovit to convert the price to the official currency (AED).

      <price period="weekly" currency="CAD"><![CDATA[...]]></price>

      In this example, the weekly rental price is in Canadian dollars. Trovit will convert this into AE Dirhams.

    • property_type: apartment, home, bungalow, villa, condo, etc. (only applicable if you filled out “for rent” or “for sale” in the field “type”) Please view our Technical Specifications Sheet for more details.
    • foreclosure: whether or not the property is in foreclosure; (format: 0 = No, 1 = Yes)
    • address: street address
    • floor_number: floor number/stories
    • city_area: city area or neighborhood where the property is located
    • city: city name
    • postcode: zipcode
    • region: emirate
    • latitude: latitude of the property [-90.0, 90.0]
    • longitude: longitude of the property [-180.0,180.0]
    • orientation: orientation of the property: north, south, east or west
    • agency: name of the listing agency
    • floor_area: area of the property in square feet (integer value)
    • plot_area: lot area / area of the land on which the property is located; select one of the following: 
      <plot_area unit="feet"><![CDATA[...]]></plot_area>
<plot_area unit="acres"><![CDATA[...]]></plot_area>
    • rooms: number of bedrooms
    • bathrooms: number of bathrooms, decimal values permitted (ex. 2.5)
    • condition: condition of the home. e.g.: “remodeled” or “second hand apartment”
    • 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.
    • pictures: This tag includes the distinct images of the property.The field that defines a specific image is <picture>:
      • 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.

    • date: date and time of the ad in the following format: DD/MM/YYYY or DD/MM/YYYY HH:MM:SS
    • expiration_date: date that the ad expires in the following format: DD/MM/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.
    • parking: whether or not the property has parking. (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 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>
    <content><![CDATA[...]]></content>
    <price><![CDATA[...]]></price>
    <property_type><![CDATA[...]]></property_type>
    <address><![CDATA[...]]></address>
    <floor_number><![CDATA[...]]></floor_number>
    <city_area><![CDATA[...]]></city_area>
    <city><![CDATA[...]]></city>
    <region><![CDATA[...]]></region>
    <latitude><![CDATA[...]]></latitude>
    <longitude><![CDATA[...]]></longitude>
    <orientation><![CDATA[...]]></orientation>
    <agency><![CDATA[...]]></agency>
    <floor_area><![CDATA[...]]></floor_area>
    <plot_area unit="acres"><![CDATA[...]]></plot_area>
    <rooms><![CDATA[...]]></rooms>
    <bathrooms><![CDATA[...]]></bathrooms>
    <condition><![CDATA[...]]></condition>
    <year><![CDATA[...]]></year>
    <virtual_tour><![CDATA[...]]></virtual_tour>
    <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>
    <expiration_date><![CDATA[...]]></expiration_date>
    <by_owner><![CDATA[...]]></by_owner>
    <parking><![CDATA[...]]></parking>
    <is_furnished><![CDATA[...]]></is_furnished>
    <is_new><![CDATA[...]]></is_new>
</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[4 br, 2 bath House Dubai Marina]]></title>
<type><![CDATA[For rent]]></type>
<content><![CDATA[Large 2 bedroom with large eat-in kitchen area, and 2nd entrance with deck.]]></content>
        <price><![CDATA[1195]]></price>
<property_type><![CDATA[House]]></property_type>
<address><![CDATA[Emirates Hills, Sector R]]]></address>
<floor_number><![CDATA[2]]></floor_number>
<city_area><![CDATA[Emirates Hills]]></city_area>
<city><![CDATA[Dubai]]></city>
<region><![CDATA[Dubai]]></region>
<latitude><![CDATA[42.276230]]></latitude>
<longitude><![CDATA[-83.7455700]]></longitude>
<orientation><![CDATA[]]></orientation>
<agency><![CDATA[UAE Property Mgmt]]></agency>
<floor_area><![CDATA[2000]]></floor_area>
<plot_area unit="acres"><![CDATA[1]]></plot_area>
<rooms><![CDATA[4]]></rooms>
<bathrooms><![CDATA[2]]></bathrooms>
<condition><![CDATA[]]></condition>
<year><![CDATA[2006]]></year>
<virtual_tour><![CDATA[]]></virtual_tour>
        <pictures>
<picture>
<picture_url><![CDATA[http://www.yourdomain.com/image.jpg]]></picture_url>
<picture_title><![CDATA[living room]]></picture_title>
</picture>
</pictures>
<date><![CDATA[31/02/2011 17:30:00]]></date>
        <expiration_date><![CDATA[01/06/2012]]></expiration_date>
        <by_owner><![CDATA[1]]></by_owner>
<parking><![CDATA[1]]></parking>
<is_furnished><![CDATA[0]]></is_furnished>
<is_new><![CDATA[0]]></is_new>
</ad>
<ad>
<id><![CDATA[332A53BC2]]></id>
<url><![CDATA[http://www.yourdomain.com/ad/332A53BC2]]></url>
<title><![CDATA[ 1 br, 1 bath Apartment - Al Qurm]]></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[2209950]]></price>
<property_type><![CDATA[Apartment]]></property_type>
<address><![CDATA[Al Qurm Resort]]></address>
<floor_number><![CDATA[]]></floor_number>
<city_area><![CDATA[Al Qurm]]></city_area>
<city><![CDATA[Abu Dhabi]]></city>
<region><![CDATA[Abu Dhabi]]></region>
<latitude><![CDATA[42.276230]]></latitude>
<longitude><![CDATA[-83.7455700]]></longitude>
<orientation><![CDATA[west]]></orientation>
<agency><![CDATA[Resort Properties]]></agency>
<floor_area><![CDATA[1100]]></floor_area>
<plot_area unit="feet"><![CDATA[]]></plot_area>
<rooms><![CDATA[1]]></rooms>
<bathrooms><![CDATA[1]]></bathrooms>
<condition><![CDATA[]]></condition>
<year><![CDATA[1998]]></year>
<virtual_tour><![CDATA[]]></virtual_tour>
<pictures>
<picture>
<picture_url><![CDATA[http://www.yourdoman.com/image.jpg]]></picture_url>
<picture_title><![CDATA[living room]]></picture_title>
</picture>
</pictures>
<date><![CDATA[31/06/2011 09:30:00]]></date>
        <expiration_date><![CDATA[31/12/2012]]></expiration_date>
        <by_owner><![CDATA[1]]></by_owner>
<parking><![CDATA[0]]></parking>
<is_furnished><![CDATA[]]></is_furnished>
<is_new><![CDATA[]]></is_new>
</ad>
</trovit>

TECHNICAL SPECIFICATIONS

For more information, see our technical specifications

Comments

0 comments

Please sign in to leave a comment.