XML Formatting

OVERVIEW

Only include exclusive listings. Open listings and limited listings should not be included

The StreetEasy Feed Format is a simple XML format that allows us to index your listings and have them appear on our site. The format is flexible, but designed for quick implementation, many of the fields are optional.

When you are implementing the feed you should note the following:

• Make this feed available on your website via HTTP, we can accept feeds through other methods, but this is the easiest integration.
• Make sure to encode any special characters in the text of your feed, these include ‘<‘ to ‘&gt;’ and ‘>’ to ‘&lt;’
• We will request the feed every three hours, or more often if requested.
• The feed should contain a list of all properties currently available/in contract. Any properties that we do not find in the feed will be assumed to be off market.
• Please use CDATA in the listing description to mark line breaks in the text e.g. <br>

If you already have an existing feed we can probably accept the feed as-is. Contact us and we will work with you to have it integrated into our site.

XML FEED FORMAT

<?xml version="1.0" encoding="UTF-8"?>
<streeteasy version="1.6">
  <properties>
    <property type="rental|sale" status="active|off-market|temp-off-market|in-contract|contract-out|contract-signed|sold|rented"
      id="unique id" url="external url for the property">
      <location>
        <address/>
        <apartment/>
        <city/>
        <state/>
        <zipcode/>
        <neighborhood/>
      </location>

      <details>
        <price/>

        <!-- We can accept rental period pricing for seasonal rentals. Ensure property type is rental and price attribute above is blank -->
        <rental_period_pricing>
          <md_ld/> <!-- for Memorial Day to Labor Day -->
          <june/> <!-- for June -->
          <july/> <!-- for July -->
          <august/> <!-- for August -->
          <august_ld/> <!-- for August - Labor Day -->
          <july_ld/> <!-- for July - Labor Day -->
          <june_july/> <!-- for June - July -->
          <july_august/> <!-- for July - August -->
          <extended_season/> <!-- for Extended Season pricing -->
          <year_round/> <!-- for Year Round pricing -->
          <winter/> <!-- for Winter pricing -->
          <short_term/> <!-- for Short Term pricing -->
        </rental_period_pricing>

        <noFee/> <!-- include if no fee -->
        <maintenance/> <!-- monthly (Also Common Charges for condos) -->
        <max_financing/> <!-- Max financing option -->
        <exclusive/> <!-- Include this tag if this is an exclusive listing -->
        <taxes/> <!-- monthly -->
        <bedrooms/>
        <bathrooms/>
        <totalrooms/> <!-- total # rooms in the property -->
        <squareFeet/>
        <availableOn> <!-- rental only -->
        <listedOn/>
        <soldOn/>
        <description/>
        <propertyType>condo|coop|townhouse|condop|rental|house|other</propertyType>
        <mlsId></mlsId>
        <mlsName></mlsName>
        <built/>
        <amenities>
          <!-- include all that apply -->
          <doorman/>
          <gym/>
          <pool/>
          <elevator/>
          <garage/>
          <parking/>
          <balcony/>
          <storage/>
          <patio/> <!-- Outdoor space -->
          <fireplace/>
          <washerDryer/>
          <dishwasher/>
          <furnished/>
          <pets/>
          <other/> <!-- A comma delimited string of other amenities -->
        </amenities>
      </details>

      <openHouses>
        <openHouse>
          <startsAt/>
          <endsAt/>
          <apptOnly/>
        </openHouse>
      </openHouses>

      <agents>
        <agent id=""> <!-- If agents have a unique id in your system put that here -->
          <name/>
          <company/>
          <photo/> <!-- URL of the agent photo -->
          <url/> <!-- Brokers personal page -->
          <email/>
          <lead_email/> <!-- If you have a lead generation email, this email address can put here -->
          <phone_numbers>
            <main/>
            <office/>
            <cell/>
            <fax/>
          </phone_numbers>
        </agent>
      </agents>

      <media>
        <!-- Multiple pictures, video and otherMedia allowed-->
        <photo url="" description="" position="x" />
        <photo url="" description="" position="y" />

        <floorplan url="" description=""/>

        <video url="" description=""/>

        <otherMedia url="" description="">

      </media>
    </property>
  </properties>
</streeteasy>

SAMPLE FEED

<?xml version="1.0" encoding="UTF-8"?>
<streeteasy version="1.6">
  <properties>
    <property status="active" type="sale" id="296321" url="http://www.eastsiderealty.com/listing.php?id=296321">
      <location>
        <address>15 East 14th Street</address>
        <apartment>4H</apartment>
        <city>New York</city>
        <state>NY</state>
        <zipcode>10016</zipcode>
        <neighborhood>Flatiron</neighborhood>
      </location>
      <details>
        <mlsName>Tri-State MLS</mlsName>
        <mlsId>1273371</mlsId>
        <price>1595000</price>
        <maintenance>1159.0</maintenance>
        <max_financing>80</max_financing>
        <exclusive/>
        <taxes>889.0</taxes>
        <bedrooms>2</bedrooms>
        <bathrooms>1</bathrooms>
        <totalrooms>4</totalrooms>
        <squareFeet>850</squareFeet>
        <listedOn>2006-06-21</listedOn>
        <description>
        <![CDATA[
Dazzling million dollar panoramic views include the East River and
downtown NYC. Pristine convertible two bed / two bath plus powder room condo.
Upon entering, your eyes focus on the views from oversized windows facing east
and south.<br /><br />
Listings like this don't last long. Contact us today!<br />
]]>
</description>
        <propertyType>Condo</propertyType>
        <amenities>
          <doorman />
          <prewar />
          <other>salt water lap pool, media room</other>
        </amenities>
      </details>
      <openHouses>
        <openHouse>
          <startsAt>2007-05-13 1:00PM</startsAt>
          <endsAt>2007-05-13 3:00PM</endsAt>
          <apptOnly></apptOnly>
        </openHouse>
      </openHouses>
      <media>
        <photo url="http://www.eastsiderealty.com/img/296321_int_photo1.jpg"/>
        <photo url="http://www.eastsiderealty.com/img/296321_int_photo2.jpg"/>
        <photo url="http://www.eastsiderealty.com/img/296321_int_photo3.jpg"/>
        <photo url="http://www.eastsiderealty.com/img/296321_int_photo4.jpg"/>
        <photo url="http://www.eastsiderealty.com/img/296321_int_photo5.jpg"/>
        <floorplan url="http://www.eastsiderealty.com/fp/296321_1.pdf"/>
        <floorplan url="http://www.eastsiderealty.com/fp/296321_2.pdf"/>
      </media>
      <agents>
        <agent id="MB12514">
         <name>Michelle Brown</name>
         <photo>http://www.eastsiderealty.com/agent/mb/12514.jpg</photo>
         <email>mbrown@eastsiderealty.com</email>
         <lead_email>1231.s1231321@leadgenerator.com</lead_email>
         <url>http://www.eastsiderealty.com/agent.php?id=12514</url>
        </agent>
        <agent id="MW12312">
         <name>Michael Williams</name>
         <photo>http://www.eastsiderealty.com/agent/mw/12312.jpg</photo>
         <email>mwilliams@eastsiderealty.com</email>
         <lead_email>1231.s1231321@leadgenerator.com</lead_email>
         <url>http://www.eastsiderealty.com/agent.php?id=12311</url>
        </agent>
      </agents>
    </property>
  </properties>
</streeteasy>

XML TAG DEFINITIONS