Getting Started

    API Endpoint: https://doorinsight.com/api/
                

The Door Insight API provides access to rental rates and comparable listings for neighbourhoods and cities across Canada.

To use this API, you need an API key. Please contact us at info@doorinsight.com to get your own API key.

Rent By Address


# Here is a curl example
curl \
-X POST https://doorinsight.com/api/search-address \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{"city": "toronto", "province": "ON", "street": "York St", "postalCode": "M5J", "beds": "2", "baths": "1", "homeType":"condo", "radius": 5}' 
                

Rent By City will return median, average, lowest, highest rent along with comparables for the area. This search looks back to 3 months of data to draw estimations.

Adjusting parameters such as home type, beds, baths and radius will further specify the results.

To retrieve a rent search for an address, you will need to make a POST request to the following url:
https://doorinsight.com/api/search-address



Result example :

{
average_price: 2881,
highest_price: 4200,
lowest_price: 2250,
median_price: 2700,
price_per_sqft: 1.86,
result_count: 74,
text_address: "York St, Toronto, ON, M5J, CAN"
  }
  results: [
    {
        bathrooms: 2
        bedrooms: 1
        city: "Toronto"
        community: "Waterfront Toronto"
        date retrieved: "2022-09-18"
        dist: {calculated: 892.5595731988153, location: {type: "Point", coordinates: [-79.7634909, 43.7359228]}}
        full address: "14 York St"
        location: {lat: 43.7359228, lng: -79.7634909, x: -79.7634909, y: 43.7359228}
        postal code: "M5J 0B1"
        price: 2600
        province: "ON"
        sqft: 700
        type: "condo"
    },
    {
        bathrooms: 2
        bedrooms: 1
        city: "Toronto"
        community: "Waterfront Toronto"
        date retrieved: "2022-09-18"
        dist: {calculated: 892.5595731988153, location: {type: "Point", coordinates: [-79.7634909, 43.7359228]}}
        full address: "10 York St"
        location: {lat: 43.7359228, lng: -79.7634909, x: -79.7634909, y: 43.7359228}
        postal code: "M5J 2L9"
        price: 2650
        province: "ON"
        sqft: 700
        type: "condo"
    },
    
    ...
  ]
}
                

QUERY PARAMETERS [POST]

Add the following required parameters to your post request.

Field Type Required Description
city String Required Name of city "Toronto" or "toronto"
province String Required 2 letter code
Possible Options: ['AB', 'BC', 'MB', 'NB', 'NL', 'NT', 'NS', 'NU', 'ON', 'PE', 'QC', 'SK', 'YT']
street String Required Street name with or without specific identifier: "10 York St" or "York St"
postalCode String Optional Complete or partial postal code: "M9V 3N4" or "M9V"
beds String Required Possible Options: ["0", "1", "2", "3", "4", "5"]
Passing "0" refers to Studio units
baths String Required Possible Options: ["0", "1", "1.5", "2", "2.5", "3", "3.5", "4", "5"]
Passing "0" is equivalent to "Any" and any type of bath will be included in the results and calculations.
homeType String Required Possible Options: ["any", "house", "basement", "apartment", "condo", "townhouse"] Passing "any" will use all home types in results and calculations.
radius Integer Required Radius in KM - Any integer between 1 and 10 is accepted.

Rent By City


# Here is a curl example
curl \
-X POST https://doorinsight.com/api/search-city \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{"city": "toronto", "province": "ON", "beds": "3", "baths": "2", "homeType":"house"}' 
                

Rent by city will return median, average, lowest, highest rent on the city level. This search looks back to 1 months of data to draw estimations. If a sample size greater than 15 is not found, 3 months time span will be used to estimate.

Adjusting parameters such as home type, beds, baths will further specify the results but may also limit sample size, especially in smaller cities.

To retrieve a rent search for city, you will need to make a POST request to the following url:
https://doorinsight.com/api/search-city



Result example :

{
"query": {"city":"Toronto","homeType":"house","beds":"3","baths":"2"},
"sample_size":29,
"median_price":4199,
"average_price":4445,
"lowest_price":3250,
"highest_price":6995,
"price_per_sqft":3.07
}
                

QUERY PARAMETERS [POST]

Add the following required parameters to your post request.

Field Type Required Description
city String Required Name of city "Toronto" or "toronto"
province String Required 2 letter code
Possible Options: ['AB', 'BC', 'MB', 'NB', 'NL', 'NT', 'NS', 'NU', 'ON', 'PE', 'QC', 'SK', 'YT']
beds String Required Possible Options: ["0", "1", "2", "3", "4", "5"]
Passing "0" refers to Studio units
baths String Required Possible Options: ["0", "1", "1.5", "2", "2.5", "3", "3.5", "4", "5"]
Passing "0" is equivalent to "Any" and any type of bath will be included in the results and calculations.
homeType String Required Possible Options: ["any", "house", "basement", "apartment", "condo", "townhouse"] Passing "any" will use all home types in results and calculations.

Errors

The API uses the following error codes:

Error Code Meaning
X100 Some parameters are missing. This error appears when you don't pass every mandatory parameters.
X101 Some parameters are invalid. Check API doc for possible input types.