Short Term Rentals

Mashvisor provides data and analysis for different short-term rental services, including Airbnb, HomeAway, and VRBO.

Mashvisor has one of the largest databases (over 2.5M+ records) of historical short-term rental data with detailed property information, reviews, photos, host information, and a yearly calendar of daily booking availability and booking price per night.

Our short-term occupancy calculator is supported by an algorithm calculating the occupancy rate for each listing based on the properties' historical performance and available future bookings. Our algorithms can differentiate between booked and blocked days, and estimate monthly rental income for future bookings.

We have established a validation process for occupancy rates calculations with verified Airbnb hosts to ensure higher accuracy and certify our data.

Country parameter: In the Short Term Rentals APIs, you can optionally set the country parameter. It defaults to US. If specified, use ISO-3166 Alpha-2 format (e.g. GB for Great Britain, ES for Spain).


GET/v1.1/client/airbnb-property/{id}

Get Airbnb Listing Info

Fetches a full snapshot of any Airbnb listing—covering host profile, guest reviews, photos, occupancy rate, and income projections—to help evaluate performance and investment potential.

Path parameters

  • Name
    id
    Type
    long
    Description

    The Airbnb listing ID.

Query parameters

  • Name
    state
    Type
    string
    Description

    State of the listing. Required. API returns 404 if omitted.

  • Name
    country
    Type
    string
    Description

    Country ISO-3166 Alpha-2 code. Default: US.

Airbnb Property Data Dictionary

AttributeDefinitionPossible Returns
idAirbnb listing IDInteger
nameListing full nameString
neighborhoodListing neighborhoodBoolean
cityThe city where the listing is locatedString
state*The state where the property is locatedString
zip codePostal code where a listing is locatedInteger
countryCounty where a listing is locatedString
smart_locationFull location of listingString
addressAddress of listing entered by hostString
public_addressFull address along with the countryString
country_codeListing's country code, ex: USString
marketListing marketString
latLatitude of listing locationFloat
lngLongitude of listing locationFloat
instant_bookableIndicator if listing is available for instant bookingBoolean
picture_urlMain picture urlString
thumbnail_urlMain thumbnail picture urlString
medium_urlMain XL picture urlString
xl_picture_urlAll XL pictures urlsString
picture_urlsAll pictures urlString - array
thumbnail_urlsAll thumbnail pictures urlString - array
xl_picture_urlsAll XL pictures urlsString - array
picture_countCount of all picturesInteger
picture_captionsAll pictures captionsString - array
map_image_urlGoogle map image urlString
user_idListing's host IDInteger
priceListing current booking price per nightInteger
native_currencyNative price currency, ex: USDString
price_nativeListing native priceInteger
price_formattedPrice along with the currencyString
price_for_extra_person_nativeExtra person's priceInteger
weekly_price_nativeWeekly price after the discountInteger
monthly_price_nativeMonthly price after the discountInteger
currency_symbol_leftCurrency symbol, ex: $String
currency_symbol_rightCurrency symbol, ex: €String
security_deposit_nativeSecurity deposit priceInteger
security_price_nativeSecurity deposit native priceInteger
security_deposit_formattedSecurity deposit price with currencyString
bedroomsNumber of bedroomsInteger
bedsNumber of bedsInteger
bathroomsNumber of bathroomsInteger
min_nightsMin allowed booking nightsInteger
person_capacityMax listing capacity of personsInteger
userHost/user objectUser Object
cancellation_policyCancellation policy categoryString
cancel_policyCancellation policy category IDInteger
cancel_policy_short_strSummary of cancellation policyString
has_double_blind_reviewsBoolean indicator for blind reviewsBoolean
property_typeProperty main type (House, Apartment, Villa, etc.)String
reviews_countTotal reviews countInteger
review_scoresDetailed reviews scores per categoryReview Scores object
room_typeListing room type (Entire home/apt, Private room, Shared room)String
room_type_categoryRoom type categoryString
bed_typeBed typeString
bed_type_categoryBed type categoryString
require_guest_profile_pictureRequire guest profile pictureBoolean
require_guest_phone_verificationRequire guest phone verificationBoolean
force_mobile_legal_modalForce mobile legal modalBoolean
check_in_timeCheck in time hourInteger
check_out_timeCheck out time hourInteger
guests_includedNumber of guests includedInteger
licenseAirBnB license for listingString
max_nightsMax booking nightsInteger
square_feetListing living areaInteger
localeListing's localeString
languageListing page languageString
experiences_offeredListing experience offered along with bookingString
max_nights_input_valueMax nights input valueInteger
min_nights_input_valueMin nights input valueInteger
requires_licenseIndicator if the listing requires licenceBoolean
property_type_idProperty type IDInteger
house_rulesHosting rules provided by host when bookingString
descriptionListing full descriptionString
description_localeDescription localeString
summaryDescription summaryString
spaceListing spaceString
accessAllowed accesses in the listing from hostString
interactionHost interactionString
neighborhood_overviewListing neighborhood overviewString
transitListing around transitString
amenitiesAll included amenitiesString - array
is_location_exactVerified exact locationBoolean
star_ratingTotal star ratingFloat
time_zone_nameFull timezone nameString
created_atListing creation date and timeTimestamp
updated_atListing updates date and timeTimestamp
existsIndicator if the listing is still active over AirBnB or notBoolean

Request

GET
/v1.1/client/airbnb-property/{id}
curl -G "https://api.mashvisor.com/v1.1/client/airbnb-property/22518616" \
  -d "state=AZ" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "id": "22518616",
    "city": "Tempe",
    "picture_url": "https://a0.muscache.com/4ea/air/v2//pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?t=r:w1200-h720-sfit,e:fjpg-c85",
    "thumbnail_url": "https://a0.muscache.com/im/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?aki_policy=small",
    "medium_url": "https://a0.muscache.com/im/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?aki_policy=medium",
    "xl_picture_url": "https://a0.muscache.com/im/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?aki_policy=x_large",
    "user_id": 2158239,
    "price": 134,
    "native_currency": "USD",
    "price_native": 134,
    "price_formatted": "$134",
    "lat": 33.44431,
    "lng": -111.92187,
    "country": "United States",
    "name": "Community Pool - Three Story Home with Two Balconies.",
    "smart_location": "Tempe, AZ",
    "has_double_blind_reviews": false,
    "instant_bookable": false,
    "bedrooms": 4,
    "beds": 5,
    "bathrooms": 3.5,
    "market": "Phoenix",
    "min_nights": 2,
    "neighborhood": null,
    "person_capacity": 9,
    "state": "AZ",
    "zipcode": "85281",
    "address": "Tempe, AZ, United States",
    "country_code": "US",
    "cancellation_policy": "moderate",
    "property_type": "House",
    "reviews_count": 97,
    "room_type": "Entire home/apt",
    "room_type_category": "entire_home",
    "picture_count": 42,
    "currency_symbol_left": "$",
    "currency_symbol_right": null,
    "bed_type": "Real Bed",
    "bed_type_category": "real_bed",
    "require_guest_profile_picture": false,
    "require_guest_phone_verification": false,
    "force_mobile_legal_modal": false,
    "cancel_policy": 4,
    "check_in_time": 15,
    "check_out_time": 10,
    "guests_included": 4,
    "license": null,
    "max_nights": 1125,
    "square_feet": null,
    "locale": "en",
    "has_viewed_terms": null,
    "has_viewed_cleaning": null,
    "has_agreed_to_legal_terms": null,
    "has_viewed_ib_perf_dashboard_panel": null,
    "language": "en",
    "public_address": "Tempe, AZ, United States",
    "map_image_url": "https://maps.googleapis.com/maps/api/staticmap?maptype=roadmap&markers=33.44431%2C-111.92187&size=480x320&zoom=15&client=gme-airbnbinc&channel=monorail-prod&signature=7dUWsaAPDy3FOP1bZTg7eYRLj0o%3D",
    "experiences_offered": "none",
    "max_nights_input_value": 1125,
    "min_nights_input_value": 2,
    "requires_license": false,
    "property_type_id": 2,
    "house_rules": "--NOISE--\nPlease keep your volume down if you are playing music especially using the stereo system (Yes even during the day).\nPlease keep your volume down when you talk on the rooftop as the sound travels.\nAny loud noise during the quite hours between 10pm and 8am may result in complaints and fines.\n--PARTY--\nPlease DO NOT host any party in the house except pre-approved small gatherings (with low noise level). \nOnly the guests on the booking request allowed to stay overnight. There will be fees for extra guests staying.\n--PARKING--\nPlease do not park in front of the garage door as it will block the neighbor's pathway.\nPlease do not park anywhere that has NO PARKING or red curb.\n--SMOKING--\nSmoking is prohibited anywhere in the house. Fees will be charged if the cleaning company find any signs of cigarette and smoke. \n--PETS--\nNo pets allowed in the house. Fines will be applied for any violation. \n--CLEANING--\nExtra cleaning charge will be reported to Airbnb if the house needs extensive cleaning efforts (longer than 3 hours: $55/hour)\n--CHECKOUT--\nCheckout time is 10am. If you check out later that 10am there will be an extra charge of $50 (Please contact your host to confirm the availability)\n\nThank you for treating your house as your own home and taking consideration of the neighbors!",
    "security_deposit_native": 200,
    "security_price_native": 200,
    "security_deposit_formatted": "$200",
    "description": "COVID19 Responding Action: We are blocking off 72 between each stay to ensure the safety for our guests. We also hired a professional third party cleaning company to perform the cleaning for each stay. \nThe community pool is open for use. \n--------------\nBask in the sun on one of the two lovely balconies, or socialize at the pool, at this dreamy desert getaway. Utilize the comfy bedrooms on all three floors, cook a gourmet meal in the high-end kitchen and watch TV on the giant projection screen.\n\nMaster Bedroom: King Bed | Bedroom 2: Queen Bed | Bedroom 3: Queen Bed, Twin Trundle Bed | Bedroom 4 (1st floor): Queen Sleeper Sofa \n\nNestled in the pristine Newport community, this spacious home is designed to impress with modern elegance and comfortable furnishings. \n\nJust steps from your home-away-from-home is the shared outdoor pool and spa. Dive into relaxation in this pristine body of water or enjoy a soothing soak in the jacuzzi for optimal holiday relaxation. \n\nWhen you're not lounging poolside, unwind in the living area, featuring plush sofas, a stereo, smart home system, and a Smart TV with cable channels and a large projector screen. \n\nYou'll want to put your culinary skills to the test in the high-end kitchen, adorned with stainless steel appliances, sleek countertops, a breakfast bar, and a farmhouse sink. Enjoy your home-cooked cuisine at the 2-person breakfast bar or at the dining room table with seating for 6. \n\nFor a front-row seat to colorful Arizona sunsets, retreat upstairs to the private rooftop patio, with seating for 2 and picturesque Tempe views. The property also features a second-floor balcony - the perfect place to jumpstart your day with a cup of coffee or end it with an evening nightcap.\n\nRetire to the well-appointed master bedroom, offering a king-sized bed and an en-suite bathroom with a large shower and bathtub. Sleep will come easy in Bedrooms 2 and 3, boasting high-quality memory foam queen mattresses. Additional sleeping can be found in the downstairs 4th bedroom with high-end foam mattress queen-sized sleeper sofa.\n\nGuest has access to the whole house. Just make it your own home in the dessert.\n\nKeyless entry and self check in is available. Instruction will be sent to you after booking.\n\nVisit boutiques, museums, galleries, live theatre, gourmet fare and more in these lively cities, or head out into nature for more adventure. Downtown Tempe is just a stone's throw away, and Old Scottsdale is only 15 minutes away.\n\nRental car is highly recommended. Although uber/Lyft are also very convenient to use in town. There’s also free flash to go to ASU and downtown. \nWe have two bikes you can use for free.\n\nKey Residence Features:\n- Amenities include a fully equipped kitchen with stainless steel appliances, free WiFi, flat-screen cable TV, Smart TV with cable channels and projector screen, Amazon Echo Dots and smart AC control, private rooftop patio, second-floor balcony, access to resort pool and spa, 2 cruiser bikes, and much more! \n- Prime Tempe location just 4 minutes from downtown, 8 minutes to Old Town Scottsdale, a 5-minute drive to Arizona State University, and 15 minutes to downtown Phoenix!\n\nAdditional Information: \n- Please note that the trash is picked up on Monday mornings. It will need to be pulled to the front of the community on Sunday night and returned to the unit the next day\n\n- Please note that recycling is picked up on Thursday mornings. It will need to be pulled to the front of the community on Wednesday night, and returned to the unit the next day\n\n- During weekdays and some weekends there maybe construction noises in the morning",
    "description_locale": "en",
    "summary": "COVID19 Responding Action: We are blocking off 72 between each stay to ensure the safety for our guests. We also hired a professional third party cleaning company to perform the cleaning for each stay. \nThe community pool is open for use. \n--------------\nBask in the sun on one of the two lovely balconies, or socialize at the pool, at this dreamy desert getaway. Utilize the comfy bedrooms on all three floors, cook a gourmet meal in the high-end kitchen and watch TV on the giant projection screen.",
    "space": "Master Bedroom: King Bed | Bedroom 2: Queen Bed | Bedroom 3: Queen Bed, Twin Trundle Bed | Bedroom 4 (1st floor): Queen Sleeper Sofa \n\nNestled in the pristine Newport community, this spacious home is designed to impress with modern elegance and comfortable furnishings. \n\nJust steps from your home-away-from-home is the shared outdoor pool and spa. Dive into relaxation in this pristine body of water or enjoy a soothing soak in the jacuzzi for optimal holiday relaxation. \n\nWhen you're not lounging poolside, unwind in the living area, featuring plush sofas, a stereo, smart home system, and a Smart TV with cable channels and a large projector screen. \n\nYou'll want to put your culinary skills to the test in the high-end kitchen, adorned with stainless steel appliances, sleek countertops, a breakfast bar, and a farmhouse sink. Enjoy your home-cooked cuisine at the 2-person breakfast bar or at the dining room table with seating for 6. \n\nFor a front-row seat to colorful Arizona sunsets, retreat upstairs to the private rooftop patio, with seating for 2 and picturesque Tempe views. The property also features a second-floor balcony - the perfect place to jumpstart your day with a cup of coffee or end it with an evening nightcap.\n\nRetire to the well-appointed master bedroom, offering a king-sized bed and an en-suite bathroom with a large shower and bathtub. Sleep will come easy in Bedrooms 2 and 3, boasting high-quality memory foam queen mattresses. Additional sleeping can be found in the downstairs 4th bedroom with high-end foam mattress queen-sized sleeper sofa.",
    "access": "Guest has access to the whole house. Just make it your own home in the dessert.",
    "interaction": "Keyless entry and self check in is available. Instruction will be sent to you after booking.",
    "neighborhood_overview": "Visit boutiques, museums, galleries, live theatre, gourmet fare and more in these lively cities, or head out into nature for more adventure. Downtown Tempe is just a stone's throw away, and Old Scottsdale is only 15 minutes away.",
    "transit": "Rental car is highly recommended. Although uber/Lyft are also very convenient to use in town. There’s also free flash to go to ASU and downtown. \nWe have two bikes you can use for free.",
    "amenities": [
      "TV",
      "Cable TV",
      "Wifi",
      "Air conditioning",
      "Pool",
      "Kitchen",
      "Free parking on premises",
      "Free street parking",
      "Hot tub",
      "Indoor fireplace",
      "Heating",
      "Washer",
      "Dryer",
      "Smoke alarm",
      "Carbon monoxide alarm",
      "Essentials",
      "Shampoo",
      "Hangers",
      "Hair dryer",
      "Iron",
      "Laptop-friendly workspace",
      "Self check-in",
      "Keypad",
      "Bathtub",
      "Room-darkening shades",
      "Body soap",
      "Bath towel",
      "Toilet paper",
      "Bed linens",
      "Extra pillows and blankets",
      "Microwave",
      "Coffee maker",
      "Refrigerator",
      "Dishwasher",
      "Dishes and silverware",
      "Cooking basics",
      "Oven",
      "Stove",
      "BBQ grill",
      "Patio or balcony",
      "Long term stays allowed",
      "Handheld shower head",
      "Hot water kettle",
      "Central air conditioning",
      "Smart TV",
      "Mountain view",
      "Rain shower",
      "Balcony",
      "Sound system",
      "Gas oven",
      "Projector and screen",
      "Breakfast table",
      "Espresso machine",
      "Formal dining area",
      "Sun loungers",
      "Day bed",
      "Shared pool",
      "Shared hot tub",
      "Convection oven",
      "Amazon Echo",
      "Memory foam mattress",
      "En suite bathroom",
      "Outdoor seating",
      "Soaking tub",
      "Walk-in shower",
      "Full kitchen",
      "Bedroom comforts",
      "Bathroom essentials"
    ],
    "is_location_exact": true,
    "cancel_policy_short_str": "Moderate",
    "star_rating": null,
    "price_for_extra_person_native": 15,
    "weekly_price_native": null,
    "monthly_price_native": null,
    "time_zone_name": "America/Phoenix",
    "loc": {
      "type": "Point",
      "coordinates": [
        -111.92187,
        33.44431
      ]
    },
    "exists": false,
    "created_at": "2018-04-05T23:17:26.415Z",
    "updated_at": "2021-06-12T08:55:24.570Z",
    "cleaning_fee_native": 280,
    "extras_price_native": 280,
    "in_building": false,
    "in_toto_area": false,
    "instant_book_enabled": true,
    "is_business_travel_ready": null,
    "listing_cleaning_fee_native": 280,
    "listing_monthly_price_native": null,
    "listing_price_for_extra_person_native": 15,
    "listing_weekend_price_native": 295,
    "listing_weekly_price_native": null,
    "localized_city": "Tempe",
    "monthly_price_factor": 0.9,
    "special_offer": null,
    "toto_opt_in": null,
    "weekly_price_factor": 0.95,
    "wireless_info": null,
    "host_id": 2158239,
    "airbnb_id": "22518616",
    "mashvisor_id": null,
    "photos_count": 42,
    "has_media": true,
    "occupancy": null,
    "rental_income": null,
    "nights_booked": null
  }
}

GET/v1.1/client/vrbo-property/{id}

Get VRBO Listing Info

This endpoint retrieves the VRBO property's detailed information, reviews count, address, estimated rental income, and calculated occupancy rate.

Path parameters

  • Name
    id
    Type
    long
    Description

    The VRBO listing ID.

Query parameters

  • Name
    state
    Type
    string
    Description

    State of the listing. Required. API returns 404 if omitted.

  • Name
    country
    Type
    string
    Description

    Country ISO-3166 Alpha-2 code. Default: US.

VRBO Property Data Dictionary

AttributeDefinitionData Type
idVRBO listing IDString
headlineListing full nameString
addressListing address including country, state, city, postal codeString
propertyTimezoneFull timezone nameString
created_atListing creation date and timeTimestamp
updated_atListing updates date and timeTimestamp
existsIndicator if the listing is still active over VRBOBoolean
propertyIdProperty IDString
propertyNameProperty nameString
propertyTypeProperty type (e.g., Condo)String
propertyTypeKeyProperty type key (e.g., condo)String
descriptionProperty descriptionString
canonicalLinkLink to the property listingString
sleepsNumber of guests the property sleepsInteger
bedroomsNumber of bedrooms in the propertyInteger
bathroomsNumber of bathrooms in the propertyObject
averageRatingAverage rating of the propertyFloat
reviewCountNumber of reviews for the propertyInteger
onlineBookableIndicates if the property is bookable onlineBoolean
instantBookableIndicates if the property supports instant bookingBoolean
unitMetadataMetadata for the unitObject
featuredAmenitiesFeatured amenities for the propertyArray of Strings
allFeaturedAmenitiesRankedRanked list of featured amenitiesArray of Strings
houseRulesProperty's house rulesObject
cancellationPolicyCancellation policy for the propertyObject
payPerBookingIndicates if the property uses a pay-per-booking modelBoolean
priceSummaryPrice summary for the propertyObject
ownerManagedIndicates if the property is owner-managedBoolean
ownerListingProfileOwner's listing profile informationObject
propertyManagerProfileProperty manager's profile informationObject
registrationNumberProperty registration number (if applicable)String
recentAddedIndicates if the property was recently addedBoolean
takesInquiriesIndicates if the property takes inquiries from guestsBoolean
videoUrlsURLs to videos related to the propertyArray of Strings
thumbnailUrlURL to the property's thumbnail imageString
travelerFeeEligibleIndicates if traveler fees are eligible for the propertyBoolean
listingNumberListing number for the propertyInteger
multiUnitPropertyIndicates if the property is a multi-unit propertyBoolean
egratedPropertyManagerInformation about an integrated property manager (if applicable)Object
platformPropertyManagerIndicates if the property is managed by a platform property managerBoolean
ipmGuaranteedPricingActiveIndicates if guaranteed pricing is active for the propertyBoolean
petsAllowedIndicates if pets are allowed in the propertyBoolean
minStayRangeRange of minimum stay requirements for the propertyObject
maxOccupancyMaximum occupancy details for the propertyObject
industryHealthAssociationsHealth associations associated with the propertyArray of Objects
regionalHealthGuidelinesRegional health guidelines for the propertyArray of Objects
impressumProperty's impressum (if applicable)String
occupancyOccupancy details for the propertyObject
rentalIncomeRental income details for the propertyObject
nightsBookedNumber of nights booked for the propertyInteger

Request

GET
/v1.1/client/vrbo-property/{id}
curl -G "https://api.mashvisor.com/v1.1/client/vrbo-property/1943760" \
  -d "state=FL" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "propertyTimezone": "America/New_York",
    "address": {
      "city": "Gainesville",
      "country": "US",
      "postalCode": "32608",
      "stateProvince": "FL"
    },
    "availabilityUpdated": "2023-09-01",
    "averageRating": 4.8541665,
    "bedrooms": 2,
    "canonicalLink": "https://www.vrbo.com/1943760",
    "description": "One block from Shands Hospital, VA Hospital, and the University of Florida campus. This is a spacious ground level condo with two bedrooms. Each includes walk-in closet, luxury queen bed, chest of drawers, ceiling fan, bedside table, bed linens provided; there is one bathroom, tiled with tub/shower grab bar, towels provided; fully furnished kitchen with refrigerator, dishwasher, gas stove, microwave, all dishes and cooking utensils; table and 4 chairs; living room with large comfortable sofa, two large upholstered chairs, 50 inch flat screen TV, cable, internet, wireless;  sleeps four comfortably and 1 other on the sofa.\nThe complex does not allow dogs.",
    "detailPageUrl": "/1943760?unitId=2506282&childrenCount=0&noDates=true",
    "featuredAmenities": [
      "POOL",
      "INTERNET",
      "AIR_CONDITIONING",
      "TV",
      "CABLE",
      "PARKING",
      "HEATER"
    ],
    "firstLiveInLastThirtyDays": false,
    "geoCode": {
      "exact": false,
      "latitude": 29.6353672,
      "longitude": -82.34372944
    },
    "geography": {
      "description": "Gainesville, Florida, United States of America",
      "ids": [
        {
          "type": "LBS",
          "value": "d616f541-1f46-4b1a-a665-986baf96dfec"
        }
      ],
      "name": "Gainesville",
      "relatedGeographies": null,
      "types": [
        "locality"
      ],
      "location": {
        "lat": 29.651939,
        "lng": -82.325043
      }
    },
    "propertyManagerProfile": null,
    "headline": "2Short walk to Shands & VA Hospitals, and UF campus",
    "houseRules": {
      "children": {
        "label": "Children allowed",
        "note": "There are no play areas for children.",
        "allowed": true
      },
      "events": {
        "label": "No events",
        "note": null,
        "allowed": false
      },
      "smoking": {
        "label": "Smoking allowed",
        "note": null,
        "allowed": true
      },
      "pets": {
        "label": "No pets",
        "note": null,
        "allowed": false
      },
      "unitUrl": "/units/0004/33784c7c-d1c6-4803-8f3d-f022b46ba272",
      "checkInTime": "4:00 PM",
      "checkOutTime": "11:00 AM",
      "minimumAge": {
        "label": "Minimum age of primary renter:",
        "note": null,
        "minimumAge": 20,
        "displayText": "Minimum age to rent: 20"
      },
      "maxOccupancy": {
        "adults": null,
        "guests": 4,
        "label": "Max guests:",
        "maxAdultsLabel": null,
        "note": null,
        "displayText": "Maximum overnight guests: 4"
      },
      "standardRules": [
        {
          "key": "childrenRule",
          "label": "Children allowed",
          "note": "There are no play areas for children."
        },
        {
          "key": "petsRule",
          "label": "No pets",
          "note": null
        },
        {
          "key": "eventsRule",
          "label": "No events",
          "note": null
        },
        {
          "key": "smokingRule",
          "label": "Smoking allowed",
          "note": null
        }
      ],
      "customRules": [],
      "label": "House Rules",
      "checkInRule": {
        "label": "<strong>Check in</strong> after 4:00 PM",
        "time": "4:00 PM"
      },
      "checkOutRule": {
        "label": "<strong>Check out</strong> before 11:00 AM",
        "time": "11:00 AM"
      },
      "childrenRule": {
        "displayText": "Children allowed: ages 0-17",
        "allowed": true,
        "childrenNotAllowedNote": null,
        "note": "There are no play areas for children."
      },
      "petsRule": {
        "displayText": "No pets allowed",
        "allowed": false,
        "note": null
      },
      "eventsRule": {
        "displayText": "No events allowed",
        "allowed": false,
        "maxEventAttendeesLabel": null,
        "allowedEventsNote": null,
        "note": null
      },
      "smokingRule": {
        "displayText": "Smoking allowed: outside",
        "allowed": true,
        "outside": {
          "allowed": true,
          "note": null
        },
        "inside": null,
        "note": null
      }
    },
    "cancellationPolicy": {
      "cancellationPolicyPeriods": [
        {
          "label": "<strong>100% refund of amount paid</strong> if you cancel at least 14 days before check-in."
        },
        {
          "label": "<strong>50% refund of amount paid</strong> (minus the service fee) if you cancel at least 7 days before check-in."
        },
        {
          "label": "<strong>No refund</strong> if you cancel less than 7 days before check-in."
        }
      ],
      "cancellationPolicyLabel": {
        "label": "<strong>Free cancellation</strong> up to",
        "date": "14 days before check-in",
        "isFullRefundWindow": true
      },
      "cancellationTimelinePeriods": [
        {
          "timelineLabel": "14 days before check-in",
          "refundPercent": 100,
          "refundWindowLabel": "100% refund",
          "shortDateLocalized": null,
          "isPast": false,
          "isActive": false,
          "iconCode": null
        },
        {
          "timelineLabel": "7 days before check-in",
          "refundPercent": 50,
          "refundWindowLabel": "50% refund",
          "shortDateLocalized": null,
          "isPast": false,
          "isActive": false,
          "iconCode": null
        },
        {
          "timelineLabel": "Check in",
          "refundPercent": 0,
          "refundWindowLabel": "No refund",
          "shortDateLocalized": null,
          "isPast": false,
          "isActive": false,
          "iconCode": "KEY"
        }
      ],
      "policyType": "RELAXED"
    },
    "instantBookable": true,
    "egratedPropertyManager": null,
    "platformPropertyManager": false,
    "ipmGuaranteedPricingActive": false,
    "isBasicListing": false,
    "isCrossSell": false,
    "isSubscription": false,
    "listingId": "321.1943760.2506282",
    "listingNumber": 1943760,
    "minStayRange": {
      "minStayHigh": 7,
      "minStayLow": 2
    },
    "multiUnitProperty": false,
    "onlineBookable": true,
    "ownerManaged": true,
    "ownersListingProfile": {
      "aboutYou": null,
      "storyPhoto": null,
      "uniqueBenefits": null,
      "whyHere": null
    },
    "payPerBooking": true,
    "petsAllowed": false,
    "priceSummary": {
      "amount": 98,
      "currency": "USD",
      "formattedAmount": "$98",
      "pricePeriodDescription": "avg/night",
      "currencySymbol": "$"
    },
    "propertyId": "1943760",
    "id": "49177741",
    "propertyManagerMessaging": null,
    "propertyType": "Condo",
    "propertyTypeKey": "condo",
    "recentlyAdded": false,
    "registrationNumber": "",
    "reviewCount": 48,
    "sleeps": 4,
    "sleepsDisplay": "Sleeps 4",
    "spu": "vrbo-1943760-2506282",
    "status": "AVAILABLE",
    "takesInquiries": true,
    "testListing": false,
    "thumbnailUrl": "https://media.vrbo.com/lodging/50000000/49180000/49177800/49177741/7d1d1ee0.TREATMENT.jpg",
    "travelerFeeEligible": true,
    "videoUrls": [],
    "bathrooms": {
      "full": 1,
      "half": 0,
      "toiletOnly": 0
    },
    "industryHealthAssociations": [],
    "regionalHealthGuidelines": [],
    "impressum": null,
    "allFeaturedAmenitiesRanked": [
      "INTERNET",
      "PETS",
      "AIR_CONDITIONING",
      "POOL",
      "WHEELCHAIR",
      "HEATER",
      "FIREPLACE",
      "CABLE",
      "CHILDREN_WELCOME",
      "WASHER_DRYER",
      "HOT_TUB",
      "PARKING",
      "TV",
      "NO_SMOKING"
    ],
    "nights_booked": null
  }
}

GET/v1.1/client/airbnb-property/{id}/historical

Listing's Historical Performance

This endpoint retrieves the Airbnb/VRBO property's 12 historical records—nightly price, revenue, occupancy, unbooked nights, and occupancy rate—for a specific property.

Path parameters

  • Name
    id
    Type
    long
    Description

    The property record ID from the Mashvisor database.

Query parameters

  • Name
    state
    Type
    string
    Description

    State of the property. Required. API returns 404 if omitted.

  • Name
    country
    Type
    string
    Description

    Country ISO-3166 Alpha-2 code. Default: US.

Request

GET
/v1.1/client/airbnb-property/{id}/historical
curl -G "https://api.mashvisor.com/v1.1/client/airbnb-property/2769902/historical" \
  -d "state=LA" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "name": "Kasper's Kountryside Inn",
    "airbnb_id": "2769902",
    "months": [
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2025,
        "month": 11,
        "nightly_price": 165,
        "revenue": 4950,
        "occupancy": 30,
        "unbooked_nights": null,
        "booked_nights": 30,
        "occupancy_rate": 100
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2025,
        "month": 10,
        "nightly_price": 165,
        "revenue": 5122,
        "occupancy": 31,
        "unbooked_nights": null,
        "booked_nights": 31,
        "occupancy_rate": 100
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2025,
        "month": 9,
        "nightly_price": 195,
        "revenue": 3696,
        "occupancy": 19,
        "unbooked_nights": 11,
        "booked_nights": 19,
        "occupancy_rate": 63
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2025,
        "month": 8,
        "nightly_price": 198,
        "revenue": 8596,
        "occupancy": 29,
        "unbooked_nights": 2,
        "booked_nights": 29,
        "occupancy_rate": 94
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2025,
        "month": 7,
        "nightly_price": 194,
        "revenue": 19387,
        "occupancy": 25,
        "unbooked_nights": 6,
        "booked_nights": 25,
        "occupancy_rate": 81
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2025,
        "month": 6,
        "nightly_price": 206,
        "revenue": 15865,
        "occupancy": 25,
        "unbooked_nights": 5,
        "booked_nights": 25,
        "occupancy_rate": 83
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2025,
        "month": 5,
        "nightly_price": 207,
        "revenue": 12698,
        "occupancy": 14,
        "unbooked_nights": 17,
        "booked_nights": 14,
        "occupancy_rate": 45
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2025,
        "month": 4,
        "nightly_price": 210,
        "revenue": 27210,
        "occupancy": 30,
        "unbooked_nights": null,
        "booked_nights": 30,
        "occupancy_rate": 100
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2025,
        "month": 3,
        "nightly_price": 183,
        "revenue": 13077,
        "occupancy": 31,
        "unbooked_nights": null,
        "booked_nights": 31,
        "occupancy_rate": 100
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2025,
        "month": 2,
        "nightly_price": 155,
        "revenue": 4340,
        "occupancy": 28,
        "unbooked_nights": null,
        "booked_nights": 28,
        "occupancy_rate": 100
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2025,
        "month": 1,
        "nightly_price": 155,
        "revenue": 4805,
        "occupancy": 31,
        "unbooked_nights": null,
        "booked_nights": 31,
        "occupancy_rate": 100
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2024,
        "month": 12,
        "nightly_price": 205,
        "revenue": 6353,
        "occupancy": 31,
        "unbooked_nights": null,
        "booked_nights": 31,
        "occupancy_rate": 100
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2024,
        "month": 11,
        "nightly_price": 155,
        "revenue": 4650,
        "occupancy": 30,
        "unbooked_nights": null,
        "booked_nights": 30,
        "occupancy_rate": 100
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2024,
        "month": 10,
        "nightly_price": 155,
        "revenue": 4805,
        "occupancy": 31,
        "unbooked_nights": null,
        "booked_nights": 31,
        "occupancy_rate": 100
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2024,
        "month": 9,
        "nightly_price": 155,
        "revenue": 3565,
        "occupancy": 23,
        "unbooked_nights": 7,
        "booked_nights": 23,
        "occupancy_rate": 77
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2024,
        "month": 8,
        "nightly_price": 145,
        "revenue": 4495,
        "occupancy": 31,
        "unbooked_nights": null,
        "booked_nights": 31,
        "occupancy_rate": 100
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2024,
        "month": 7,
        "nightly_price": 145,
        "revenue": 3770,
        "occupancy": 26,
        "unbooked_nights": 5,
        "booked_nights": 26,
        "occupancy_rate": 84
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2024,
        "month": 6,
        "nightly_price": 145,
        "revenue": 3190,
        "occupancy": 22,
        "unbooked_nights": 8,
        "booked_nights": 22,
        "occupancy_rate": 73
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2024,
        "month": 5,
        "nightly_price": 145,
        "revenue": 1740,
        "occupancy": 12,
        "unbooked_nights": 19,
        "booked_nights": 12,
        "occupancy_rate": 39
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2024,
        "month": 4,
        "nightly_price": 145,
        "revenue": 2320,
        "occupancy": 16,
        "unbooked_nights": 14,
        "booked_nights": 16,
        "occupancy_rate": 53
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2024,
        "month": 3,
        "nightly_price": 145,
        "revenue": 2610,
        "occupancy": 18,
        "unbooked_nights": 13,
        "booked_nights": 18,
        "occupancy_rate": 58
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2024,
        "month": 2,
        "nightly_price": 145,
        "revenue": 1740,
        "occupancy": 12,
        "unbooked_nights": 17,
        "booked_nights": 12,
        "occupancy_rate": 41
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2024,
        "month": 1,
        "nightly_price": 145,
        "revenue": 0,
        "occupancy": 0,
        "unbooked_nights": 31,
        "booked_nights": null,
        "occupancy_rate": null
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2023,
        "month": 12,
        "nightly_price": 145,
        "revenue": 1595,
        "occupancy": 11,
        "unbooked_nights": 20,
        "booked_nights": 11,
        "occupancy_rate": 35
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2023,
        "month": 11,
        "nightly_price": 135,
        "revenue": 2160,
        "occupancy": 16,
        "unbooked_nights": 14,
        "booked_nights": 16,
        "occupancy_rate": 53
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2023,
        "month": 10,
        "nightly_price": 136,
        "revenue": 1493,
        "occupancy": 11,
        "unbooked_nights": 20,
        "booked_nights": 11,
        "occupancy_rate": 35
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2023,
        "month": 9,
        "nightly_price": 136,
        "revenue": 4090,
        "occupancy": 30,
        "unbooked_nights": null,
        "booked_nights": 30,
        "occupancy_rate": 100
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2023,
        "month": 8,
        "nightly_price": 138,
        "revenue": 4150,
        "occupancy": 30,
        "unbooked_nights": 1,
        "booked_nights": 30,
        "occupancy_rate": 97
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2023,
        "month": 7,
        "nightly_price": 141,
        "revenue": 4358,
        "occupancy": 31,
        "unbooked_nights": null,
        "booked_nights": 31,
        "occupancy_rate": 100
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2023,
        "month": 6,
        "nightly_price": 137,
        "revenue": 3987,
        "occupancy": 29,
        "unbooked_nights": 1,
        "booked_nights": 29,
        "occupancy_rate": 97
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2023,
        "month": 5,
        "nightly_price": 120,
        "revenue": 1565,
        "occupancy": 13,
        "unbooked_nights": 18,
        "booked_nights": 13,
        "occupancy_rate": 42
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2023,
        "month": 4,
        "nightly_price": 127,
        "revenue": 2026,
        "occupancy": 16,
        "unbooked_nights": 14,
        "booked_nights": 16,
        "occupancy_rate": 53
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2023,
        "month": 3,
        "nightly_price": 0,
        "revenue": 0,
        "occupancy": 0,
        "unbooked_nights": null,
        "booked_nights": null,
        "occupancy_rate": null
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2023,
        "month": 2,
        "nightly_price": 0,
        "revenue": 0,
        "occupancy": 0,
        "unbooked_nights": null,
        "booked_nights": null,
        "occupancy_rate": null
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2023,
        "month": 1,
        "nightly_price": 0,
        "revenue": 0,
        "occupancy": 0,
        "unbooked_nights": null,
        "booked_nights": null,
        "occupancy_rate": null
      },
      {
        "airbnb_id": "2769902",
        "name": "Kasper's Kountryside Inn",
        "year": 2022,
        "month": 12,
        "nightly_price": 127,
        "revenue": 0,
        "occupancy": 0,
        "unbooked_nights": 31,
        "booked_nights": null,
        "occupancy_rate": null
      }
    ]
  }
}

GET/v1.1/client/neighborhood/{id}/historical/airbnb

Neighborhood Historical Performance

This endpoint retrieves a neighborhood/area's short-term historical performance for listings in an array.

Path parameters

  • Name
    id
    Type
    long
    Description

    Neighborhood ID to fetch data for.

Query parameters

  • Name
    state
    Type
    string
    Description

    State. Required. API returns 404 if omitted.

  • Name
    country
    Type
    string
    Description

    Country ISO-3166 Alpha-2 code. Default: US.

  • Name
    percentile_rate
    Type
    double
    Description

    Percentile rate. Default: 1.

  • Name
    average_by
    Type
    string
    Description

    Possible values: occupancy, price, revenue. Default: occupancy.

  • Name
    category
    Type
    string
    Description

    Airbnb category type: flat, house, apartment, loft.

  • Name
    beds
    Type
    integer
    Description

    0 to 4 bedrooms value.

Request

GET
/v1.1/client/neighborhood/{id}/historical/airbnb
curl -G "https://api.mashvisor.com/v1.1/client/neighborhood/268201/historical/airbnb" \
  -d "state=CA" \
  -d "average_by=revenue" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "results": [
      {
        "year": 2025,
        "month": 12,
        "value": 16
      },
      {
        "year": 2025,
        "month": 11,
        "value": 28
      },
      {
        "year": 2025,
        "month": 10,
        "value": 35
      },
      {
        "year": 2025,
        "month": 9,
        "value": 46
      },
      {
        "year": 2025,
        "month": 8,
        "value": 61
      },
      {
        "year": 2025,
        "month": 7,
        "value": 42
      },
      {
        "year": 2025,
        "month": 6,
        "value": 18
      },
      {
        "year": 2025,
        "month": 5,
        "value": 20
      },
      {
        "year": 2025,
        "month": 4,
        "value": 31
      },
      {
        "year": 2025,
        "month": 3,
        "value": 47
      },
      {
        "year": 2025,
        "month": 2,
        "value": 44
      },
      {
        "year": 2025,
        "month": 1,
        "value": 48
      }
    ]
  },
  "message": "Historical Data fetched successfully"
}

GET/v1.1/client/airbnb-property/{id}/projections

Airbnb Listing Occupancy and Revenue Projections

This endpoint retrieves Airbnb listing's occupancy and revenue projections.

Path parameters

  • Name
    id
    Type
    long
    Description

    Property ID to fetch data for.

Query parameters

  • Name
    state
    Type
    string
    Description

    State. Required. API returns 404 if omitted.

Request

GET
/v1.1/client/airbnb-property/{id}/projections
curl -G "https://api.mashvisor.com/v1.1/client/airbnb-property/16871799/projections?state=GA" \
  -H "x-api-key: YOUR_API_KEY"

Response

      {
          "status": "success",
          "content": {
          "airbnb_listing_id": "16871799",
          "annual": {
          "occ": {
          "occ_floor": 0,
          "occ_lower_estimate": 0,
          "occ_estimate": 0,
          "occ_upper_estimate": 0,
          "occ_ceil": 0.9014
      },
          "revenue": {
          "revenue_floor": 0,
          "revenue_lower_estimate": 0,
          "revenue_estimate": 0,
          "revenue_upper_estimate": 0,
          "revenue_ceil": 57857
      },
          "booked_days": {
          "booked_days_lower_estimate": 42,
          "booked_days_estimate": 61,
          "booked_days_upper_estimate": 61
      },
          "avg_price": {
          "avg_price_lower_estimate": 169,
          "avg_price_estimate": 169,
          "avg_price_upper_estimate": 169
      },
          "unbooked_days": {
          "unbooked_days_estimate": 36
      },
          "months_with_bookings": 12
      },
          "monthly": [
      {
          "2023-05": {
          "occ": {
          "occ_floor": 0,
          "occ_lower_estimate": 0,
          "occ_estimate": 0,
          "occ_upper_estimate": 0,
          "occ_ceil": 0.7667
      },
          "revenue": {
          "revenue_floor": 0,
          "revenue_lower_estimate": 0,
          "revenue_estimate": 0,
          "revenue_upper_estimate": 0,
          "revenue_ceil": 4027
      },
          "booked_days": {
          "booked_days_lower_estimate": 0,
          "booked_days_estimate": 0,
          "booked_days_upper_estimate": 0
      },
          "avg_price": {
          "avg_price_lower_estimate": 169,
          "avg_price_estimate": 169,
          "avg_price_upper_estimate": 169
      },
          "unbooked_days": {
          "unbooked_days_estimate": 7
      }
      }
      },
      {
          "2023-06": {
          "occ": {
          "occ_floor": 0,
          "occ_lower_estimate": 0,
          "occ_estimate": 0,
          "occ_upper_estimate": 0,
          "occ_ceil": 1
      },
          "revenue": {
          "revenue_floor": 0,
          "revenue_lower_estimate": 0,
          "revenue_estimate": 0,
          "revenue_upper_estimate": 0,
          "revenue_ceil": 5230
      },
          "booked_days": {
          "booked_days_lower_estimate": 0,
          "booked_days_estimate": 0,
          "booked_days_upper_estimate": 0
      },
          "avg_price": {
          "avg_price_lower_estimate": 169,
          "avg_price_estimate": 169,
          "avg_price_upper_estimate": 169
      },
          "unbooked_days": {
          "unbooked_days_estimate": 0
      }
      }
      },
      {
          "2023-07": {
          "occ": {
          "occ_floor": 0,
          "occ_lower_estimate": 0,
          "occ_estimate": 0,
          "occ_upper_estimate": 0,
          "occ_ceil": 0.8
      },
          "revenue": {
          "revenue_floor": 0,
          "revenue_lower_estimate": 0,
          "revenue_estimate": 0,
          "revenue_upper_estimate": 0,
          "revenue_ceil": 4366
      },
          "booked_days": {
          "booked_days_lower_estimate": 0,
          "booked_days_estimate": 0,
          "booked_days_upper_estimate": 0
      },
          "avg_price": {
          "avg_price_lower_estimate": 169,
          "avg_price_estimate": 169,
          "avg_price_upper_estimate": 169
      },
          "unbooked_days": {
          "unbooked_days_estimate": 6
      }
      }
      },
      {
          "2023-08": {
          "occ": {
          "occ_floor": 0,
          "occ_lower_estimate": 0,
          "occ_estimate": 0,
          "occ_upper_estimate": 0,
          "occ_ceil": 1
      },
          "revenue": {
          "revenue_floor": 0,
          "revenue_lower_estimate": 0,
          "revenue_estimate": 0,
          "revenue_upper_estimate": 0,
          "revenue_ceil": 5230
      },
          "booked_days": {
          "booked_days_lower_estimate": 0,
          "booked_days_estimate": 0,
          "booked_days_upper_estimate": 0
      },
          "avg_price": {
          "avg_price_lower_estimate": 169,
          "avg_price_estimate": 169,
          "avg_price_upper_estimate": 169
      },
          "unbooked_days": {
          "unbooked_days_estimate": 0
      }
      }
      },
      {
          "2023-09": {
          "occ": {
          "occ_floor": 0,
          "occ_lower_estimate": 0,
          "occ_estimate": 0.5,
          "occ_upper_estimate": 1,
          "occ_ceil": 1
      },
          "revenue": {
          "revenue_floor": 0,
          "revenue_lower_estimate": 0,
          "revenue_estimate": 960,
          "revenue_upper_estimate": 2898,
          "revenue_ceil": 5230
      },
          "booked_days": {
          "booked_days_lower_estimate": 0,
          "booked_days_estimate": 10,
          "booked_days_upper_estimate": 16
      },
          "avg_price": {
          "avg_price_lower_estimate": 169,
          "avg_price_estimate": 174,
          "avg_price_upper_estimate": 175
      },
          "unbooked_days": {
          "unbooked_days_estimate": 0
      }
      }
      },
      {
          "2023-10": {
          "occ": {
          "occ_floor": 0,
          "occ_lower_estimate": 0,
          "occ_estimate": 0,
          "occ_upper_estimate": 0,
          "occ_ceil": 1
      },
          "revenue": {
          "revenue_floor": 0,
          "revenue_lower_estimate": 0,
          "revenue_estimate": 0,
          "revenue_upper_estimate": 0,
          "revenue_ceil": 5430
      },
          "booked_days": {
          "booked_days_lower_estimate": 0,
          "booked_days_estimate": 0,
          "booked_days_upper_estimate": 7
      },
          "avg_price": {
          "avg_price_lower_estimate": 169,
          "avg_price_estimate": 172,
          "avg_price_upper_estimate": 173
      },
          "unbooked_days": {
          "unbooked_days_estimate": 0
      }
      }
      },
      {
          "2023-11": {
          "occ": {
          "occ_floor": 0,
          "occ_lower_estimate": 0,
          "occ_estimate": 0,
          "occ_upper_estimate": 0,
          "occ_ceil": 1
      },
          "revenue": {
          "revenue_floor": 0,
          "revenue_lower_estimate": 0,
          "revenue_estimate": 0,
          "revenue_upper_estimate": 0,
          "revenue_ceil": 5515
      },
          "booked_days": {
          "booked_days_lower_estimate": 0,
          "booked_days_estimate": 0,
          "booked_days_upper_estimate": 0
      },
          "avg_price": {
          "avg_price_lower_estimate": 169,
          "avg_price_estimate": 169,
          "avg_price_upper_estimate": 169
      },
          "unbooked_days": {
          "unbooked_days_estimate": 0
      }
      }
      },
      {
          "2023-12": {
          "occ": {
          "occ_floor": 0,
          "occ_lower_estimate": 0,
          "occ_estimate": 0.6818,
          "occ_upper_estimate": 0.7407,
          "occ_ceil": 0.7667
      },
          "revenue": {
          "revenue_floor": 0,
          "revenue_lower_estimate": 0,
          "revenue_estimate": 2535,
          "revenue_upper_estimate": 2704,
          "revenue_ceil": 3887
      },
          "booked_days": {
          "booked_days_lower_estimate": 2,
          "booked_days_estimate": 15,
          "booked_days_upper_estimate": 16
      },
          "avg_price": {
          "avg_price_lower_estimate": 169,
          "avg_price_estimate": 169,
          "avg_price_upper_estimate": 169
      },
          "unbooked_days": {
          "unbooked_days_estimate": 7
      }
      }
      },
      {
          "2024-01": {
          "occ": {
          "occ_floor": 0,
          "occ_lower_estimate": 0.9048,
          "occ_estimate": 0.9048,
          "occ_upper_estimate": 0.9091,
          "occ_ceil": 0.9333
      },
          "revenue": {
          "revenue_floor": 0,
          "revenue_lower_estimate": 3211,
          "revenue_estimate": 3211,
          "revenue_upper_estimate": 3549,
          "revenue_ceil": 4732
      },
          "booked_days": {
          "booked_days_lower_estimate": 19,
          "booked_days_estimate": 19,
          "booked_days_upper_estimate": 21
      },
          "avg_price": {
          "avg_price_lower_estimate": 169,
          "avg_price_estimate": 169,
          "avg_price_upper_estimate": 169
      },
          "unbooked_days": {
          "unbooked_days_estimate": 2
      }
      }
      },
      {
          "2024-02": {
          "occ": {
          "occ_floor": 0,
          "occ_lower_estimate": 0,
          "occ_estimate": 0,
          "occ_upper_estimate": 0.6667,
          "occ_ceil": 0.8
      },
          "revenue": {
          "revenue_floor": 0,
          "revenue_lower_estimate": 0,
          "revenue_estimate": 0,
          "revenue_upper_estimate": 2028,
          "revenue_ceil": 4056
      },
          "booked_days": {
          "booked_days_lower_estimate": 6,
          "booked_days_estimate": 6,
          "booked_days_upper_estimate": 12
      },
          "avg_price": {
          "avg_price_lower_estimate": 169,
          "avg_price_estimate": 169,
          "avg_price_upper_estimate": 169
      },
          "unbooked_days": {
          "unbooked_days_estimate": 6
      }
      }
      },
      {
          "2024-03": {
          "occ": {
          "occ_floor": 0,
          "occ_lower_estimate": 1,
          "occ_estimate": 1,
          "occ_upper_estimate": 1,
          "occ_ceil": 1
      },
          "revenue": {
          "revenue_floor": 0,
          "revenue_lower_estimate": 3887,
          "revenue_estimate": 3887,
          "revenue_upper_estimate": 5070,
          "revenue_ceil": 5070
      },
          "booked_days": {
          "booked_days_lower_estimate": 23,
          "booked_days_estimate": 23,
          "booked_days_upper_estimate": 30
      },
          "avg_price": {
          "avg_price_lower_estimate": 169,
          "avg_price_estimate": 169,
          "avg_price_upper_estimate": 169
      },
          "unbooked_days": {
          "unbooked_days_estimate": 0
      }
      }
      },
      {
          "2024-04": {
          "occ": {
          "occ_floor": 0,
          "occ_lower_estimate": 0.9487,
          "occ_estimate": 0.9487,
          "occ_upper_estimate": 0.9487,
          "occ_ceil": 0.9667
      },
          "revenue": {
          "revenue_floor": 0,
          "revenue_lower_estimate": 3126,
          "revenue_estimate": 3126,
          "revenue_upper_estimate": 3126,
          "revenue_ceil": 4901
      },
          "booked_days": {
          "booked_days_lower_estimate": 18,
          "booked_days_estimate": 18,
          "booked_days_upper_estimate": 18
      },
          "avg_price": {
          "avg_price_lower_estimate": 169,
          "avg_price_estimate": 169,
          "avg_price_upper_estimate": 169
      },
          "unbooked_days": {
          "unbooked_days_estimate": 1
      }
      }
      },
      {
          "2024-05": {
          "occ": {
          "occ_floor": 0,
          "occ_lower_estimate": 0,
          "occ_estimate": 0,
          "occ_upper_estimate": 0,
          "occ_ceil": 1
      },
          "revenue": {
          "revenue_floor": 0,
          "revenue_lower_estimate": 0,
          "revenue_estimate": 0,
          "revenue_upper_estimate": 0,
          "revenue_ceil": 5070
      },
          "booked_days": {
          "booked_days_lower_estimate": 0,
          "booked_days_estimate": 0,
          "booked_days_upper_estimate": 0
      },
          "avg_price": {
          "avg_price_lower_estimate": 169,
          "avg_price_estimate": 169,
          "avg_price_upper_estimate": 169
      },
          "unbooked_days": {
          "unbooked_days_estimate": 0
      }
      }
      },
      {
          "2024-06": {
          "occ": {
          "occ_floor": 0,
          "occ_lower_estimate": 0,
          "occ_estimate": 0,
          "occ_upper_estimate": 0,
          "occ_ceil": 0.8333
      },
          "revenue": {
          "revenue_floor": 0,
          "revenue_lower_estimate": 0,
          "revenue_estimate": 0,
          "revenue_upper_estimate": 0,
          "revenue_ceil": 4225
      },
          "booked_days": {
          "booked_days_lower_estimate": 0,
          "booked_days_estimate": 0,
          "booked_days_upper_estimate": 4
      },
          "avg_price": {
          "avg_price_lower_estimate": 169,
          "avg_price_estimate": 169,
          "avg_price_upper_estimate": 169
      },
          "unbooked_days": {
          "unbooked_days_estimate": 5
      }
      }
      },
      {
          "2024-07": {
          "occ": {
          "occ_floor": 0,
          "occ_lower_estimate": 0,
          "occ_estimate": 0,
          "occ_upper_estimate": 0,
          "occ_ceil": 0.7333
      },
          "revenue": {
          "revenue_floor": 0,
          "revenue_lower_estimate": 0,
          "revenue_estimate": 0,
          "revenue_upper_estimate": 0,
          "revenue_ceil": 3718
      },
          "booked_days": {
          "booked_days_lower_estimate": 0,
          "booked_days_estimate": 0,
          "booked_days_upper_estimate": 0
      },
          "avg_price": {
          "avg_price_lower_estimate": 169,
          "avg_price_estimate": 169,
          "avg_price_upper_estimate": 169
      },
          "unbooked_days": {
          "unbooked_days_estimate": 8
      }
      }
      },
          ]
      }
}

GET/v1.1/client/airbnb-property/active-listings

Get Listings

Lists all active short-term rentals for a specific location: city, zip code, or neighborhood.

Query parameters

  • Name
    state
    Type
    string
    Description

    State. Required. API returns 404 if omitted.

  • Name
    country
    Type
    string
    Description

    Country ISO-3166 Alpha-2 code. Default: US.

  • Name
    city
    Type
    string
    Description

    City filter.

  • Name
    neighborhood
    Type
    long
    Description

    Neighborhood ID.

  • Name
    zip_code
    Type
    integer
    Description

    Postal zip code.

  • Name
    page
    Type
    integer
    Description

    Page number. Default: 1.

  • Name
    items
    Type
    integer
    Description

    Items per page. Default: 4.

Request

GET
/v1.1/client/airbnb-property/active-listings
curl -G "https://api.mashvisor.com/v1.1/client/airbnb-property/active-listings" \
  -d "state=CA" \
  -d "city=San Francisco" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "num_of_properties": 1011,
    "items": 4,
    "total_pages": 253,
    "page": 1,
    "properties": [
      {
        "id": 104884816,
        "property_id": "1001598884664966076",
        "host_id": "308816547",
        "source": "Airbnb",
        "status": "ACTIVE",
        "night_priceـnative": 319,
        "night_price": 285,
        "weekly_price": 0,
        "monthly_price": 0,
        "cleaning_fee_native": 200,
        "currency": null,
        "num_of_baths": 2,
        "num_of_rooms": 3,
        "occupancy": 16,
        "nights_booked": 58,
        "rental_income": 1378,
        "airbnb_neighborhood_id": 117447,
        "name": "Cozy 2nd Floor Home w/Adjustable Beds & Air Hockey",
        "description": "\"Relax and Unwind in our Private 2nd Floor House with Adjustable Beds, Air Hockey, and Smart Devices in Every Bedroom\"<br /><br /><b>The space</b><br />Very IMPORTANT: *****Please read carefully before you book*****<br /><br />\"Private Space on the Second Floor\"<br /><br />",
        "address": "San Francisco, California, United States",
        "airbnb_city": "San Francisco",
        "state": "CA",
        "capacity_of_people": 7,
        "zip": "94124",
        "property_type": "House",
        "room_type": "Entire home/apt",
        "room_type_category": "entire_home",
        "amenities": "1,4,8,9,137,521,522,139,145,657,146,23,665,30,415,671,33,34,35,36,37,39,40,41,44,45,46,47,51,52,308,57,185,77,79,85,86,89,90,91,92,93,94,95,96,97,611,103,236,251",
        "airbnb_neighborhood": "Silver Terrace",
        "reviews_count": 59,
        "start_rating": 4.79,
        "reviews": null,
        "created_at": "2025-12-04T04:12:53.000Z",
        "updated_at": "2025-12-04T04:12:53.000Z",
        "last_seen": "2025-11-10T13:45:04.000Z",
        "user_id": 308816547,
        "num_of_beds": 4,
        "lat": 37.7398,
        "lon": -122.4,
        "image": "https://a0.muscache.com/pictures/miso/Hosting-1001598884664966076/original/ee496d01-2b84-47c1-98d2-ae616363ac15.jpeg",
        "url": "https://www.airbnb.com/rooms/1001598884664966076",
        "airbnb_listing_id": "1001598884664966076",
        "estimation_model": "formula_based",
        "star_rating": 4.79,
        "neighborhood_zipcode": "94134"
      },
      {
        "id": 104885901,
        "property_id": "1002283155405615516",
        "host_id": "49665336",
        "source": "Airbnb",
        "status": "ACTIVE",
        "night_priceـnative": 314,
        "night_price": 216,
        "weekly_price": 0,
        "monthly_price": 0,
        "cleaning_fee_native": 120,
        "currency": null,
        "num_of_baths": 2,
        "num_of_rooms": 1,
        "occupancy": 6,
        "nights_booked": 19,
        "rental_income": 373,
        "airbnb_neighborhood_id": 117654,
        "name": "Luxury Golden Gate Park Getaway",
        "description": "Fully remodeled luxury suite near Golden Gate Park, Ocean Beach, Balboa & Lands End. Quiet, safe street with ample free parking. Walk to public transit, markets, and top-rated restaurants on Clement, Geary & Balboa. Features a serene master with walk-in closet & ensuite, spacious living room with plush sofa bed, and second full bath. Premium furniture, hotel-quality bedding, and stylish decor throughout. Perfect for comfort & convenience. No visitors allowed.<br /><br /><b>The space</b><br />Our space, fully remodeled in 2023 with the best materials, invites you to experience the epitome of luxury in San Francisco. Every detail has been meticulously curated, from the high-quality furnishings.<br /><br />The house is uniquely located on a street which offers plenty of street parking (very rare in San Francisco) so you almost never have to search for a parking.<br /><br />The bedroom, featuring a queen bed, a walk-in closet, and a private full bathroom. The spacious living room, equipped with a comfortable sofa bed, connects to a well-equipped kitchenette, and a second full bathroom. <br /><br />The unit provide a 55\" LG smart TV and Apple TV, providing access to all your streaming apps. Stay connected with lightning-fast WiFi (200Mbp+). The kitchenette has all the appliances you need for a short stay (cooktop, freezer, fridge, microwave, toaster). Additioanlly there is a Breville espresso machine, grinder and a regular coffee maker where you can enjoy freshly roasted coffee from several coffee shops around. Most appliances are high quality and brand new so you’re not dealing with old used tools/appliances you see in most places!<br /><br />The unit has direct access to the beautifully designed backyard (only a portion under the deck). The rest of the backyard, sauna, the deck and roof deck is not for guest use! For access to washer/dryer please contact me and we can arrange that for longer stays.<br /><br />Since this is a hosted visit, we kindly ask that guests do not invite outside visitors or host parties at the property. Thank you for your understanding and helping us maintain a peaceful and respectful environment.<br /><br /><b>Guest access</b><br />We provide self check in. The main entry, gate as well as the entry to the guest suite are all equipped with Yale smart lock.<br /><br /><b>Other things to note</b><br />I will provide a guidebook that should help you navigate around Richmond. I ‘m a big foodie and can share all about best restaurants and coffee shops around here (most are walking distance). There is a long list of great restaurants (Mexican, Italian, Japanese, Korean, Indian, Chinese, Moroccan, Turkish, etc)<br /><br /><br />Please check the house rules! No smoking or vaping of any kind on the premise. Please remove your shoes when in the house. The access to backyard is limited to the area under the deck (visible in the picture) and other parts of the house are not included! For access to washer/dryer please contact me and we can arrange that for longer stays (more than 3 days and one load every 3-4 days).<br /><br /><b>Registration Details</b><br />STR-0006182",
        "address": "San Francisco, California, United States",
        "airbnb_city": "San Francisco",
        "state": "CA",
        "capacity_of_people": 4,
        "zip": "94121",
        "property_type": "Guest suite",
        "room_type": "Entire home/apt",
        "room_type_category": "entire_home",
        "amenities": "1,4,8,137,77,79,657,146,23,89,665,90,93,30,94,671,33,34,98,35,36,100,40,41,236,45,46,47,51,52,308,61,510",
        "airbnb_neighborhood": null,
        "reviews_count": 52,
        "start_rating": 4.96,
        "reviews": null,
        "created_at": "2025-12-04T04:14:46.000Z",
        "updated_at": "2025-12-04T04:14:46.000Z",
        "last_seen": "2025-09-24T02:45:19.000Z",
        "user_id": 49665336,
        "num_of_beds": 2,
        "lat": 37.7782,
        "lon": -122.489,
        "image": "https://a0.muscache.com/pictures/airflow/Hosting-1002283155405615516/original/1ff22a7e-f866-452b-af9b-fb629d474c36.jpg",
        "url": "https://www.airbnb.com/rooms/1002283155405615516",
        "airbnb_listing_id": "1002283155405615516",
        "estimation_model": "formula_based",
        "star_rating": 4.96,
        "neighborhood_zipcode": "94121"
      },
      {
        "id": 104882680,
        "property_id": "1002454386536745431",
        "host_id": "541880661",
        "source": "Airbnb",
        "status": "ACTIVE",
        "night_priceـnative": 306,
        "night_price": 244,
        "weekly_price": 0,
        "monthly_price": 0,
        "cleaning_fee_native": 120,
        "currency": null,
        "num_of_baths": 2,
        "num_of_rooms": 3,
        "occupancy": 30,
        "nights_booked": 109,
        "rental_income": 2216,
        "airbnb_neighborhood_id": 115774,
        "name": "Fullmoon’s house",
        "description": "Welcome to views of the Pacific Ocean with this spacious 3 bed, 2 bath on second floor. Behind the modern facade, recessed lightings, plenty of natural light flows throughout the home's open airy layout with skylights. Near Stonestown, Trader Joe's and Whole Foods, and H-mart. Easy access to 280 Freeway, Bart and Muni Metro Lines. Nearby parks including the Merced Heights Playground, Minnie & Lovie Ward Recreational Center, Lake Merced Park and Harding Park Golf Course.<br /><br /><b>Registration Details</b><br />2023-008058STR",
        "address": "San Francisco, California, United States",
        "airbnb_city": "San Francisco",
        "state": "CA",
        "capacity_of_people": 5,
        "zip": "94132",
        "property_type": "House",
        "room_type": "Entire home/apt",
        "room_type_category": "entire_home",
        "amenities": "1,4,133,8,9,137,657,23,665,27,30,671,672,33,34,674,35,36,37,39,40,41,44,45,46,47,51,52,308,64,73,74,77,85,86,87,89,90,91,92,93,94,95,96,227,611,103,236,625,251",
        "airbnb_neighborhood": "Ingleside Terraces",
        "reviews_count": 126,
        "start_rating": 4.98,
        "reviews": null,
        "created_at": "2025-12-04T04:08:36.000Z",
        "updated_at": "2025-12-04T04:08:36.000Z",
        "last_seen": "2025-10-07T02:47:54.000Z",
        "user_id": 541880661,
        "num_of_beds": 3,
        "lat": 37.7169,
        "lon": -122.468,
        "image": "https://a0.muscache.com/pictures/miso/Hosting-1002454386536745431/original/f857e125-6958-4108-b401-4f535828a6c4.jpeg",
        "url": "https://www.airbnb.com/rooms/1002454386536745431",
        "airbnb_listing_id": "1002454386536745431",
        "estimation_model": "formula_based",
        "star_rating": 4.98,
        "neighborhood_zipcode": "94112"
      },
      {
        "id": 104891303,
        "property_id": "1005129877077277243",
        "host_id": "3259677",
        "source": "Airbnb",
        "status": "ACTIVE",
        "night_priceـnative": 259,
        "night_price": 224,
        "weekly_price": 0,
        "monthly_price": 0,
        "cleaning_fee_native": 100,
        "currency": null,
        "num_of_baths": 1,
        "num_of_rooms": 2,
        "occupancy": 41,
        "nights_booked": 136,
        "rental_income": 2769,
        "airbnb_neighborhood_id": 227971,
        "name": "Golden Gate Park Garden Apartment",
        "description": "Enjoy everything San Francisco has to offer when you make this cozy garden apartment your home base. Just steps from Golden Gate Park, stroll to the De Young museum, Japanese Tea Garden, Science Academy and neighborhood restaurants. With two bedrooms, two seating areas, a work station, kitchenette, and your own private garden, you'll have plenty of space to relax and settle in.<br /><br /><b>The space</b><br />This is a garden apartment, located in the lower level of a classic San Francisco Edwardian-era row house. Your hosts live in the space above and have created this welcoming space for you to enjoy! The unit features:<br /><br />-Two bedrooms, each with a double bed<br />-Bedroom one includes an en suite bathroom with walk-in shower (this is the only bathroom in the unit)<br />-A kitchenette with mini fridge, microwave, coffee maker, tea kettle, coffee bean grinder, toaster oven, and single burner induction cooktop<br />-Washer, dryer, and dishwasher<br />-Two seating areas; one includes a convertible sleeper sofa<br />-Private backyard accessible only by guests of this garden apartment<br /><br /><b>Guest access</b><br />Guests can enjoy the private backyard— featuring a basketball half court, garden, and seating area—all to themselves.<br /><br /><b>Other things to note</b><br />Please note that there are two bedrooms and one bathroom. The primary bedroom is an en suite, so the bathroom is accessed from within this bedroom. <br /><br />To access the unit, you'll enter a security code on a keypad that opens a door into the home's garage, go through the garage to reach the unit's private door, which will be left unlocked with a key hanging nearby.<br /><br /><b>Registration Details</b><br />2023-011479STR",
        "address": "San Francisco, California, United States",
        "airbnb_city": "San Francisco",
        "state": "CA",
        "capacity_of_people": 4,
        "zip": "94118",
        "property_type": "Apartment",
        "room_type": "Entire home/apt",
        "room_type_category": "entire_home",
        "amenities": "1,4,392,73,137,394,77,145,146,85,86,23,280,89,665,90,92,93,30,94,671,33,34,35,36,101,39,103,40,44,236,45,47,51,52,251,510",
        "airbnb_neighborhood": null,
        "reviews_count": 107,
        "start_rating": 4.95,
        "reviews": null,
        "created_at": "2025-12-04T04:24:57.000Z",
        "updated_at": "2025-12-04T04:24:57.000Z",
        "last_seen": "2025-09-24T02:45:19.000Z",
        "user_id": 3259677,
        "num_of_beds": 3,
        "lat": 37.7736,
        "lon": -122.468,
        "image": "https://a0.muscache.com/pictures/bb97e590-ddfe-46a5-84bb-a6bef6ff6c97.jpg",
        "url": "https://www.airbnb.com/rooms/1005129877077277243",
        "airbnb_listing_id": "1005129877077277243",
        "estimation_model": "formula_based",
        "star_rating": 4.95,
        "neighborhood_zipcode": "94118"
      }
    ]
  }
}

GET/v1.1/client/airbnb-property/market-summary

Market Summary

This endpoint retrieves a summary and overview for a specific location: city, zip code, or neighborhood.

Query parameters

  • Name
    state
    Type
    string
    Description

    State. Required. API returns 404 if omitted.

  • Name
    country
    Type
    string
    Description

    Country ISO-3166 Alpha-2 code. Default: US.

  • Name
    city
    Type
    string
    Description

    City filter.

  • Name
    neighborhood
    Type
    long
    Description

    Neighborhood ID.

  • Name
    zip_code
    Type
    integer
    Description

    Postal zip code.

Request

GET
/v1.1/client/airbnb-property/market-summary
curl -G "https://api.mashvisor.com/v1.1/client/airbnb-property/market-summary" \
  -d "state=CA" \
  -d "city=San Francisco" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "listings_count": 1011,
    "property_types": {
      "total_types": 1011,
      "histogram": [
        "Hotel",
        "Studio",
        "Apartment",
        "House",
        ...
      ]
    },
    "occupancy_histogram": {
      "average_occupancy": 25.882294757665676,
      "histogram": [
        57,
        50,
        43,
        21,
        33,
        30,
        49,
        54,
        59,
        ...
      ]
    },
    "night_price_histogram": {
      "average_price": 298.4451038575668,
      "histogram": [
        93,
        123,
        136,
        115,
        108,
        163,
        83,
        212,
        161,
        ...
      ]
    },
    "rental_income_histogram": {
      "average_rental_income": 2172.6191889218594,
      "histogram": [
        1581,
        1845,
        1768,
        ...
      ]
    },
    "listings_ids": [
      "2866061",
      "2866060",
      "400898",
      "89116",
      "1895875",
      "2504901",
      "1408554",
      "2278063",
      "837857",
      "1535663",
      ...
    ]
  }
}

GET/v1.1/client/market/amenity-performance

Amenities Performance

This endpoint retrieves amenities performance for a specific city-state

Query parameters

  • Name
    state
    Type
    string
    Description

    State. Required. API returns 404 if omitted.

  • Name
    city
    Type
    string
    Description

    City. Required. API returns 404 if omitted.

Request

GET
/v1.1/client/market/amenity-performance
curl -G "https://api.mashvisor.com/v1.1/client/market/amenity-performance?state=TX&city=Austin" \
-H "x-api-key: YOUR_API_KEY"

Response

{
    "status": "success",
    "content": {
    "market": {
    "state": "TX",
    "city": "Austin"
},
    "results": [
{
    "amenity_name": "Wide clearance to shower, toilet",
    "amenity_id": 126,
    "pct_high_occ_with": 2.3,
    "pct_all_with": 0.31,
    "lift_vs_market": 7.445,
    "avg_nightly_with": 226,
    "avg_nightly_high": 97,
    "avg_income_with": 2819,
    "avg_income_high": 2355
},
{
    "amenity_name": "Other pet(s)",
    "amenity_id": 20,
    "pct_high_occ_with": 1.15,
    "pct_all_with": 0.17,
    "lift_vs_market": 6.618,
    "avg_nightly_with": 119,
    "avg_nightly_high": 85,
    "avg_income_with": 1376,
    "avg_income_high": 1950
},
{
    "amenity_name": "DVD player",
    "amenity_id": 152,
    "pct_high_occ_with": 1.15,
    "pct_all_with": 0.17,
    "lift_vs_market": 6.618,
    "avg_nightly_with": 391,
    "avg_nightly_high": 241,
    "avg_income_with": 3107,
    "avg_income_high": 5563
},
{
    "amenity_name": "Accessible-height bed",
    "amenity_id": 118,
    "pct_high_occ_with": 2.3,
    "pct_all_with": 0.42,
    "lift_vs_market": 5.415,
    "avg_nightly_with": 353,
    "avg_nightly_high": 97,
    "avg_income_with": 2673,
    "avg_income_high": 2355
},
{
    "amenity_name": "Balcony",
    "amenity_id": 181,
    "pct_high_occ_with": 2.3,
    "pct_all_with": 0.48,
    "lift_vs_market": 4.765,
    "avg_nightly_with": 251,
    "avg_nightly_high": 97,
    "avg_income_with": 2215,
    "avg_income_high": 2355
}
    ]
},
    "message": "Amenity performance data fetched successfully"
}

GET/v1.1/client/airbnb-property/short-term-regulatory

Short-Term Regulations by City

Retrieve detailed short-term rental (STR) regulations for a specific city and state, including legal status, occupancy limits, permit requirements, and official rule sources. This endpoint helps property investors, managers, and platforms stay compliant with local Airbnb laws before listing a property.

Query parameters

  • Name
    state
    Type
    string
    Description

    State. Required. API returns 404 if omitted.

  • Name
    city
    Type
    string
    Description

    City. Required.

  • Name
    rating
    Type
    string
    Description

    Optional: Positive, Negative, Neutral, or Restricted.

Request

GET
/v1.1/client/airbnb-property/short-term-regulatory
curl -G "https://api.mashvisor.com/v1.1/client/airbnb-property/short-term-regulatory" \
  -d "state=CA" \
  -d "city=Los Angeles" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "list": [
      {
        "state": "California",
        "state_short": "CA",
        "city": "Los Angeles",
        "rating": "Negative",
        "rules_summary": "An accessory use of a Host’s Primary Residence for a maximum of 120 days in a calendar year for the purpose of providing Short-Term Rental in compliance with the registration and other requirements of Los Angeles Municipal Code Section 12.22 A 32.",
        "Legal_for_occupied": "No",
        "occupied_days_limit": "120",
        "permit_fee": "$89 (renews yearly)",
        "rules_source": "https://planning.lacity.org/plans-policies/initiatives-policies/home-sharing\r",
        "lat": 34.0522,
        "lng": -118.244
      }
    ]
  },
  "message": "Short Term Regulatory fetched successfully"
}

GET/v1.1/client/airbnb-property/occupancy-rates

Listing's Occupancy Rates

For each Airbnb/VRBO listing, we calculate its occupancy rate (month per month and annual rates), plus 12-month historical occupancy data.

Using our proprietary algorithms and data validation methods, we have solved the issue of 'blocked by host' vs 'booked' calendar and offer highly reliable and accurate occupancy data. Our algorithms account for seasonality, local market fluctuations and management of data outliers.

Query parameters

  • Name
    state
    Type
    string
    Description

    State. Required. API returns 404 if omitted.

  • Name
    country
    Type
    string
    Description

    Country ISO-3166 Alpha-2 code. Default: US.

  • Name
    city
    Type
    string
    Description

    City filter.

  • Name
    neighborhood
    Type
    long
    Description

    Neighborhood ID.

  • Name
    zip_code
    Type
    integer
    Description

    Postal zip code.

Request

GET
/v1.1/client/airbnb-property/occupancy-rates
curl -G "https://api.mashvisor.com/v1.1/client/airbnb-property/occupancy-rates" \
  -d "state=CA" \
  -d "city=San Francisco" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "occupancy_rates": {
      "studio": 60,
      "one_bedroom": 29,
      "two_bedrooms": 23,
      "three_bedrooms": 22,
      "four_bedrooms": 16
    },
    "sample_count": 1011,
    "detailed": {
      "studio_occupancies_histogram": [
        38,
        43,
        60,
        73,
        100
      ],
      "one_bedroom_histogram": [
        1,
        1,
        1,
        1,
        2,
        2,
        2,
        2,
        2,
        3,
        3,
        3,
        3,
        4,
        4,
        ...
      ],
      "two_bedrooms_histogram": [
        1,
        1,
        2,
        3,
        3,
        3,
        4,
        4,
        ...
      ],
      "three_bedrooms_histogram": [
        1,
        2,
        2,
        3,
        3,
        4,
        4,
        4,
        4,
        4,
        4,
        5,
        ...
      ],
      "four_bedrooms_histogram": [
        3,
        4,
        5,
        5,
        5,
        6,
        6,
        6,
        7,
        8,
        ...
      ]
    }
  }
}

GET/v1.1/client/airbnb-property/property-types

Get Property Types

Returns available Airbnb property types for a location (e.g. Apartment, House, Condo, Villa, Tiny house, Serviced apartment, Bed and breakfast, and others).

Query parameters

  • Name
    state
    Type
    string
    Description

    State. Required. API returns 404 if omitted.

  • Name
    country
    Type
    string
    Description

    Country ISO-3166 Alpha-2 code. Default: US.

  • Name
    city
    Type
    string
    Description

    City filter.

  • Name
    neighborhood
    Type
    long
    Description

    Neighborhood ID.

  • Name
    zip_code
    Type
    integer
    Description

    Postal zip code.

Request

GET
/v1.1/client/airbnb-property/property-types
curl -G "https://api.mashvisor.com/v1.1/client/airbnb-property/property-types" \
  -d "state=CA" \
  -d "city=San Francisco" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "Apartment": 247,
    "Casa particular": 1,
    "Condo": 3,
    "Condominium": 95,
    "Entire bungalow": 2,
    "Entire cottage": 2,
    "Entire guesthouse": 17,
    "Entire serviced apartment": 2,
    "Entire townhouse": 10,
    "Entire vacation home": 1,
    "Guest house": 1,
    "Guest suite": 266,
    "Hotel": 5,
    "Hotel suite": 1,
    "House": 344,
    "Loft": 4,
    "Studio": 9,
    "Townhome": 1
  }
}

GET/v1.1/client/airbnb-property/super-hosts

Get Super Hosts

Obtains a list of an area's Airbnb super hosts for a zip code or a city.

Query parameters

  • Name
    state
    Type
    string
    Description

    State. Required. API returns 404 if omitted.

  • Name
    country
    Type
    string
    Description

    Country ISO-3166 Alpha-2 code. Default: US.

  • Name
    city
    Type
    string
    Description

    City filter.

  • Name
    zip_code
    Type
    integer
    Description

    Postal zip code.

Request

GET
/v1.1/client/airbnb-property/super-hosts
curl -G "https://api.mashvisor.com/v1.1/client/airbnb-property/super-hosts" \
  -d "state=CA" \
  -d "city=San Francisco" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "items_per_page": 10,
    "page": 1,
    "total_pages": 828,
    "total_items": 8274,
    "super_hosts": [
      {
        "id": 6018001,
        "first_name": "Hannah",
        "picture_url": "https://a1.muscache.com/ac/users/6018001/profile_pic/1383670797/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=225:*&output-format=jpg&output-quality=70",
        "thumbnail_url": "https://a1.muscache.com/ac/users/6018001/profile_pic/1383670797/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=50:*&output-format=jpg&output-quality=70",
        "has_profile_pic": true,
        "created_at": "2013-04-21T05:22:20Z",
        "reviewee_count": 19,
        "recommendation_count": 2,
        "last_name": "",
        "thumbnail_medium_url": "https://a1.muscache.com/ac/users/6018001/profile_pic/1383670797/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=68:*&output-format=jpg&output-quality=70",
        "picture_large_url": "https://a1.muscache.com/ac/users/6018001/profile_pic/1383670797/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=640:*&output-format=jpg&output-quality=70",
        "response_time": "within an hour",
        "response_rate": "100%",
        "acceptance_rate": "95%",
        "wishlists_count": 3,
        "publicly_visible_wishlists_count": 0,
        "is_superhost": true,
        "identity_verified": false,
        "neighborhood": "Noe Valley",
        "verifications": [
          "email",
          "phone",
          "reviews"
        ],
        "verification_labels": [
          "Email Address",
          "Phone Number",
          "Reviewed"
        ],
        "location": "San Francisco, California, United States",
        "is_generated_user": false,
        "about": "The best summary of myself is that I'm an old soul who's young at heart. \r\n\r\nAfter 4 years of office work, I quit to do freelance copywriting and editing so I'd have more time to pursue my artistic passions -- jewelry making and illustration. \r\n\r\nI've lived abroad twice, once in Paris and once in London, and I try to travel outside the country every year. When at home in the lovely city of San Francisco, I'm often seeing biking around the neighborhood, singing karaoke, or hiking on one of the beautiful travels just outside the city.",
        "school": "",
        "work": "",
        "groups": "",
        "listings_count": 2,
        "total_listings_count": 2,
        "friends_count": 2,
        "recent_review": {
          "review": {
            "id": 39346783,
            "reviewer_id": 38182096,
            "reviewee_id": 6018001,
            "created_at": "2015-07-22T15:44:02Z",
            "reviewer": {
              "user": {
                "id": 38182096,
                "first_name": "Misha",
                "picture_url": "https://a0.muscache.com/ac/users/38182096/profile_pic/1436726136/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=225:*&output-format=jpg&output-quality=70",
                "thumbnail_url": "https://a0.muscache.com/ac/users/38182096/profile_pic/1436726136/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=50:*&output-format=jpg&output-quality=70",
                "has_profile_pic": true
              }
            },
            "comments": "Hannah is the perfect host. Laid-back yet professional. We felt privileged staying with her and by the end as though we were leaving an old friend's place.",
            "listing_id": 4887782,
            "reviewee": {
              "user": {
                "id": 6018001,
                "first_name": "Hannah",
                "picture_url": "https://a1.muscache.com/ac/users/6018001/profile_pic/1383670797/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=225:*&output-format=jpg&output-quality=70",
                "thumbnail_url": "https://a1.muscache.com/ac/users/6018001/profile_pic/1383670797/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=50:*&output-format=jpg&output-quality=70",
                "has_profile_pic": true
              }
            },
            "listing": {
              "listing": {
                "id": 4887782,
                "city": "San Francisco",
                "thumbnail_url": "https://a0.muscache.com/ac/pictures/61301000/9cfa929c_original.jpg?interpolation=lanczos-none&size=small&output-format=jpg&output-quality=70",
                "medium_url": "https://a0.muscache.com/ac/pictures/61301000/9cfa929c_original.jpg?interpolation=lanczos-none&size=medium&output-format=jpg&output-quality=70",
                "user_id": 6018001,
                "picture_url": "https://a0.muscache.com/ac/pictures/61301000/9cfa929c_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70",
                "xl_picture_url": "https://a0.muscache.com/ac/pictures/61301000/9cfa929c_original.jpg?interpolation=lanczos-none&size=x_large_cover&output-format=jpg&output-quality=70",
                "price": 115,
                "native_currency": "EUR",
                "price_native": 108,
                "price_formatted": "€108",
                "lat": 37.74740659651842,
                "lng": -122.421827960416,
                "country": "United States",
                "name": "ROOM #2- A Mediterranean Getaway ",
                "smart_location": "San Francisco, CA",
                "has_double_blind_reviews": false,
                "instant_bookable": false
              }
            }
          }
        },
        "recent_recommendation": {
          "recommendation": {
            "id": 244252,
            "created_at": "2013-11-08T10:48:19Z",
            "user_id": 6018001,
            "recommendation": "Hannah is an amazing tour de force of creativity and energy. She is extremely sociable, very considerate and a great host. A treat to meet!",
            "left_by_user": {
              "user": {
                "id": 2314203,
                "first_name": "Jan",
                "picture_url": "https://a0.muscache.com/ac/users/2314203/profile_pic/1336774285/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=225:*&output-format=jpg&output-quality=70",
                "thumbnail_url": "https://a0.muscache.com/ac/users/2314203/profile_pic/1336774285/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=50:*&output-format=jpg&output-quality=70",
                "has_profile_pic": true,
                "created_at": "2012-05-07T19:01:20Z",
                "reviewee_count": 13,
                "recommendation_count": 0,
                "last_name": "",
                "thumbnail_medium_url": "https://a0.muscache.com/ac/users/2314203/profile_pic/1336774285/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=68:*&output-format=jpg&output-quality=70",
                "picture_large_url": "https://a0.muscache.com/ac/users/2314203/profile_pic/1336774285/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=640:*&output-format=jpg&output-quality=70",
                "response_time": "N/A",
                "response_rate": "N/A",
                "acceptance_rate": "N/A",
                "wishlists_count": 4,
                "publicly_visible_wishlists_count": 1,
                "is_superhost": false
              }
            },
            "relationship_type": "friend",
            "relationship_type_text": "Friend"
          }
        }
      },
      {
        "id": 23278,
        "first_name": "Zain And Duncan",
        "picture_url": "https://a0.muscache.com/ac/users/23278/profile_pic/1422513326/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=225:*&output-format=jpg&output-quality=70",
        "thumbnail_url": "https://a0.muscache.com/ac/users/23278/profile_pic/1422513326/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=50:*&output-format=jpg&output-quality=70",
        "has_profile_pic": true,
        "created_at": "2009-06-26T01:35:05Z",
        "reviewee_count": 148,
        "recommendation_count": 1,
        "last_name": "",
        "thumbnail_medium_url": "https://a0.muscache.com/ac/users/23278/profile_pic/1422513326/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=68:*&output-format=jpg&output-quality=70",
        "picture_large_url": "https://a0.muscache.com/ac/users/23278/profile_pic/1422513326/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=640:*&output-format=jpg&output-quality=70",
        "response_time": "within a few hours",
        "response_rate": "94%",
        "acceptance_rate": "100%",
        "wishlists_count": 7,
        "publicly_visible_wishlists_count": 4,
        "is_superhost": true,
        "identity_verified": true,
        "neighborhood": "Mission District",
        "verifications": [
          "email",
          "phone",
          "facebook",
          "reviews",
          "kba"
        ],
        "verification_labels": [
          "Email Address",
          "Phone Number",
          "Facebook",
          "Reviewed",
          "Offline ID"
        ],
        "location": "San Francisco, California, United States",
        "is_generated_user": false,
        "about": "My name is Zain and I'm a nerd. By day, I write code at a small startup in San Francisco, CA. By night... well, actually, I code at night too. But I got an email from a Nigerian prince the other day, so I have that going for me.\r\n\r\nMy roommate Duncan is an ENTP, just like me. He's one of the friendliest people I've ever met -- like when you're in a bar and you turn around for a second, he'll have made a new friend.",
        "school": "Purdue University",
        "work": "Coder",
        "groups": "",
        "listings_count": 6,
        "total_listings_count": 6,
        "friends_count": 0,
        "recent_review": {
          "review": {
            "id": 41631539,
            "reviewer_id": 37264011,
            "reviewee_id": 23278,
            "created_at": "2015-08-08T14:32:42Z",
            "reviewer": {
              "user": {
                "id": 37264011,
                "first_name": "Anna",
                "picture_url": "https://a0.muscache.com/ac/users/37264011/profile_pic/1435787821/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=225:*&output-format=jpg&output-quality=70",
                "thumbnail_url": "https://a0.muscache.com/ac/users/37264011/profile_pic/1435787821/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=50:*&output-format=jpg&output-quality=70",
                "has_profile_pic": true
              }
            },
            "comments": "This place is excellently exceptional! Duncan and Zain were very welcoming and helpful with suggestions. The house had everything you needed and was clean. I felt completely chilled staying here. Roux the dog was lovely as well. Would recommend this place to everyone I know visiting San Francisco wanting to see the non touristy side.",
            "listing_id": 5299461,
            "reviewee": {
              "user": {
                "id": 23278,
                "first_name": "Zain And Duncan",
                "picture_url": "https://a0.muscache.com/ac/users/23278/profile_pic/1422513326/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=225:*&output-format=jpg&output-quality=70",
                "thumbnail_url": "https://a0.muscache.com/ac/users/23278/profile_pic/1422513326/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=50:*&output-format=jpg&output-quality=70",
                "has_profile_pic": true
              }
            },
            "listing": {
              "listing": {
                "id": 5299461,
                "city": "San Francisco",
                "thumbnail_url": "https://a1.muscache.com/ac/pictures/69646425/752f073f_original.jpg?interpolation=lanczos-none&size=small&output-format=jpg&output-quality=70",
                "medium_url": "https://a1.muscache.com/ac/pictures/69646425/752f073f_original.jpg?interpolation=lanczos-none&size=medium&output-format=jpg&output-quality=70",
                "user_id": 23278,
                "picture_url": "https://a1.muscache.com/ac/pictures/69646425/752f073f_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70",
                "xl_picture_url": "https://a1.muscache.com/ac/pictures/69646425/752f073f_original.jpg?interpolation=lanczos-none&size=x_large_cover&output-format=jpg&output-quality=70",
                "price": 49,
                "native_currency": "EUR",
                "price_native": 46,
                "price_formatted": "€46",
                "lat": 37.75861793523278,
                "lng": -122.4131771000983,
                "country": "United States",
                "name": "Bunk bed in Treat Street Clubhouse",
                "smart_location": "San Francisco, CA",
                "has_double_blind_reviews": false,
                "instant_bookable": true
              }
            }
          }
        }
      },
      {
        "id": 4903607,
        "first_name": "Doyle",
        "picture_url": "https://a2.muscache.com/ac/users/4903607/profile_pic/1359553850/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=225:*&output-format=jpg&output-quality=70",
        "thumbnail_url": "https://a2.muscache.com/ac/users/4903607/profile_pic/1359553850/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=50:*&output-format=jpg&output-quality=70",
        "has_profile_pic": true,
        "created_at": "2013-01-30T11:25:44Z",
        "reviewee_count": 64,
        "recommendation_count": 0,
        "last_name": "",
        "thumbnail_medium_url": "https://a2.muscache.com/ac/users/4903607/profile_pic/1359553850/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=68:*&output-format=jpg&output-quality=70",
        "picture_large_url": "https://a2.muscache.com/ac/users/4903607/profile_pic/1359553850/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=640:*&output-format=jpg&output-quality=70",
        "response_time": "within an hour",
        "response_rate": "100%",
        "acceptance_rate": "100%",
        "wishlists_count": 3,
        "publicly_visible_wishlists_count": 1,
        "is_superhost": true,
        "identity_verified": true,
        "neighborhood": "Cole Valley",
        "verifications": [
          "email",
          "phone",
          "facebook",
          "reviews",
          "kba"
        ],
        "verification_labels": [
          "Email Address",
          "Phone Number",
          "Facebook",
          "Reviewed",
          "Offline ID"
        ],
        "location": "San Francisco, California, United States",
        "is_generated_user": false,
        "about": "I'm a design professional & I travel a lot for work I enjoy fitness, the outdoors, eating out and spending time with my friends. ",
        "school": "",
        "work": "interior design professional",
        "groups": "",
        "listings_count": 1,
        "total_listings_count": 1,
        "friends_count": 0,
        "recent_review": {
          "review": {
            "id": 36653728,
            "reviewer_id": 8928455,
            "reviewee_id": 4903607,
            "created_at": "2015-06-30T11:20:18Z",
            "reviewer": {
              "user": {
                "id": 8928455,
                "first_name": "Charlotte",
                "picture_url": "https://a2.muscache.com/defaults/user_pic-225x225.png?v=2",
                "thumbnail_url": "https://a2.muscache.com/defaults/user_pic-50x50.png?v=2",
                "has_profile_pic": false
              }
            },
            "comments": "I haven't actually met Doyle but he was very quick in answering my inquiries. His place is perfectly located in SF and great to enjoy the city. ",
            "listing_id": 913508,
            "reviewee": {
              "user": {
                "id": 4903607,
                "first_name": "Doyle",
                "picture_url": "https://a2.muscache.com/ac/users/4903607/profile_pic/1359553850/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=225:*&output-format=jpg&output-quality=70",
                "thumbnail_url": "https://a2.muscache.com/ac/users/4903607/profile_pic/1359553850/original.jpg?interpolation=lanczos-none&crop=w:w;*,*&crop=h:h;*,*&resize=50:*&output-format=jpg&output-quality=70",
                "has_profile_pic": true
              }
            },
            "listing": {
              "listing": {
                "id": 913508,
                "city": "San Francisco",
                "thumbnail_url": "https://a2.muscache.com/ac/pictures/13386135/6d97468b_original.jpg?interpolation=lanczos-none&size=small&output-format=jpg&output-quality=70",
                "medium_url": "https://a2.muscache.com/ac/pictures/13386135/6d97468b_original.jpg?interpolation=lanczos-none&size=medium&output-format=jpg&output-quality=70",
                "user_id": 4903607,
                "picture_url": "https://a2.muscache.com/ac/pictures/13386135/6d97468b_original.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70",
                "xl_picture_url": "https://a2.muscache.com/ac/pictures/13386135/6d97468b_original.jpg?interpolation=lanczos-none&size=x_large_cover&output-format=jpg&output-quality=70",
                "price": 139,
                "native_currency": "EUR",
                "price_native": 131,
                "price_formatted": "€131",
                "lat": 37.76412760792781,
                "lng": -122.45310355310517,
                "country": "United States",
                "name": "Delightful Designer Digs ",
                "smart_location": "San Francisco, CA",
                "has_double_blind_reviews": false,
                "instant_bookable": false
              }
            }
          }
        }
      },
      ...
    ]
  }
}

GET/v1.1/client/airbnb-property/{id}/media

Get Airbnb Listing Media

Returns media (photos, etc.) for a specific Airbnb listing.

Path parameters

  • Name
    id
    Type
    long
    Description

    The Airbnb listing ID.

Query parameters

  • Name
    state
    Type
    string
    Description

    State. Required. API returns 400 if omitted.

Request

GET
/v1.1/client/airbnb-property/{id}/media
curl -G "https://api.mashvisor.com/v1.1/client/airbnb-property/22518616/media" \
  -d "state=AZ" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "_id": "5ac6ae8613790944288b4583",
    "picture_urls": [
      "https://a0.muscache.com/4ea/air/v2//pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?t=r:w1200-h720-sfit,e:fjpg-c85",
      "https://a0.muscache.com/4ea/air/v2//pictures/39f93922-3bb4-44aa-8ee0-ad52701dc706.jpg?t=r:w1200-h720-sfit,e:fjpg-c85",
      "https://a0.muscache.com/4ea/air/v2//pictures/bd0c4e30-7be1-4d40-8c64-c704986bc08e.jpg?t=r:w1200-h720-sfit,e:fjpg-c85"
    ],
    "thumbnail_urls": [
      "https://a0.muscache.com/im/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?aki_policy=small",
      "https://a0.muscache.com/im/pictures/39f93922-3bb4-44aa-8ee0-ad52701dc706.jpg?aki_policy=small",
      "https://a0.muscache.com/im/pictures/44006604-3e20-4138-9768-95ab71be94b0.jpg?aki_policy=small"
    ],
    "xl_picture_urls": [
      "https://a0.muscache.com/im/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?aki_policy=x_large",
      "https://a0.muscache.com/im/pictures/39f93922-3bb4-44aa-8ee0-ad52701dc706.jpg?aki_policy=x_large",
      "https://a0.muscache.com/im/pictures/44006604-3e20-4138-9768-95ab71be94b0.jpg?aki_policy=x_large"
    ],
    "picture_count": 42,
    "photos": [
      {
        "id": 529986300,
        "picture": "https://a0.muscache.com/im/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?aki_policy=large",
        "sort_order": 4,
        "caption": "",
        "large": "https://a0.muscache.com/im/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?aki_policy=large",
        "large_cover": "https://a0.muscache.com/ac/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70",
        "medium": "https://a0.muscache.com/im/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?aki_policy=medium",
        "mini_square": "https://a0.muscache.com/im/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?aki_policy=mini_square",
        "scrim_color": "#2C2328",
        "small": "https://a0.muscache.com/im/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?aki_policy=small",
        "thumbnail": "https://a0.muscache.com/im/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?aki_policy=small",
        "preview_encoded_png": "iVBORw0KGgoAAAANSUhEUgAAAAUAAAADCAIAAADUVFKvAAAAO0lEQVQIHQEwAM//AdLSz/b4/NbP0CYrKOvq5gHGxsfn5OHJw8QgJSMKCgUBj4uP3+jv7u/u8ernGRMO6KYdALXgvREAAAAASUVORK5CYII=",
        "x_large": "https://a0.muscache.com/im/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?aki_policy=x_large",
        "x_large_cover": "https://a0.muscache.com/ac/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?interpolation=lanczos-none&size=x_large_cover&output-format=jpg&output-quality=70",
        "x_medium": "https://a0.muscache.com/im/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?aki_policy=x_medium",
        "x_small": "https://a0.muscache.com/im/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?aki_policy=x_small",
        "xl_picture": "https://a0.muscache.com/im/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?aki_policy=x_large",
        "xx_large": "https://a0.muscache.com/im/pictures/81b62204-5602-49e9-83af-baf5a2477dcb.jpg?aki_policy=xx_large"
      },
      {
        "id": 529983381,
        "picture": "https://a0.muscache.com/im/pictures/39f93922-3bb4-44aa-8ee0-ad52701dc706.jpg?aki_policy=large",
        "sort_order": 5,
        "caption": "",
        "large": "https://a0.muscache.com/im/pictures/39f93922-3bb4-44aa-8ee0-ad52701dc706.jpg?aki_policy=large",
        "large_cover": "https://a0.muscache.com/ac/pictures/39f93922-3bb4-44aa-8ee0-ad52701dc706.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70",
        "medium": "https://a0.muscache.com/im/pictures/39f93922-3bb4-44aa-8ee0-ad52701dc706.jpg?aki_policy=medium",
        "mini_square": "https://a0.muscache.com/im/pictures/39f93922-3bb4-44aa-8ee0-ad52701dc706.jpg?aki_policy=mini_square",
        "scrim_color": "#1F1D20",
        "small": "https://a0.muscache.com/im/pictures/39f93922-3bb4-44aa-8ee0-ad52701dc706.jpg?aki_policy=small",
        "thumbnail": "https://a0.muscache.com/im/pictures/39f93922-3bb4-44aa-8ee0-ad52701dc706.jpg?aki_policy=small",
        "preview_encoded_png": "iVBORw0KGgoAAAANSUhEUgAAAAUAAAADCAIAAADUVFKvAAAAO0lEQVQIHQEwAM//AdDNyP78+cnJzDEyLyAgHQGcmJkNERXLyMUeHRhLS0QBXVpgPT0/5OHfAwH//f/7LggWnJ9/ILIAAAAASUVORK5CYII=",
        "x_large": "https://a0.muscache.com/im/pictures/39f93922-3bb4-44aa-8ee0-ad52701dc706.jpg?aki_policy=x_large",
        "x_large_cover": "https://a0.muscache.com/ac/pictures/39f93922-3bb4-44aa-8ee0-ad52701dc706.jpg?interpolation=lanczos-none&size=x_large_cover&output-format=jpg&output-quality=70",
        "x_medium": "https://a0.muscache.com/im/pictures/39f93922-3bb4-44aa-8ee0-ad52701dc706.jpg?aki_policy=x_medium",
        "x_small": "https://a0.muscache.com/im/pictures/39f93922-3bb4-44aa-8ee0-ad52701dc706.jpg?aki_policy=x_small",
        "xl_picture": "https://a0.muscache.com/im/pictures/39f93922-3bb4-44aa-8ee0-ad52701dc706.jpg?aki_policy=x_large",
        "xx_large": "https://a0.muscache.com/im/pictures/39f93922-3bb4-44aa-8ee0-ad52701dc706.jpg?aki_policy=xx_large"
      },
      {
        "id": 529986773,
        "picture": "https://a0.muscache.com/im/pictures/44006604-3e20-4138-9768-95ab71be94b0.jpg?aki_policy=large",
        "sort_order": 34,
        "caption": "",
        "large": "https://a0.muscache.com/im/pictures/44006604-3e20-4138-9768-95ab71be94b0.jpg?aki_policy=large",
        "large_cover": "https://a0.muscache.com/ac/pictures/44006604-3e20-4138-9768-95ab71be94b0.jpg?interpolation=lanczos-none&size=large_cover&output-format=jpg&output-quality=70",
        "medium": "https://a0.muscache.com/im/pictures/44006604-3e20-4138-9768-95ab71be94b0.jpg?aki_policy=medium",
        "mini_square": "https://a0.muscache.com/im/pictures/44006604-3e20-4138-9768-95ab71be94b0.jpg?aki_policy=mini_square",
        "scrim_color": "#120D11",
        "small": "https://a0.muscache.com/im/pictures/44006604-3e20-4138-9768-95ab71be94b0.jpg?aki_policy=small",
        "thumbnail": "https://a0.muscache.com/im/pictures/44006604-3e20-4138-9768-95ab71be94b0.jpg?aki_policy=small",
        "preview_encoded_png": "iVBORw0KGgoAAAANSUhEUgAAAAUAAAADCAIAAADUVFKvAAAAO0lEQVQIHQEwAM//Ac7HvgIB/v8CBLy9xUhHQwGagWcOIDXr8QHu6+b29vEBnIh76vgLtLW0DAcENTAhQHEXEbnVLgkAAAAASUVORK5CYII=",
        "x_large": "https://a0.muscache.com/im/pictures/44006604-3e20-4138-9768-95ab71be94b0.jpg?aki_policy=x_large",
        "x_large_cover": "https://a0.muscache.com/ac/pictures/44006604-3e20-4138-9768-95ab71be94b0.jpg?interpolation=lanczos-none&size=x_large_cover&output-format=jpg&output-quality=70",
        "x_medium": "https://a0.muscache.com/im/pictures/44006604-3e20-4138-9768-95ab71be94b0.jpg?aki_policy=x_medium",
        "x_small": "https://a0.muscache.com/im/pictures/44006604-3e20-4138-9768-95ab71be94b0.jpg?aki_policy=x_small",
        "xl_picture": "https://a0.muscache.com/im/pictures/44006604-3e20-4138-9768-95ab71be94b0.jpg?aki_policy=x_large",
        "xx_large": "https://a0.muscache.com/im/pictures/44006604-3e20-4138-9768-95ab71be94b0.jpg?aki_policy=xx_large"
      }
    ]
  }
}

GET/v1.1/client/airbnb-property/top-reviewed

Airbnb Top Reviewed Homes

This endpoint retrieves Airbnb top reviewed short-term rentals based on review quantity for a specific location: city, or a zip code.

Query parameters

  • Name
    state
    Type
    string
    Description

    State. Required. API returns 404 if omitted.

  • Name
    country
    Type
    string
    Description

    Country ISO-3166 Alpha-2 code. Default: US.

  • Name
    city
    Type
    string
    Description

    City filter.

  • Name
    neighborhood
    Type
    long
    Description

    Neighborhood ID.

  • Name
    zip_code
    Type
    integer
    Description

    Postal zip code.

  • Name
    page
    Type
    integer
    Description

    Page number. Default: 1.

  • Name
    items
    Type
    integer
    Description

    Items per page.

Request

GET
/v1.1/client/airbnb-property/top-reviewed
curl -G "https://api.mashvisor.com/v1.1/client/airbnb-property/top-reviewed" \
  -d "state=CA" \
  -d "city=San Francisco" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
    "status": "success",
    "content": {
        "items_per_page": 10,
        "page": 1,
        "reviews_count_limit": 30,
        "total_pages": 2,
        "total_items": 11,
        "list": [
            {
                "propertyTimezone": "America/Los_Angeles",
                "address": {
                    "city": "Burbank",
                    "country": "US",
                    "postalCode": "91506",
                    "stateProvince": "CA"
                },
                "availabilityUpdated": "2023-07-27",
                "averageRating": 4.9006624,
                "bedrooms": 0,
                "canonicalLink": "https://www.vrbo.com/635249",
                "description": "The Space\n\nA short 13 minute walk from beautiful downtown Burbank, the Burbank Sanctuary is a well-appointed and comfortable studio apartment with an elegant boutique touch. Enjoy luxury bedding, abundant amenities, 42\" flat screen and full kitchen. Experience five diamond standards with at home comfort, privacy and security.  An ALDI supermarket is at the other end of the street.\n\nThe Burbank Sanctuary is a downstairs apartment. While the vast majority of our guests love the apartment, it's not for very light sleepers.\n\nRelaxation and comfort will come easy during your stay with us. Your experience includes queen-size luxury bedding, unlimited hot showers, free wifi and digital 55\" smart widescreen with Netflix, Amazon, Hulu and Pandora. There is no local TV.\n\nYou will also have a full size kitchen at your fingertips with all the cooking comforts you could wish for. A full size fridge, unlimited ice, soap, shampoo and towels are among the many delightful amenities available during your stay at the Burbank Sanctuary.\n\nEnjoy accommodations and VIP treatment of a boutique hotel with at home comfort, privacy and security.\n\nThe building is a charming and cozy 5-unit apartment residence. There is a secluded side-entrance for maximum privacy and home-like comfort.\n\nGuest Access\n\nAmple unrestricted street parking is available, no permits or pesky meter feeding required. Driveway parking is reserved for our permanent residents. Everything is digital, no keys to weigh you down during your time out and about. I set a new code for each guest which assures total privacy and security during your stay.\n\nInteraction with Guests\n\nDepending upon the time of year, Self check-in is available or you may meet and greet with your host, sharing tips and information about the apartment and local area. \n\nThe Neighborhood \n\nI love the Magnolia Park area of Burbank. This property sits next to the Chandler bike path and is walking distance from the downtown Burbank area. There's convenient food, markets and plenty of shopping nearby.\n\nGetting Around\n\nI always recommend rideshares such as Uber or Lyft, but public transportation is equally within reach.\n\nOther Things to Note\n\nI have been in the hospitality industry since 2005. I owned and operated two hotels and I have traveled extensively. My sensibilities are for the traveler and the amenities included in your stay meet my high standards for quality hotel accommodations. In addition, the Burbank Sanctuary offers the fastest and most reliable internet available in the city.\n\nHouse Rules \n\nI cater to the nonsmoker without pets. Smoking is not permitted inside the apartment nor on the property. Our other tenants dislike the aroma. We love small non-human friends, but unfortunately they are not allowed at the property. We observe quiet time from 10pm to 8am and kindly request that you do the same by turning down your music or television during these times.",
                "detailPageUrl": "/635249?unitId=1183030&childrenCount=0&noDates=true",
                "featuredAmenities": [
                    "INTERNET",
                    "AIR_CONDITIONING",
                    "TV",
                    "CABLE",
                    "PARKING",
                    "NO_SMOKING",
                    "HEATER"
                ],
                "firstLiveInLastThirtyDays": false,
                "geoCode": {
                    "exact": true,
                    "latitude": 34.177985,
                    "longitude": -118.320758
                },
                "geography": {
                    "description": "Burbank, Los Angeles County, California, United States of America",
                    "ids": [
                        {
                            "type": "LBS",
                            "value": "3b66d3bc-445d-4a3e-a623-8a4417745d1d"
                        }
                    ],
                    "name": "Burbank",
                    "relatedGeographies": null,
                    "types": [
                        "locality"
                    ],
                    "location": {
                        "lat": 34.18084,
                        "lng": -118.308968
                    }
                },
                "propertyManagerProfile": null,
                "headline": "The Sanctuary - Be Pampered - Full Kitchen",
                "houseRules": {
                    "children": {
                        "label": "Children not allowed",
                        "note": null,
                        "allowed": false
                    },
                    "events": {
                        "label": "No events",
                        "note": null,
                        "allowed": false
                    },
                    "smoking": {
                        "label": "No smoking",
                        "note": null,
                        "allowed": false
                    },
                    "pets": {
                        "label": "No pets",
                        "note": null,
                        "allowed": false
                    },
                    "unitUrl": "/units/0004/6ad4b648-15a1-4694-b38c-255370e5e59a",
                    "checkInTime": "4:00 PM",
                    "checkOutTime": "11:00 AM",
                    "minimumAge": {
                        "label": "Minimum age of primary renter:",
                        "note": null,
                        "minimumAge": 18,
                        "displayText": "Minimum age to rent: 18"
                    },
                    "maxOccupancy": {
                        "adults": null,
                        "guests": 2,
                        "label": "Max guests:",
                        "maxAdultsLabel": null,
                        "note": null,
                        "displayText": "Maximum overnight guests: 2"
                    },
                    "standardRules": [
                        {
                            "key": "childrenRule",
                            "label": "Children not allowed",
                            "note": null
                        },
                        {
                            "key": "petsRule",
                            "label": "No pets",
                            "note": null
                        },
                        {
                            "key": "eventsRule",
                            "label": "No events",
                            "note": null
                        },
                        {
                            "key": "smokingRule",
                            "label": "No smoking",
                            "note": null
                        }
                    ],
                    "customRules": [],
                    "label": "House Rules",
                    "checkInRule": {
                        "label": "<strong>Check in</strong> after 4:00 PM",
                        "time": "4:00 PM"
                    },
                    "checkOutRule": {
                        "label": "<strong>Check out</strong> before 11:00 AM",
                        "time": "11:00 AM"
                    },
                    "childrenRule": {
                        "displayText": "No children allowed",
                        "allowed": false,
                        "childrenNotAllowedNote": null,
                        "note": null
                    },
                    "petsRule": {
                        "displayText": "No pets allowed",
                        "allowed": false,
                        "note": null
                    },
                    "eventsRule": {
                        "displayText": "No events allowed",
                        "allowed": false,
                        "maxEventAttendeesLabel": null,
                        "allowedEventsNote": null,
                        "note": null
                    },
                    "smokingRule": {
                        "displayText": "No smoking allowed",
                        "allowed": false,
                        "outside": null,
                        "inside": null,
                        "note": null
                    }
                },
                "cancellationPolicy": {
                    "cancellationPolicyPeriods": [
                        {
                            "label": "<strong>100% refund of amount paid</strong> if you cancel at least 30 days before check-in."
                        },
                        {
                            "label": "<strong>50% refund of amount paid</strong> (minus the service fee) if you cancel at least 14 days before check-in."
                        },
                        {
                            "label": "<strong>No refund</strong> if you cancel less than 14 days before check-in."
                        }
                    ],
                    "cancellationPolicyLabel": {
                        "label": "<strong>Free cancellation</strong> up to",
                        "date": "30 days before check-in",
                        "isFullRefundWindow": true
                    },
                    "cancellationTimelinePeriods": [
                        {
                            "timelineLabel": "30 days before check-in",
                            "refundPercent": 100,
                            "refundWindowLabel": "100% refund",
                            "shortDateLocalized": null,
                            "isPast": false,
                            "isActive": false,
                            "iconCode": null
                        },
                        {
                            "timelineLabel": "14 days before check-in",
                            "refundPercent": 50,
                            "refundWindowLabel": "50% refund",
                            "shortDateLocalized": null,
                            "isPast": false,
                            "isActive": false,
                            "iconCode": null
                        },
                        {
                            "timelineLabel": "Check in",
                            "refundPercent": 0,
                            "refundWindowLabel": "No refund",
                            "shortDateLocalized": null,
                            "isPast": false,
                            "isActive": false,
                            "iconCode": "KEY"
                        }
                    ],
                    "policyType": "MODERATE"
                },
                "instantBookable": false,
                "egratedPropertyManager": null,
                "platformPropertyManager": false,
                "ipmGuaranteedPricingActive": false,
                "isBasicListing": false,
                "isCrossSell": false,
                "isSubscription": false,
                "listingId": "321.635249.1183030",
                "listingNumber": 635249,
                "minStayRange": {
                    "minStayHigh": 30,
                    "minStayLow": 30
                },
                "multiUnitProperty": false,
                "onlineBookable": true,
                "ownerManaged": true,
                "ownersListingProfile": {
                    "aboutYou": "My sensibilities are for the traveler and the amenities meet my high standards for a quality hotel stay. I offer the fastest internet available in the city.",
                    "storyPhoto": null,
                    "uniqueBenefits": null,
                    "whyHere": null
                },
                "payPerBooking": true,
                "petsAllowed": false,
                "priceSummary": {
                    "amount": 165,
                    "currency": "USD",
                    "formattedAmount": "$165",
                    "pricePeriodDescription": "avg/night",
                    "currencySymbol": "$"
                },
                "propertyId": "635249",
                "id": "33505162",
                "propertyManagerMessaging": null,
                "propertyType": "Apartment",
                "propertyTypeKey": "apartment",
                "recentlyAdded": false,
                "registrationNumber": "",
                "reviewCount": 151,
                "sleeps": 2,
                "sleepsDisplay": "Sleeps 2",
                "spu": "vrbo-635249-1183030",
                "status": "AVAILABLE",
                "takesInquiries": true,
                "testListing": false,
                "thumbnailUrl": "https://media.vrbo.com/lodging/34000000/33510000/33505200/33505162/e73f620d.TREATMENT.jpg",
                "travelerFeeEligible": true,
                "videoUrls": [
                    "https://youtube.com/watch?v=GIiO5vRz-T8"
                ],
                "bathrooms": {
                    "full": 1,
                    "half": 0,
                    "toiletOnly": 0
                },
                "industryHealthAssociations": [],
                "regionalHealthGuidelines": [],
                "impressum": null,
                "allFeaturedAmenitiesRanked": [
                    "INTERNET",
                    "PETS",
                    "AIR_CONDITIONING",
                    "POOL",
                    "WHEELCHAIR",
                    "HEATER",
                    "FIREPLACE",
                    "CABLE",
                    "CHILDREN_WELCOME",
                    "WASHER_DRYER",
                    "HOT_TUB",
                    "PARKING",
                    "TV",
                    "NO_SMOKING"
                ],
                "created_at": "2023-08-31T12:00:07.676Z",
                "exists": true,
                "updated_at": "2023-09-11T17:16:58.661Z",
                "vrbo_id": "635249"
            },
            ...
        ]
    }
}

GET/v1.1/client/airbnb-property/top-reviewed-vrbo

Get VRBO Top Reviewed Homes

Retrieves VRBO top reviewed short-term rentals for a specific location (city or zip code).

Query parameters

  • Name
    state
    Type
    string
    Description

    State. Required. API returns 404 if omitted.

  • Name
    country
    Type
    string
    Description

    Country ISO-3166 Alpha-2 code. Default: US.

  • Name
    city
    Type
    string
    Description

    City filter.

  • Name
    neighborhood
    Type
    long
    Description

    Neighborhood ID.

  • Name
    zip_code
    Type
    integer
    Description

    Postal zip code.

  • Name
    page
    Type
    integer
    Description

    Page number. Default: 1.

  • Name
    items
    Type
    integer
    Description

    Items per page.

Request

GET
/v1.1/client/airbnb-property/top-reviewed-vrbo
curl -G "https://api.mashvisor.com/v1.1/client/airbnb-property/top-reviewed-vrbo" \
  -d "state=CA" \
  -d "city=Burbank" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "items_per_page": 10,
    "page": 1,
    "reviews_count_limit": 30,
    "total_pages": 2,
    "total_items": 11,
    "list": [
      {
        "propertyTimezone": "America/Los_Angeles",
        "address": {
          "city": "Burbank",
          "country": "US",
          "postalCode": "91506",
          "stateProvince": "CA"
        },
        "availabilityUpdated": "2023-07-27",
        "averageRating": 4.9006624,
        "bedrooms": 0,
        "canonicalLink": "https://www.vrbo.com/635249",
        "description": "The Space\n\nA short 13 minute walk from beautiful downtown Burbank, the Burbank Sanctuary is a well-appointed and comfortable studio apartment with an elegant boutique touch. Enjoy luxury bedding, abundant amenities, 42\" flat screen and full kitchen. Experience five diamond standards with at home comfort, privacy and security.  An ALDI supermarket is at the other end of the street.\n\nThe Burbank Sanctuary is a downstairs apartment. While the vast majority of our guests love the apartment, it's not for very light sleepers.\n\nRelaxation and comfort will come easy during your stay with us. Your experience includes queen-size luxury bedding, unlimited hot showers, free wifi and digital 55\" smart widescreen with Netflix, Amazon, Hulu and Pandora. There is no local TV.\n\nYou will also have a full size kitchen at your fingertips with all the cooking comforts you could wish for. A full size fridge, unlimited ice, soap, shampoo and towels are among the many delightful amenities available during your stay at the Burbank Sanctuary.\n\nEnjoy accommodations and VIP treatment of a boutique hotel with at home comfort, privacy and security.\n\nThe building is a charming and cozy 5-unit apartment residence. There is a secluded side-entrance for maximum privacy and home-like comfort.\n\nGuest Access\n\nAmple unrestricted street parking is available, no permits or pesky meter feeding required. Driveway parking is reserved for our permanent residents. Everything is digital, no keys to weigh you down during your time out and about. I set a new code for each guest which assures total privacy and security during your stay.\n\nInteraction with Guests\n\nDepending upon the time of year, Self check-in is available or you may meet and greet with your host, sharing tips and information about the apartment and local area. \n\nThe Neighborhood \n\nI love the Magnolia Park area of Burbank. This property sits next to the Chandler bike path and is walking distance from the downtown Burbank area. There's convenient food, markets and plenty of shopping nearby.\n\nGetting Around\n\nI always recommend rideshares such as Uber or Lyft, but public transportation is equally within reach.\n\nOther Things to Note\n\nI have been in the hospitality industry since 2005. I owned and operated two hotels and I have traveled extensively. My sensibilities are for the traveler and the amenities included in your stay meet my high standards for quality hotel accommodations. In addition, the Burbank Sanctuary offers the fastest and most reliable internet available in the city.\n\nHouse Rules \n\nI cater to the nonsmoker without pets. Smoking is not permitted inside the apartment nor on the property. Our other tenants dislike the aroma. We love small non-human friends, but unfortunately they are not allowed at the property. We observe quiet time from 10pm to 8am and kindly request that you do the same by turning down your music or television during these times.",
        "detailPageUrl": "/635249?unitId=1183030&childrenCount=0&noDates=true",
        "featuredAmenities": [
          "INTERNET",
          "AIR_CONDITIONING",
          "TV",
          "CABLE",
          "PARKING",
          "NO_SMOKING",
          "HEATER"
        ],
        "firstLiveInLastThirtyDays": false,
        "geoCode": {
          "exact": true,
          "latitude": 34.177985,
          "longitude": -118.320758
        },
        "geography": {
          "description": "Burbank, Los Angeles County, California, United States of America",
          "ids": [
            {
              "type": "LBS",
              "value": "3b66d3bc-445d-4a3e-a623-8a4417745d1d"
            }
          ],
          "name": "Burbank",
          "relatedGeographies": null,
          "types": [
            "locality"
          ],
          "location": {
            "lat": 34.18084,
            "lng": -118.308968
          }
        },
        "propertyManagerProfile": null,
        "headline": "The Sanctuary - Be Pampered - Full Kitchen",
        "houseRules": {
          "children": {
            "label": "Children not allowed",
            "note": null,
            "allowed": false
          },
          "events": {
            "label": "No events",
            "note": null,
            "allowed": false
          },
          "smoking": {
            "label": "No smoking",
            "note": null,
            "allowed": false
          },
          "pets": {
            "label": "No pets",
            "note": null,
            "allowed": false
          },
          "unitUrl": "/units/0004/6ad4b648-15a1-4694-b38c-255370e5e59a",
          "checkInTime": "4:00 PM",
          "checkOutTime": "11:00 AM",
          "minimumAge": {
            "label": "Minimum age of primary renter:",
            "note": null,
            "minimumAge": 18,
            "displayText": "Minimum age to rent: 18"
          },
          "maxOccupancy": {
            "adults": null,
            "guests": 2,
            "label": "Max guests:",
            "maxAdultsLabel": null,
            "note": null,
            "displayText": "Maximum overnight guests: 2"
          },
          "standardRules": [
            {
              "key": "childrenRule",
              "label": "Children not allowed",
              "note": null
            },
            {
              "key": "petsRule",
              "label": "No pets",
              "note": null
            },
            {
              "key": "eventsRule",
              "label": "No events",
              "note": null
            },
            {
              "key": "smokingRule",
              "label": "No smoking",
              "note": null
            }
          ],
          "customRules": [],
          "label": "House Rules",
          "checkInRule": {
            "label": "<strong>Check in</strong> after 4:00 PM",
            "time": "4:00 PM"
          },
          "checkOutRule": {
            "label": "<strong>Check out</strong> before 11:00 AM",
            "time": "11:00 AM"
          },
          "childrenRule": {
            "displayText": "No children allowed",
            "allowed": false,
            "childrenNotAllowedNote": null,
            "note": null
          },
          "petsRule": {
            "displayText": "No pets allowed",
            "allowed": false,
            "note": null
          },
          "eventsRule": {
            "displayText": "No events allowed",
            "allowed": false,
            "maxEventAttendeesLabel": null,
            "allowedEventsNote": null,
            "note": null
          },
          "smokingRule": {
            "displayText": "No smoking allowed",
            "allowed": false,
            "outside": null,
            "inside": null,
            "note": null
          }
        },
        "cancellationPolicy": {
          "cancellationPolicyPeriods": [
            {
              "label": "<strong>100% refund of amount paid</strong> if you cancel at least 30 days before check-in."
            },
            {
              "label": "<strong>50% refund of amount paid</strong> (minus the service fee) if you cancel at least 14 days before check-in."
            },
            {
              "label": "<strong>No refund</strong> if you cancel less than 14 days before check-in."
            }
          ],
          "cancellationPolicyLabel": {
            "label": "<strong>Free cancellation</strong> up to",
            "date": "30 days before check-in",
            "isFullRefundWindow": true
          },
          "cancellationTimelinePeriods": [
            {
              "timelineLabel": "30 days before check-in",
              "refundPercent": 100,
              "refundWindowLabel": "100% refund",
              "shortDateLocalized": null,
              "isPast": false,
              "isActive": false,
              "iconCode": null
            },
            {
              "timelineLabel": "14 days before check-in",
              "refundPercent": 50,
              "refundWindowLabel": "50% refund",
              "shortDateLocalized": null,
              "isPast": false,
              "isActive": false,
              "iconCode": null
            },
            {
              "timelineLabel": "Check in",
              "refundPercent": 0,
              "refundWindowLabel": "No refund",
              "shortDateLocalized": null,
              "isPast": false,
              "isActive": false,
              "iconCode": "KEY"
            }
          ],
          "policyType": "MODERATE"
        },
        "instantBookable": false,
        "egratedPropertyManager": null,
        "platformPropertyManager": false,
        "ipmGuaranteedPricingActive": false,
        "isBasicListing": false,
        "isCrossSell": false,
        "isSubscription": false,
        "listingId": "321.635249.1183030",
        "listingNumber": 635249,
        "minStayRange": {
          "minStayHigh": 30,
          "minStayLow": 30
        },
        "multiUnitProperty": false,
        "onlineBookable": true,
        "ownerManaged": true,
        "ownersListingProfile": {
          "aboutYou": "My sensibilities are for the traveler and the amenities meet my high standards for a quality hotel stay. I offer the fastest internet available in the city.",
          "storyPhoto": null,
          "uniqueBenefits": null,
          "whyHere": null
        },
        "payPerBooking": true,
        "petsAllowed": false,
        "priceSummary": {
          "amount": 165,
          "currency": "USD",
          "formattedAmount": "$165",
          "pricePeriodDescription": "avg/night",
          "currencySymbol": "$"
        },
        "propertyId": "635249",
        "id": "33505162",
        "propertyManagerMessaging": null,
        "propertyType": "Apartment",
        "propertyTypeKey": "apartment",
        "recentlyAdded": false,
        "registrationNumber": "",
        "reviewCount": 151,
        "sleeps": 2,
        "sleepsDisplay": "Sleeps 2",
        "spu": "vrbo-635249-1183030",
        "status": "AVAILABLE",
        "takesInquiries": true,
        "testListing": false,
        "thumbnailUrl": "https://media.vrbo.com/lodging/34000000/33510000/33505200/33505162/e73f620d.TREATMENT.jpg",
        "travelerFeeEligible": true,
        "videoUrls": [
          "https://youtube.com/watch?v=GIiO5vRz-T8"
        ],
        "bathrooms": {
          "full": 1,
          "half": 0,
          "toiletOnly": 0
        },
        "industryHealthAssociations": [],
        "regionalHealthGuidelines": [],
        "impressum": null,
        "allFeaturedAmenitiesRanked": [
          "INTERNET",
          "PETS",
          "AIR_CONDITIONING",
          "POOL",
          "WHEELCHAIR",
          "HEATER",
          "FIREPLACE",
          "CABLE",
          "CHILDREN_WELCOME",
          "WASHER_DRYER",
          "HOT_TUB",
          "PARKING",
          "TV",
          "NO_SMOKING"
        ],
        "created_at": "2023-08-31T12:00:07.676Z",
        "exists": true,
        "updated_at": "2023-09-11T17:16:58.661Z",
        "vrbo_id": "635249"
      },
      ...
    ]
  }
}

GET/v1.1/client/airbnb-property/newly-listed

Get Airbnb Newly Listed Homes

This endpoint retrieves all Airbnb short-term rentals that are recently listed for a specific location: city, or a zip code.

Query parameters

  • Name
    state
    Type
    string
    Description

    State. Required. API returns 404 if omitted.

  • Name
    country
    Type
    string
    Description

    Country ISO-3166 Alpha-2 code. Default: US.

  • Name
    city
    Type
    string
    Description

    City filter.

  • Name
    neighborhood
    Type
    long
    Description

    Neighborhood ID.

  • Name
    zip_code
    Type
    integer
    Description

    Postal zip code.

  • Name
    page
    Type
    integer
    Description

    Page number. Default: 1.

  • Name
    items
    Type
    integer
    Description

    Items per page.

Request

GET
/v1.1/client/airbnb-property/newly-listed
curl -G "https://api.mashvisor.com/v1.1/client/airbnb-property/newly-listed" \
  -d "state=CA" \
  -d "city=San Francisco" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
  "status": "success",
  "content": {
    "items_per_page": 10,
    "page": 1,
    "reviews_count_limit": 30,
    "total_pages": 2,
    "total_items": 11,
    "list": [
      {
        "propertyTimezone": "America/Los_Angeles",
        "address": {
          "city": "Burbank",
          "country": "US",
          "postalCode": "91506",
          "stateProvince": "CA"
        },
        "availabilityUpdated": "2023-07-27",
        "averageRating": 4.9006624,
        "bedrooms": 0,
        "canonicalLink": "https://www.vrbo.com/635249",
        "description": "The Space\n\nA short 13 minute walk from beautiful downtown Burbank, the Burbank Sanctuary is a well-appointed and comfortable studio apartment with an elegant boutique touch. Enjoy luxury bedding, abundant amenities, 42\" flat screen and full kitchen. Experience five diamond standards with at home comfort, privacy and security.  An ALDI supermarket is at the other end of the street.\n\nThe Burbank Sanctuary is a downstairs apartment. While the vast majority of our guests love the apartment, it's not for very light sleepers.\n\nRelaxation and comfort will come easy during your stay with us. Your experience includes queen-size luxury bedding, unlimited hot showers, free wifi and digital 55\" smart widescreen with Netflix, Amazon, Hulu and Pandora. There is no local TV.\n\nYou will also have a full size kitchen at your fingertips with all the cooking comforts you could wish for. A full size fridge, unlimited ice, soap, shampoo and towels are among the many delightful amenities available during your stay at the Burbank Sanctuary.\n\nEnjoy accommodations and VIP treatment of a boutique hotel with at home comfort, privacy and security.\n\nThe building is a charming and cozy 5-unit apartment residence. There is a secluded side-entrance for maximum privacy and home-like comfort.\n\nGuest Access\n\nAmple unrestricted street parking is available, no permits or pesky meter feeding required. Driveway parking is reserved for our permanent residents. Everything is digital, no keys to weigh you down during your time out and about. I set a new code for each guest which assures total privacy and security during your stay.\n\nInteraction with Guests\n\nDepending upon the time of year, Self check-in is available or you may meet and greet with your host, sharing tips and information about the apartment and local area. \n\nThe Neighborhood \n\nI love the Magnolia Park area of Burbank. This property sits next to the Chandler bike path and is walking distance from the downtown Burbank area. There's convenient food, markets and plenty of shopping nearby.\n\nGetting Around\n\nI always recommend rideshares such as Uber or Lyft, but public transportation is equally within reach.\n\nOther Things to Note\n\nI have been in the hospitality industry since 2005. I owned and operated two hotels and I have traveled extensively. My sensibilities are for the traveler and the amenities included in your stay meet my high standards for quality hotel accommodations. In addition, the Burbank Sanctuary offers the fastest and most reliable internet available in the city.\n\nHouse Rules \n\nI cater to the nonsmoker without pets. Smoking is not permitted inside the apartment nor on the property. Our other tenants dislike the aroma. We love small non-human friends, but unfortunately they are not allowed at the property. We observe quiet time from 10pm to 8am and kindly request that you do the same by turning down your music or television during these times.",
        "detailPageUrl": "/635249?unitId=1183030&childrenCount=0&noDates=true",
        "featuredAmenities": [
          "INTERNET",
          "AIR_CONDITIONING",
          "TV",
          "CABLE",
          "PARKING",
          "NO_SMOKING",
          "HEATER"
        ],
        "firstLiveInLastThirtyDays": false,
        "geoCode": {
          "exact": true,
          "latitude": 34.177985,
          "longitude": -118.320758
        },
        "geography": {
          "description": "Burbank, Los Angeles County, California, United States of America",
          "ids": [
            {
              "type": "LBS",
              "value": "3b66d3bc-445d-4a3e-a623-8a4417745d1d"
            }
          ],
          "name": "Burbank",
          "relatedGeographies": null,
          "types": [
            "locality"
          ],
          "location": {
            "lat": 34.18084,
            "lng": -118.308968
          }
        },
        "propertyManagerProfile": null,
        "headline": "The Sanctuary - Be Pampered - Full Kitchen",
        "houseRules": {
          "children": {
            "label": "Children not allowed",
            "note": null,
            "allowed": false
          },
          "events": {
            "label": "No events",
            "note": null,
            "allowed": false
          },
          "smoking": {
            "label": "No smoking",
            "note": null,
            "allowed": false
          },
          "pets": {
            "label": "No pets",
            "note": null,
            "allowed": false
          },
          "unitUrl": "/units/0004/6ad4b648-15a1-4694-b38c-255370e5e59a",
          "checkInTime": "4:00 PM",
          "checkOutTime": "11:00 AM",
          "minimumAge": {
            "label": "Minimum age of primary renter:",
            "note": null,
            "minimumAge": 18,
            "displayText": "Minimum age to rent: 18"
          },
          "maxOccupancy": {
            "adults": null,
            "guests": 2,
            "label": "Max guests:",
            "maxAdultsLabel": null,
            "note": null,
            "displayText": "Maximum overnight guests: 2"
          },
          "standardRules": [
            {
              "key": "childrenRule",
              "label": "Children not allowed",
              "note": null
            },
            {
              "key": "petsRule",
              "label": "No pets",
              "note": null
            },
            {
              "key": "eventsRule",
              "label": "No events",
              "note": null
            },
            {
              "key": "smokingRule",
              "label": "No smoking",
              "note": null
            }
          ],
          "customRules": [],
          "label": "House Rules",
          "checkInRule": {
            "label": "<strong>Check in</strong> after 4:00 PM",
            "time": "4:00 PM"
          },
          "checkOutRule": {
            "label": "<strong>Check out</strong> before 11:00 AM",
            "time": "11:00 AM"
          },
          "childrenRule": {
            "displayText": "No children allowed",
            "allowed": false,
            "childrenNotAllowedNote": null,
            "note": null
          },
          "petsRule": {
            "displayText": "No pets allowed",
            "allowed": false,
            "note": null
          },
          "eventsRule": {
            "displayText": "No events allowed",
            "allowed": false,
            "maxEventAttendeesLabel": null,
            "allowedEventsNote": null,
            "note": null
          },
          "smokingRule": {
            "displayText": "No smoking allowed",
            "allowed": false,
            "outside": null,
            "inside": null,
            "note": null
          }
        },
        "cancellationPolicy": {
          "cancellationPolicyPeriods": [
            {
              "label": "<strong>100% refund of amount paid</strong> if you cancel at least 30 days before check-in."
            },
            {
              "label": "<strong>50% refund of amount paid</strong> (minus the service fee) if you cancel at least 14 days before check-in."
            },
            {
              "label": "<strong>No refund</strong> if you cancel less than 14 days before check-in."
            }
          ],
          "cancellationPolicyLabel": {
            "label": "<strong>Free cancellation</strong> up to",
            "date": "30 days before check-in",
            "isFullRefundWindow": true
          },
          "cancellationTimelinePeriods": [
            {
              "timelineLabel": "30 days before check-in",
              "refundPercent": 100,
              "refundWindowLabel": "100% refund",
              "shortDateLocalized": null,
              "isPast": false,
              "isActive": false,
              "iconCode": null
            },
            {
              "timelineLabel": "14 days before check-in",
              "refundPercent": 50,
              "refundWindowLabel": "50% refund",
              "shortDateLocalized": null,
              "isPast": false,
              "isActive": false,
              "iconCode": null
            },
            {
              "timelineLabel": "Check in",
              "refundPercent": 0,
              "refundWindowLabel": "No refund",
              "shortDateLocalized": null,
              "isPast": false,
              "isActive": false,
              "iconCode": "KEY"
            }
          ],
          "policyType": "MODERATE"
        },
        "instantBookable": false,
        "egratedPropertyManager": null,
        "platformPropertyManager": false,
        "ipmGuaranteedPricingActive": false,
        "isBasicListing": false,
        "isCrossSell": false,
        "isSubscription": false,
        "listingId": "321.635249.1183030",
        "listingNumber": 635249,
        "minStayRange": {
          "minStayHigh": 30,
          "minStayLow": 30
        },
        "multiUnitProperty": false,
        "onlineBookable": true,
        "ownerManaged": true,
        "ownersListingProfile": {
          "aboutYou": "My sensibilities are for the traveler and the amenities meet my high standards for a quality hotel stay. I offer the fastest internet available in the city.",
          "storyPhoto": null,
          "uniqueBenefits": null,
          "whyHere": null
        },
        "payPerBooking": true,
        "petsAllowed": false,
        "priceSummary": {
          "amount": 165,
          "currency": "USD",
          "formattedAmount": "$165",
          "pricePeriodDescription": "avg/night",
          "currencySymbol": "$"
        },
        "propertyId": "635249",
        "id": "33505162",
        "propertyManagerMessaging": null,
        "propertyType": "Apartment",
        "propertyTypeKey": "apartment",
        "recentlyAdded": false,
        "registrationNumber": "",
        "reviewCount": 151,
        "sleeps": 2,
        "sleepsDisplay": "Sleeps 2",
        "spu": "vrbo-635249-1183030",
        "status": "AVAILABLE",
        "takesInquiries": true,
        "testListing": false,
        "thumbnailUrl": "https://media.vrbo.com/lodging/34000000/33510000/33505200/33505162/e73f620d.TREATMENT.jpg",
        "travelerFeeEligible": true,
        "videoUrls": [
          "https://youtube.com/watch?v=GIiO5vRz-T8"
        ],
        "bathrooms": {
          "full": 1,
          "half": 0,
          "toiletOnly": 0
        },
        "industryHealthAssociations": [],
        "regionalHealthGuidelines": [],
        "impressum": null,
        "allFeaturedAmenitiesRanked": [
          "INTERNET",
          "PETS",
          "AIR_CONDITIONING",
          "POOL",
          "WHEELCHAIR",
          "HEATER",
          "FIREPLACE",
          "CABLE",
          "CHILDREN_WELCOME",
          "WASHER_DRYER",
          "HOT_TUB",
          "PARKING",
          "TV",
          "NO_SMOKING"
        ],
        "created_at": "2023-08-31T12:00:07.676Z",
        "exists": true,
        "updated_at": "2023-09-11T17:16:58.661Z",
        "vrbo_id": "635249"
      },
      ...
    ]
  }
}

GET/v1.1/client/airbnb-property/newly-listed-vrbo

Get VRBO Newly Listed Homes

Retrieves VRBO short-term rentals that are recently listed for a specific location (city or zip code).

Query parameters

  • Name
    state
    Type
    string
    Description

    State. Required. API returns 404 if omitted.

  • Name
    country
    Type
    string
    Description

    Country ISO-3166 Alpha-2 code. Default: US.

  • Name
    city
    Type
    string
    Description

    City filter.

  • Name
    neighborhood
    Type
    long
    Description

    Neighborhood ID.

  • Name
    zip_code
    Type
    integer
    Description

    Postal zip code.

  • Name
    page
    Type
    integer
    Description

    Page number. Default: 1.

  • Name
    items
    Type
    integer
    Description

    Items per page.

Request

GET
/v1.1/client/airbnb-property/newly-listed-vrbo
curl -G "https://api.mashvisor.com/v1.1/client/airbnb-property/newly-listed-vrbo" \
  -d "state=CA" \
  -d "city=Burbank" \
  -H "x-api-key: YOUR_API_KEY"

Response

{
    "status": "success",
    "content": {
        "items_per_page": 10,
        "page": 1,
        "total_pages": 1,
        "total_items": 3,
        "list": [
          {
            "propertyTimezone": "America/Los_Angeles",
            "address": {
              "city": "Burbank",
              "country": "US",
              "postalCode": "91502",
              "stateProvince": "CA"
            },
            "availabilityUpdated": "2023-09-11",
            "averageRating": 0,
            "bedrooms": 2,
            "canonicalLink": "https://www.vrbo.com/3536272",
            "description": "- (RLNE8088308) Available for lease in the Burbank Collection Luxury Condos is an immaculate 2BD 2BA unit overlooking the glistening pool. 1, 100 SF in size, this well-kept, fully furnished unit features high ceilings, an abundance of light, and an open floor plan w/ a dining area. The kitchen features stainless appliances (oven, range, microwave, dishwasher, refrigerator) and a peninsula style island w/ granite counters perfect for entertaining. The master suites include walk-in closets and luxurious master bath with dual vanities, soaking tub and separate shower. Laundry is inside the unit and there is a private opera patio for added enjoyment. Building amenities include controlled access, a pool, clubhouse with billiard table, bocce ball court, putting green, BBQ area with fire pit, well equipped gym and 2 side-by-side secured parking spaces. Burbank living at its finest awaits! Do not miss the opportunity to be in the heart of Downtown Burbank near Disney, NBC, Warner Bros, Universal, Nickelodeon Studios with easy access to the 5 freeway and the Bob Hope airport, trendy restaurants, shops, Burbank Town Center and the Empire Center. 052691502JP23075129 Please call Listing provided by Artak Dovlatyan of Specialized Realty (LA State License 01250473) 818Leases.com Houzlet publishes listings on Vrbo; which in turn, allows tenants to instantly rent seasonal rentals. Houzlet’s properties are managed by licensed real estate agents. Although the property is an instant rental, it’s possible there can be another pending application. If the home is not available, we can offer you another suitable option or you can cancel for free. \n\n\nHouse Rules. \nThe refundable policy is as follows:\n\n1.\t100% refund less the service fee if you cancel 30 days prior to move-in.\n2.\t100% refund less the service fee if you are not approved to rent or the home is unavailable. \n3.\tNot refundable if you are within 30 days from arrival or if you signed the leased with the Agent (whichever comes first).\n\nPlease note this property may require a tenant screening at an extra cost to you. You will be required to sign a lease with the landlord. Security deposit vary and range from USD 500 up to one full month rent that is payable directly to the landlord.",
            "detailPageUrl": "/3536272?unitId=4109418&childrenCount=0&noDates=true",
            "featuredAmenities": [
              "INTERNET",
              "AIR_CONDITIONING",
              "WASHER_DRYER",
              "PARKING",
              "NO_SMOKING"
            ],
            "firstLiveInLastThirtyDays": false,
            "geoCode": {
              "exact": true,
              "latitude": 34.181442,
              "longitude": -118.311191
            },
            "geography": {
              "description": "Downtown Burbank, Burbank, California, United States of America",
              "ids": [
                {
                  "type": "LBS",
                  "value": "8adba945-cabb-4399-b6de-4af55348bab7"
                }
              ],
              "name": "Downtown Burbank",
              "relatedGeographies": null,
              "types": [
                "neighborhood"
              ],
              "location": {
                "lat": 34.182269,
                "lng": -118.310087
              }
            },
            "propertyManagerProfile": null,
            "headline": "2 Bedroom Single_family (626774) by Houzlet",
            "houseRules": {
              "children": {
                "label": "Children allowed",
                "note": null,
                "allowed": true
              },
              "events": {
                "label": "No events",
                "note": null,
                "allowed": false
              },
              "smoking": {
                "label": "No smoking",
                "note": null,
                "allowed": false
              },
              "pets": {
                "label": "No pets",
                "note": null,
                "allowed": false
              },
              "unitUrl": "/units/0004/a26f8b00-9251-4fb2-a2e4-4ab72136219a",
              "checkInTime": "3:00 PM",
              "checkOutTime": "11:00 AM",
              "minimumAge": {
                "label": "Minimum age of primary renter:",
                "note": null,
                "minimumAge": null,
                "displayText": null
              },
              "maxOccupancy": {
                "adults": 4,
                "guests": 4,
                "label": "Max guests:",
                "maxAdultsLabel": "(sleeps up to 4 adults)",
                "note": null,
                "displayText": "Maximum overnight guests: 4 (sleeps up to 4 adults)"
              },
              "standardRules": [
                {
                  "key": "childrenRule",
                  "label": "Children allowed",
                  "note": null
                },
                {
                  "key": "petsRule",
                  "label": "No pets",
                  "note": null
                },
                {
                  "key": "eventsRule",
                  "label": "No events",
                  "note": null
                },
                {
                  "key": "smokingRule",
                  "label": "No smoking",
                  "note": null
                }
              ],
              "customRules": [],
              "label": "House Rules",
              "checkInRule": {
                "label": "<strong>Check in</strong> after 3:00 PM",
                "time": "3:00 PM"
              },
              "checkOutRule": {
                "label": "<strong>Check out</strong> before 11:00 AM",
                "time": "11:00 AM"
              },
              "childrenRule": {
                "displayText": null,
                "allowed": true,
                "childrenNotAllowedNote": null,
                "note": null
              },
              "petsRule": {
                "displayText": "No pets allowed",
                "allowed": false,
                "note": null
              },
              "eventsRule": {
                "displayText": "No events allowed",
                "allowed": false,
                "maxEventAttendeesLabel": null,
                "allowedEventsNote": null,
                "note": null
              },
              "smokingRule": {
                "displayText": "No smoking allowed",
                "allowed": false,
                "outside": null,
                "inside": null,
                "note": null
              }
            },
            "cancellationPolicy": {
              "cancellationPolicyPeriods": [
                {
                  "label": "<strong>100% refund of amount payable</strong> if you cancel at least 30 days before check-in."
                },
                {
                  "label": "<strong>50% refund of amount payable</strong> (minus the service fee) if you cancel at least 14 days before check-in."
                },
                {
                  "label": "<strong>No refund</strong> if you cancel less than 14 days before check-in."
                }
              ],
              "cancellationPolicyLabel": {
                "label": "<strong>Free cancellation</strong> up to",
                "date": "30 days before check-in",
                "isFullRefundWindow": true
              },
              "cancellationTimelinePeriods": [
                {
                  "timelineLabel": "30 days before check-in",
                  "refundPercent": 100,
                  "refundWindowLabel": "100% refund",
                  "shortDateLocalized": null,
                  "isPast": false,
                  "isActive": false,
                  "iconCode": null
                },
                {
                  "timelineLabel": "14 days before check-in",
                  "refundPercent": 50,
                  "refundWindowLabel": "50% refund",
                  "shortDateLocalized": null,
                  "isPast": false,
                  "isActive": false,
                  "iconCode": null
                },
                {
                  "timelineLabel": "Check in",
                  "refundPercent": 0,
                  "refundWindowLabel": "No refund",
                  "shortDateLocalized": null,
                  "isPast": false,
                  "isActive": false,
                  "iconCode": "KEY"
                }
              ],
              "policyType": "MODERATE"
            },
            "instantBookable": true,
            "egratedPropertyManager": null,
            "platformPropertyManager": false,
            "ipmGuaranteedPricingActive": true,
            "isBasicListing": false,
            "isCrossSell": false,
            "isSubscription": false,
            "listingId": "321.3536272.4109418",
            "listingNumber": 3536272,
            "minStayRange": {
              "minStayHigh": 30,
              "minStayLow": 30
            },
            "multiUnitProperty": false,
            "onlineBookable": true,
            "ownerManaged": false,
            "ownersListingProfile": {
              "aboutYou": null,
              "storyPhoto": null,
              "uniqueBenefits": null,
              "whyHere": null
            },
            "payPerBooking": true,
            "petsAllowed": false,
            "priceSummary": {
              "amount": 178,
              "currency": "USD",
              "formattedAmount": "$178",
              "pricePeriodDescription": "avg/night",
              "currencySymbol": "$"
            },
            "propertyId": "3536272",
            "id": "96433850",
            "propertyManagerMessaging": null,
            "propertyType": "Apartment",
            "propertyTypeKey": "apartment",
            "recentlyAdded": true,
            "registrationNumber": "320623",
            "reviewCount": 0,
            "sleeps": 4,
            "sleepsDisplay": "Sleeps 4",
            "spu": "vrbo-3536272-4109418",
            "status": "AVAILABLE",
            "takesInquiries": true,
            "testListing": false,
            "thumbnailUrl": "https://media.vrbo.com/lodging/97000000/96440000/96433900/96433850/w1016h675x4y4-cc2e3dcb.TREATMENT.jpg",
            "travelerFeeEligible": true,
            "videoUrls": [],
            "bathrooms": {
              "full": 2,
              "half": 0,
              "toiletOnly": 0
            },
            "industryHealthAssociations": [],
            "regionalHealthGuidelines": [],
            "impressum": null,
            "allFeaturedAmenitiesRanked": [
              "INTERNET",
              "PETS",
              "AIR_CONDITIONING",
              "POOL",
              "WHEELCHAIR",
              "HEATER",
              "FIREPLACE",
              "CABLE",
              "CHILDREN_WELCOME",
              "WASHER_DRYER",
              "HOT_TUB",
              "PARKING",
              "TV",
              "NO_SMOKING"
            ],
            "created_at": "2023-09-11T17:15:24.668Z",
            "vrbo_id": "3536272"
          },
            ...
        ]
    }
}

GET/v1.1/client/neighborhood/{id}/recent-sold-properties

Neighborhood Recent Sold Listings

This endpoint retrieves recent sold properties for a specific neighborhood.

Path parameters

  • Name
    id
    Type
    long
    Description

    Neighborhood ID to fetch data for.

Query parameters

  • Name
    state
    Type
    string
    Description

    State. Required. API returns 404 if omitted.

Request

GET
/v1.1/client/neighborhood/{id}/recent-sold-properties
curl -G "https://api.mashvisor.com/v1.1/client/neighborhood/49102/recent-sold-properties" \
-d "state=DE" \
-H "x-api-key: YOUR_API_KEY"

Response

{
    "status": "success",
    "content": [
        {
            "country": "United States",
            "city": "Georgetown",
            "state": "DE",
            "zipcode": "19947",
            "address": "18155 Deer Forest Rd, Georgetown, DE, 19947, United States",
            "beds": 7,
            "baths": 4,
            "image_url": "https://photos.zillowstatic.com/fp/711c9af5b23c9ef3af813021da613e57-p_c.jpg",
            "price": 698000,
            "lat": 38.73814,
            "lng": -75.43364,
            "home_type": "Single Family Residential",
            "sqft": 4200,
            "last_sale_price": 698000,
            "last_sale_date": 1705622400000
        },
        {
            "country": "United States",
            "city": "Georgetown",
            "state": "DE",
            "zipcode": "19947",
            "address": "19576 R L Field Dr, Georgetown, DE, 19947, United States",
            "beds": 3,
            "baths": null,
            "image_url": "https://maps.googleapis.com/maps/api/staticmap?mobile=false&sensor=true&maptype=satellite&size=316x234&zoom=17&center=38.725364685058594,-75.40948486328125&key=AIzaSyBWYJWCA8FNMQvSe_k3LKfDGJaEgdKwsco&&signature=qTbyHgdIQlBgxKFQPKcfMSg9cxU=",
            "price": 250000,
            "lat": 38.725365,
            "lng": -75.409485,
            "home_type": "Single Family Residential",
            "sqft": 1683,
            "last_sale_price": 250000,
            "last_sale_date": 1698624000000
        }
    ]
}

Was this page helpful?