LUXRE XML Feed Development Guidelines

Version 1.0: Last Updated 6/9/14

PREFACE

This document defines the XML syntax required by LuxuryRealEstate.com for the automatic submission of listings.

Intended Audience

This guide assumes that its readers:

Are experienced web or application developers
Are familiar with XML
Have a background in the Real Estate industry

Organization of this document

This document is organized as follows:

Chapter 1 – Feed Development Guidelines Overview of the key aspects to consider before submitting your feed to LuxuryRealEstate.com.
Chapter 2 – Element Dictionary XML elements that are included within LuxuryRealEstate.com's data cycle.
Chapter 3 – Sample XML Feed Specification How a complete XML Listing Feed should look.

CHAPTER 1: Feed development guidelines

Basic Guidelines

To ensure rich, quality data, please fill out as many fields as possible for all listings. We calculate a completeness score for each listing, and the more complete the listing is, the better the chance it gets good visibility on LuxuryRealEstate.com and LuxuryRealEstate.com's social media channels.
Element names are case sensitive. <LivingArea> will work, but <livingarea> will not.
Do not include quotations around values (for example <ListingTitle>”Amazing city view”</ListingTitle>)
Include open and close tags for all nodes, and use proper indentation for parent/child tags.
Do not include HTML tags and do not include line breaks in the fields.
THE XML MUST CONTAIN FIELDS MARKED REQUIRED

Real Estate Standards Organization Syndication Format

Syndication of listings to a wide variety of listing portals, such as Google, Yahoo!, Trulia, Three Wide, Point2, Zillow, and many others, is a priority for listing agents and brokers. To address this, the National Association of Realtors, the Real Estate Standards Organization (RESO) and a committee of diverse I.T. professionals, publishers and data processors has formed a syndication workgroup that have developed a standardized listing data and transport specification (RETS Syndication Format) that makes it easy for brokers to syndicate their listings to multiple sites.

The format that LuxuryRealEstate.com accepts adheres to the RETS Syndication Format (not to be confused with RETS data feeds or servers) however it is a strict subset of the RETS standard. This means that if you implement the full RESO standard, it is valid to submit to LuxuryRealEstate.com, however only the elements defined in this document will be imported.

For more information on the RETS Syndication standard please visit the syndication workgroup website.

http://www.reso.org/schemas-for-syndication

Creating and Submitting an XML file

Extensible Markup Language (XML) is a markup language that defines a set of rules for encoding and structuring data in a format that is both human-readable and machine-readable. The data format described in this document is an XML structured data format.

LuxuryRealEstate.com has the ability to process XML files that are stored on either a web server or an FTP server. After you have configured your system to generate an XML file, email the url link to websupport@luxre.com and we'll validate the file and set up the import to your LuxuryRealEstate.com account if validation passes.

Handling Illegal XML Characters

When an XML element is parsed, all of the text within the XML tags is also parsed. This is done because it is possible, and highly likely, that the text will contain other XML elements. Because of this, there are certain characters that are deemed illegal since they will be misinterpreted by the XML parser. Entity Reference and CDATA Sections are two methods to avoid causing the XML parser to break.

ENTITY REFERENCE Replace the characters with their corresponding entity reference
Illegal Character	Entity Reference	Description
<	<	Less Than
>	>	Greater Than
&	&	Ampersand
'	'	Apostrophe

CDATA SECTION Enclose values in a CDATA section that starts with “<![CDATA[“ and ends with “]]>”
Without CDATA <Example>Brokers & Agents</Example> With CDATA <Example><![CDATA[Brokers & Agents]]></Example>

CDATA SECTION
Enclose values in a CDATA section that starts with “<![CDATA[“ and ends with “]]>”

Without CDATA
<Example>Brokers & Agents</Example>

With CDATA
<Example><![CDATA[Brokers & Agents]]></Example>

CHAPTER 2: Element dictionary

###<Listings>

Included exactly once following the XML declaration.

<Listings xmlns="http://rets.org/xsd/Syndication/2012-03" xmlns:commons="http://rets.org/xsd/RETSCommons" xmlns:schemaLocation="http://rets.org/xsd/Syndication/2012-03/Syndication.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" listingsKey="2012-03-06T22:14:47" version="0.96" versionTimestamp="2012-02-07T03:00:00Z" xml:lang="en-us">
  <Listing>
    See documentation for Listing element.
  </Listing>
</Listings>

###<Listing>

Contained once or many times by <Listings>, each time representing a Listing.

<Listing>
  <Address>
    See documentation for Address element.
  </Address>
  <ListPrice commons:isgSecurityClass="Public" commons:currencyCode="USD" commons:currencyPeriod="Week">599000</ListPrice>
  <ListingURL>http://www.realestatesite.com/listings/123123</ListingURL>
  <ProviderName>Springfield Real Estate, Inc.</ProviderName>
  <ProviderURL>http://www.realestatesite.com</ProviderURL>
  <ProviderCategory>Broker</ProviderCategory>
  <LeadRoutingEmail>listingagent@realestatesite.com</LeadRoutingEmail>
  <Bedrooms>3</Bedrooms>
  <Bathrooms>2</Bathrooms>
  <PropertyType>Residential</PropertyType>
  <PropertySubType otherDescription="Chateau">Other</PropertySubType>
  <MlsNumber>123456789</MlsNumber>
  <ListingCategory>Purchase</ListingCategory>
  <ListingStatus>Active</ListingStatus>
  <MarketingInformation>
    See documentation for MarketingInformation element.
  </MarketingInformation>
  <Photos>
    See documentation for Photos element.
  </Photos>
  <ListingDescription>Gorgeous house. Must see. Tell all of your friends and relations in the market.</ListingDescription>
  <LivingArea commons:areaUnits="squareFoot">1260</LivingArea>
  <LotSize commons:areaUnits="acre">0.135</LotSize>
  <YearBuilt>1954</YearBuilt>
  <ListingDate>1989-12-17</ListingDate>
  <ListingTitle>Very Lovely Home</ListingTitle>
  <FullBathrooms>1</FullBathrooms>
  <ThreeQuarterBathrooms>2</ThreeQuarterBathrooms>
  <HalfBathrooms>1</HalfBathrooms>
  <OneQuarterBathrooms>0</OneQuarterBathrooms>
  <PartialBathrooms>1</PartialBathrooms>
  <ListingParticipants>
    See documentation for ListingParticipants element.
  </ListingParticipants>
  <VirtualTours>
    See documentation for VirtualTours element.
  </VirtualTours>
  <Offices>
    See documentation for Offices element.
  </Offices>
  <Brokerage>
    See documentation for Brokerage element.
  </Brokerage>
  <Location>
    See documentation for Location element.
  </Location>
  <DetailedCharacteristics>
    See documentation for DetailedCharacteristics element.
  </DetailedCharacteristics>
  <ModificationTimestamp>2013-12-12T06:07:05+00:00</ModificationTimestamp>
  <Disclaimer>Copyright 2013 Springfield Real Estate, Inc. All rights reserved. All information provided by the listing agent/broker is deemed reliable but is not guaranteed and should be independently verified.</Disclaimer>
</Listing>

Name	Type	Description
ListPrice	Integer	REQUIRED Unformatted numerical list price for the property. commons:currencyCode is used to state the currency used. Currency is a three letter currency code as defined by ISO 4217. commons:isgSecurityClass can be used to hide price from public display. Allowed values are: Public - Default assumed value. Will display price on LuxuryRealEstate.com. Confidential - Use to hide price from display on LuxuryRealEstate.com. The currencyPeriod attribute is only expected for rental properites and contains either the value "Daily", "Weekly" or "Monthly" to indicate that a rental price is repeated at the frequency indicated. The abscence of the attribute indicates a one-time payment and the attribute is not expected for listings for sale. If a rental currencyPeriod is set to "Monthly", it is considered a residential long term rental. If the listing is a rental and currencyPeriod is set to either "Daily" or "Weekly", it is considered a Vacation Rental.
ListingURL	String	The URL for the original listing.
ProviderName	String	The name of the entity that authorized the listing to be syndicated.
ProviderURL	String	A URL for the entity that authorized the listing to be syndicated.
ProviderCategory	String	The type of the entity that authorized the listing to be syndicated. Must be one of these values: Aggregator Broker Franchiser HomeBuilder MLS Other Owner Publisher Unknown
LeadRoutingEmail	String	An email address leads will be sent to, in addition to the email addresses of any agent profiles that might be associated with the listing. See documentation for ListingParticipant for further instructions on listing agent inclusion and matching to agent profiles on LuxuryRealEstate.com.
Bedrooms	Integer	The total number of bedrooms. For listings with no home on the property, such as a lot or land, this element should have the value of 0. When no information is available on Bathrooms, the value should be empty.
Bathrooms	Integer	The total number of bathrooms. For listings with no home on the property, such as a lot or land, this element should have the value of 0. When no information is available on Bathrooms, the value should be empty.
PropertyType	String	Primary type of the listed property. Must be one of these values: Commercial Common Interest Farm And Agriculture Lots And Land MultiFamily Other Rental Residential In order to specify that the listing comes fully furnished, populate otherDescription with "Furnished": <PropertyType otherDescription="Furnished">Rental</PropertyType> This will mostly affect Rental, however can be applied to any PropertyType. If omitted this will default to 'Residential.'
PropertySubType	String	Secondary type of the listed property. Must be one of these values: Apartment Boatslip Cabin Condominium Deeded Parking Duplex Farm Manufactured Home Mobile Home Other Own Your Own Quadruplex Single Family Attached Single Family Detached Stock Cooperative Timeshare Townhouse Triplex In addition, LuxuryRealEstate.com support three property types not covered by the RETS Syndication Format. Those three property types are: Chateau Estate Villa In order to specify one of these property types, use the PropertySubType "Other" and populate otherDescription with one of these three values. For example: <PropertySubType otherDescription="Chateau">Other</PropertySubType>
MlsNumber	String	REQUIRED In the US and Canada, it is the listing MLS number. In any other country or in markets witout an MLS, it is a unique listing identifier that you have given it that the listing will consistently have on each submission.
ListingCategory	String	REQUIRED Must be one of these values: Purchase Lease Rent
ListingStatus	String	REQUIRED Must be one of these values: Active Cancelled Closed Expired Pending Withdrawn
ListingDescription	String	Unformatted description of the listing. HTML will be stripped out.
LivingArea	Integer	Unformatted number with total livable area of the listed property. Attribute areaUnits must be one of these values: acre hectare squareCentimeter squareFoot squareMeter squareYard unknown
LotSize	Integer	Unformatted number with size of the lot of the listed property. Attribute areaUnit must be one of these values: acre hectare squareCentimeter squareFoot squareMeter squareYard unknown
YearBuilt	Integer	Year the property was constructed.
ListingDate	Date	Date the property was listed, formatted YYYY-MM-DD as specified in ISO 8601.
ListingTitle	String(80)	A short title for the listing.
FullBathrooms	Integer	A total count for the full bathrooms on the property. Full bathrooms generally include a sink, toilet, shower and bath, but may have other local definitions.
ThreeQuarterBathrooms	Integer	A total count for the three-quarter bathrooms on the property. Three-quarter bathrooms generally include a sink, toilet, and shower with no bathtub, but may have other local definitions.
HalfBathrooms	Integer	A total count of the half bathrooms on the property. Half bathrooms contain a sink and toilet.
OneQuarterBathrooms	Integer	A total count of the one-quarter bathrooms on the property. One-quarter bathrooms contain a sink.
PartialBathrooms	Integer	A total count for all the partial bathrooms on the property. This includes one quarter, one half, and three quarter baths.
ModificationTimestamp	Timestamp	The most recent timestamp that information about this listing changed within the originating data source.
Disclaimer	String	Custom disclaimer.

###<DetailedCharacteristics>

Contained exactly once by <Listing>.

<DetailedCharacteristics>
  <Appliances>
    See documentation for Appliances element.
  </Appliances>
  <CoolingSystems>
    See documentation for CoolingSystems element.
  </CoolingSystems>
  <HasAttic>true</HasAttic>
  <HasBarbecueArea>true</HasBarbecueArea>
  <HasDeck>true</HasDeck>
  <HasDock>true</HasDock>
  <HasPatio>true</HasPatio>
  <HasSkylight>true</HasSkylight>
  <HasFireplace>true</HasFireplace>
  <HasHotTubSpa>true</HasHotTubSpa>
  <HasJettedBathTub>true</HasJettedBathTub>
  <HasPond>true</HasPond>
  <HasPool>true</HasPool>
  <HasSauna>true</HasSauna>
  <HasSportsCourt>true</HasSportsCourt>
  <HasWetBar>true</HasWetBar>
  <IsWaterfront>true</IsWaterfront>
  <ParkingTypes>
    See documentation for ParkingTypes
  </ParkingTypes>
  <ViewTypes>
    See documentation for ViewTypes
  </ViewTypes>
</DetailedCharacteristics>

Name	Type	Description
HasAttic	Boolean	`true` or `false` to state if the property has an attic.
HasBarbecueArea	Boolean	`true` or `false` to state if the property has a barbecue area.
HasDeck	Boolean	`true` or `false` to state if the property has one or more decks.
HasDoorman	Boolean	`true` or `false` to state if the property has a doorman or concierge.
HasDock	Boolean	`true` or `false` to state if the property has one or more docks.
HasElevator	Boolean	`true` or `false` to state if the property has one or more elevators.
HasGarden	Boolean	`true` or `false` to state if the property has a garden.
HasPatio	Boolean	`true` or `false` to state if the property has one or more patios.
HasSkylight	Boolean	`true` or `false` to state if the property has one or more skylights.
HasFireplace	Boolean	`true` or `false` to state if the property has one or more fireplaces.
HasHotTubSpa	Boolean	`true` or `false` to state if the property has one or more hot tubs or spas.
HasJettedBathTub	Boolean	`true` or `false` to state if the property has one or more jetted bath tubs.
HasPond	Boolean	`true` or `false` to state if the property has one or more ponds.
HasPool	Boolean	`true` or `false` to state if the property has one or more pools.
HasSauna	Boolean	`true` or `false` to state if the property has one or more saunas.
HasSportsCourt	Boolean	`true` or `false` to state if the property has one or more sports courts.
HasWetBar	Boolean	`true` or `false` to state if the property has one or more wet bars.
IsWaterfront	Boolean	`true` or `false` to state if the property is on the waterfronts.

###<Appliances>

Contained exactly once by <DetailedCharacteristics>.

<Appliances>
  <Appliance>Coffee System</Appliance>
  <Appliance>Refrigerator</Appliance>
  <Appliance>Dishwasher</Appliance>
  <Appliance>Freezer</Appliance>
  <Appliance>Vacuum System</Appliance>
</Appliances>

Name Type Description

Appliance

String

Name	Type	Description
Appliance	String	The Appliance element repeats and must be one of these values: `<ul> <li>Barbeque or Grill</li> <li>Coffee System</li> <li>Cooktop</li> <li>Dishwasher</li> <li>Dryer</li> <li>Freezer</li> <li>Garbage Disposer</li> <li>Ice Maker</li> <li>Microwave</li> <li>Oven</li> <li>Range</li> <li>Rangetop - Electric</li> <li>Refrigerator</li> <li>Trash Compactor</li> <li>Vacuum System</li> <li>Vent Hood</li> <li>Warming Drawer</li> <li>Washer</li> <li>Washer/Dryer Combo</li> <li>Water - Filter</li> <li>Water - Instant Hot</li> <li>Water - Softener</li> </ul> </td>`

The Appliance element repeats and must be one of these values:

  <ul>
    <li>Barbeque or Grill</li>
    <li>Coffee System</li>
    <li>Cooktop</li>
    <li>Dishwasher</li>
    <li>Dryer</li>
    <li>Freezer</li>
    <li>Garbage Disposer</li>
    <li>Ice Maker</li>
    <li>Microwave</li>
    <li>Oven</li>
    <li>Range</li>
    <li>Rangetop - Electric</li>
    <li>Refrigerator</li>
    <li>Trash Compactor</li>
    <li>Vacuum System</li>
    <li>Vent Hood</li>
    <li>Warming Drawer</li>
    <li>Washer</li>
    <li>Washer/Dryer Combo</li>
    <li>Water - Filter</li>
    <li>Water - Instant Hot</li>
    <li>Water - Softener</li>
  </ul>

</td>

###<Address>

Contained exactly once by <Listing>, <Brokerage> and <Office>.

<Address>
  <commons:preference-order>1</commons:preference-order>
  <commons:address-preference-order>1</commons:address-preference-order>
  <commons:FullStreetAddress>742 Evergreen Terrace</commons:FullStreetAddress>
  <commons:City>Springfield</commons:City>
  <commons:StateOrProvince>CA</commons:StateOrProvince>
  <commons:PostalCode>91401</commons:PostalCode>
  <commons:Country>US</commons:Country>
</Address>

Name	Type	Description
commons:preference-order	Integer	Value always 1.
commons:address-preference-order	Integer	Value always 1.
commons:FullStreetAddress	String	FullStreetAddress is a text representation of the address.
commons:City	String	The city, township, municipality, etc. portion of an address.
commons:StateOrProvince	String	For USA and Canada, the two letter state/province code. For other countries, the two letter subdivision code as defined by ISO 3166-2.
commons:PostalCode	String	For USA, the five digit zip code. For other countries, a string representing the postal code for the address.
commons:Country	String	REQUIRED Two digit country code as specified by ISO-3166-1 Alpha-2

###<CoolingSystems>

Contained exactly once by <DetailedCharacteristics>.

<CoolingSystems>
  <CoolingSystem>Attic Fan</CoolingSystem>
  <CoolingSystem>Ceiling Fan(s)</CoolingSystem>
  <CoolingSystem>Central A/C</CoolingSystem>
</CoolingSystems>

Name	Type	Description
CoolingSystem	String	The CoolingSystem element repeats and must be one of these values: Attic Fan Ceiling Fan(s) Central A/C

Name

Type

Description

CoolingSystem

String

The CoolingSystem element repeats and must be one of these values:

Attic Fan
Ceiling Fan(s)
Central A/C

###<MarketingInformation>

Contained exactly once by <Listing>.

<MarketingInformation>
  <commons:VOWAddressDisplay>true</commons:VOWAddressDisplay>
  <commons:VOWAutomatedValuationDisplay>true</commons:VOWAutomatedValuationDisplay>
  <commons:VOWConsumerComment>true</commons:VOWConsumerComment>
</MarketingInformation>

Name	Type	Description
commons:VOWAddressDisplay	String	The string `true` or `false` to state whether it is allowed to show the address of the listing.
commons:VOWAutomatedValuationDisplay	String	The string `true` or `false` to state whether it is allowed to show automatic valuation of the listing. Set this to `true` to enable display of mortgage calculator, and `false` to disable display of mortgage calculator.
commons:VOWConsumerComment	String	The string `true` or `false` to state whether it is allowed for visitors to comment on the listing.

###<Photos>

Contained exactly once by <Listing>.

<Photos>
  <Photo>
    See documentation for Photo element.
  </Photo>
</Photos>

###<Photo>

Contained one or many times by <Photos>.

<Photo>
  <MediaModificationTimestamp>2013-08-27T09:06:50+00:00</MediaModificationTimestamp>
  <MediaURL>http://upload.wikimedia.org/wikipedia/en/c/ca/742_Evergreen_Terrace.png</MediaURL>
  <MediaCaption>Wine cellar fits 1,500 bottles.</MediaCaption>
  <MediaDescription>Wine Cellar</MediaDescription>
</Photo>

Name	Type	Description
MediaModificationTimestamp	Timestamp	Timestamp for when the photo was last updated. Update this value to force reimport of a new photo that has the same filename as the photo it replaces.
MediaURL	String	The publicly accessible URL for the photo.
MediaCaption	String	Short description of what is pictured.
MediaDescription	String	LuxuryRealEstate.com uses MediaDescription to categorize what is pictured. It is optional, but if included must be one of these values: Basement Bathroom Bedroom Closet Deck Dining Room Entry Exterior Family Room Floor Plan Garage Hall Home Gym Home Office Kids Kitchen Landscape Laundry Room Living Room Media Room Patio Pool Porch Powder Room Shed Staircase Wine Cellar

###<VirtualTours>

Contained exactly once by <Listing>.

<VirtualTours>
  <VirtualTour>
    See documentation for VirtualTour element.
  </VirtualTour>
</VirtualTours>

###<VirtualTour>

Contained one or many times by <VirtualTours>.

<VirtualTour>
  <MediaModificationTimestamp>2013-08-27T09:06:50+00:00</MediaModificationTimestamp>
  <MediaURL>http://upload.wikimedia.org/wikipedia/en/c/ca/742_Evergreen_Terrace.png</MediaURL>
</VirtualTour>

Name	Type	Description
MediaModificationTimestamp	Timestamp	Timestamp for when the virtual tour was last updated. Update this value to force update of a new virtual that has the same URL as the virtual tour it replaces.
MediaURL	String	The URL for the virtual tour.

###<ListingParticipants>

Contained exactly once by <Listing>.

<ListingParticipants>
  <Participant>
    See documentation for Participant element.
  </Participant>
</ListingParticipants>

###<Participant>

Contained once or twice by <ListingParticipants>.

<Participant>
  <ParticipantId>AG123123</ParticipantId>
  <FirstName>Gil</FirstName>
  <LastName>Gunderson</LastName>
  <Role>Listing</Role>
  <PrimaryContactPhone>5557891234</PrimaryContactPhone>
  <OfficePhone>5559875432</OfficePhone>
  <Email>gilgunderson@realestatesite.com.com</Email>
  <WebsiteURL>http://myownagentsite.com</WebsiteURL>
</Participant>

Name	Type	Description
ParticipantId	String	A value that uniquely identifies the listing agent within your LUXRE account. For US based listing agents, this is the agent's agent MLS ID. For other countries, it can be any unique string as long as it is consistently used for the particular agent, and as long as it's used only for that particular agent. This value must also be assigned to the corresponding agent's LUXRE profile in the Luxury Lounge in order for the listing to get correctly associated with the agent profile on LuxuryRealEstate.com.
FirstName	String	The listing agent's first name.
LastName	String	The listing agent's last name.
Role	String	Always contains the value `Listing` to signify listing agent.
PrimaryContactPhone	String	Primary phone number for the participant, no format enforced.
OfficePhone	String	The listing agent's office phone number, no format enforced.
Email	String	Email address of the listing agent, no format enforced.
WebsiteURL	String	URL for agent's website, no format enforced.

###<Offices>

Contained exactly once by <Listing>.

<Offices>
   <Office>
     See documentation for Office element.
   </Office>
 </Offices>

###<Office>

Contained exactly once by <Offices>.

 <Office>
   <OfficeKey>OURPREFIX-OF123123</OfficeKey>
   <OfficeId>OF123123</OfficeId>
   <Name>Springfield Real Estate, Inc.</Name>
   <CorporateName>Springfield Real Estate, Inc.</CorporateName>
   <BrokerId>BRID123123</BrokerId>
   <PhoneNumber>555-789-1234</PhoneNumber>
   <Fax>555-987-4321</Fax>
   <Address>
     See documentation for Address element.
   </Address>
   <OfficeEmail>info@realestatesite.com</OfficeEmail>
   <Website>http://www.realestatesite.com</Website>
</Office>

Name	Type	Description
OfficeKey	String	Compound value made up from your unique LUXRE account token, a dash, and the value from OfficeId. Inquire with websupport@luxre.com if you don't know what your unique LUXRE token is.
OfficeId	String	REQUIRED A value that uniquely identifies the office within your LUXRE account. For US based companies, this is the office MLS ID. For other countries, it can be any unique string as long as it is consistently used for the particular office, and as long as it's used only for that particular office. This value must also be assigned to the corresponding office's LUXRE profile in the Luxury Lounge in order for the listing to get correctly associated with the office profile on LuxuryRealEstate.com.
Name	String	The name of the office.
BrokerId	String	Identifier for the person who is the designated broker of the office. For US based offices, this is the broker's MLS ID. For other countries, it can be any unqiue string as long as it is consistenly used for the particular managing agent, and as long as it's used only for the particular person.
PhoneNumber	String	Phone number of the office, no format enforced.
Fax	String	Fax number of the office, no format enforced.
OfficeEmail	String	Email address of the office, no format enforced.
Website	String	Public website for the office.

###<Brokerage>

Contained exactly once by <Listing>.

<Brokerage>
  <Name>Springfield Real Estate, Inc.</Name>
  <Phone>555-789-1234</Phone>
  <Email>info@realestatesite.com</Email>
  <WebsiteURL>http://www.realestatesite.com</WebsiteURL>
  <LogoURL>http://www.realestatesite.com/images/logo.jpg</LogoURL>
</Brokerage>

Name	Type	Description
Name	String	Name of the business that is a member of LuxuryRealEstate.com.
Phone	String	Phone number as a string, no specific format enforced.
Email	String	Email address as a string no specific format enforced.
WebsiteURL	String	URL for the company website.
LogoURL	String	Publicly accessible URL for the business logo.

###<Location>

Contained exactly once by <Listing>.

<Location>
  <County>Springfield</County>
  <Latitude>47.62001290</Latitude>
  <Longitude>-122.3491637</Longitude>
  <Neighborhoods>
    <Neighborhood>
      See documentation for Neighborhood element.
    </Neighborhood>
  </Neighborhoods>
</Location>

Name	Type	Description
County	String	The county that the property is located in.
Latitude	String	Latitude of the property.
Longitude	String	Longitude of the property.
Neighborhoods	String	Container for a Neighborhood element. Maximum 1 is allowed.

###<Neighborhood>

Contained exactly once by <Listing>.

<Neighborhood>
  <Name>Evergreen Terrace</Name>
</Neighborhood>

Name	Type	Description
Name	String	Name of the neighborhood the listings is in. This value can contain the name of an island, burrough or similar where the listing is located in a geographical area that doesn't fit to include elsewhere.

###<ParkingTypes>

Contained exactly once by <DetailedCharacteristics>.

<ParkingTypes>
  <ParkingType>Garage</ParkingType>
</ParkingTypes>

Name	Type	Description
ParkingType	String	The ParkingType element repeats and must be one of these values: Garage

Name

Type

Description

ParkingType

String

The ParkingType element repeats and must be one of these values:

Garage

###<ViewTypes>

Contained exactly once by <DetailedCharacteristics>.

<ViewTypes>
  <ViewType>Water</ViewType>
  <ViewType>Ocean</ViewType>
  <ViewType>Golf Course</ViewType>
</ViewTypes>

Name	Type	Description
ViewType	String	The ViewType element repeats and must be one of these values: Airport Average Bluff Bridge Canyon City Desert Forest Golf Course Harbor Hills Lake Marina Mountain None Ocean Other Panorama Park Ravine River Territorial Unknown Valley Vista Water

Name

Type

Description

ViewType

String

The ViewType element repeats and must be one of these values:

Airport
Average
Bluff
Bridge
Canyon
City
Desert
Forest
Golf Course
Harbor
Hills
Lake
Marina
Mountain
None
Ocean
Other
Panorama
Park
Ravine
River
Territorial
Unknown
Valley
Vista
Water

CHAPTER 3 – Sample XML Feed

<?xml version="1.0"?>
<Listings xmlns="http://rets.org/xsd/Syndication/2012-03" xmlns:commons="http://rets.org/xsd/RETSCommons" xmlns:schemaLocation="http://rets.org/xsd/Syndication/2012-03/Syndication.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" listingsKey="2012-03-06T22:14:47" version="0.96" versionTimestamp="2012-02-07T03:00:00Z" xml:lang="en-us">
  <Listing>
    <Address>
      <commons:preference-order>1</commons:preference-order>
      <commons:address-preference-order>1</commons:address-preference-order>
      <commons:FullStreetAddress>742 Evergreen Terrace</commons:FullStreetAddress>
      <commons:City>Springfield</commons:City>
      <commons:StateOrProvince>CA</commons:StateOrProvince>
      <commons:PostalCode>91401</commons:PostalCode>
      <commons:Country>US</commons:Country>
    </Address>
    <ListPrice commons:isgSecurityClass="Public" commons:currencyCode="USD">599000</ListPrice>
    <ListingURL>http://www.realestatesite.com/listings/123123</ListingURL>
    <ProviderName>Springfield Real Estate, Inc.</ProviderName>
    <ProviderURL>http://www.realestatesite.com</ProviderURL>
    <ProviderCategory>Broker</ProviderCategory>
    <LeadRoutingEmail>listingagent@realestatesite.com</LeadRoutingEmail>
    <Bedrooms>3</Bedrooms>
    <Bathrooms>2</Bathrooms>
    <PropertyType otherDescription="Residential">Residential</PropertyType>
    <PropertySubType otherDescription="Single Family Residence">Single Family Detached</PropertySubType>
    <ListingCategory>Purchase</ListingCategory>
    <ListingStatus>Active</ListingStatus>
    <MarketingInformation>
      <commons:VOWAddressDisplay>true</commons:VOWAddressDisplay>
      <commons:VOWAutomatedValuationDisplay>true</commons:VOWAutomatedValuationDisplay>
      <commons:VOWConsumerComment>true</commons:VOWConsumerComment>
    </MarketingInformation>
    <Photos>
      <Photo>
        <MediaModificationTimestamp>2013-08-27T09:06:50+00:00</MediaModificationTimestamp>
        <MediaURL>http://upload.wikimedia.org/wikipedia/en/c/ca/742_Evergreen_Terrace.png</MediaURL>
        <MediaCaption>Exterior showing overview.</MediaCaption>
        <MediaDescription>Exterior</MediaDescription>
      </Photo>
      <Photo>
        <MediaModificationTimestamp>2013-08-27T09:06:50+00:00</MediaModificationTimestamp>
        <MediaURL>http://www.blogcdn.com/www.parentdish.co.uk/media/2011/05/parentdish-best-dads-homer-simpson-rex-590mt200511.jpg</MediaURL>
        <MediaCaption>Perfect couch for watching fottball.</MediaCaption>
        <MediaDescription>Living Room</MediaDescription>
      </Photo>
      <Photo>
        <MediaModificationTimestamp>2013-08-27T09:06:50+00:00</MediaModificationTimestamp>
        <MediaURL>http://i.dailymail.co.uk/i/pix/2013/12/21/article-2527254-1A3BFD0A00000578-904_634x377.jpg</MediaURL>
        <MediaCaption>Ideal space for family time.</MediaCaption>
        <MediaDescription>Living Room</MediaDescription>
      </Photo>
      <Photo>
        <MediaModificationTimestamp>2013-08-27T09:06:50+00:00</MediaModificationTimestamp>
        <MediaURL>http://stuffpoint.com/the-simpsons/image/312601-the-simpsons-simpsons-house-interior.jpg</MediaURL>
        <MediaCaption>Overview of floor plan.</MediaCaption>
        <MediaDescription>Floor Plan</MediaDescription>
      </Photo>
    </Photos>
    <DiscloseAddress>true</DiscloseAddress>
    <ListingDescription>Gorgeous house. Must see. Tell all of your friends and relations in the market.</ListingDescription>
    <MlsNumber>123456789</MlsNumber>
    <LivingArea commons:areaUnits="squareFoot">1260</LivingArea>
    <LotSize commons:areaUnits="acre">0.135</LotSize>
    <YearBuilt>1954</YearBuilt>
    <ListingDate>1989-12-17</ListingDate>
    <ListingTitle>Very Lovely Home</ListingTitle>
    <FullBathrooms>1</FullBathrooms>
    <ThreeQuarterBathrooms>2</ThreeQuarterBathrooms>
    <HalfBathrooms>1</HalfBathrooms>
    <OneQuarterBathrooms>0</OneQuarterBathrooms>
    <PartialBathrooms>1</PartialBathrooms>
    <ListingParticipants>
      <Participant>
        <ParticipantId>AG123123</ParticipantId>
        <FirstName>Gil</FirstName>
        <LastName>Gunderson</LastName>
        <Role>Listing</Role>
        <PrimaryContactPhone>5557891234</PrimaryContactPhone>
        <OfficePhone>5559875432</OfficePhone>
        <Email>gilgunderson@realestatesite.com.com</Email>
        <WebsiteURL>http://myownagentsite.com</WebsiteURL>
      </Participant>
    </ListingParticipants>
    <VirtualTours>
      <VirtualTour>
        <MediaModificationTimestamp/>
        <MediaURL>http://www.youtube.com/watch?v=IL2WHdRwlJ4</MediaURL>
      </VirtualTour>
    </VirtualTours>
    <Offices>
      <Office>
        <OfficeKey>OURPREFIX-OF123123</OfficeKey>
        <OfficeId>OF123123</OfficeId>
        <Name>Springfield Real Estate, Inc.</Name>
        <BrokerId>BRID123123</BrokerId>
        <PhoneNumber>555-789-1234</PhoneNumber>
        <Fax>555-987-4321</Fax>
        <Address>
          <commons:preference-order>1</commons:preference-order>
          <commons:address-preference-order>1</commons:address-preference-order>
          <commons:FullStreetAddress>123 NW Main St</commons:FullStreetAddress>
          <commons:UnitNumber>#100</commons:UnitNumber>
          <commons:City>Springfield</commons:City>
          <commons:StateOrProvince>CA</commons:StateOrProvince>
          <commons:PostalCode>91362</commons:PostalCode>
          <commons:Country>US</commons:Country>
        </Address>
        <OfficeEmail>info@realestatesite.com</OfficeEmail>
        <Website>http://www.realestatesite.com</Website>
      </Office>
    </Offices>
    <Brokerage>
      <Name>Springfield Real Estate, Inc.</Name>
      <Phone>555-789-1234</Phone>
      <Email>info@realestatesite.com</Email>
      <WebsiteURL>http://www.realestatesite.com</WebsiteURL>
      <LogoURL>http://www.realestatesite.com/images/logo.jpg</LogoURL>
      <Address>
        <commons:preference-order>1</commons:preference-order>
        <commons:address-preference-order>1</commons:address-preference-order>
        <commons:FullStreetAddress>123 NW Main St</commons:FullStreetAddress>
        <commons:UnitNumber>Suite 12</commons:UnitNumber>
        <commons:City>Springfield</commons:City>
        <commons:StateOrProvince>CA</commons:StateOrProvince>
        <commons:PostalCode>93065</commons:PostalCode>
        <commons:Country>US</commons:Country>
      </Address>
    </Brokerage>
    <Location>
      <County>Springfield</County>
      <Latitude>47.62001290</Latitude>
      <Longitude>-122.3491637</Longitude>
      <Neighborhoods>
        <Neighborhood>
          <Name>Evergreen Terrace</Name>
        </Neighborhood>
      </Neighborhoods>
    </Location>
    <DetailedCharacteristics>
      <Appliances>
        <Appliance>Dishwasher</Appliance>
        <Appliance>Washer</Appliance>
        <Appliance>Dryer</Appliance>
        <Appliance>Oven</Appliance>
        <Appliance>Range</Appliance>
      </Appliances>
      <CoolingSystems>
        <CoolingSystem>Attic Fan</CoolingSystem>
        <CoolingSystem>Ceiling Fan(s)</CoolingSystem>
        <CoolingSystem>Central A/C</CoolingSystem>
      </CoolingSystems>
      <HasAttic>true</HasAttic>
      <HasBarbecueArea>true</HasBarbecueArea>
      <HasDeck>true</HasDeck>
      <HasDock>true</HasDock>
      <HasDoorman>true</HasDoorman>
      <HasElevator>true</HasElevator>
      <HasGarden>true</HasGarden>
      <HasPatio>true</HasPatio>
      <HasSkylight>true</HasSkylight>
      <ParkingTypes>
        <ParkingType>Garage</ParkingType>
      </ParkingTypes>
      <ViewTypes>
        <ViewType>Water</ViewType>
        <ViewType>Ocean</ViewType>
        <ViewType>Golf Course</ViewType>
      </ViewTypes>
    </DetailedCharacteristics>
    <ModificationTimestamp>2013-12-12T06:07:05+00:00</ModificationTimestamp>
    <Disclaimer>Copyright 2013 Springfield Real Estate, Inc. All rights reserved. All information provided by the listing agent/broker is deemed reliable but is not guaranteed and should be independently verified.</Disclaimer>
  </Listing>
</Listings>

bobdutch/knowledgebase

LUXRE XML Feed Development Guidelines

PREFACE

CHAPTER 1: Feed development guidelines

CHAPTER 2: Element dictionary

CHAPTER 3 – Sample XML Feed