AI Search Features
Utilizing AI-Powered NLP for Real Estate Listing Searches
Our real estate APIs include an advanced AI-powered Natural Language Processing (NLP) feature that enables you to collect natural language prompts from your users and seamlessly convert them into search API requests. This cutting-edge functionality is rapidly becoming essential in real estate listing searches, particularly for chatbot and voice applications. How It Works The NLP feature processes natural language prompts provided by your users and generates the corresponding search API reqPopularAI Image Search Implementation Guide
Our real estate APIs enable advanced image search capabilities using AI to enhance the search experience. When searching images, the results are not limited by the search criteria but are sorted by relevance, ensuring the most relevant listings appear first. Each listing is assigned a relevance score, indicating how closely it matches the image inputs. Important Note When using image search, the results are not restricted by the image search criteria. For instance, if you search through 500Popular
Comparables
Sold Comparables & Similar (Active) Listings Selection Logic
Repliers makes it easy to get Sold Comparables and Similar (Active) Listings for any given property. This is particularly useful for creating a detailed property page, helping your users make more informed decisions with enriched information. Sold Comparables When a new listing hits the market, we check the MLS® history for similar listings. Here's what we consider when identifying comparables: Status (sold, leased, or off-market) Proximity to the new listing Same number of bedroomsFew readersHow to Find Comparable Sold or Leased Properties
When working with our API, you might need to find comparable properties that have been sold or leased, based on specific attributes of a subject property that isn't listed on the MLS®. Below, we will demonstrate how to perform this search using various parameters. Example Scenario Suppose you have a property for sale in New York, with the following attributes: Bedrooms: 3 Property Type: Apartment Size: 1000 sqft Location: Latitude 40.0, Longitude -80 To find similar sold propeFew readersFinding Comparables by Address - Implementation Guide
This guide demonstrates how to find comparable sold or leased properties for a specific address using the Repliers API. The process involves two main steps: first, searching for the subject property by address to obtain its attributes, then using those attributes to find comparable properties. Overview The implementation consists of two API calls: Address Search: Find the subject property and extract its key attributes Comparables Search: Use the extracted attributes to findFew readers
Filtering
Searching, Filtering, and Pagination Guide
Our real estate APIs provide powerful and flexible search capabilities, allowing you to find the perfect listings using a variety of query string parameters. In this article, we'll guide you through the process of searching, filtering, and paginating listings using our API. Getting Started To search for real estate listings, you will make a GET request to our listings endpoint. By appending query string parameters to the URL, you can filter the listings to match your specific criteria.PopularUsing Aggregates To Determine Distinct Values For Filters and Parameters
The Repliers real estate APIs include a powerful feature called "aggregates," which allows users to determine distinct values for certain parameters and filters. This guide will explain how to use this feature effectively. Determining Distinct Values To find out what values you can use for a specific parameter like propertyType, you can make a request to the Repliers API with the aggregates query parameter. For example: https://api.repliers.io/listings?aggregates=details.propertyTypePopularHow to Search Listings Using Keywords
Our real estate APIs offer a robust keyword search feature that allows API users to search listings using specific keywords. This feature is highly versatile and can be used to create a general search input for your users, enabling them to find listings by MLS® number, address, or by searching text in descriptions. Additionally, you can implement an auto-complete function using this feature. The "search" Parameter The search parameter enables users to find listings that contain specific kePopularSearching Listings By Address
When using our API, you might need to search for property listings by a specific address. There are a couple of ways to do this. Below are the methods you can use to search for listings at a given address, such as 101 Yonge St. Method 1: Use search and searchFields This method allows you to search listings by specifying the address directly in the query. Here’s how you can find listings at 101 Yonge St: https://api.repliers.io/listings?search=101 Yonge St&searchFields=address.streFew readersHow to Search Listings by Agent or Brokerage Using the Repliers API
At Repliers, we make it easy to filter and search for listings based on agent or brokerage. Whether you're looking to organize listings by the agent who created them or by the brokerage they belong to, you can do so using our API. Search Listings by Agent To search listings associated with a specific agent, use the agent parameter: Example: Replace 17306118 with the unique ID of the agent you want to search for. You caFew readersUnderstanding "Plus" in numBedroomsPlus, numBathroomsPlus, numKitchensPlus, and numRoomsPlus
When working with our API, you may encounter fields such as numBedroomsPlus, numBathroomsPlus, numKitchensPlus, and numRoomsPlus. These fields are used to indicate additional rooms that were not part of the original design of the home. Instead, these rooms were added during a renovation or an extension of the property. What Does "Plus" Mean? The "Plus" in these fields signifies rooms that have been added to the original layout of the home. For example: numBedroomsPlus: Additional bedrooFew readersA Guide to Accessing Sold & Leased Listings
A Guide to Accessing Sold & Leased Listings With proper authorization from your MLS®, retrieving sold and leased listing data becomes seamless through Repliers. By default, Repliers returns active listings when no specific request regarding status or lastStatus is made. Hence, to access sold listings, it is imperative to define the parameters by specifying status=U and lastStatus=Sld (or lastStatus=Lsd for leased listings). Let's break down how you can effectively utilize Repliers' API forFew readersHow to Search for Listings with Open Houses
One of the common questions we receive is how to find listings with open houses using our APIs. Repliers offers parameters that allow you to filter listings by open house dates. Here's how you can use the minOpenHouseDate and maxOpenHouseDate parameters to find the listings you need: Finding Open Houses for This Week If you want to find open houses scheduled for this week, you can set the date range by passing a minOpenHouseDate and maxOpenHouseDate. For example, assuming today is JanuaFew readersHow to Search for Freehold Listings
One of the most frequently asked questions is how to search specifically for freehold listings. A freehold property typically refers to a property where the owner has full ownership and control over the land and building. Unlike condominiums, freehold properties do not have a maintenance or association fee. Searching for Freehold Listings To search for freehold listings using Repliers' API, you can filter out properties with any maintenance or association fees by using the maxMaintenancFew readers
Locations, Map & Geospatial
Filtering Listings Geo-Spatially Using the "map" Parameter
Our real estate API allows users to filter listings geo-spatially by using the "map" parameter. Users can pass in single polygon or multipolygon shapes to isolate listings within specified map boundaries. This feature is commonly used to display listings within a map's boundaries or to allow users to draw shapes on a map to filter listings. Single Polygon Request To filter listings within a single polygon, use the following request format: Request:PopularMap Clustering Implementation Guide
Our real estate APIs feature a map clustering capability that optimizes the display of listings on a map. This feature significantly improves performance by clustering listings server-side, thereby reducing the need to handle large datasets on the front-end. Requesting Clusters To request clusters of listings, set the cluster parameter to true in your API request: GET&32;https://api.repliers.io/listings?cluster=true Example Response Containing ClustersPopularHandling Detailed GeoJSON Polygons in Repliers API Requests
When working with our API, you may encounter situations where you need to pass a detailed GeoJSON polygon. If the polygon is too detailed and is passed in the request URL, a 414 (URL Too Long) error can occur. This guide will help you avoid this error by showing you how to include the polygon in the body of a POST request. Why the Error Occurs The 414 error happens when the URL exceeds the maximum length allowed by the server. This is common with detailed GeoJSON polygons, which can havFew readersLocations API Implementation Guide
Overview The Locations API provides two endpoints for working with geographical data in your real estate application: GET /locations - Advanced filtering and querying of location data GET /locations/autocomplete - Relevance-based search for typeahead/dropdown interfaces These endpoints use location terminology that directly matches your MLS data, eliminating the common mismatch issues that occur when using third-party services like Google Maps or Mapbox for location search. |Few readersUsing Mapping Libraries with Our Real Estate Data APIs
Overview Our platform provides comprehensive real estate data through our APIs, but we are a headless service. This means we supply the data—not the front-end visualization tools. When you see our demos featuring maps with Google Maps, Mapbox, or Leaflet, these are examples of how our data can be integrated with third-party mapping libraries. What's Included in Our Service Our APIs provide: Real estate property data with geocoded coordinates Features designed for map-based applFew readers
How to Find Listings Using Radius Search
Our API provides a powerful radius search feature that allows you to find listings within a specific distance from any location. This is particularly useful for location-based applications, real estate searches, or any service that needs to find nearby listings. What You'll Need To perform a radius search, you need three key pieces of information: Latitude - The north-south coordinate of your search center Longitude - The east-west coordinate of your search center RadiusFew readersUnderstanding and Using boardIds in The Repliers API
What are BoardIds? BoardIds are unique identifiers that Repliers uses to distinguish between different datasets (boards) that you may have access to. As a subscriber, you might be licensed in multiple MLS® regions or have access to different types of datasets from the same MLS® (such as VOW® and IDX® separately). Each of these datasets is assigned a unique boardId. Why are BoardIds Important? BoardIds are crucial because: The same MLS® number can exist in different datasets To aFew readersFiltering Listings by Status
When working with listings in the system, you have three different ways to filter by status. Each method serves different purposes and provides varying levels of detail. Overview of Status Filtering Options 1. status (Binary Filter) The status parameter provides a simple binary filter for listings: A = Available (On-Market) U = Unavailable (Off-Market) This is the most basic status filter, giving you a high-level view of listing availability. When to use: When yoFew readersPassing Multiple Values for the Same Parameter
When working with our API, you may need to filter results using multiple values for the same parameter. For instance, you might want to search for both single-family residences and townhouses in a single API call. Two Supported Methods Our API supports two different approaches for passing multiple values to the same parameter: Method 1: Repeated Parameters You can repeat the same parameter name with different values:Few readersBuilding an Autocomplete Search Feature with Repliers APIs
A comprehensive guide to implementing a unified search experience that combines MLS® listings with cities and neighborhoods using the Repliers API. Overview This recipe demonstrates how to build a powerful autocomplete search feature that allows users to search for both MLS® listings and locations simultaneously. The results are presented categorically, giving users a seamless search experience whether they're looking for a specific property address, MLS® number, or exploring different areaFew readersUnderstanding Operators In The Repliers API
Overview When querying the Repliers API with multiple values for the same parameter, it's important to understand how these values are combined logically. This guide explains how the operator parameter affects your search results, and when you should use it. Default Behavior: AND Between Parameters, OR Within Parameters By default, our API uses the following logic: Values for the same parameter are combined with OR logic Different parameters are combined with ANDFew readersUsing minListDate and maxListDate Parameters For Days On Market Filtering
The /listings API endpoint provides filtering capabilities through the minListDate and maxListDate parameters. These parameters allow you to precisely target properties based on their time on market, enabling you to offer days on market filters. What are minListDate and maxListDate? These two parameters work together to filter properties based on when they were listed on the market: minListDate: Sets the earliest listing date to include in results maxListDate: Sets theFew readersHow to Filter Listings by MLS® Number
The mlsNumber parameter allows you to filter a specific listing by its exact MLS® number. This is useful when you need to fetch data for one or more listings you already know the MLS® number for. Basic Usage To filter listings by MLS® number, add the mlsNumber parameter to your API request: Important: The MLS® number must be an exact match. Partial matches or similar numbers will not return results. Multiple MLS® NumbersFew readersBundled Searches Developer Guide
Overview The bundled searches feature allows you to combine multiple search criteria into a single API call, enabling complex property searches that would otherwise require multiple separate requests. This is particularly useful when you need different filter combinations that can't be achieved with standard query parameters alone. When to Use Bundled Searches Bundled searches are ideal when you need to search for properties with different criteria that can't be combined in a single staFew readersHow to Filter Out Properties from Other Countries Using Geographic Boundaries
Why Am I Seeing Properties from Other Countries? If you're noticing properties from other countries appearing in your API responses, this is actually normal behavior. MLS® Systems don't have built-in geographic restrictions, which means agents can and often do list properties "out of area." This practice is quite common in the real estate industry. The Solution: Geographic Boundary Filtering The most effective way to keep your search results local and confined to your desired geographyFew readersLot Size Filtering with API Parameters
Overview Our API supports lot size filtering through the minLotSizeSqft and maxLotSizeSqft parameters. These parameters allow you to find listings that meet specific lot size requirements by specifying minimum and maximum lot sizes in square feet. Key Points API Parameters: Use minLotSizeSqft and maxLotSizeSqft for lot size filtering Unit Requirement: Both parameters accept values in square feet only Conversion Required: Regardless of how users provide lot sizeFew readersUsing the "not" Prefix in API Filters
Overview The Repliers API now supports a powerful "not" prefix that allows you to exclude specific values from your search results. This feature works across all API fields and provides flexible filtering options to help you find exactly what you're looking for. Basic Usage To exclude a specific value from your results, simply add the not: prefix before the value you want to exclude. Syntax Example To find all listings except those wFew readersQ&A Related to Filtering
Can we submit filters in the request body instead of the request URL? Only certain filters are permitted in the request body, such as the "map" filter. This is because values for the "map" filter are often large and exceed the URL length limit if used in the URL. All other filters should be used in the request URL as query parameters. Example of body filter usage:Few readersSearching for Locations Not Found in Our Database
Issue You may find that certain well-known areas or neighborhoods or other local community names don't produce results when you use them in listing searches. Why This Happens The locations available through our endpoints reflect the address normalization standards used by the MLS*®* system. Since the MLS*®* doesn't consistently use certain neighborhood names, community identifiers, or local area designations in their standardized addressing, these locations won't produce resultsFew readers