Advanced feed specs

As approved by the LandSearch team you can provide the following descriptive attributes in place of a relationship to existing LandSearch team and agent IDs. It's critical that the OfficeKey and ParticipantKey values never change. Only one element or both may be applicable depending on your requirements so contact us if you have questions.

There are other important pieces of information that we capture that will need to be completed as shell profiles are created for newly identified teams and users. This information includes specialties as well as the service areas and bios. Missing profile data won't keep listings from displaying but will limit the team and agent visibility in the directory.

Office

The following element is a child of the <Offices/> element.

ElementFormatDescriptionMultipleRequired
<Office>Yes
<OfficeKey/>string (100)Unique, persistent office IDYes
<Name/>string (100)Public office labelYes
<PhoneNumber/>stringWell-formatted phone numberYes
<OfficeEmail/>stringValid email addressYes
<Website/>stringURL specific to the office
<Address>
<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 hereYes
<commons:Country/>string (2)ISO-3166-1 Alpha-2 country code

Agents

The following elements are children of the <ListingParticipants/> element.

ElementFormatDescriptionMultipleRequired
<Participant>YesYes
<ParticipantKey/>string (100)Unique, persistent agent IDYes
<FirstName/>string (50)First name onlyYes
<LastName/>string (50)Last name onlyYes
<PrimaryContactPhone/>stringWell-formatted phone numberYes
<OfficePhone/>stringWell-formatted phone number
<Email/>stringValid email addressYes
<PhotoURL/>stringHead shot photo URL specific to agent
<WebsiteURL/>stringURL specific to agent
<Address>Defaults to office address
<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 hereYes
<commons:Country/>string (2)ISO-3166-1 Alpha-2 country code

Example

Office

Define a single office in the following format.

<Offices>
	<Office>
		<OfficeKey>UNIQUE-ID-123</OfficeKey>
		<Name>Listing Team Name</Name>
		<PhoneNumber>123-456-7890</PhoneNumber>
		<Website>https://www.domain.com</Website>
		<Address>
			<commons:FullStreetAddress>230 E Main Street</commons:FullStreetAddress>
			<commons:UnitNumber>Suite 120</commons:UnitNumber>
			<commons:City>Colorado Springs</commons:City>
			<commons:StateOrProvince>CO</commons:StateOrProvince>
			<commons:PostalCode>80903</commons:PostalCode>
			<commons:Country>US</commons:Country>
		</Address>
	</Office>
</Offices>

Example

Agents

Provide one or more agents in order of priority in the following format.

<ListingParticipants>
	<Participant>
		<ParticipantKey>UNIQUE-ID-123</ParticipantKey>
		<FirstName>John</FirstName>
		<LastName>Doe</LastName>
		<PrimaryContactPhone>123-456-7890</PrimaryContactPhone>
		<OfficePhone>123-456-7890</OfficePhone>
		<Email>name@domain.com</Email>
		<PhotoURL>https://www.domain.com/agents/agent-id/photo.jpg</PhotoURL>
		<WebsiteURL>https://www.domain.com/agents/agent-id</WebsiteURL>
		<Address>
			<commons:FullStreetAddress>230 E Main Street</commons:FullStreetAddress>
			<commons:UnitNumber>Suite 120</commons:UnitNumber>
			<commons:City>Colorado Springs</commons:City>
			<commons:StateOrProvince>CO</commons:StateOrProvince>
			<commons:PostalCode>80903</commons:PostalCode>
			<commons:Country>US</commons:Country>
		</Address>
	</Participant>
</ListingParticipants>