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.

Extended profiles

Out property feed allows defining basic user information. To sync more complete profile information you can supplement your listing data with a dedicated profile import file.

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 ID
<ListingURL/>stringFully qualified URL of the original listing
<ListingDate/>dateYYYY-MM-DD ISO 8601 date listing became available
<MlsId/>string (20)MLS short code identifier
<MlsNumber/>stringID for the MLS listing
<LeadRoutingEmail/>stringAdditional email address to copy on listing messages
<Address>
<commons:FullStreetAddress/>stringValid street address
<commons:UnitNumber/>stringExtended address information
<commons:City/>enumMust match values here
<commons:StateOrProvince/>enumMust match values here
<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
<ListingStatus/>enum
  • Active
  • Pending
  • Closed
<ListingDescription/>string

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

<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
<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
<YearBuilt/>integer Unformatted, 4 digit year
<Zoning/>string
<Location>
<ParcelId/>string

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

<County/>enumMust match values here
<Latitude/>decimalLatitude of the property
<Longitude/>decimalLongitude of the property
<Elevation/>integerUnformatted in feet
<Directions/>stringNo HTML formatting or links
<Photos>
<Photo>
<MediaURL/>string Fully qualified URL of the original asset
JPG/JPEG, PNG, and GIF formats supported
Maximum 10MB file size
<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>
<MediaURL/>string YouTube and Vimeo links are supported
Maximum 512MB file size
<MediaCaption/>string (100)Short title for the video
<MediaModificationTimestamp/>datetimeISO 8601 formatted date
<MediaOrderNumber/>integerPosition of the video in the gallery
<VirtualTours>
<VirtualTour>
<MediaURL/>stringFully qualified URL of the viewable tour
<MediaCaption/>string (100)Short title for the virtual tour
<MediaModificationTimestamp/>datetimeISO 8601 formatted date
<MediaOrderNumber/>integerPosition of the virtual tour in the list
<Offices>
<Office>
<OfficeId/>presetLandSearch team ID
<ListingParticipants>
<Participant>
<ParticipantId/>preset

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

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

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

Fully qualified embed URL. Limit of 1 per type.

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

<Auction>
<StartDate/>datetimeISO 8601 formatted date
<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 address
<commons:UnitNumber/>stringExtended address information
<commons:City/>enumMust match values here
<commons:StateOrProvince/>enumMust match values here
<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
<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
<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>
		<ListingCategory>Purchase</ListingCategory>
		<ListingStatus>Active</ListingStatus>
		<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>
		<LeadRoutingEmail>crm@domain.com</LeadRoutingEmail>
		<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://youtu.be/VIDEO_ID</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>