« Custom Point of Interest Technology on the Horizon for Real Estate | Home | 6 Best Practices for Online Leads »
softRealty Search Connect URL API Information
By Carl Martens | June 17, 2008
I figured this might be beneficial to those of you that are using softRealty’s IDX and also wanted to post it here so I’d have a reference. The below was provided by David Carroll of SoftRealty. This is probably posted here to be more of a reference to me, but hopefully some others will benefit as well. If you have questions, just post them in the comments section. To see the Search Connect URL in action, visit www.SoldonRoswell.com
* Note: the links below will not work…I do not have a softRealty account setup for AuntBrenda.com
There are 2 approaches your developer can take with building your JavaScript logic:
Option 1: JavaScript logic could dynamically update the iFrame src path.
Option 2: JavaScript logic could build a new website Url and redirect to the new Url address with the selected search criteria.
I will leave it to your developer’s discretion on which option makes the most sense to implement. Regardless, both options will follow the same rules which are as follows:
Option 1: Base Address in iFrame src is: http://idx.softrealty.com/YourSite’sName/start/
Option 2: Base Address in browser url is: http://www.YourSite.com
Displaying Specific Property Page
1. Modify Base Address:
a. Option 1: Replace /start/ with /Details/ListingNumber=3684786;SourceName=FMLS
i. Example: http://idx.softrealty.com/auntbrenda/Details/ListingNumber=3684786;SourceName=FMLS
b. Option 2: Append the following to Base Address: /?Details/ListingNumber=3684786;SourceName=FMLS
i. Example: http://www.auntbrenda.com/?Details/ListingNumber=3684786;SourceName=FMLS
c. SourceName values can be GAMLS or FMLS.
Displaying Custom Search Results
2. Modify Base Address:
a. Option 1: Replace /start/ with /search/ and Search Criteria appended.
i. Example: http://idx.softrealty.com/auntbrenda/Search/
b. Option 2: Append /?search/ and Search Criteria to Base Address.
i. Example: http://www.auntbrenda.com/?Search/
3. Append Search Criteria to modified Base Address:
a. Apply Search Criteria using the following formats:
i. Search/CriteriaA=Value1;CriteriaB=Value2,Value3/
ii. Examples:
1. http://idx.softrealty.com/atlantahomequest/Search/Cities=Atlanta,Suwanee,Duluth;ListPriceMin=300000/
2. http://www.auntbrenda.com/?Search/Cities=Atlanta,Suwanee,Duluth;ListPriceMin=300000/
iii. Notes:
1. Search Criteria can be applied in any order.
2. Multiple [Criteria=Value] Pairs are separated by semi-colons (;).
a. Examples: Cities;HasBasement;ListPriceMin
3. Some Criteria known as Selected Location Filters can support multiple Values.
a. Examples: Cities=Duluth,Atlanta,Suwanee;PostalCodes=30518,30341,30096
4. General Search Options support specifying a min and max range.
a. Min/Max Examples:
i. Min Only: Search/ListPriceMin=300000
ii. Max Only: Search/ListPriceMax=800000
iii. Both: Search/ListPriceMin=300000;ListPriceMax=800000
5. Valid Values for the Search Criteria can be found in the drop down boxes on the Search Page
6. List of Valid Search Criteria are listed below:
Valid Search Criteria:
Selected Location Filters (Supports multiple values):
Addresses (string)
Cities (string)
PostalCodes (string)
Counties (string)
Subdivisions (string)
ElementarySchools (string)
MiddleSchools (string)
HighSchools (string)
ListingNumbers (string)
General Search Options:
ListPriceMin (int)
ListPriceMax (int)
BedroomsMin (int)
BedroomsMax (int)
BathsFullMin (int)
BathsHalfMin (int)
BathsHalfMax (int)
YearBuiltMin (int)
YearBuiltMax (int)
LotSizeMin (int)
LotSizeMax (int)
Property Features:
GarageSize (0,1,2,3,Carport)
HasBasement (true/false)
HasGolf (true/false)
HasSwimTennis (true/false)
HasPool (true/false)
HasLake (true/false)
HasFence (true/false)
HasMasterOnMain (true/false)
ShowListingsWithPhotosOnly (true/false)
NOTE: To test various Search Criteria, your developer can use the link called “Link to this Page” and click the “Go” Button to see study how the query was built. This link is found on both the Search and Details pages.
Topics: IDX Service |
