Feed specs

Please review the following workflow and XML specification of our feed program. Be sure to also review the FAQ and contact our support team you have any questions.

Data process

  1. At regular intervals LandSearch will fetch your XML feed for processing, typically every 2 hours.
  2. Our format is a superset of the RETS Syndication Schema (download XSD) and will be validated as such.
  3. Each listing in the feed will be processed based on their required unique ID.
    1. New feed entries will be created as new listings.
    2. Changes to entries will be updated in live listings.
    3. Listing display will be updated if the entry is missing from the feed at least 24 hours since the previous import completed.
  4. The processing report is made available in your account outlining the results including warnings or errors with helpful descriptions. This can also be emailed optionally.

Note that listings flagged as manual from the LandSearch admin will be excluded from any feed operations and must be updated from the team or agent account unless reverted.

Asset process

  1. Assets are extracted from the listing data and pushed into a queue for distributed processing.
  2. On existing listings only new or modified assets are fetched based on a HEAD modification time request and/or the recommended <MediaModificationTimestamp/> attribute.
  3. Images are compressed and scaled as follows:
    1. Thumbnails are constrained within 480x480.
    2. Large images are constrained within 1680x1680.
  4. Videos are compressed into high-quality MP4 formats.

Requirements

  • Listings must satisfy our land-centric property requirements. Generally speaking this means that if the property has a structure over 800 square feet then it must have a minimum of 3 acres. Otherwise all vacant or large tract properties are valid. Other conditions may apply and are communicated in the feed report.
  • State, county, and city names should match our official naming or one of our aliases. Unmatchable values are included in the report. To view and download these values click here.
  • Other enumerable properties should also match our predefined options, as defined below.
  • Do not include any HTML, links, or email addresses in your descriptive fields.
  • We prioritize completed listings so include as much data as possible to gain the most exposure.
  • Listings must be mappable so a valid address, parcel ID, or latitude/longitude must be provided although we prefer all data be sent.

Technical notes

  • Element names are case sensitive.
  • Wrap text with a CDATA tag when invalid XML characters (< > & ') exist.
  • The ListingKey must persist throughout the listing lifecycle and be unique to your brokerage.
  • There are no limits on the number of <Listing/> elements in a feed.

XML specifications

Our format is compatible with the RETS Syndication Schema (2012-03) but we only utilize a portion of allowed data. Additionally we support some custom values to better serve our land focus. The table below lists all currently supported attributes but you're welcome to send other RETS data as we may expand our use.

Advanced use

If your feed needs to supply listings for multiple teams or you need profiles to be dynamically generated contact us for approval and follow the instructions here.

ElementFormatDescriptionMultipleRequired
<ListingKey/>string (100)Unique, persistent listing IDYes
<ListingURL/>stringFully qualified URL of the original listing
<ListingDate/>dateYYYY-MM-DD ISO 8601 date listing became availableYes
<MlsId/>string (20)MLS short code identifier
<MlsNumber/>stringID for the MLS listing
<LeadRoutingEmail/>stringAdditional email address to copy on listing messages
<Address>Yes
<commons:FullStreetAddress/>stringValid street address
<commons:UnitNumber/>stringExtended address information
<commons:City/>enumMust match values hereYes
<commons:StateOrProvince/>enumMust match values hereYes
<commons:PostalCode/>enum5-digit code matching values here
<commons:Country/>stringISO-3166-1 Alpha-2 country code, defaults to US
<DiscloseAddress/>booleanSet to "false" to hide address
<PropertyType/>enum

We prefer the <Types> attribute

  • Commercial
  • Farm And Agriculture
  • Lots And Land
  • Residential
  • Other
<PropertySubType/>enum

We prefer the <Tags> attribute

  • Cabin
  • Farm
  • Manufactured Home
  • Mobile Home
  • Single Family Detached
  • Other
<ListingCategory/>enum
  • Lease
  • Purchase
Yes
<ListingStatus/>enum
  • Active
  • Pending
  • Closed
Yes
<ListingDescription/>string

No HTML formatting or links
Basic paragraph and unordered list markdown is supported

Yes
<ListPrice/>decimal
Optional attributes
commons:currencyCode - string
ISO 4217 country code, defaults to USD
commons:isgSecurityClass - string
"Public" default, "Confidential" to hide
commons:currencyPeriod - enum
  • Annually
  • Bi-Monthly
  • Bi-Weekly
  • Daily
  • Month
  • Quarterly
  • Seasonal
  • Semi-Annually
  • Week
Yes
<Bedrooms/>integerCount of bedrooms
<FullBathrooms/>integerCount of full bathrooms
<ThreeQuarterBathrooms/>integerCount of three quarter bathrooms
<HalfBathrooms/>integerCount of half bathrooms
<OneQuarterBathrooms/>integerCount of one quarter bathrooms
<LivingArea/>integer

Unformatted, defaults to square feet

Optional attributes
commons:areaUnits - enum
  • acre
  • hectare
  • squareCentimeter
  • squareFoot
  • squareMeter
  • squareYard
<LotSize/>decimal Unformatted, unit defaults to "acre"
Attributes same as above
Yes
<YearBuilt/>integer Unformatted, 4 digit year
<Zoning/>string
<Location>Yes
<ParcelId/>string

We prefer the <Parcels> attribute
Identifier assigned by tax assessor

<County/>enumMust match values hereYes
<Latitude/>decimalLatitude of the propertyYes
<Longitude/>decimalLongitude of the propertyYes
<Elevation/>integerUnformatted in feet
<Directions/>stringNo HTML formatting or links
<Photos>
<Photo>Yes
<MediaURL/>string Fully qualified URL of the original asset
JPG/JPEG, PNG, and GIF formats supported
Maximum 10MB file size
Yes
<MediaCaption/>string (100)Short title for the image
<MediaModificationTimestamp/>datetimeISO 8601 formatted date
<MediaOrderNumber/>integerPosition of the image in the gallery with 1 being the cover
<Videos>
<Video>Yes
<MediaURL/>string Fully qualified URL of the original asset
AVI, MPEG, and MOV formats supported
YouTube and Vimeo links also supported
Maximum 512MB file size
Yes
<MediaCaption/>string (100)Short title for the video
<MediaModificationTimestamp/>datetimeISO 8601 formatted date
<MediaOrderNumber/>integerPosition of the video in the gallery
<VirtualTours>
<VirtualTour>Yes
<MediaURL/>stringFully qualified URL of the viewable tourYes
<MediaCaption/>string (100)Short title for the virtual tour
<MediaModificationTimestamp/>datetimeISO 8601 formatted date
<MediaOrderNumber/>integerPosition of the virtual tour in the list
<Offices>Yes
<Office>
<OfficeId/>presetLandSearch team IDYes
<ListingParticipants>Yes
<Participant>Yes
<ParticipantId/>preset

LandSearch user ID or email
For dynamic user creation see our advanced specs

Yes
<Taxes>
<Tax>Yes
<Year/>integer4 digit yearYes
<Amount/>decimalUnformatted valueYes
<Description/>string (100)Additional detail about the tax
<Expenses>
<Expense>Yes
<commons:ExpenseCategory/>string (100)Description of the expense typeYes
<commons:ExpenseValue/>enum
Attributes
period
  • Annually
  • Bi-Monthly
  • Bi-Weekly
  • Daily
  • Month
  • Quarterly
  • Seasonal
  • Semi-Annually
  • Week
Yes
<Disclaimer/>stringCustom legal text to display
<ModificationTimestamp/>datetimeISO 8601 formatted date of last listing changeYes

Custom

These non-standard attributes are specific to LandSearch. Though some are required, we highly recommend providing all applicable values for increased exposure.

ElementFormatDescriptionMultipleRequired
<Types>Yes
<Type/>enum
  • Agricultural
  • Commercial
  • Recreational
  • Residential
YesYes
<Tags>
<Tag/>enum
  • Beachfront
  • Cabin
  • Equestrian
  • High Visibility
  • Hunting
  • Incentivized
  • Industrial
  • Lakefront
  • Mineral Rights
  • Mountain
  • Owner Financing
  • Ranch
  • Riverfront
  • Rural
  • Timber
  • Unrestricted
  • Vacant
  • Waterfront
Yes
<Parcels>
<Parcel/>stringIdentifier assigned by tax assessorYes
<Attachments>
<Attachment>Yes
<MediaURL/>string Fully qualified URL of the original asset
PDF, JPG/JPEG, PNG, GIF, and TIFF formats supported
Maximum 50MB file size
Yes
<MediaCaption/>string (100)Short title for the attachmentYes
<MediaModificationTimestamp/>datetimeISO 8601 formatted date
<MediaOrderNumber/>integerPosition of the attachment in the list
<Embeds>
<Embed>Yes
<Type/>enum
  • MapRight
  • Matterport
  • TerraStride
Yes
<SourceURL/>string

Fully qualified embed URL. Limit of 1 per source.

https://mapright.com/ranching/maps/ID/embed or
https://my.matterport.com/show/?m=ID or
https://app.terrastridepro.com/property/ID/map?referer=iframe

Limit of 1 embed per type

Yes
<Auction>
<StartDate/>datetimeISO 8601 formatted dateYes
<EndDate/>datetimeISO 8601 formatted date
<MinimumBid/>decimal
Optional attributes
commons:currencyCode - string
ISO 4217 country code, defaults to USD
commons:isgSecurityClass - string
"Public" default, "Confidential" to hide
<EventLocation/>stringCommon name for location
<EventDescription/>stringImportant event notes or directions
<EventAddress>
<commons:FullStreetAddress/>stringValid street addressYes
<commons:UnitNumber/>stringExtended address information
<commons:City/>enumMust match values hereYes
<commons:StateOrProvince/>enumMust match values hereYes
<commons:PostalCode/>enum5-digit code matching values here
<commons:Country/>stringISO-3166-1 Alpha-2 country code, defaults to US
<Format/>enum
  • Hybrid
  • Online
  • Sealed bid
  • Traditional
  • Other
<Type/>enum
  • Absolute
  • Minimum Bid
  • Reserve
  • Other
<Lease>
<Type/>enum
  • Agricultural
  • Commercial
  • Hunting
  • Recreational
  • Residential
  • Other
Yes
<ContractPrice/>decimal
Required attributes
commons:currencyPeriod - enum
  • Annually
  • Bi-Monthly
  • Bi-Weekly
  • Daily
  • Month
  • Quarterly
  • Seasonal
  • Semi-Annually
  • Week
Optional attributes
commons:currencyCode - string
ISO 4217 country code, defaults to USD
commons:isgSecurityClass - string
"Public" default, "Confidential" to hide
Yes
<MinimumDuration/>integerMinimum contract length in units defined by the <ContractPrice/> currencyPeriod attribute
<MaximumDuration/>integerMaximum contract length in units defined by the <ContractPrice/> currencyPeriod attribute
<Terms/>stringImportant lease terms or notes
<DepositPrice/>decimal

Lease deposit cost

Optional attributes
commons:currencyCode - string
ISO 4217 country code, defaults to USD
commons:isgSecurityClass - string
"Public" default, "Confidential" to hide
<LegalDescription/>string
<Geometry/>array

Array of coordinate arrays
Polygon or MultiPolygon value from GeoJSON

Example

Minimum

The following displays the basic data requirements.

<?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" xml:lang="en-us" listingsKey="2012-03-06T22:14:47" version="0.96" versionTimestamp="2012-02-07T03:00:00Z">
	<Listing>
		<ListingKey>UNIQUE-ID-123</ListingKey>
		<ListingDate>2019-01-26</ListingDate>
		<Address>
			<commons:FullStreetAddress>230 E Main Street</commons:FullStreetAddress>
			<commons:City>Colorado Springs</commons:City>
			<commons:StateOrProvince>CO</commons:StateOrProvince>
			<commons:PostalCode>80903</commons:PostalCode>
			<commons:Country>US</commons:Country>
		</Address>
		<Types>
			<Type>Agricultural</Type>
			<Type>Residential</Type>
		</Types>
		<Tags>
			<Tag>Hunting</Tag>
			<Tag>Mineral Rights</Tag>
			<Tag>Owner Financing</Tag>
			<Tag>Ranch</Tag>
		</Tags>
		<ListingCategory>Purchase</ListingCategory>
		<ListingDescription>This incredible land has so much to offer with flat tillable ground as well as recreational opportunities and mountain views...</ListingDescription>
		<ListPrice>275000</ListPrice>
		<LotSize>94.5</LotSize>
		<Location>
			<County>El Paso</County>
			<Latitude>31.7684449</Latitude>
			<Longitude>-106.4561127</Longitude>
		</Location>
		<Offices>
			<Office>
				<OfficeId>6371</OfficeId>
			</Office>
		</Offices>
		<ListingParticipants>
			<Participant>
				<ParticipantId>46371</ParticipantId>
			</Participant>
		</ListingParticipants>
		<ModificationTimestamp>2019-03-06T17:14:47-05:00</ModificationTimestamp>
	</Listing>
</Listings>

Example

Complete

The following represents full-featured syndication.

<?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" xml:lang="en-us" listingsKey="2012-03-06T22:14:47" version="0.96" versionTimestamp="2012-02-07T03:00:00Z">
	<Listing>
		<ListingKey>UNIQUE-ID-123</ListingKey>
		<ListingURL>https://www.domain.com/property/listing-id</ListingURL>
		<ListingDate>2019-01-26</ListingDate>
		<MlsId>MLS-ID</MlsId>
		<MlsNumber>123456</MlsNumber>
		<Address>
			<commons:FullStreetAddress>230 E Main Street</commons:FullStreetAddress>
			<commons:City>Colorado Springs</commons:City>
			<commons:StateOrProvince>CO</commons:StateOrProvince>
			<commons:PostalCode>80903</commons:PostalCode>
			<commons:Country>US</commons:Country>
		</Address>
		<DiscloseAddress>true</DiscloseAddress>
		<Types>
			<Type>Agricultural</Type>
			<Type>Residential</Type>
		</Types>
		<Tags>
			<Tag>Hunting</Tag>
			<Tag>Mineral Rights</Tag>
			<Tag>Owner Financing</Tag>
			<Tag>Ranch</Tag>
		</Tags>
		<ListingCategory>Purchase</ListingCategory>
		<ListingStatus>Active</ListingStatus>
		<ListingDescription><![CDATA[This incredible land has so much to offer with flat tillable ground as well as recreational opportunities & mountain views...

		* Lush tillable ground
		* Incredible mountain views
		* Recreational opportunities]]></ListingDescription>
		<ListPrice commons:isgSecurityClass="Public">275000</ListPrice>
		<Bedrooms>3</Bedrooms>
		<FullBathrooms>2</FullBathrooms>
		<HalfBathrooms>1</HalfBathrooms>
		<LivingArea>1600</LivingArea>
		<LotSize>94.5</LotSize>
		<YearBuilt>1995</YearBuilt>
		<LegalDescription>LOT 2 MAIN ST ADD COLO SPGS</LegalDescription>
		<Zoning>R-3</Zoning>
		<Location>
			<ParcelId>ID-123456-123</ParcelId>
			<County>El Paso</County>
			<Latitude>38.4533</Latitude>
			<Longitude>-88.8391</Longitude>
			<Elevation>287</Elevation>
			<Directions>Head south on Market St and turn left on Main at the dead end</Directions>
		</Location>
		<Geometry>[[[-86.856689, 34.992046], [-86.819389, 34.991881], [-86.819455, 34.977195], [-86.855636, 34.977387], [-86.851563, 34.984477], [-86.857346, 34.984436], [-86.855827, 34.988196], [-86.857422, 34.992059], [-86.856689, 34.992046]]]</Geometry>
		<Photos>
			<Photo>
				<MediaURL>https://media.domain.com/listing-id/1.jpg</MediaURL>
				<MediaCaption>Incredible mountain views</MediaCaption>
				<MediaModificationTimestamp>2017-04-16T17:14:47-05:00</MediaModificationTimestamp>
			</Photo>
			<Photo>
				<MediaURL>https://media.domain.com/listing-id/2.jpg</MediaURL>
				<MediaCaption>Multiple springs available</MediaCaption>
				<MediaModificationTimestamp>2017-04-16T17:14:47-05:00</MediaModificationTimestamp>
			</Photo>
		</Photos>
		<Videos>
			<Video>
				<MediaURL>https://media.domain.com/listing-id/1.mp4</MediaURL>
				<MediaCaption>Incredible mountain views</MediaCaption>
				<MediaModificationTimestamp>2017-04-16T17:14:47-05:00</MediaModificationTimestamp>
			</Video>
		</Videos>
		<Attachments>
			<Attachment>
				<MediaURL>https://domain.com/listing-id/survey.jpg</MediaURL>
				<MediaCaption>2018 Survey</MediaCaption>
				<MediaModificationTimestamp>2017-04-16T17:14:47-05:00</MediaModificationTimestamp>
			</Attachment>
			<Attachment>
				<MediaURL>https://domain.com/listing-id/soil-report.pdf</MediaURL>
				<MediaCaption>Soil Sample Report</MediaCaption>
				<MediaModificationTimestamp>2017-04-16T17:14:47-05:00</MediaModificationTimestamp>
			</Attachment>
		</Attachments>
		<VirtualTours>
			<VirtualTour>
				<MediaURL>https://domain.com/listing-id/virtual-tour</MediaURL>
				<MediaCaption>Property virtual tour</MediaCaption>
				<MediaModificationTimestamp>2017-04-16T17:14:47-05:00</MediaModificationTimestamp>
			</VirtualTour>
		</VirtualTours>
		<Embeds>
			<Embed>
				<Type>MapRight</Type>
				<SourceURL>https://mapright.com/ranching/maps/ID/embed</SourceURL>
			</Embed>
			<Embed>
				<Type>TerraStride</Type>
				<SourceURL>https://app.terrastridepro.com/property/ID/map?referer=iframe</SourceURL>
			</Embed>
		</Embeds>
		<Offices>
			<Office>
				<OfficeId>6371</OfficeId>
			</Office>
		</Offices>
		<ListingParticipants>
			<Participant>
				<ParticipantId>46371</ParticipantId>
			</Participant>
		</ListingParticipants>
		<Taxes>
			<Tax>
				<Year>2017</Year>
				<Amount>1514.25</Amount>
				<TaxDescription>Annual property tax</TaxDescription>
			</Tax>
			<Tax>
				<Year>2016</Year>
				<Amount>1400.50</Amount>
				<TaxDescription>Annual property tax</TaxDescription>
			</Tax>
		</Taxes>
		<Expenses>
			<Expense>
				<commons:ExpenseCategory>Home Owner Assessments Fee</commons:ExpenseCategory>
				<commons:ExpenseValue commons:currencyPeriod="Annually">200</commons:ExpenseValue>
			</Expense>
		</Expenses>
		<Disclaimer commons:isgSecurityClass="Public">Copyright © 2014 Listing Exchange Group. All rights reserved. All information provided by the listing agent/broker is deemed reliable but is not guaranteed and should be independently verified.</Disclaimer>
		<ModificationTimestamp>2019-03-06T17:14:47-05:00</ModificationTimestamp>
	</Listing>
</Listings>

Example

Auction

The following shows the relevant custom auction attributes. All core property attributes are also supported.

<Listing>
	<ListingCategory>Purchase</ListingCategory>
	<Auction>
		<Format>Traditional</Format>
		<Type>Absolute</Type>
		<MinimumBid>75000</MinimumBid>
		<StartDate>2019-03-06T17:00:00-05:00</StartDate>
		<EndDate>2019-03-06T18:00:00-05:00</EndDate>
		<EventLocation>El Paso County Courthouse</EventLocation>
		<EventDescription>At the East side entrance. Cash only, financing not accepted.</EventDescription>
		<EventAddress>
			<commons:FullStreetAddress>230 E Main Street</commons:FullStreetAddress>
			<commons:City>Colorado Springs</commons:City>
			<commons:StateOrProvince>CO</commons:StateOrProvince>
			<commons:PostalCode>80903</commons:PostalCode>
			<commons:Country>US</commons:Country>
		</EventAddress>
	</Auction>
</Listing>

Example

Lease

The following shows the relevant custom lease attributes. All core property attributes are also supported.

<Listing>
	<ListingCategory>Lease</ListingCategory>
	<Lease>
		<Type>Hunting</Type>
		<Terms>No more than 5 hunters. Turkey only.</Terms>
		<ContractPrice commons:currencyPeriod="Annually">3600</ContractPrice>
		<MinimumDuration>12</MinimumDuration>
		<MaximumDuration>24</MaximumDuration>
		<Deposit>1200</Deposit>
	</Lease>
</Listing>