Rental Rates

Mashvisor API allows estimating rental rates for a specific location either for long-term rentals (traditional rent strategy), or for short-term rentals (Airbnb, VRBO, or Homeaway). These estimates are categorized by the number of bedrooms of a target property/location. The estimates are based on 12-month historical performance for the target area and calculated using sampling of similar listings either recently or currently actively rented in the area.

The Rental Rates Object

{
  "retnal_rates": {
    "studio_value": 2100,
    "one_room_value": 2500,
    "two_room_value": 3890,
    "three_room_value": 4997.5,
    "four_room_value": 7995
  },
  "sample_count": 268,
  "detailed": [
    {
      "state": "CA",
      "city": null,
      "neighborhood": "117954",
      "zipcode": null,
      "beds": "0",
      "count": 7,
      "min": 2000,
      "max": 3000,
      "avg": 2221.4285714285716,
      "median": 2100,
      "adjusted_rental_income": 2022.3
    },
    {
      "state": "CA",
      "city": null,
      "neighborhood": "117954",
      "zipcode": null,
      "beds": "1",
      "count": 31,
      "min": 995,
      "max": 4500,
      "avg": 2641.6129032258063,
      "median": 2500,
      "adjusted_rental_income": 2407.5
    },
    {
      "state": "CA",
      "city": null,
      "neighborhood": "117954",
      "zipcode": null,
      "beds": "2",
      "count": 136,
      "min": 1300,
      "max": 7500,
      "avg": 3979.8970588235293,
      "median": 3890,
      "adjusted_rental_income": 3746.07
    },
    {
      "state": "CA",
      "city": null,
      "neighborhood": "117954",
      "zipcode": null,
      "beds": "3",
      "count": 78,
      "min": 645,
      "max": 12000,
      "avg": 5288.961538461538,
      "median": 4997.5,
      "adjusted_rental_income": 4812.5925
    },
    {
      "state": "CA",
      "city": null,
      "neighborhood": "117954",
      "zipcode": null,
      "beds": "4",
      "count": 16,
      "min": 4700,
      "max": 27000,
      "avg": 11459.6875,
      "median": 7995,
      "adjusted_rental_income": 7699.1849999999995
    }
  ]
}

Mashvisor API allows estimating rental rates for a specific location either for long-term rentals (traditional) or for short-term rentals (Airbnb, VRBO, or Homeaway). Estimates are categorized by the number of bedrooms and are based on 12-month historical performance and sampling of similar listings in the area.

Property Data Dictionary

Attribute	Definition	Possible Returns
Studio Value	The expected monthly rent if a studio property is rented out	Double
One Room Value	The expected monthly rent if a one bedroom property is rented out	Double
Two Room Value	The expected monthly rent if a two bedroom property is rented out	Double
Three Room Value	The expected monthly rent if a three bedroom property is rented out	Double
Four Room Value	The expected monthly rent if a four bedroom property is rented out	Double

GET/v1.1/client/rental-rates

Get Rental Rates

Retrieves traditional or short-term (Airbnb) rental rate estimates for a neighborhood or area, with comparable attributes and sample counts by bedroom count.

Query parameters

Name
state
Type
string
Description
State of the neighborhood. Required. API returns 404 if omitted.
Name
city
Type
string
Description
A specific city.
Name
neighborhood
Type
long
Description
Neighborhood ID to target.
Name
zip_code
Type
integer
Description
Postal zip code.
Name
source
Type
string
Description
Target service for estimates: airbnb or traditional.

Request

GET

/v1.1/client/rental-rates

curl -G "https://api.mashvisor.com/v1.1/client/rental-rates" \
  -d "city=Collinsville" \
  -d "state=OK" \
  -d "neighborhood=51492" \
  -d "source=airbnb" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "retnal_rates": {
      "studio_value": null,
      "one_room_value": 1009,
      "two_room_value": 278,
      "three_room_value": 991,
      "four_room_value": 1075
    },
    "sample_count": 18,
    "detailed": [
      {
        "state": "OK",
        "city": "Collinsville",
        "neighborhood": "51492",
        "zipcode": null,
        "beds": "1",
        "count": 2,
        "min": 777,
        "max": 1240,
        "avg": 1008.5,
        "median": 1009,
        "adjusted_rental_income": 1136.0625,
        "median_night_rate": 95,
        "median_occupancy": 36
      },
      {
        "state": "OK",
        "city": "Collinsville",
        "neighborhood": "51492",
        "zipcode": null,
        "beds": "2",
        "count": 4,
        "min": 166,
        "max": 360,
        "avg": 270.5,
        "median": 278,
        "adjusted_rental_income": 196.0861111111115,
        "median_night_rate": 132,
        "median_occupancy": 7
      },
      {
        "state": "OK",
        "city": "Collinsville",
        "neighborhood": "51492",
        "zipcode": null,
        "beds": "3",
        "count": 8,
        "min": 353,
        "max": 1923,
        "avg": 1056.375,
        "median": 991,
        "adjusted_rental_income": 1035.586111111111,
        "median_night_rate": 193,
        "median_occupancy": 19
      },
      {
        "state": "OK",
        "city": "Collinsville",
        "neighborhood": "51492",
        "zipcode": null,
        "beds": "4",
        "count": 3,
        "min": 819,
        "max": 1616,
        "avg": 1170,
        "median": 1075,
        "adjusted_rental_income": 814.9638888888883,
        "median_night_rate": 312,
        "median_occupancy": 11
      },
      {
        "state": "OK",
        "city": "Collinsville",
        "neighborhood": "51492",
        "zipcode": null,
        "beds": "null",
        "count": 1,
        "min": 1073,
        "max": 1073,
        "avg": 1073,
        "median": 1073,
        "adjusted_rental_income": 1237.3499999999997,
        "median_night_rate": 79,
        "median_occupancy": 45
      }
    ]
  }
}