XML Feed Development Specification

XML Feed Development Specification

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 CharacterEntity ReferenceDescription
< &lt; Less Than
> &gt; Greater Than
& &amp; Ampersand
' &apos; Apostrophe
CDATA SECTION
Enclose values in a CDATA section that starts with “<![CDATA[“ and ends with “]]>”

Without CDATA
<Example>Brokers &amp; 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>
NameTypeDescription
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, or when no information is available on Bedrooms, the value should be empty.
Bathrooms Integer The total number of bathrooms. For listings with no home on the property, or 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>
NameTypeDescription
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>
NameTypeDescription
Appliance String The Appliance element repeats and must be one of these values:
  • Barbeque or Grill
  • Coffee System
  • Cooktop
  • Dishwasher
  • Dryer
  • Freezer
  • Garbage Disposer
  • Ice Maker
  • Microwave
  • Oven
  • Range
  • Rangetop - Electric
  • Refrigerator
  • Trash Compactor
  • Vacuum System
  • Vent Hood
  • Warming Drawer
  • Washer
  • Washer/Dryer Combo
  • Water - Filter
  • Water - Instant Hot
  • Water - Softener

<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>

.

NameTypeDescription
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 byISO-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>
NameTypeDescription
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>
NameTypeDescription
commons:VOWAddressDisplay String The string true or falseto state whether it is allowed to show the address of the listing.
commons:VOWAutomatedValuationDisplay String The string true or falseto state whether it is allowed to show automatic valuation of the listing. Set this totrue to enable display of mortgage calculator, andfalse to disable display of mortgage calculator.
commons:VOWConsumerComment String The string true or falseto 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>
NameTypeDescription
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>. Put a valid youtube or vimeo URL in the <MediaURL> tag to be added as a video. Any other URLs appear under a link that reads "Virtual Tour".

<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>
NameTypeDescription
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>
NameTypeDescription
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>
   <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>
NameTypeDescription
OfficeId String

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>
NameTypeDescription
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>
NameTypeDescription
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 <Location>.

<Neighborhood>
  <Name>Evergreen Terrace</Name>
</Neighborhood>
NameTypeDescription
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>
NameTypeDescription
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>
NameTypeDescription
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>
        <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>
Have more questions? Submit a request
Powered by Zendesk