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 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
| Attribute | Definition | Possible Returns |
|---|---|---|
| id | Airbnb listing ID | Integer |
| name | Listing full name | String |
| neighborhood | Listing neighborhood | Boolean |
| city | The city where the listing is located | String |
| state* | The state where the property is located | String |
| zip code | Postal code where a listing is located | Integer |
| country | County where a listing is located | String |
| smart_location | Full location of listing | String |
| address | Address of listing entered by host | String |
| public_address | Full address along with the country | String |
| country_code | Listing's country code, ex: US | String |
| market | Listing market | String |
| lat | Latitude of listing location | Float |
| lng | Longitude of listing location | Float |
| instant_bookable | Indicator if listing is available for instant booking | Boolean |
| picture_url | Main picture url | String |
| thumbnail_url | Main thumbnail picture url | String |
| medium_url | Main XL picture url | String |
| xl_picture_url | All XL pictures urls | String |
| picture_urls | All pictures url | String - array |
| thumbnail_urls | All thumbnail pictures url | String - array |
| xl_picture_urls | All XL pictures urls | String - array |
| picture_count | Count of all pictures | Integer |
| picture_captions | All pictures captions | String - array |
| map_image_url | Google map image url | String |
| user_id | Listing's host ID | Integer |
| price | Listing current booking price per night | Integer |
| native_currency | Native price currency, ex: USD | String |
| price_native | Listing native price | Integer |
| price_formatted | Price along with the currency | String |
| price_for_extra_person_native | Extra person's price | Integer |
| weekly_price_native | Weekly price after the discount | Integer |
| monthly_price_native | Monthly price after the discount | Integer |
| currency_symbol_left | Currency symbol, ex: $ | String |
| currency_symbol_right | Currency symbol, ex: € | String |
| security_deposit_native | Security deposit price | Integer |
| security_price_native | Security deposit native price | Integer |
| security_deposit_formatted | Security deposit price with currency | String |
| bedrooms | Number of bedrooms | Integer |
| beds | Number of beds | Integer |
| bathrooms | Number of bathrooms | Integer |
| min_nights | Min allowed booking nights | Integer |
| person_capacity | Max listing capacity of persons | Integer |
| user | Host/user object | User Object |
| cancellation_policy | Cancellation policy category | String |
| cancel_policy | Cancellation policy category ID | Integer |
| cancel_policy_short_str | Summary of cancellation policy | String |
| has_double_blind_reviews | Boolean indicator for blind reviews | Boolean |
| property_type | Property main type (House, Apartment, Villa, etc.) | String |
| reviews_count | Total reviews count | Integer |
| review_scores | Detailed reviews scores per category | Review Scores object |
| room_type | Listing room type (Entire home/apt, Private room, Shared room) | String |
| room_type_category | Room type category | String |
| bed_type | Bed type | String |
| bed_type_category | Bed type category | String |
| require_guest_profile_picture | Require guest profile picture | Boolean |
| require_guest_phone_verification | Require guest phone verification | Boolean |
| force_mobile_legal_modal | Force mobile legal modal | Boolean |
| check_in_time | Check in time hour | Integer |
| check_out_time | Check out time hour | Integer |
| guests_included | Number of guests included | Integer |
| license | AirBnB license for listing | String |
| max_nights | Max booking nights | Integer |
| square_feet | Listing living area | Integer |
| locale | Listing's locale | String |
| language | Listing page language | String |
| experiences_offered | Listing experience offered along with booking | String |
| max_nights_input_value | Max nights input value | Integer |
| min_nights_input_value | Min nights input value | Integer |
| requires_license | Indicator if the listing requires licence | Boolean |
| property_type_id | Property type ID | Integer |
| house_rules | Hosting rules provided by host when booking | String |
| description | Listing full description | String |
| description_locale | Description locale | String |
| summary | Description summary | String |
| space | Listing space | String |
| access | Allowed accesses in the listing from host | String |
| interaction | Host interaction | String |
| neighborhood_overview | Listing neighborhood overview | String |
| transit | Listing around transit | String |
| amenities | All included amenities | String - array |
| is_location_exact | Verified exact location | Boolean |
| star_rating | Total star rating | Float |
| time_zone_name | Full timezone name | String |
| created_at | Listing creation date and time | Timestamp |
| updated_at | Listing updates date and time | Timestamp |
| exists | Indicator if the listing is still active over AirBnB or not | Boolean |
Request
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 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
| Attribute | Definition | Data Type |
|---|---|---|
| id | VRBO listing ID | String |
| headline | Listing full name | String |
| address | Listing address including country, state, city, postal code | String |
| propertyTimezone | Full timezone name | String |
| created_at | Listing creation date and time | Timestamp |
| updated_at | Listing updates date and time | Timestamp |
| exists | Indicator if the listing is still active over VRBO | Boolean |
| propertyId | Property ID | String |
| propertyName | Property name | String |
| propertyType | Property type (e.g., Condo) | String |
| propertyTypeKey | Property type key (e.g., condo) | String |
| description | Property description | String |
| canonicalLink | Link to the property listing | String |
| sleeps | Number of guests the property sleeps | Integer |
| bedrooms | Number of bedrooms in the property | Integer |
| bathrooms | Number of bathrooms in the property | Object |
| averageRating | Average rating of the property | Float |
| reviewCount | Number of reviews for the property | Integer |
| onlineBookable | Indicates if the property is bookable online | Boolean |
| instantBookable | Indicates if the property supports instant booking | Boolean |
| unitMetadata | Metadata for the unit | Object |
| featuredAmenities | Featured amenities for the property | Array of Strings |
| allFeaturedAmenitiesRanked | Ranked list of featured amenities | Array of Strings |
| houseRules | Property's house rules | Object |
| cancellationPolicy | Cancellation policy for the property | Object |
| payPerBooking | Indicates if the property uses a pay-per-booking model | Boolean |
| priceSummary | Price summary for the property | Object |
| ownerManaged | Indicates if the property is owner-managed | Boolean |
| ownerListingProfile | Owner's listing profile information | Object |
| propertyManagerProfile | Property manager's profile information | Object |
| registrationNumber | Property registration number (if applicable) | String |
| recentAdded | Indicates if the property was recently added | Boolean |
| takesInquiries | Indicates if the property takes inquiries from guests | Boolean |
| videoUrls | URLs to videos related to the property | Array of Strings |
| thumbnailUrl | URL to the property's thumbnail image | String |
| travelerFeeEligible | Indicates if traveler fees are eligible for the property | Boolean |
| listingNumber | Listing number for the property | Integer |
| multiUnitProperty | Indicates if the property is a multi-unit property | Boolean |
| egratedPropertyManager | Information about an integrated property manager (if applicable) | Object |
| platformPropertyManager | Indicates if the property is managed by a platform property manager | Boolean |
| ipmGuaranteedPricingActive | Indicates if guaranteed pricing is active for the property | Boolean |
| petsAllowed | Indicates if pets are allowed in the property | Boolean |
| minStayRange | Range of minimum stay requirements for the property | Object |
| maxOccupancy | Maximum occupancy details for the property | Object |
| industryHealthAssociations | Health associations associated with the property | Array of Objects |
| regionalHealthGuidelines | Regional health guidelines for the property | Array of Objects |
| impressum | Property's impressum (if applicable) | String |
| occupancy | Occupancy details for the property | Object |
| rentalIncome | Rental income details for the property | Object |
| nightsBooked | Number of nights booked for the property | Integer |
Request
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
}
}
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
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
}
]
}
}
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
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"
}
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
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 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
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"
}
]
}
}
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
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",
...
]
}
}
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
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"
}
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
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"
}
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
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 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
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 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
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 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
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"
}
]
}
}
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
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 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
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 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
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 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
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"
},
...
]
}
}
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
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¢er=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
}
]
}