SiteBuilder RSS/XML Feed Information

The SiteBuilder tool generates a standard RSS 2.0/Atom feed. In addition to the default standard RSS elements there are custom elements which are specific to landmachine listings.

Feed URL
The Feed URL is the address any application or feed reader will use to download the listing data. In addition you can specify parameters to the feed url to filter contents. If any parameters are missing, the system will generate default parameters for the feed.

The base URL for all feeds is: http://feed.landmachine.com/

Possible feed parameters and default values

parameter	description	default
id	the feed ID, this is used to apply pre-configured filters to listings. The default filter displays all listings, or if you have a filter configured as your default it will automatically use that id.	0
s	site id, each customer has a unique site address.	all
start	listings are sent 10 listings at a time, this parameter allows you to page through your listings.	1 (first page)

Parameters are passed in standard url key/value pair format, eg: &parameter=value

Examples:
http://feed.landmachine.com/?s=babenco would display the listings for the customer with the site address babenco, it would show the first 10 listings using the default filter created by that customer

http://feed.landmachine.com/?start=5 would display the listings for all customers starting at page 5.

Custom elements
Using the second example above, lets take a look at the resulting xml feed data:

<channel>
<title>LANDMACHINE.COM Virtual Land</title>
<description>Virtual Land For Sale</description>
<link>http://land.landmachine.com/</link>
<copyright>(c) 2007,2008 LANDMACHINE.COM, All rights reserved</copyright>
<atom:link href="http://land.landmachine.com/" rel="self" type="application/rss+xml" />
   <item>
     	<guid>http://land.landmachine.com/search/50258</guid>
         <title> Menisa -  (M) -  1024 sq.m. - buy or rent</title>
         <description>  You can also rent this land for L$ 600 per week, IM Lalli Laval for renting information. Visit our complete listing at http://land.landmachine.com/lamaestates</description>
	      <link>http://land.landmachine.com/search/50258</link>
	      <category>Mainland</category>
         <enclosure url="http://www.landmachine.com/app/rss/rdr/pics/24570fa6-67fa-456e-b459-c1500e37e6d5_normal.jpg" length="6423" type="image/jpeg" />
         <source url="http://feed.landmachine.com/">LANDMACHINE.COM Virtual Land</source>
         <pubDate> Sun, 14 Dec 2008 05:09:14 PST</pubDate>
	      <landmachine:lastpage>302</landmachine:lastpage>
	      <landmachine:ownername>LaMa Estates</landmachine:ownername>
	      <landmachine:landid>50258</landmachine:landid>
	      <landmachine:parcelarea>1024</landmachine:parcelarea>
	      <landmachine:parcelprice>9540</landmachine:parcelprice>
	      <landmachine:price_sqm>9.32</landmachine:price_sqm>
	      <landmachine:slurl>http://slurl.com/secondlife/Menisa/48/144/0/?img=http%3A//www.landmachine.com/images/slurl-lm.gif&amp;ttle=LANDMACHINE.COM&amp;u=0494193d5074411d8bcc06900c5d0fd4</landmachine:slurl>
	      <landmachine:prims>234</landmachine:prims>
	      <landmachine:simname>Menisa</landmachine:simname>
	      <landmachine:added>2008-12-14 05:09:05</landmachine:added>
	      <landmachine:piccount>1</landmachine:piccount>
      	<landmachine:pictures>[{"WebPicID":"24570fa6-67fa-456e-b459-c1500e37e6d5","Caption":"","Body":""}]</landmachine:pictures>
     </item> 
     <item>
     ... repeated for each listing up to 10 ...
     </item>  
</channel>
</rss>

The standard RSS attribute documentation can be found here: http://www.rssboard.org/rss-specification
Documentation for extended landmachine attributes can be found here:
http://www.landmachine.com/app/rss/landmachine/

Displaying SiteBuilder Listings in HTML Format on your site
In addition to using the RAW RSS/XML feeds and parsing them into your preferred format, you can also use an iframe to include the pre-generated sitebuilder pages.

Once you enable your site by choosing a site address in the SiteBuilder tool, and optionally configuring filters and pages, you can use an iframe to include your listings in an html page on your own site, an example is below:

<iframe style="border:0;width:100%;height:100%" src="http://land.landmachine.com/yoursite"/>

where yoursite is the site address you chose in the SiteBuilder tool.