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.
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.
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:
Email
Text Message
Matches and Notifications
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.
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
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
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.
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.
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.
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.
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.
Personalization: Tailored searches improve user satisfaction by providing relevant property updates.
User Retention: Regular alerts keep clients engaged and returning to your platform.
For detailed API documentation and examples, please refer to our API Reference for Saved Searches.
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.
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
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
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.
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.
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.
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: 23/02/2025
Thank you!