Your ads on Trovit Pakistan

Homes Feed

Prepare a UTF-8 XML feed in the format specified for our Homes vertical (see below)

    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)

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 per listing. 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: type of listing. Trovit only accepts “For Rent” or “For Sale” listings at the moment.
  • content: description of the property (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. The default payment term is monthly but you can indicate alternative payment terms (weekly or daily) by applying the appropriate syntax:
      <price period="monthly"><![CDATA[...]]></price>
      <price period="weekly"><![CDATA[...]]></price>

      Please do not include any symbols such as $ or Rs. If the price is specified in a currency other than the official currency (PKR), please apply the attribute “currency” within the ‘price’ tag. Each currency value will be determined by the standard ISO-4217. With this, Trovit will convert the price to the official currency (PKR)

      Below is an example of a complete syntax:

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

      In this example, the price is specified as weekly in USD ($). Trovit will convert this to PKR.

    • id: id of the ad on your website (numeric or alphanumeric, however it must be unique because we use it to avoid duplicate entries)
    • property_type: apartment, home, studio, condo, 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
    • city: city name
    • city_area: city area or neighborhood where the property is located
    • postcode: zipcode
    • region: state
    • latitude: latitude
    • longitude: longitude of the property
    • orientation: orientation of the property: north, south, east or west
    • 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.
        <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>
      • picture_title: Title of the picture
      • picture_url: URL link to the picture on your website
<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>

The picture shown on Trovit is the first picture of the set of pictures included in the feed. Please select this picture carefully as it has a strong influence on the click through behaviour of our users.

Trovit doesn’t allow corporate images with information such as “No image available”.
If Trovit detects these kind of pictures, it has the right to stop the inclusion of your ads.

Once inserted for the first time, our system doesn’t modify or upload new pictures.
Please make sure that you include the correct picture(s) once you include the ad in the feed for the first time. Images must be at least 186x186px and have a maximum size of 1MB.

  • virtual_tour: URL to the virtual tour of the property
  • 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.
  • 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)
  • 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
  • eco_score: information, in free-text format, about the property’s energy efficiency.
  • 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>
    
        <date><![CDATA[...]]></date>
        <plot_area unit="feet"><![CDATA[...]]></plot_area>
        <floor_number><![CDATA[...]]></floor_number>
        <orientation><![CDATA[...]]></orientation>
        <foreclosure><![CDATA[...]]></foreclosure>
        <is_furnished><![CDATA[...]]></is_furnished>
        <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 - BTM Layout Lahore]]></title>
    	<type><![CDATA[For sale]]></type>
    	<agency><![CDATA[Lahore Properties]]></agency>
    	<content><![CDATA[2BHK furnished, american kitchen has en-suite bathroom]]></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[52 Ghazi Road]]]></address>
    	<city><![CDATA[Lahore]]></city>
    	<city_area><![CDATA[Alpha Society]]></city_area>
    	<postcode><![CDATA[560076]]></postcode>
    	<region><![CDATA[Lahore]]></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>
    	<date><![CDATA[31/03/2010 16:30]]></date>
    	<plot_area unit="feet"><![CDATA[]]></plot_area>
    	<floor_number><![CDATA[]]></floor_number>
    	<orientation><![CDATA[]]></orientation>
    	<foreclosure><![CDATA[]]></foreclosure>
    	<is_furnished><![CDATA[]]></is_furnished>
    	<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 2 bedroom bungalow -Islamabad]]></title>
    	<type><![CDATA[For sale]]></type>
    	<content><![CDATA[Fully furnished 2BHK bungalow, 3 bedroom and a terrace.]]></content>
    	<price><![CDATA[3700000]]></price>
    	<property_type><![CDATA[Bungalow]]></property_type>
    	<floor_area><![CDATA[2800]]></floor_area>
    	<rooms><![CDATA[2]]></rooms>
    	<bathrooms><![CDATA[2]]></bathrooms>
    	<parking><![CDATA[1]]></parking>
    	<address><![CDATA[Fateh Jung]]></address>
    	<city><![CDATA[Islamabad]]></city>
    	<city_area><![CDATA[Sohan Valley]]></city_area>
    	<postcode><![CDATA[411016]]></postcode>
    	<region><![CDATA[Islamabad]]></region>
    	<pictures>
    		<picture>
    			<picture_url><![CDATA[http://www.yourdoman.com/image.jpg]]></picture_url>
    			<picture_title><![CDATA[view from front]]></picture_title>
    		</picture>
    	</pictures>
    	<virtual_tour><![CDATA[]]></virtual_tour>
    	<date><![CDATA[27/02/2010 15:30]]></date>
    	<plot_area unit="feet"><![CDATA[]]></plot_area>
    	<floor_number><![CDATA[]]></floor_number>
    	<orientation><![CDATA[]]></orientation>
    	<foreclosure><![CDATA[]]></foreclosure>
    	<is_furnished><![CDATA[]]></is_furnished>
    	<is_new><![CDATA[]]></is_new>
    	<condition><![CDATA[]]></condition>
    	<year><![CDATA[2008]]></year>
            <by_owner><![CDATA[0]]></by_owner>
    
    
    
    </ad>
    </trovit>

    Technical Specifications

    For more information, click here: see technical specifications.

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