Filter Parameters and Options Reference

Agent ID Filter

Syntax: agent_id:12345 or agent_id:12345,67890 for multiple agents

How it works:

• Active listings: Matches listing agent OR co-listing agent
• Sold listings: Matches listing agent OR selling agent (buyer's agent)
• Can also use team IDs if supported by your MLS

Examples

// Show all active listings for agent 12345
data-filter="agent_id:12345"

// Show sold listings for agents 12345 or 67890
data-filter="agent_id:12345,67890+listing_status:sold"

Buyer's Agent Filter (Sold Only)

Syntax: seller_id:12345

Shows sold listings where the specified agent was the buyer's agent. Only relevant with listing_status:sold

Office ID Filter

Syntax: office_id:ABC01 or office_id:ABC01,XYZ02

How it works:

• Active listings: Matches listing office OR co-listing office
• Sold listings: Matches listing office OR selling office

Advanced Example: Office Listings with Agent Priority

// Show office listings with agent 12345's listings first
data-filter="office_id:ABC01+order:FIELD(agent_id,'12345') desc,create_dt desc"

Recently Listed Properties

Syntax: create_dt:{days}

Shows properties added to the database within the specified number of days.

// Properties listed in last 7 days
data-filter="create_dt:7"

// Properties listed in last 30 days, sorted by newest first
data-filter="create_dt:30+order:create_dt desc"

Aged/Distressed Listings

Syntax: create_dt_min:{days}

Shows properties that have been listed for MORE than the specified number of days.

// Properties listed for more than 90 days
data-filter="create_dt_min:90"

Price Reductions

Syntax: price_drop:{days} (1-30 days)

// Properties with price drop in last 7 days
data-filter="price_drop:7"

Sold Properties

Recently Sold: sold_dt:{days}

// Properties sold in last 30 days
data-filter="sold_dt:30+listing_status:sold"

// Properties sold in last 6 months, sorted by sale date
data-filter="sold_dt:180+listing_status:sold+order:sold_dt desc"

Sold Date Range: sold_range_min:yyyy-mm-dd and sold_range_max:yyyy-mm-dd

// Properties sold in 2024
data-filter="sold_range_min:2024-01-01+sold_range_max:2024-12-31"

// Properties sold since January 1, 2024
data-filter="sold_range_min:2024-01-01"

Open Houses

Syntax: openhouse_dt:{value}

Available values:

• tomorrow - Open houses tomorrow
• weekend - This weekend
• next-weekend - Next weekend
• 7, 10, 14, 30 - Next X days

// Open houses this weekend
data-filter="openhouse_dt:weekend+order:openhouse_dt desc"

Limiting Results

Syntax: limit:{number}

Controls how many properties to display. Ignored on Results and Interactive Map widgets.

// Show only 5 properties
data-filter="city:denver+limit:5"

Sorting Results

Syntax: order:{field} {direction}

Direction is optional: use desc for descending (high to low) or leave blank for ascending (low to high).

Common Sort Options

• order:price desc - Highest price first
• order:price - Lowest price first
• order:create_dt desc - Newest listings first
• order:sold_dt desc - Most recently sold first (sold listings only)
• order:openhouse_dt desc - Soonest open houses first
• order:city - Alphabetical by city
• order:rand() - Random order

Nested Sorting

Sort by multiple criteria using commas:

// Sort by city, then by price (high to low)
order:city,price desc

Agent Priority Sorting

Show specific agent's listings first using FIELD:

// Single agent priority
order:FIELD(agent_id,'12345') desc

// Multiple agents priority
order:FIELD(agent_id,'12345','67890') desc,create_dt desc

Display Filters

Only show properties with photos: prop_img:true

// Featured listings with photos only
data-filter="city:denver+prop_img:true+limit:6"

Hide widget when no listings: nolistingshide:{html-class}

Hides the specified HTML container if there are no results. Useful for "My Listings" sections.

Suffix Operators

Available Suffixes

• _min - Minimum value
• _max - Maximum value
• _not - Exclude values

Examples

// Minimum 3200 sqft
sqft_min:3200

// Maximum 2 car garage
garages_max:2

// Exclude short sales
financing_not:short

// Exclude multiple values
financing_not:short,foreclosure

Combining Include and Exclude

// Include HUD homes but exclude short sales
financing:hud+financing_not:short

Listing Status

Syntax: listing_status:{status}

Available status options (varies by MLS):

• active - Active listings (default, includes coming-soon if available)
• under-contract - Under contract/pending
• sold - Sold properties
• active-rental - Rental properties (if available)
• coming-soon - Coming soon only

Sold Properties Special Notes

• Sold price field: sold_price
• Filter by sold price: sold_price_min:300000+sold_price_max:500000
• Sort by sold price: order:sold_price desc

// Sold properties in Denver, $300k-$500k, newest sales first
data-filter="city:denver+listing_status:sold+sold_price_min:300000+sold_price_max:500000+order:sold_dt desc"