How To Use The Link Structure for Loading MLS Content
With dsIDXpress you can load property search results and individual property details based on a relatively simple URL structure. The URL structure always starts with /idx/, so if your domain name is yourblog.com, the dsIDXpress “virtual” pages would always start with http://www.yourblog.com/idx/. You can display search results from the MLS based on a number of different link structures.
Note: All search results are currently limited to 500 properties maximum; please read our blog post on this issue for our reasonings. If you’re simply looking to display listings from a particular city, community, tract, or zip without any other filters, you can link to the search results according to the following:
yourblog.com/idx/city/los-angeles – Shows 500 newest listings in Los Angeles, ordered by newest first.
yourblog.com/idx/area/the-village – Shows all of the listings (since total is less than 250) in “The Village” community/tract, ordered by newest first.
yourblog.com/idx/zip-92651 – Shows all of the listings (since total is less than 250) in the 92651 zip code, ordered by newest first.
yourblog.com/idx/860 – Shows all of the listings (since total is less than 250) that match the criteria in the Link ID 860 that was created in your Diverse Solutions Control Panel. Note: This is currently available for dsSearchAgent Pro users.
There’s a ton of other ways to use the link structure to load MLS content. Below is a list of ALL of the different search URL parameters that can be used with dsIDXpress links. Each of these parameters need to be prefixed with:
Neither the parameter nor the parameter names are case sensitive. To use these parameters, you will need to follow this format:
…starting with a question mark and separating each parameter with an ampersand.
List of Parameters:
- idx-q-MlsNumbers : † List of MLS numbers.
- idx-q-PropertyTypes : † List of property type IDs (numbers). You can get these numbers from the URLs when you do a search using the search panel. We plan to make the process of getting these numbers more user-friendly in the future.
- idx-q-PropertyFeatures : † List of property feature IDs (numbers). We do not yet have a way to look these up however, so you will need to contact customer service if you’d like a list of the features.
- idx-q-DaysOnMarketMin : Number indicating minimum days on market. ex: 90
- idx-q-DaysOnMarketMax : Number indicating maximum days on market. ex: 7
- idx-q-PriceMin : Number indicating minimum price.
- idx-q-PriceMax : Number indicating maximum price.
- idx-q-BedsMin : Number indicating minimum beds.
- idx-q-BedsMax : Number indicating maximum beds.
- idx-q-BathsMin : Number indicating minimum baths.
- idx-q-BathsMax : Number indicating maximum baths.
- idx-q-ImprovedSqFtMin : Number indicating minimum home size in sq ft. Be aware that some MLSs do not provide home size in their data.
- idx-q-ImprovedSqFtMax : Number indicating maximum home size in sq ft. Be aware that some MLSs do not provide home size in their data.
- idx-q-LotSqFtMin : Number indicating minimum lot size in sq ft. Be aware that some MLSs either do not provide lot size in their data or give us an unreliable way to calculate it.
- idx-q-LotSqFtMax : Number indicating maximum lot size in sq ft. Be aware that some MLSs either do not provide lot size in their data or give us an unreliable way to calculate it.idx-q-YearBuiltMin : Number indicating minimum year built.
- idx-q-YearBuiltMax : Number indicating maximum year built.
- idx-q-PriceDropDays : Number indicating how many days price drop percent is calculated over. See below.
- idx-q-PriceDropPercent : Number indicating the price drop percentage over the number of days. See above. ex: 30 days with a value of 10 percent will show properties that have dropped their price at least 10% in 30 days.
- idx-q-WalkScoreMin : Number indicating minimum Walk Score. Be aware that properties without addresses or properties that have un-geocodable addresses will not have Walk Scores. ex: 90
- idx-q-DistressTypes : Number indicating whether to show only pre-foreclosures (1), only foreclosed listings / REOs (2), only pre-foreclosures or REOs (3), or neither pre-foreclosures nor REOs (0). ex: 2 shows only foreclosed listings.
- idx-q-Schools : † List of schools / school types. See Schools sub-section below.
- idx-q-ListingAgentID : † List of agent IDs in the MLS.
- idx-q-ListingOfficeID : † List of agent IDs in the MLS.
- idx-q-AddressMasks : † List of partial addresses to match. A % character indicates a wildcard. See the Encoding Text sub-section below. ex: 234%20Cliff%20Dr%25 will match listings that have an address that starts with “234 Cliff Dr”.
- idx-q-Cities : † List of cities. See Encoding Text and Redirects sub-sections below. ex: idx-q-Cities<0>=Irvine&idx-q-Cities<1>=Laguna%20Beach
- idx-q-States : † List of states. ex: CA
- idx-q-ZipCodes : † List of zip codes. See Encoding Text and Redirects sub-section below. ex: 92612
- idx-q-Communities : † List of communities. See Encoding Text, Areas, and Redirects sub-sections below.
- idx-q-TractIdentifiers : † List of tracts. See Encoding Text, Areas, and Redirects sub-sections below.
- idx-q-Areas : † List of tracts or communities. See Encoding Text, Areas, and Redirects sub-sections below.
- idx-q-Counties : † List of counties. See Encoding Text sub-sections below. ex: idx-q-Counties<0>=Orange
- idx-q-LatitudeMin : Number indicating minimum latitude. ex: 33.567573
- idx-q-LatitudeMax : Number indicating maximum latitude. Latitude / longitude will correlate to a rectangular map area. ex: 117.714214
- idx-q-LongitudeMin : Number indicating minimum longitude. ex: 33.495884
- idx-q-LongitudeMax : Number indicating maximum longitude. Latitude / longitude will correlate to a rectangular map area. ex: -117.824249
Additionally, these two parameters can be used for sorting the results:
- idx-d-SortOrders-Column : † Specifies which field to use for sorting (either: Price, DateAdded, OverallPriceDropPercent, WalkScore, ImprovedSqFt, or LotSqFt)
- idx-d-SortOrders-Direction : † Specifies sort direction (either: ASC or DESC)