	20% annualised returns with complete capital protection.
		20% annualised returns with complete capital protection. IPIN's Secure Exit Strategy enables you to profit from the current economic climate and generate 20%+ annualised returns with no risk to your capital, low entry levels and no ongoing costs. Already proven on 6 UK projects. Click Here to find out more.

Propertyshowrooms.com Xml Specification

This document details the specification of the XML file required to export property information in the Propertyshowrooms.com format.

If possible, please create your xml to be available as a "live" link for us to pick up. This way we will be able to automatically refresh feeds on a regular basis.

To validate your feed, visit http://schemas.propertyshowrooms.com you can validate either files or urls within this page.

Element:

Required:

Definition:

<?xml version="1.0" encoding="UTF-8"?>

yes

The very first line of the feed. This can be either UTF-8, UTF-16 or ISO-8859-1

<root>

yes

Opens the document

yes

Identifies the Propertyshowrooms feed version.

yes

Opens the property node for each individual property.

yes

Must be datetime which is 19 characters and is usually the last modified date for the property as it is in your database. This must follow or be converted to standard datetime format of: YYYY-MM-DD HH:MM:SS. This is used in conjunction with the <id> tag to determine if the property should be added or updated.

yes

Alphanumeric, max 20 characters. This is the unique identifier for each property that you list. You will have something similar in you database so its recommended that you use this for ease of identification. This is used in conjunction with the <date> tag to determine if the property should be added or updated. This will need to be a unique reference number or the system will not except the property

yes

Numeric, max 8 characters. This is used in conjunction with <price_freq> and <currency> tags to establish the pricing for the property in question. This is the price the price the property is for sale at. Please only use whole numbers only with no punctuation. (e.g, 200000 NOT 200,000 or 200.000,00 or 200,000.00) No deviations from this method will be accepted. For development price variations, enter the LOWEST PRICE and use the <desc> node to detail pricing options.

yes

Used in conjunction with <price> tag. This must be the correct and up-to-date official ISO currency code. You can look up your curreny code below:

<price_freq>sale</price_freq>

yes

Alpha 'sale' for properties for sale. Do not put anything else in this tag, This tag used in conjunction with <price> and <currency> tags.

<part_ownership>0</part_ownership>

Numeric. '1' denotes price does not represent 100% ownership. Applicable only when <price_freq> is set to 'sale'. Empty, missing tag or '0' denotes a 'normal' property for sale.

Numeric. '1' denotes leasehold is being offered. Applicable only when <price_freq> is set to 'sale'. Empty, missing tag or '0' denotes a freehold is for sale.

Numeric. "1" denotes it is a new development, "0" denotes it is resale.
An empty or missing tag will denote a resale property

<type>
<en>Townhouse</en>
</type>

yes

Alpha. Property type in ENGLISH only. Will be converted to one of the following property types during import:

Apartment	Cabin	Business	Maisonette	Flat
Airport	Garage	Penthouse	House	Cavehouse
Land	Rural	Villa	Church	Hospital
Village	Townhouse	Game Reserve	Ruins	Other

<town>Marbella</town>

yes

Alpha. This needs to be the nearest locale, town or city, preferably a valid Postal location (eg: Javea, Nerja, Paris, Berlin).

<province>Andalusia</province>

yes

Alpha. This needs to be the 1st administrative division the town is located in. (e.g, the first divisions that a country is divided into, Andalucía, Hampshire, Texas) AKA Province, Region, County, State. This does not include small municipalities that lie within another larger region or tourist names for areas (e.g, Costa del Sol or the Algarve for instance), preferably a valid Postal province or region.

<country>Spain</country>

yes

Alpha. Country name, (eg: Germany, France).

<location_detail>Malaga</location_detail>

Alphanumeric. max 50 characters Free text used to describe an area that is important to the location of your listing. for instance, if your listing is in Marbella the province has to be Andalusia (as above) but you may like to add Malaga in this tag to show that it is in Malaga municipality.

yes

Numeric. Number of bedrooms, '0' denotes 'no beds' (Studio apartment). Whole numbers ONLY. Not 1.5 etc.

yes

Numeric. Number of bathrooms, '0' denotes 'no baths'. Whole numbers ONLY. Not 1.5 etc.

yes

Numeric. '1' denotes a pool is available and '0' denotes 'no pool'.

<surface_area>
<built>200</built>
<plot>3000</plot>
<terrace>60</terrace>
</surface_area>

Numeric. All areas must be in square meters. Use whole numbers only, with no punctuation (i.e. 200000 NOT 200,000 or 200.000,00 or 200,000.00).

Numeric. All distances must be in meters, leave blank or zero if not applicable.

Alpha. North, East, South, West. Can be left blank if unknown.

<views>Sea, Mountains</views>

yes

Alphanumeric. Up to 200 characters free text, NO HTML or page breaks, Links or Logos.

Numeric. 1 denotes car park is available. 0 denotes car park is not available.

1 denotes yes, 0 denotes for no.

<desc>
<en>English property description</en>
</desc>

yes

Alphanumeric. There should be no contact details or company information of any kind in any part of the description under any circumstances (i.e. email addresses, web addresses, company name or telephone numbers). There is no character limit but the absolute minimum is 50 characters long.

Descriptions should be encoded to ensure the following characters are encrypted.

Below is a list of the accepted html encoding:

<b></b>	<blockquote></blockquote>	<br/>	<center></center>
<cite></cite>	<dfn></dfn>	<em></em>	<i></i>
<wbr>	<p></p>	<strong></strong>	<sub></sub>
>	&		<
<u></u>	<sup></sup>	"

Please note that any descriptions where the html is untidy or corrupt will be rejected.

<images>
<image id="1">
<url>http://www.website.com/images/141.jpg</url>
<primary>1</primary>
<title>
<en>title of the image</en>
</title>
</image>
</images>

The images node has a maximum of 10 image's per property. Image id's start at 1 and end in 10. The url tag needs to be the absolute http url of each image. The original image size must be at least 640 x 480 pixels. No images below this size will be accepted It must also be a JPG image and end in the ".jpg" extension, No other types are supported. Primary tag denotes if is the main image for this property (the one that displays in Propertyshowrooms.com search results). Only one image per property can be marked as 'primary' images (empty or missing tag or '0' denotes a non-primary image). If this tag is not used, the first image listed will be imported as the 'primary' image. No watermarks or text of any kind are allowed in any of the images. Optional title tag, max 150 characters, describing the image. This format can be repeated for 10 images - up to <image id="10">

</property>

yes

End of property node.

</root>

yes

MUST be the last line of the feed.

This sequence should be repeated for each property you wish to include in your feed. To validate your feed go to http://schemas.propertyshowrooms.com.

Click Here to Submit your Real Estate Listings