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.
Feed specs
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.
- New feed entries will be created as new listings.
- Changes to entries will be updated in live listings.
- 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:
- Thumbnails are constrained within 480x480.
- 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.
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.
Element | Format | Description | Multiple | Required |
---|---|---|---|---|
<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 | ||
<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 | 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 | ||
<PropertyType/> | enum | We prefer the
| ||
<PropertySubType/> | enum | We prefer the
| ||
<ListingCategory/> | enum |
| ||
<ListingStatus/> | enum |
| ||
<ListingDescription/> | string |
No HTML formatting or links | ||
<ListPrice/> | decimal | Optional attributes
| ||
<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
| ||
<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 | ||
<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 | ||
<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/> | datetime | ISO 8601 formatted date | ||
<MediaOrderNumber/> | integer | Position 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/> | 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 | ||
<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
| ||
<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 | Multiple | Required |
---|---|---|---|---|
<Types> | ||||
<Type/> | enum |
| ||
<Tags> | ||||
<Tag/> | enum |
| ||
<Parcels> | ||||
<Parcel/> | string | Identifier 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/> | datetime | ISO 8601 formatted date | ||
<MediaOrderNumber/> | integer | Position of the attachment in the list | ||
<Embeds> | ||||
<Embed> | ||||
<Type/> | enum |
| ||
<SourceURL/> | string | Fully qualified embed URL. Limit of 1 per type.
https://mapright.com/ranching/maps/ID/embed or | ||
<Auction> | ||||
<StartDate/> | datetime | ISO 8601 formatted date | ||
<EndDate/> | datetime | ISO 8601 formatted date | ||
<MinimumBid/> | decimal | Optional attributes
| ||
<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 |
| ||
<Type/> | enum |
| ||
<Lease> | ||||
<Type/> | enum |
| ||
<ContractPrice/> | decimal | Required attributes
Optional attributes
| ||
<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
| ||
<LegalDescription/> | string | |||
<Geometry/> | mixed |
Valid GeoJSON or array of coordinate arrays |
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>