Trends

Endpoints for top cities by occupancy, city-level summaries, listing prices by zip code, and investment performance heatmaps by geography.

GET/v1.1/client/trends/cities

Get Top Airbnb Cities

This endpoint retrieves the cities with the highest occupancy rates including total Airbnb active listings in a specific state.

Query parameters

  • Name
    state
    Type
    string
    Description

    State name, e.g. NV. Required.

  • Name
    items
    Type
    integer
    Description

    Number of items to return. Default: 5. Valid values: 10, etc.

  • Name
    page
    Type
    integer
    Description

    Page number. Default: 1.

Request

GET
/v1.1/client/trends/cities
curl -G "https://api.mashvisor.com/v1.1/client/trends/cities" \
  -d "state=GA" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "input": {
      "page": 1,
      "items": 5,
      "state": "GA"
    },
    "total_page_results": 5,
    "cities": [
      {
        "city": "Atlanta",
        "state": "GA",
        "occupancy": 16,
        "total_listing": 28770,
        "occ_listing": 460320
      },
      {
        "city": "Columbus",
        "state": "GA",
        "occupancy": 35,
        "total_listing": 3925,
        "occ_listing": 137375
      },
      {
        "city": "Augusta",
        "state": "GA",
        "occupancy": 25,
        "total_listing": 3480,
        "occ_listing": 87000
      },
      {
        "city": "Decatur",
        "state": "GA",
        "occupancy": 47,
        "total_listing": 1766,
        "occ_listing": 83002
      },
      {
        "city": "BROOKHAVEN",
        "state": "GA",
        "occupancy": 27,
        "total_listing": 2621,
        "occ_listing": 70767
      }
    ]
  }
}
GET/v1.1/client/trends/summary/{state}/{city}

Get City Summary

This endpoint retrieves a summary of Airbnb properties, traditional properties, investment properties, and active neighborhoods including average occupancy, nightly price, property price, and ROI for a specific city.

Path parameters

  • Name
    state
    Type
    string
    Description

    State name, e.g. NV. Required.

  • Name
    city
    Type
    string
    Description

    City name, e.g. Las Vegas. Required.

Request

GET
/v1.1/client/trends/summary/{state}/{city}
curl "https://api.mashvisor.com/v1.1/client/trends/summary/IL/Chicago" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "active_neighborhoods": 227,
    "investment_properties": 5231,
    "airbnb_listings": 3397,
    "traditional_listings": 1913,
    "avg_property_price": 549642.8436,
    "avg_price_per_sqft": 299.24933879,
    "avg_days_on_market": 109.5151,
    "avg_occupancy": 0.4565,
    "avg_nightly_price": 240.1466,
    "avg_airbnb_ROI": 0.2904370212375566,
    "avg_airbnb_rental": 1102.0666666666666,
    "avg_traditional_ROI": 5.0594554904758136,
    "avg_traditional_rental": 2250.0005555555554
  }
}
GET/v1.1/client/trends/listing-price

Get Listing Prices

This endpoint retrieves average listing prices, median prices, average prices per sqft, and the median price/sqft for each zip code.

Query parameters

  • Name
    state
    Type
    string
    Description

    State name, e.g. CA. Required.

  • Name
    zip_code
    Type
    string
    Description

    Zip code value, e.g. 95118. Required.

  • Name
    beds
    Type
    integer
    Description

    0 to 4 bedrooms value.

  • Name
    property_type
    Type
    string
    Description

    Single Family Residential, Townhouse, Condo/Coop, Multi Family, Other.

Request

GET
/v1.1/client/trends/listing-price
curl -G "https://api.mashvisor.com/v1.1/client/trends/listing-price" \
  -d "zip_code=95118" \
  -d "state=CA" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "sample_size": 96,
    "avg_price": 1600205.49,
    "avg_price_per_sqft": 1001.216,
    "median_price": 1644187,
    "median_price_per_sqft": 1046
  }
}
GET/v1.1/client/search/heatmap

Get Location Heatmap

This endpoint retrieves the investment performance heatmap for a specific area based on geographical coordinates.

Query parameters

  • Name
    state
    Type
    string
    Description

    The state to search in, e.g. CA. Required.

  • Name
    sw_lat
    Type
    number
    Description

    South west point latitude for geo area, e.g. 33.76436731683163.

  • Name
    sw_lng
    Type
    number
    Description

    South west point longitude for geo area, e.g. -118.72974734005544.

  • Name
    ne_lat
    Type
    number
    Description

    North east point latitude for geo area, e.g. 34.410846062851626.

  • Name
    ne_lng
    Type
    number
    Description

    North east point longitude for geo area, e.g. -117.99366335568044.

  • Name
    type
    Type
    string
    Description

    AirbnbCoc, listingPrice, TraditionalCoc, OccupancyRate, AirbnbRental, or TraditionalRental.

Request

GET
/v1.1/client/search/heatmap
curl -G "https://api.mashvisor.com/v1.1/client/search/heatmap" \
  -d "state=IL" \
  -d "type=AirbnbCoc" \
  -d "sw_lat=41.888509508814266" \
  -d "sw_lng=-87.7059177836914" \
  -d "ne_lat=41.93992529459902" \
  -d "ne_lng=-87.60995907397461" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "min": -3,
    "max": -1,
    "total_results": 112,
    "results": [
      {
        "id": 603,
        "boundary": "POLYGON((-87.672667 41.91425,-87.672657 41.913876,...))",
        "value": -3.01,
        "airbnb_coc": -3.0146684646606445,
        "border_color": "f7b5a7",
        "color": "f06b50",
        "color_level": 1
      },
      {
        "id": 35,
        "boundary": "POLYGON((-87.69211 41.910277,...))",
        "value": -1.97,
        "airbnb_coc": -1.9666345119476318,
        "border_color": "f7b5a7",
        "color": "f06b50",
        "color_level": 1
      }
    ]
  }
}

Was this page helpful?