Saved Search Implementation Guide
Repliers' Saved Search feature is a powerful tool that enhances user engagement and retention by allowing clients to receive timely notifications on property listings that match their specific criteria. Clients receive notifications via email and/or text message when properties that match their search criteria are listed, sold, or experience price changes. These timely alerts keep clients in the loop and contribute to user retention, ensuring they are always informed about relevant listings.
This guide will walk you through the various functionalities of the Saved Search feature, from creation to customization.
Key Features
- Create a Saved Search: Set up saved searches tailored to client preferences.
- Filter Saved Searches: Narrow down saved searches based on specific criteria.
- Update a Saved Search: Modify existing saved searches to reflect new preferences.
- Delete a Saved Search: Remove saved searches that are no longer needed.
- Get Details of a Specific Saved Search: Retrieve comprehensive information about a particular saved search.
Setting Up Alerts
Saved Searches can be configured to send alerts to clients for the following scenarios:
- New Listings: Notify clients when new properties match their search criteria.
- Price Changes: Alert clients about any changes in the prices of listings they are interested in.
- Sold Listings: Inform clients when a property they were tracking is sold.
Alerts can be sent based on the client's preferred frequency:
- Instantly
- Daily
- Weekly
- Monthly
Alerts can be delivered via:
- Text Message
- Matches and Notifications
2-Way Communication
Saved search email and text alerts are 2-way, meaning the client can reply directly to the message and their reply will be sent to the agent. Regardless of if they reply to a text or an email, the agent will receive an email. The agent can also reply to the email and their reply will be sent to the client via email and/or text depending on their communication preferences.
Handling Listing Clicks in Email Alerts
When clients click on listings in email alerts, they are redirected to your website through a customizable URL structure. The system passes relevant listing information through URL parameters.
Example redirect URL: https://{your_domain}/{your_path}?mlsNumber=W123456789&boardId=123&token=643xxxd1-0ba1-4774-840d-1385exxxb270&utm_medium=email&clientId=12345&email=client@example.com
The URL consists of:
- Your custom domain and path (configurable)
- Essential listing data as URL parameters (not configurable)
- MLS number
- Board ID
- Security token - More info
- UTM tracking parameters
- Client identifier
- Email - can be used for email tracking, more info.
Your website can parse these parameters to direct users to the appropriate listing page or view. You have full control over the domain and path structure while maintaining access to all necessary listing context through the URL parameters.
Matches and Notifications
When a listing meets the client's criteria, a match is created. Through our APIs, you can:
- Filter Matches: Find matches for specific clients or criteria.
- Update Matches: Mark matches as viewed or liked by clients.
- Get Match Details: Retrieve detailed information about specific matches.
Association with Agents and Clients
A Saved Search must be associated with an agent and a client:
- Agent: The sender of the alerts.
- Client: The receiver of the alerts.
To create Saved Searches, you must first create agents and clients using our agents and clients API resources.
Saved Search Limit Per Client
By default, each client can have up to 5 saved searches. If you need this limit increased for your implementation, please reach out to our support team for assistance.
Customizing Email Templates
The email templates used for Saved Searches can be fully customized to match your branding and preferences. If no customization is provided, the default Repliers theming will be used.
Extended Support with Webhooks
We have extended support for Saved Searches through webhooks, enabling real-time event-driven integrations. The following events are supported:
- search.created
- search.updated
- search.deleted
- search.match.created
- search.match.updated
These events can be used to trigger workflow automation with other systems. For example, you can push a notification to a mobile app when a new match is created.
Input Validation for Saved Searches
When creating or updating saved searches, it's important to ensure that the filter values you provide are valid for the MLS systems you have access to. Invalid input values will result in a 400 Bad Request
error response.
Common Validation Errors
The most common validation error occurs when providing location-based filters (such as city names) that don't exist in one or more of the MLS systems you have access to. For example:
- Providing a city name that exists in one MLS but not another
- Using outdated or incorrect spelling for location names
- Specifying property types that aren't recognized by certain MLS systems
Determining Valid Filter Values Using Aggregates
To avoid validation errors and determine which values are acceptable for your filters, use the aggregates parameter in the Repliers API. This feature allows you to discover all distinct values available for specific filter parameters across your accessible MLS systems.
For detailed information on using the aggregates parameter, refer to our Using Aggregates to Determine Distinct Values for Filters guide.
Benefits of Saved Searches
- Personalization: Tailored searches improve user satisfaction by providing relevant property updates.
- User Retention: Regular alerts keep clients engaged and returning to your platform.
API Reference
For detailed API documentation and examples, please refer to our [API Reference for Saved Searches.
](https://docs.repliers.io/reference/create-a-saved-search)
The Saved Search feature in Repliers Real Estate API is an invaluable tool, ensuring clients stay informed and engaged with the latest property listings. Utilize this feature to enhance your service offerings and improve client satisfaction.
For further assistance, please contact our support team.
Updated on: 11/06/2025
Thank you!