Question 1

Searching, Filtering, and Pagination Guide

Accepted Answer

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.

Example Search Request

Let's say you want to find homes in New York that have three bedrooms and are priced under one million dollars. You would make a request like this:

GET https://api.repliers.io/listings?maxPrice=1000000&city=New York&minBedrooms=3

This request will return an array of listings that match the search criteria you specified.

Supported Filters

Our API supports a wide range of filters to help you narrow down your search. Here are some of the most commonly used filters:

maxPrice: The maximum price of the listings.
minPrice: The minimum price of the listings.
city: The city where the listings are located.
minBedrooms: The minimum number of bedrooms.
maxBedrooms: The maximum number of bedrooms.
minBaths: The minimum number of bathrooms.
maxBaths: The maximum number of bathrooms.
propertyType: The type of property (e.g., house, condo, townhouse).
status: The status of the listing (e.g., active, pending, sold).
minSqft: The minimum

Question 2

Accessing MLS® Data Across Canada: Understanding REALTOR.ca DDF® and Regional Restrictions

Accepted Answer

In Canada, access to Multiple Listing Service (MLS®) data is compartmentalized by region, similar to the system in the United States. This means that if you're a licensed real estate agent in Toronto, you cannot directly access MLS® data in Vancouver, and vice versa. Each region has its own MLS® System with separate access requirements.

However, there is a solution that allows agents to access data across the country: the REALTOR.ca DDF®. This feed provides national access to active listings, but there are important limitations to consider.

What is REALTOR.ca DDF®?

The REALTOR.ca DDF® is a national data feed provided by the Canadian Real Estate Association (CREA). It allows real estate agents to access listings from across the country, regardless of their regional licensing. This feed is particularly useful for agents who operate in multiple regions or who have clients interested in properties outside their licensed area.

Limitations of REALTOR.ca DDF®

While the REALTOR.ca DDF® offers broad access, it comes with several limitations:

Active Listings Only

The REALTOR.ca DDF® contains only active listings. If your product or service requires historical data, such as market statistics or comparables, the REALTOR.ca DDF® will not be suitable. For these features, you will need access to historical data from regional MLS® Systems.

Participation of Brokerages

Not all brokerages participate in the REALTOR.ca DDF®. This means that listings from non-pa

Question 3

Accessing Real Estate Listing Data in Quebec

Accepted Answer

A common question we receive is whether we provide a feed for real estate listings in the province of Quebec. The short answer is "sort of." Here's why:

Data Management in Quebec

In Quebec, real estate listings are managed by a company called Centris. Centris holds all the real estate data for the province. However, unlike most regions in North America, obtaining a comprehensive feed of all listings in Quebec comes with a unique challenge.

Important Note: Currently, Repliers does not have any data share framework in place that allows subscribers direct access to listings in Quebec. The process described below would need to be undertaken independently by subscribers who wish to access Quebec listing data.

Brokerage Authorization

Centris will only grant access to data from brokerages that have explicitly agreed to provide their listings. This means that to access all listings in Quebec, you must obtain authorization from every individual brokerage through Centris.

Comparison with Other Regions

This approach differs significantly from most other regions in North America. Typically, a single (IDX or VOW) feed provides access to all listings within a region, and this feed is available for all realtors to use.

Historical Data Limitation

Another important consideration is that Centris does not provide historical listing data. They only offer access to active listing data. This means you will not have access to past listings, which can be a

Question 4

Listing Images Implementation Guide

Accepted Answer

Repliers offers a robust Listing Images Content Delivery Network (CDN) that allows developers to embed and dynamically resize/format property photos seamlessly. This feature brings significant cost and time savings, enhances performance through shared caching, and mitigates the need for manual image monitoring.

CDN URL Structure

listing For listings with available images, an "images" array will be present. Here's an example listings array:

"images": [
                "area/IMG-N8418368_1.jpg",
                "area/IMG-N8418368_2.jpg",
                "area/IMG-N8418368_3.jpg",
                "area/IMG-N8418368_4.jpg",
                "area/IMG-N8418368_5.jpg",
                "area/IMG-N8418368_6.jpg",
                "area/IMG-N8418368_7.jpg",
                "area/IMG-N8418368_8.jpg",
                "area/IMG-N8418368_9.jpg",
                "area/IMG-N8418368_10.jpg",
                "area/IMG-N8418368_11.jpg",
                "area/IMG-N8418368_12.jpg",
                "area/IMG-N8418368_13.jpg",
                "area/IMG-N8418368_14.jpg",
                "area/IMG-N8418368_15.jpg"
          ],

The image URLs should be prefixed with https://cdn.repliers.io/. For example:

https://cdn.repliers.io/area/IMG-N8418368_15.jpg

Default Image Sizes

Mobile Devices: Image width defaults to a maximum of 800px.
Larger Screens: Image width defaults to a maximum of 1600px.

Default Image Formats

WEBP: Images will be returned in WEBP for

Question 5

MLS® Data Access Requirements: Who Can Use MLS® APIs

Accepted Answer

Overview

This article explains who is eligible to use MLS® APIs and clarifies common misunderstandings about access requirements.

Who Can Use MLS® APIs?

MLS® APIs are available to two specific groups:

Real Estate Professionals

Real estate agents and brokers
Real estate teams
Brokerages

Developers, Agencies or Vendors Helping Real Estate Professionals

Developers, agencies and vendors who have been hired by real estate professionals to build their technology.

Important Clarifications

For Real Estate Professionals

✅ Allowed: Using APIs for your own real estate business activities

❌ Not Allowed: Letting friends or third parties use your MLS® access for their services

❌ Not Allowed: Creating a separate business that uses your MLS® access, even if you're a licensed real estate professional

Developers, Agencies and Vendors

✅ Allowed: Building products or services whose sole use is for real estate professionals

❌ Not Allowed: Creating your own product or service that uses MLS® data

Important: MLS® Approval Requirement

If you are a developer, agency or vendor you must obtain specific approval from your MLS® to work with Repliers, often times this will require you to obtain your own data license from the MLS®. Generic MLS® data licenses do not automatically grant permission to use our services.

Common Misconceptions Clarified

"My friend is a real estate

Question 6

Using Aggregates To Determine Distinct Values For Filters and Parameters

Accepted Answer

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.propertyType

In the response, you will receive an aggregates object containing the possible values and their respective counts. Here is an example of what the response might look like:

```json { "aggregates": { "details": { "propertyType": { "Apartment/Condo": 8844, "House/Single Family": 8661, "Townhouse": 3114, "Vacant Land": 1021, "Business": 1001, "House With Acreage": 865, "Industrial": 804, "Office": 738, "Retail": 680, "1/2 Duplex": 594, "Land Commercial": 328, "Multi-Family Commercial": 136, "Manufactured": 134, "Business With Property": 83, "Other": 83, "Agri-Business": 70, "Duplex": 60, "Manufactured With Land": 41, "Row House (Non-Strata)": 38,

Frequently Read Articles

Browse All Categories