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

At regular intervals LandSearch will fetch your XML feed for processing, typically every 2 hours.
Our format is a superset of the RETS Syndication Schema (download XSD) and will be validated as such.
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.
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

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

Element	Format	Description	Multiple	Required
<ListingKey/>	string (100)	Unique, persistent listing ID		Yes
<ListingURL/>	string	Fully qualified URL of the original listing
<ListingDate/>	date	YYYY-MM-DD ISO 8601 date listing became available		Yes
<MlsId/>	string (20)	MLS short code identifier
<MlsNumber/>	string	ID for the MLS listing
<LeadRoutingEmail/>	string	Additional email address to copy on listing messages
<Address>				Yes
<commons:FullStreetAddress/>	string	Valid street address
<commons:UnitNumber/>	string	Extended address information
<commons:City/>	enum	Must match values here		Yes
<commons:StateOrProvince/>	enum	Must match values here		Yes
<commons:PostalCode/>	enum	5-digit code matching values here
<commons:Country/>	string	ISO-3166-1 Alpha-2 country code, defaults to US
<DiscloseAddress/>	boolean	Set 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/>	integer	Count of bedrooms
<FullBathrooms/>	integer	Count of full bathrooms
<ThreeQuarterBathrooms/>	integer	Count of three quarter bathrooms
<HalfBathrooms/>	integer	Count of half bathrooms
<OneQuarterBathrooms/>	integer	Count 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/>	enum	Must match values here		Yes
<Latitude/>	decimal	Latitude of the property		Yes
<Longitude/>	decimal	Longitude of the property		Yes
<Elevation/>	integer	Unformatted in feet
<Directions/>	string	No 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/>	datetime	ISO 8601 formatted date
<MediaOrderNumber/>	integer	Position 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/>	datetime	ISO 8601 formatted date
<MediaOrderNumber/>	integer	Position of the video in the gallery
<VirtualTours>
<VirtualTour>			Yes
<MediaURL/>	string	Fully qualified URL of the viewable tour		Yes
<MediaCaption/>	string (100)	Short title for the virtual tour
<MediaModificationTimestamp/>	datetime	ISO 8601 formatted date
<MediaOrderNumber/>	integer	Position of the virtual tour in the list
<Offices>				Yes
<Office>
<OfficeId/>	preset	LandSearch team ID		Yes
<ListingParticipants>				Yes
<Participant>			Yes
<ParticipantId/>	preset	LandSearch user ID or email For dynamic user creation see our advanced specs		Yes
<Taxes>
<Tax>			Yes
<Year/>	integer	4 digit year		Yes
<Amount/>	decimal	Unformatted value		Yes
<Description/>	string (100)	Additional detail about the tax
<Expenses>
<Expense>			Yes
<commons:ExpenseCategory/>	string (100)	Description of the expense type		Yes
<commons:ExpenseValue/>	enum	Attributes period Annually Bi-Monthly Bi-Weekly Daily Month Quarterly Seasonal Semi-Annually Week		Yes
<Disclaimer/>	string	Custom legal text to display
<ModificationTimestamp/>	datetime	ISO 8601 formatted date of last listing change		Yes

Custom

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

Element	Format	Description	Multiple	Required
<Types>				Yes
<Type/>	enum	Agricultural Commercial Recreational Residential	Yes	Yes
<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/>	string	Identifier assigned by tax assessor	Yes
<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 attachment		Yes
<MediaModificationTimestamp/>	datetime	ISO 8601 formatted date
<MediaOrderNumber/>	integer	Position 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/>	datetime	ISO 8601 formatted date		Yes
<EndDate/>	datetime	ISO 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/>	string	Common name for location
<EventDescription/>	string	Important event notes or directions
<EventAddress>
<commons:FullStreetAddress/>	string	Valid street address		Yes
<commons:UnitNumber/>	string	Extended address information
<commons:City/>	enum	Must match values here		Yes
<commons:StateOrProvince/>	enum	Must match values here		Yes
<commons:PostalCode/>	enum	5-digit code matching values here
<commons:Country/>	string	ISO-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/>	integer	Minimum contract length in units defined by the `<ContractPrice/>` currencyPeriod attribute
<MaximumDuration/>	integer	Maximum contract length in units defined by the `<ContractPrice/>` currencyPeriod attribute
<Terms/>	string	Important 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>

Feed specs

Optional attributes

Optional attributes

Attributes

Optional attributes

Required attributes

Optional attributes

Optional attributes

Example

Minimum

Example

Complete

Example

Auction

Example

Lease