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 if 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 on active listings.
3. Listings will be deactivated if the entry is missing from the feed at least 12 hours since the previous import completed.
The processing report can optionally be emailed. This outlines the results, including warnings or errors with helpful descriptions.

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

Asset process

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

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 2 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

Our 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.

Element	Format	Description
<ListingKey/>	string (100)	Unique, persistent listing ID
<ListingURL/>	string	Fully qualified URL of the original listing
<ListingDate/>	date	YYYY-MM-DD ISO 8601 date listing became available
<ProviderCategory/>	enum	Required when listed by owner Aggregator Broker Franchiser HomeBuilder Member Member MLS Owner Publisher Unknown Other
<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>
<commons:FullStreetAddress/>	string (60)	Valid street address
<commons:UnitNumber/>	string	Extended address information
<commons:City/>	enum	Must match values here
<commons:StateOrProvince/>	enum	Must match values here
<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
<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/>	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
<YearBuilt/>	integer	Unformatted, 4 digit year
<Location>
<County/>	enum	Must match values here
<Latitude/>	decimal	Latitude of the property
<Longitude/>	decimal	Longitude of the property
<Elevation/>	integer	Unformatted in feet
<Directions/>	string	No HTML formatting or links
<Zoning/>	string	The civic building zoning code
<Neighborhoods>
<Neighborhood>
<Name/>	string	Name of the neighborhood
<Community>
<commons:Subdivision>	string	Name of the subdivision
<commons:Schools>
<commons:School>
<commons:Name/>	string	Name of the school
<commons:SchoolCategory/>	enum	Elementary High JuniorHigh Middle Primary Secondary Other
<commons:District/>	string	Name of the assigned school district
<commons:Description/>	string (100)	Description of the school
<Photos>
<Photo>
<MediaURL/>	string	Fully qualified URL of the original asset JPG/JPEG, PNG, GIF, WebP, and TIFF formats supported Maximum 10MB file size
<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>
<MediaURL/>	string	Maximum 512MB file size YouTube and Vimeo links are also supported
<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>
<MediaURL/>	string	Fully qualified URL of the viewable tour
<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>
<Office>
<OfficeId/>	preset	LandSearch team ID
<ListingParticipants>
<Participant>
<ParticipantId/>	preset	LandSearch user ID or email For dynamic user creation see our advanced specs
<Taxes>
<Tax>
<Year/>	integer	4 digit year
<Amount/>	decimal	Unformatted 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 One-Time Quarterly Seasonal Semi-Annually Week
<OpenHouses>
<OpenHouse>
<Date/>	date	ISO 8601 formatted date of open house
<StartTime/>	time	12-hour formatted time the open house starts
<EndTime/>	time	12-hour formatted time the open house ends
<Description/>	string (100)	Description of the open house
<AppointmentRequiredYN/>	boolean	Whether an appointment is required or not, defaults to false
<DetailedCharacteristics>
<LegalDescription/>	string
<Disclaimer/>	string	Custom legal text to display
<ModificationTimestamp/>	datetime	ISO 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.

Element	Format	Description
<Access/>	enum	Easement Private Road Public Road None Other
<Showing/>	enum	Appointment Only Call Before You Go Call for Code Go on Your Own
<Types>
<Type/>	enum	Agricultural Commercial Recreational Residential
<Tags>
<Tag/>	enum	Barn Barndominium Beachfront Cabin Camping Chicken Farm Cottage Desert Farm House Equestrian Homestead House Hunting Industrial Island Lakefront Mineral Rights Mobile Home Mountain Off-Grid Owner Financed Ranch Riverfront Rural RV Lot Small Farm Timber Unrestricted Vacant Vineyard Waterfront Wooded
<Features>
<Feature/>	enum	A-Frame House Airstrip Boat Ramp Borders Public Land Bunker Cave Clear-Cut Conservation Corner Lot Corral Creek Cul-de-sac Dairy Farm Development Distressed Dock Estate Fenced Fishing Gated Entrance Golf Course Lot High Traffic Historic Income-Producing Irrigated Lodge Mixed-Use Oil Orchard Organic Farm Pasture Plantation Pond Rent to Own Resort Retail Row Crop Septic Solar Power Spring Stable Stream Sustainable Vacation Waterfall Waterfowl Water Rights Water Well Wetland Workshop
<Parcels>
<Parcel/>	string	Identifier assigned by tax assessor
<Attachments>
<Attachment>
<MediaURL/>	string	Fully qualified URL of the original asset JPG/JPEG, PNG, GIF, WebP, TIFF, PDF, DOC(X), XLS(X), and PPT(X) formats supported Maximum 50MB file size
<MediaCaption/>	string (100)	Short title for the attachment
<MediaModificationTimestamp/>	datetime	ISO 8601 formatted date
<MediaOrderNumber/>	integer	Position of the attachment in the list
<Embeds>
<Embed>
<Type/>	enum	MapRight Matterport TerraStride
<SourceURL/>	string	Fully qualified embed URL 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
<Utilities>
<Utility>
<Category/>	enum	Gas Internet Power Trash Waste Water
<Type/>	enum	Gas Natural Gas Owned Propane Tank Rented Propane Tank Internet Cable DSL Fiber Satellite Wireless Power Grid Wind Hydroelectric Solar Generator Other Trash Pick Up Drop Off Compost Other Waste Sewer Septic System Pit Latrine Composting Toilet Incinerating Toilet Other Water Tap Private Well Private Spring Shared Well Shared Spring Cistern Other
<Status/>	enum	Active Available Unavailable
<Description/>	string (100)	Description of the utility
<Location>
<SchoolDistrict/>	string (50)	Name of the assigned school district
<Community>
<commons:Schools>
<commons:School>
<Type/>	enum	Public Private Charter Magnet
<Auction>
<StartDate/>	datetime	ISO 8601 formatted date
<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
<commons:UnitNumber/>	string	Extended address information
<commons:City/>	enum	Must match values here
<commons:StateOrProvince/>	enum	Must match values here
<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
<BidURL/>	string	Fully qualified URL for online bidding
<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/>	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
<Geometry/>	mixed	Valid GeoJSON or array of coordinate arrays Polygon and MultiPolygon values only

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>

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>MLSID</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 Financed</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>
		<Access>Public Road</Access>
		<Showing>Appointment Only</Showing>
		<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>
			<Zoning>R-3</Zoning>
			<Neighborhoods>
				<Neighborhood>
					<Name>Mountain Side</Name>
				</Neighborhood>
			</Neighborhoods>
			<Community>
				<commons:Subdivision>Elk Crossings</commons:Subdivision>
				<commons:Schools>
					<commons:School>
						<commons:Name>Valley View</commons:Name>
						<commons:SchoolCategory>Elementary</commons:SchoolCategory>
						<commons:District>D11</commons:District>
						<commons:Description>Highly-rated early education</commons:Description>
						<Type>Public</Type>
					</commons:School>
					<commons:School>
						<commons:Name>South</commons:Name>
						<commons:SchoolCategory>Middle</commons:SchoolCategory>
						<commons:District>D11</commons:District>
						<Type>Public</Type>
					</commons:School>
					<commons:School>
						<commons:Name>Morgantown Jr High School</commons:Name>
						<commons:SchoolCategory>JuniorHigh</commons:SchoolCategory>
						<commons:District>D11</commons:District>
						<Type>Public</Type>
					</commons:School>
					<commons:School>
						<commons:Name>MHS</commons:Name>
						<commons:SchoolCategory>High</commons:SchoolCategory>
						<commons:District>D11</commons:District>
						<Type>Public</Type>
					</commons:School>
				</commons:Schools>
			</Community>
		</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>
		<Utilities>
			<Utility>
				<Category>Power</Category>
				<Type>Grid</Type>
				<Status>Available</Status>
				<Desciprion>Power to pole at building site</Desciprion>
			</Utility>
			<Utility>
				<Category>Waste</Category>
				<Type>Sewer</Type>
				<Status>Active</Status>
			</Utility>
		</Utilities>
		<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>
		<OpenHouses>
			<OpenHouse>
				<Date>2023-01-14</Date>
				<StartTime>10:00 AM</StartTime>
				<EndTime>4:00 PM</EndTime>
				<Description>Park </Description>
			</OpenHouse>
		</OpenHouses>
		<DetailedCharacteristics>
			<LegalDescription>LOT 2 MAIN ST ADD COLO SPGS</LegalDescription>
		</DetailedCharacteristics>
		<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>

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>

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>

Optional attributes

Optional attributes

Attributes

Gas

Internet

Power

Trash

Waste

Water

Optional attributes

Required attributes

Optional attributes

Optional attributes