GET — Rent Estimator

This endpoint provides a real-time estimation of rental prices for a specified property type, number of bathrooms, and bedrooms within a given latitude and longitude range. This tool is invaluable for landlords, property managers, and potential renters looking to gauge the rental value of a property in a specific location. It empowers users with actionable insights to make informed rental decisions.

URL

Base URL

https://api.ratespot.io/v1/rent_estimator

Authentication

To get started with this endpoint, you will need a valid, active RateSpot account and an API key. Please refer back to the Authentication section for more information on how to create an account and get an API key.

Once you have an API key, you should pass it to the endpoint by including it as a query parameter called apikey in the URL every time you make a request:

URL with API key

https://api.ratespot.io/v1/rent_estimator?apikey=YOUR_API_KEY

Query Parameters

This endpoint accepts the following filters as URL query parameters:

Parameter	Type	Required	Multiple	Accepted Values
apikey	string	yes	no	Your RateSpot API key
latitude	number	yes	no	Any valid latitude starting from 10
longitude	number	yes	no	Any valid longitude less than -52
property_type	string	yes	no	SingleFamily
beds	integer	yes	no	Any valid number
baths	integer	yes	no	Any valid number

Examples

Retrieve rental estimates for a given latitude and longitude, property type, and number of bedrooms and bathrooms

The following example retrieves rental estimates for a given latitude (60) and longitude (-58), property type (SingleFamily), and number of bedrooms (3) and bathrooms (2):

Bash

curl "https://api.ratespot.io/v1/rent_estimator?apikey=YOUR_API_KEY&latitude=60&longitude=-58&property_type=SingleFamily&beds=3&baths=2"

Python

import requests # pip install requests

ENDPOINT = "https://api.ratespot.io/v1/rent_estimator"
params = {
  latitude: 60,
  longitude: -58,
  property_type: "SingleFamily",
  beds: 3,
  baths: 2
}

response = requests.get(ENDPOINT, params=params)
print(response.json())

Rent estimate

{
  "endResponse": "2024-01-12 17:07:30.501460",
  "response": {
    "comparableRentals": 0,
    "highRent": null,
    "lat": "60",
    "long": "-58",
    "lowRent": null,
    "median": null,
    "percentile_25": null,
    "percentile_75": null,
    "skippedRecords": 0
  },
  "responseTimeMs": 852.437,
  "startResponse": "2024-01-12 17:07:29.353897"
}