Navigation: International XML Spec | USA XML Spec | Sample XML
When sending your feed please send secure images [https] and understand we can only display the information on our site that is contained within your feed.
To assist you in understanding the information we require and additional information we are able to display we have provided the fields below.
Required Fields
*Country:
*Address1:
*City:
*State/Region:
*Zip Code/Postal Code:
*Price:
*Local Currency:
*Title:
*Property Description:
Additional Information
Sale Type:
Sale Type:
Property Status:
County:
Currency:
MLS#:
Pool:
Baths:
Beds:
Yr Built:
Garden:
Measurement:
Building Size:
Lot Size:
Furnished:
Parking:
View:
Orientation:
Subdivision:
Scenery/Style:
Floor Type:
Roof Type:
International XML Specification
<?xml version="1.0" encoding="UTF-8"?>
<root>
<properties>
<!-- REQUIRED, string, alphanumeric characters, without spaces, in this format: [Site Initials]_[Property ID]_[Ref No] -->
<property refno="CO_10_CV00113">
<dateupdate>2008-06-25 14:23:00</dateupdate>
<!-- REQUIRED, last update date of property in mysql format "yyyy-mm-dd hh:mm:ss" -->
<seller>Charles Oliver</seller>
<!-- REQUIRED, seller name -->
<address1></address1>
<!-- string -->
<address2></address2>
<!-- string -->
<address3></address3>
<!-- string -->
<city>London</city>
<!-- REQUIRED, string -->
<county></county>
<!-- string -->
<postcode></postcode>
<!-- string -->
<country>UNITED KINGDOM</country>
<!-- REQUIRED, string -->
<region>London, City of</region>
<!-- REQUIRED, string -->
<latitude></latitude>
<!-- string -->
<longitude></longitude>
<!-- string -->
<propertytype>Land</propertytype>
<!-- REQUIRED, string -->
<!-- must be one of: House/Villa, Flat/Apartment, Land, Commercial -->
<othertype></othertype>
<!-- string -->
<saletype>New Build</saletype>
<!-- REQUIRED, string -->
<!-- must be one of: New Build, Resale, Rental -->
<tenure></tenure>
<!-- can be one of: Not Specified, Freehold, Leasehold -->
<condition></condition>
<!-- string -->
<!-- can be one of: Not Specified, Excellent, Good, Needs Decorating, Needs Modernising, Needs Renovation -->
<price>100000</price>
<!-- REQUIRED, numeric, integer -->
<maxprice></maxprice>
<!-- numeric, integer -->
<currency>GBP</currency>
<!-- REQUIRED, string -->
<!-- must be one of: EUR, GBP, USD, CAN -->
<communalfee></communalfee>
<!-- numeric, integer -->
<datecompletion></datecompletion>
<!-- string -->
<title>
<!-- REQUIRED, string -->
</title>
<summary>
<!-- REQUIRED, string -->
</summary>
<nobeds>Not Specified</nobeds>
<!-- REQUIRED, string -->
<!--
must be one of: Not Specified, Studio, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20+
if propertytype="Land"|"Commercial" then nobeds="Not Specified"
-->
<maxnobeds></maxnobeds>
<!-- string -->
<!-- if present, must be one of: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20+ -->
<nobathrooms></nobathrooms>
<!-- string -->
<!-- can be one of: Not Specified, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20+ -->
<noreceptionrooms></noreceptionrooms>
<!-- string -->
<!-- can be one of: Not Specified, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20+ -->
<floor></floor>
<!-- string -->
<!-- can be one of: Not Specified, Basement, Ground Floor, 1st Floor, 2nd Floor, 3rd Floor, 4th Floor, 5th Floor, 6th Floor, 7th Floor, 8th Floor, 9th Floor, Top Floor -->
<floorspace></floorspace>
<!-- numeric, integer -->
<furnished></furnished>
<!-- string -->
<!-- can be one of: Not Specified, Unfurnished, Furnished, Negotiable -->
<pool></pool>
<!-- string -->
<!-- can be one of: Not Specified, Communal, Private -->
<garden></garden>
<!-- string -->
<!-- can be one of: Not Specified, Communal, Private -->
<plot></plot>
<!-- numeric, integer -->
<coveredarea></coveredarea>
<!-- numeric, integer -->
<parking></parking>
<!-- string -->
<!-- can be one of: Not Specified, Street Parking, Off Street Parking, Garage -->
<outbuildings></outbuildings>
<!-- string -->
<!-- can be one of: Not Specified, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10+ -->
<view></view>
<!-- string -->
<!-- can be one of: Not Specified, Sea, Mountain, Urban, Country, City Scape -->
<orientation></orientation>
<!-- string -->
<!-- can be one of: Not Specified, North, North-East, East, South-East, South, South-West, West, North-West -->
<distancesea></distancesea>
<!-- string -->
<!-- can be one of: Not Specified, Walking, 15 mins, 30 mins, 45 mins, 1 hour, 1.5 hours, 1.5 hours + -->
<distanceairport></distanceairport>
<!-- string -->
<!-- can be one of: Not Specified, Walking, 15 mins, 30 mins, 45 mins, 1 hour, 1.5 hours, 1.5 hours + -->
<distancegolf></distancegolf>
<!-- string -->
<!-- can be one of: Not Specified, Walking, 15 mins, 30 mins, 45 mins, 1 hour, 1.5 hours, 1.5 hours + -->
<distanceattraction></distanceattraction>
<!-- string -->
<!-- can be one of: Not Specified, Walking, 15 mins, 30 mins, 45 mins, 1 hour, 1.5 hours, 1.5 hours + -->
<detailnotes>
<!-- string -->
<en></en>
<!--
supported languages: en (required), fr, it, es, pt, de, ru, nl, no
-->
</detailnotes>
<fullurl>
<!-- string -->
</fullurl>
<vrtour>
<!-- string -->
</vrtour>
<video>
<!-- string -->
</video>
<propertystatus>For Sale</propertystatus>
<!-- REQUIRED, string -->
<!-- must be one of: Available, Under Offer, Unavailable -->
<additionalnotes></additionalnotes>
<!-- string -->
<featuredproperty></featuredproperty>
<!-- string, do not enter anything -->
<measureunits></measureunits>
<!-- string -->
<!-- can be one of: m2, Ha, Acres -->
<images>
<image id="1">
<url>http://yourdomain/image1.jpg</url>
<!-- string, full URL to the image, only JPG extension is allowed. Images must be at least 400 x 300 px -->
<!-- this is the main image -->
</image>
<image id="2">
<url>http://yourdomain/image2.jpg</url>
<!-- string, full URL to the image -->
</image>
<!-- add here up to 10 images ... -->
<image id="10">
<url>http://yourdomain/image10.jpg</url>
<!-- string, full URL to the image, only JPG extension is allowed -->
</image>
</images>
<features>
<!-- list of property features to be displayed on bullets -->
<feature id="1">
<description></description>
<!-- string -->
<spanish_description></spanish_description>
<!-- string -->
</feature>
<feature id="2">
<description></description>
<!-- string -->
<spanish_description></spanish_description>
<!-- string -->
</feature>
<feature id="3">
<description></description>
<!-- string -->
<spanish_description></spanish_description>
<!-- string -->
</feature>
<feature id="4">
<description></description>
<!-- string -->
<spanish_description></spanish_description>
<!-- string -->
</feature>
<feature id="5">
<description></description>
<!-- string -->
<spanish_description></spanish_description>
<!-- string -->
</feature>
</features>
</property>
</properties>
</root>
BACK TO THE TOP
USA XML Specification
<?xml version="1.0" encoding="UTF-8"?>
<root>
<properties>
<!-- REQUIRED, string, alphanumeric characters, without spaces, in this format: [Site Initials]_[Property ID]_[Ref No] -->
<property refno="CO_10_CV00113">
<dateupdate>2008-06-25 14:23:00</dateupdate>
<!-- REQUIRED, last update date of property in mysql format "yyyy-mm-dd hh:mm:ss" -->
<seller>Charles Oliver</seller>
<!-- REQUIRED, seller name -->
<address1></address1>
<!-- string -->
<address2></address2>
<!-- string -->
<address3></address3>
<!-- string -->
<city>Los Angeles</city>
<!-- REQUIRED, string -->
<county></county>
<!-- string -->
<postcode></postcode>
<!-- string -->
<region>California</region>
<!-- REQUIRED, string -->
<latitude></latitude>
<!-- string -->
<longitude></longitude>
<!-- string -->
<propertytype>Land</propertytype>
<!-- REQUIRED, string -->
<!-- must be one of: House/Villa, Flat/Apartment, Land, Commercial -->
<othertype></othertype>
<!-- string -->
<saletype>New Build</saletype>
<!-- REQUIRED, string -->
<!-- must be one of: New Build, Resale, Rental -->
<tenure></tenure>
<!-- can be one of: Not Specified, Freehold, Leasehold -->
<condition></condition>
<!-- string -->
<!-- can be one of: Not Specified, Excellent, Good, Needs Decorating, Needs Modernising, Needs Renovation -->
<price>100000</price>
<!-- REQUIRED, numeric, integer -->
<maxprice></maxprice>
<!-- numeric, integer -->
<currency>GBP</currency>
<!-- REQUIRED, string -->
<!-- must be one of: EUR, GBP, USD, CAN -->
<communalfee></communalfee>
<!-- numeric, integer -->
<datecompletion></datecompletion>
<!-- string -->
<title>
<!-- REQUIRED, string -->
</title>
<summary>
<!-- REQUIRED, string -->
</summary>
<nobeds>Not Specified</nobeds>
<!-- REQUIRED, string -->
<!--
must be one of: Not Specified, Studio, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20+
if propertytype="Land"|"Commercial" then nobeds="Not Specified"
-->
<maxnobeds></maxnobeds>
<!-- string -->
<!-- if present, must be one of: 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20+ -->
<nobathrooms></nobathrooms>
<!-- string -->
<!-- can be one of: Not Specified, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20+ -->
<noreceptionrooms></noreceptionrooms>
<!-- string -->
<!-- can be one of: Not Specified, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20+ -->
<floor></floor>
<!-- string -->
<!-- can be one of: Not Specified, Basement, Ground Floor, 1st Floor, 2nd Floor, 3rd Floor, 4th Floor, 5th Floor, 6th Floor, 7th Floor, 8th Floor, 9th Floor, Top Floor -->
<floorspace></floorspace>
<!-- numeric, integer -->
<furnished></furnished>
<!-- string -->
<!-- can be one of: Not Specified, Unfurnished, Furnished, Negotiable -->
<pool></pool>
<!-- string -->
<!-- can be one of: Not Specified, Communal, Private -->
<garden></garden>
<!-- string -->
<!-- can be one of: Not Specified, Communal, Private -->
<plot></plot>
<!-- numeric, integer -->
<coveredarea></coveredarea>
<!-- numeric, integer -->
<parking></parking>
<!-- string -->
<!-- can be one of: Not Specified, Street Parking, Off Street Parking, Garage -->
<outbuildings></outbuildings>
<!-- string -->
<!-- can be one of: Not Specified, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10+ -->
<view></view>
<!-- string -->
<!-- can be one of: Not Specified, Sea, Mountain, Urban, Country, City Scape -->
<orientation></orientation>
<!-- string -->
<!-- can be one of: Not Specified, North, North-East, East, South-East, South, South-West, West, North-West -->
<distancesea></distancesea>
<!-- string -->
<!-- can be one of: Not Specified, Walking, 15 mins, 30 mins, 45 mins, 1 hour, 1.5 hours, 1.5 hours + -->
<distanceairport></distanceairport>
<!-- string -->
<!-- can be one of: Not Specified, Walking, 15 mins, 30 mins, 45 mins, 1 hour, 1.5 hours, 1.5 hours + -->
<distancegolf></distancegolf>
<!-- string -->
<!-- can be one of: Not Specified, Walking, 15 mins, 30 mins, 45 mins, 1 hour, 1.5 hours, 1.5 hours + -->
<distanceattraction></distanceattraction>
<!-- string -->
<!-- can be one of: Not Specified, Walking, 15 mins, 30 mins, 45 mins, 1 hour, 1.5 hours, 1.5 hours + -->
<detailnotes>
<!-- string -->
<en></en>
<!--
supported languages: en (required), fr, it, es, pt, de, ru, nl, no
-->
</detailnotes>
<yearbuilt></yearbuilt>
<agentname></agentname>
<agentphone></agentphone>
<agentemail></agentemail>
<companyname></companyname>
<companyphone></companyphone>
<Fireplace></fireplace>
<Rooftype></Rooftype>
<Floortype></Floortype>
<lotsize></lotsize>
<Subdivision></Subdivision>
<heatingtype></heatingtype>
<elementaryschool></elementaryschool>
<middleschool></middleschool>
<highschool></highschool>
<fullurl>
<!-- string -->
</fullurl>
<vrtour>
<!-- string -->
</vrtour>
<video>
<!-- string -->
</video>
<propertystatus>For Sale</propertystatus>
<!-- REQUIRED, string -->
<!-- must be one of: Available, Under Offer, Unavailable -->
<additionalnotes></additionalnotes>
<!-- string -->
<featuredproperty></featuredproperty>
<!-- string, do not enter anything -->
<measureunits></measureunits>
<!-- string -->
<!-- can be one of: m2, Ha, Acres -->
<images>
<image id="1">
<url>http://yourdomain/image1.jpg</url>
<!-- string, full URL to the image, only JPG extension is allowed. Images must be at least 400 x 300 px -->
<!-- this is the main image -->
</image>
<image id="2">
<url>http://yourdomain/image2.jpg</url>
<!-- string, full URL to the image -->
</image>
<!-- add here up to 10 images ... -->
<image id="10">
<url>http://yourdomain/image10.jpg</url>
<!-- string, full URL to the image, only JPG extension is allowed -->
</image>
</images>
<features>
<!-- list of property features to be displayed on bullets -->
<feature id="1">
<description></description>
<!-- string -->
<spanish_description></spanish_description>
<!-- string -->
</feature>
<feature id="2">
<description></description>
<!-- string -->
<spanish_description></spanish_description>
<!-- string -->
</feature>
<feature id="3">
<description></description>
<!-- string -->
<spanish_description></spanish_description>
<!-- string -->
</feature>
<feature id="4">
<description></description>
<!-- string -->
<spanish_description></spanish_description>
<!-- string -->
</feature>
<feature id="5">
<description></description>
<!-- string -->
<spanish_description></spanish_description>
<!-- string -->
</feature>
</features>
</property>
</properties>
</root>
BACK TO THE TOP
XML Sample Feed
<?xml version='1.0' encoding='UTF-8'?>
<root>
<properties>
<property refno="CBM_100_CV00113">
<dateupdate>2010-07-30 11:00:41</dateupdate>
<seller>Coldwell Banker Mexico</seller>
<address1>Ocean View Villas in La Cruz de Huanacaxtle Mexico Villas for Sale Investments Mexico</address1>
<address2></address2>
<address3></address3>
<city>La Cruz de Huanacaxtle</city>
<county></county>
<postcode></postcode>
<country>MEXICO</country>
<region>Nayarit</region>
<latitude></latitude>
<longitude></longitude>
<propertytype>House/Villa</propertytype>
<othertype></othertype>
<saletype>New Build</saletype>
<tenure>FreeHold</tenure>
<condition>Excellent</condition>
<price>804055</price>
<maxprice>960402</maxprice>
<currency>USD</currency>
<communalfee>0</communalfee>
<datecompletion></datecompletion>
<title>
<en>Ocean View Villas in La Cruz de Huanacaxtle Mexico Villas for Sale Investments Mexico</en>
</title>
<summary>
<en>This development is Mexico´s most exclusive beach community, located on the Pacific coast. It is one of the most beautiful and secluded places on the Mexican pacific coast surrounded by beautiful lakes and lush trees. Its properties consist of luxurious beachfront townhouses, lake front villas, condominiums, lofts and a hotel & spa. More than 40% of this development is designated as open areas, and is used for a garden, horseback riding, walking trails, tennis court and a Club House. An 18-hole championship golf course will make this the ultimate destination. With over 750 acres of land, vast lakes, beautiful trails, and 1.3 miles of beach, this development offers a safe real estate investment in this current economic climate.</en>
</summary>
<nobeds>4</nobeds>
<maxnobeds>Not Specified</maxnobeds>
<nobathrooms>3</nobathrooms>
<noreceptionrooms>Not Specified</noreceptionrooms>
<floor>Not Specified</floor>
<floorspace>500</floorspace>
<furnished>Unfurnished</furnished>
<pool>Communal</pool>
<garden>Communal</garden>
<plot></plot>
<coveredarea>0</coveredarea>
<parking>Not Specified</parking>
<outbuildings>Not Specified</outbuildings>
<view>Sea</view>
<orientation>North</orientation>
<distancesea>15 Mins</distancesea>
<distanceairport>1 hour</distanceairport>
<distancegolf>30 Mins</distancegolf>
<distanceattraction>Not Specified</distanceattraction>
<detailnotes>
<en></en>
</detailnotes>
<fullurl>
<en>http://www.theinternationalrealty.com/widget/details.php?property_id=47</en>
</fullurl>
<vrtour>
<en></en>
</vrtour>
<video>
<en></en>
</video>
<propertystatus>For Sale</propertystatus>
<additionalnotes></additionalnotes>
<featuredproperty></featuredproperty>
<measureunits>m2</measureunits>
<images>
<image id="1">
<url>http://www.coldwellbanker.com.mx//home/images/properties/mex_280.jpg</url>
</image>
<image id="2">
<url>http://www.coldwellbanker.com.mx//home/images/properties/mex_282.jpg</url>
</image>
<image id="3">
<url>http://www.coldwellbanker.com.mx//home/images/properties/mex_284.jpg</url>
</image>
<image id="4">
<url>http://www.coldwellbanker.com.mx//home/images/properties/mex_286.jpg</url>
</image>
<image id="5">
<url>http://www.coldwellbanker.com.mx//home/images/properties/mex_1070.jpg</url>
</image>
</images>
</property>
</properties>
</root>
BACK TO THE TOP
The International MLS (IMLS) XML Spec Requirements
Below are the required fields and instructions per field that must be adhered to in order to have your listings accepted by The IMLS.
- We will only accept the following feed types: XML2U, Zillow, Kyero.
- All listings must have a unique Property ID so that we can match the lead to your property when we send you the lead information.
- All seller information must be included, which includes Seller Name, Address (1, 2, & 3), City, County or Region, Postcode and Country.
- Property Type: Must be House/Villa, Flat/Apartment, Land, or Commercial.
- Sale Type: Must be New Build, Resale or Rental
- Price: Must be numeric only. Example: 100000
- Currency: Must be either EUR, GBP, USD or CAN.
- Title: Must include a title for each listing that has a minimum of 30 characters, including spaces.
- Summary: Must include a Summary/Description that has a minimum of 60 characters, including spaces.
- Number of Beds: Must be one of the following (Not Specified, Studio, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20+)
- If Property Type is Land or Commercial, then specify Not Specified for number of beds.
- Property Status: Must include one of the following (Available, Under Offer, Unavailable)
Images
- All images must be JPGs
- All images must measure 400px wide by 300 pixels high
- All images must NOT have your agency's watermark
- You must include at least ONE image per listing, but please have FIVE.
- If you do not have an image to represent your listing, then you must point to a “Coming Soon” image
- All images must point to a full URL (Example: http://www.yourdomain.com/image1.jpg)
Features
- You must include at least five (5) features, which will be represented as “bullets” on The IMLS website.
- Be clear, concise and short with your features (Example: Private Community Pool)
AGENTS:Get More Listings!
Reserve an IMLS Featured Listing Spot
Get more listings!
Promise sellers guaranteed global exposure on The IMLS home page!
If one of your listings sells--post another
Available for IMLS Premier Luxury Agents only
Space is limited--Two sizes available