Actor picture

The AirBnb Explorer

jupri/airbnb

Scrape data from Airbnb.com ⭐ ⭐ ⭐ ⭐ ⭐

Free trial for 7 days

Then $30/month

No credit card required now

Author's avatarcat
  • Modified
  • Users78
  • Runs922
Actor picture
The AirBnb Explorer

Free trial for 7 days

Then $30/month

Welcome to Airbnb.com Scraper

enter image description here

About Airbnb.com

Airbnb, Inc. (/ˌɛərˌbiːɛnˈbiː/ AIR-BEE-en-BEE) is an American company that operates an online marketplace for lodging, primarily homestays for vacation rentals, and tourism activities. Based in San Francisco, California, the platform is accessible via website and mobile app. Airbnb does not own any of the listed properties; instead, it profits by receiving commission from each booking. The company was founded in 2008 by Brian Chesky, Nathan Blecharczyk, and Joe Gebbia. Airbnb is a shortened version of its original name, AirBedandBreakfast.com.

About This Actor

Scrape data about properties around the world. Check for availability on specific dates. Get detailed information such as amenities, description, ratings, reviews and more. Search for properties using comprehensive list of filters.

Tutorial

Example #1: Basic Usage

The actor can run without any arguments. Arguments can be supplied for more specific search results.

{
    "location": "Antarctica",
    "offset": 50,
    "limit": 100
}
parameter type description
location string City, country or continent you wish to go
offset integer Start search from specific offset
limit integer Limit number of results

Example #2: Flexible Trips

{ 
    "location": "United States",
    "trip_length" : "one_week",
    "trip_month:april": true, 
    "trip_month:may": true
}

If check in/out dates is not supplied (empty), this is known as Flexible Dates. This arguments will take effect :

parameter type values description
trip_length string weekend_trip, one_week, one_month Lenght of trip: weekend, one week or one month.
trip_month:(monthname) boolean true / false or empty Month of trip. Multiple month can be supplied. (see example below)

Example #3: Exact Dates (check availability dates)

{ 
    "location": "United States", 
    "trip_length": "exact",
    "check_in": "2022-08-24",
    "check_out": "2022-08-26"
}

If trip_length argument not supplied (empty or "exact") then check-in/out must supplied with format : YYYY-MM-DD

parameter type values description
check_in string YYYY-MM-DD Check-in date
check_out string YYYY-MM-DD Check-out date

Example #4: Reviews

{ 
    "location": "United States", 
    "reviews": 5
}

Use reviews parameter to get reviews about a place.

parameter type description
reviews integer number of reviews

Example #5: Extra Info (additional information)

{
    "location": "United States",
    "includes:description": true,
    "includes:pricing": true,
    "includes:amenities": true,
    "includes:highlights": true,
    "includes:ratings": true,
    "includes:arrangement": true,
    "includes:location": true,
    "includes:host": true,
    "includes:images": true
}

Additional information can be fetched using includes:section flags. This will consume more CPU power = compute units.

More (maybe not) useful Information Included:

section type description
description boolean long description
pricing boolean detailed pricing
amenities boolean grouped amenities
highlights boolean property highlight
ratings boolean property detailed ratings
arrangement boolean sleep arrangement
location boolean surrounding location/place
host boolean host profiles
images boolean image gallery

Outputs Examples

Basic Information :

{
    "badges": [
        "Superhost"
    ],
    "bathrooms": 1,
    "bedrooms": 1,
    "beds": 1,
    "city": "New York",
    "contextualPictures": [
        {
            "caption": null,
            "id": "1267917892",
            "picture": "https://a0.muscache.com/im/pictures/c3199b56-ca1a-4366-9b2a-7e6ffbc7600d.jpg?im_w=720"
        },
        {
            "caption": { "kickerBadge": null, "messages": [ "1 bed", "1 bedroom" ] },
            "id": "1267917932",
            "picture": "https://a0.muscache.com/im/pictures/26f8ece1-2d3e-4e94-8379-2349e247c720.jpg?im_w=720"
        },
        {
            "caption": { "kickerBadge": null, "messages": [ "1 bath" ] },
            "id": "1267917938",
            "picture": "https://a0.muscache.com/im/pictures/003e6c90-5d0d-4bc5-a128-bba4e9840695.jpg?im_w=720"
        },
        {
            "caption": { "kickerBadge": null, "messages": [ "1 queen bed" ] },
            "id": "1267917949",
            "picture": "https://a0.muscache.com/im/pictures/3e0d9156-7cd9-4a77-969f-e7a64b80266d.jpg?im_w=720"
        },
        {
            "caption": { "kickerBadge": null, "messages": [ "Wifi", "Air conditioning", "Heating" ] },
            "id": "1267917948",
            "picture": "https://a0.muscache.com/im/pictures/4e6126aa-6ec9-4321-ab1b-851472adba41.jpg?im_w=720"
        },
        {
            "caption": { "kickerBadge": null, "messages": [ "Rated 4.9 out of 5 for cleanliness" ] },
            "id": "1267917952",
            "picture": "https://a0.muscache.com/im/pictures/2a0b960c-b9e3-4d4f-aa04-873bd7b4e0ce.jpg?im_w=720"
        }
    ],
    "distance": null,
    "headline": {
        "primary": [
            "3 beds",
            "Studio"
        ],
        "secondary": [
            "Feb 1 – 7"
        ]
    },
    "id": "52791123",
    "isAutoTranslated": false,
    "isFullyRefundable": null,
    "isNewListing": false,
    "isSuperhost": true,
    "lat": 40.72277,
    "lng": -73.99149,
    "name": "UNTITLED at Freeman - Queen Studio 407",
    "neighborhood": null,
    "overview": [
        "Apartment",
        "Downtown Manhattan"
    ],
    "pictureUrl": "https://a0.muscache.com/im/pictures/c3199b56-ca1a-4366-9b2a-7e6ffbc7600d.jpg?im_w=720",
    "pricing": {
        "details": [
            [
                {
                    "price": "$1,355",
                    "title": "$194 x 7 nights"
                },
                {
                    "price": "-$102",
                    "title": "Long stay discount"
                },
                {
                    "price": "$99",
                    "title": "Cleaning fee"
                },
                {
                    "price": "$191",
                    "title": "Service fee"
                }
            ]
        ],
        "primary": {
            "price": "$206",
            "qualifier": "night"
        },
        "secondary": {
            "price": "$1,543 total"
        }
    },
    "rating": 4.83,
    "reviewsCount": 29,
    "roomType": "Entire home/apt",
    "spaceType": "Apartment",
    "tierId": 0,
    "title": "Apartment in Downtown Manhattan",
    "url": "https://www.airbnb.com/rooms/52791123"
}

Extra Information

Description : (long description)

{
    "description": "You'll love this iconic A-frame. Close-range mountain views and easy access to the heart of downtown Black Mountain make this urban stay the best of both worlds. Only a half mile walk will lead you to breweries, restaurants, and shops in one of the prettiest small towns in the US! <br /><br />This unique stay is also close to Asheville, a top rated destination for food, craft beer, art, and outdoor adventures. Everything Asheville has to offer, including the Biltmore Estate, is only 20 minutes away!<br /><br /><b>The space</b><br />LAYOUT:<br />Newly renovated with a clean, modern look and open floor concept. The well-stocked kitchen was thoughtfully designed to prepare meals. A gorgeous spiral staircase invites you up to a cozy reading nook and loft bedroom. The main bedroom and bathroom are on the ground level for convenient access.<br /><br />BEDROOMS: <br />Both bedrooms contain a king size bed, smart TV, HVAC unit, blackout window shades, and a spacious closet. We provide access to cable and Netflix. You are also welcome to log in to your streaming service of choice, but please remember to log out before you leave. <br /><br />LINENS: <br />All bedding and towels are washed by Solar Suds, a local, solar-powered laundromat. They use \"Free & Clear\" laundry detergent for sensitive skin. Please use the black washcloths provided for makeup removal. There are extra towels as well as a laundry basket for used towels in the hall closet.  <br /><br />LAUNDRY:<br />Solar Suds, our amazing laundromat, offers a pickup/drop off service to our guests for an extra charge. If you wish to take advantage of this during your stay, please let me know! You will find a Solar Suds branded bag in the hall closet for transporting laundry. Simply fill the bag with dirty laundry, place outside on the door mat, and voilà! 24-48 hours later you will have clean laundry in the bag on your door mat. <br /><br />COFFEE: <br />We provide a coffee maker, coffee grinder, locally roasted & organic coffee beans, herbal tea, sugar, and honey. Please bring your favorite milk or creamer!<br /><br />HVAC: <br />This A-frame has 3 total units (mini splits). All units must be in the same mode (heating = sun icon or cooling = snowflake icon) in order to work properly. <br /><br />PROPERTY:<br />This A-frame (Unit A) is 1 of 4 total A-frame cabins on this property. Each cabin has a designated driveway for parking. Please be considerate of your neighbors and respectful of quiet hours from 10 pm - 8 am. Each A-frame has exterior rope lights that are set to a timer. You may turn them off if desired. Lastly, please be aware that WNC is home to black bear - they are pretty harmless but please do not leave food in your vehicle. <br /><br />TRASH & RECYCLE:<br />The trash and recycle bins are located at the end of the main driveway. If you fill up your trash or recycle can within the unit, please carry the full bag down to the appropriate container. Please note that all items in the trash bins must be bagged, and items in the recycle bins must be clean. Trash is collected on Monday mornings.<br /><br /><b>Other things to note</b><br />Connect with us on IG @blackmountainaframes"
}

Pricing : (detailed pricing)

{
    "pricing": {
        "details": [
            [
                {
                    "items": [
                        [
                            { "price": "$217", "title": "11/10/2022" },
                            { "price": "$217", "title": "11/11/2022" },
                            { "price": "$217", "title": "11/12/2022" },
                            { "price": "$218", "title": "11/13/2022" }
                        ],
                        [
                            { "price": "$869", "title": "Total Base Price" }
                        ]
                    ],
                    "price": "$869",
                    "title": "$217 x 4 nights"
                },
                {
                    "items": [
                        {
                            "info": "This discount is available because you are staying for 4 days."
                        }
                    ],
                    "price": "-$43",
                    "title": "Long stay discount"
                },
                {
                    "items": [
                        {
                            "info": "One-time fee charged by host to cover the cost of cleaning their space."
                        }
                    ],
                    "price": "$70",
                    "title": "Cleaning fee"
                },
                {
                    "items": [
                        {
                            "info": "This helps us run our platform and offer services like 24/7 support on your trip.\nIt includes VAT."
                        }
                    ],
                    "price": "$140",
                    "title": "Service fee"
                }
            ],
            [
                {
                    "price": "$1,036",
                    "title": "Total before taxes"
                }
            ]
        ],
        "disclaimer": "This place has a maximum of 2 guests, not including infants. Pets aren't allowed.",
        "primary": {
            "price": "$207",
            "qualifier": "night"
        }
    }
}

Amenities : (grouped amenities)

{
    "amenities": [
        {
            "title": "Scenic views",
            "subtitle": null,
            "amenities": [
                { "available": true, "title": "Mountain view", "subtitle": "", "image": null }
            ]
        },
        {
            "title": "Bathroom",
            "subtitle": null,
            "amenities": [
                { "available": true, "title": "Bathtub", "subtitle": "", "image": null },
                { "available": true, "title": "Hair dryer", "subtitle": "", "image": null },
            ]
        },
        {
            "title": "Bedroom and laundry",
            "subtitle": null,
            "amenities": [
                { "available": true, "title": "Hangers", "subtitle": "", "image": null },
                { "available": true, "title": "Bed linens", "subtitle": "", "image": null },
                { "available": true, "title": "Clothing storage", "subtitle": "", "image": null }
            ]
        },
        {
            "title": "Family",
            "subtitle": null,
            "amenities": [
                { "available": true, "title": "Outlet covers", "subtitle": "", "image": null },
                { "available": true, "title": "Board games", "subtitle": "", "image": null }
            ]
        },
        {
            "title": "Heating and cooling",
            "subtitle": null,
            "amenities": [
                { "available": true, "title": "Central air conditioning", "subtitle": "", "image": null },
                { "available": true, "title": "Ceiling fan", "subtitle": "", "image": null },
                { "available": true, "title": "Central heating", "subtitle": "", "image": null }
            ]
        },
        {
            "title": "Home safety",
            "subtitle": null,
            "amenities": [
                { "available": true, "title": "Fire extinguisher", "subtitle": "", "image": null },
                { "available": true, "title": "First aid kit", "subtitle": "", "image": null }
            ]
        },
        {
            "title": "Kitchen and dining",
            "subtitle": null,
            "amenities": [
                { "available": true, "title": "Refrigerator", "subtitle": "", "image": null },
                { "available": true, "title": "Microwave", "subtitle": "", "image": null },
                { "available": true, "title": "Dishwasher", "subtitle": "", "image": null },
                { "available": true, "title": "Stove", "subtitle": "", "image": null },
                { "available": true, "title": "Oven", "subtitle": "", "image": null },
                { "available": true, "title": "Hot water kettle", "subtitle": "", "image": null },
                { "available": true, "title": "Coffee maker", "subtitle": "", "image": null },
                { "available": true, "title": "Wine glasses", "subtitle": "", "image": null },
                { "available": true, "title": "Toaster", "subtitle": "", "image": null },
                { "available": true, "title": "Baking sheet", "subtitle": "", "image": null },
                { "available": true, "title": "Coffee", "subtitle": "", "image": null },
                { "available": true, "title": "Dining table", "subtitle": "", "image": null }
            ]
        }
    ]
}

Highlights

{
    "highlights": [
        {
            "title": "Dedicated workspace",
            "subtitle": "A private room with wifi that’s well-suited for working."
        },
        {
            "title": "Self check-in",
            "subtitle": "Check yourself in with the smartlock."
        },
        {
            "title": "Alexis is a Superhost",
            "subtitle": "Superhosts are experienced, highly rated hosts who are committed to providing great stays for guests."
        }
    ]
}

Ratings

{
    "ratings": [
        { "rating": "5.0", "title": "Cleanliness", "percentage": 1 },
        { "rating": "5.0", "title": "Accuracy", "percentage": 1 },
        { "rating": "5.0", "title": "Communication", "percentage": 1 },
        { "rating": "4.8", "title": "Location", "percentage": 0.96 },
        { "rating": "5.0", "title": "Check-in", "percentage": 1 },
        { "rating": "4.9", "title": "Value", "percentage": 0.9800000000000001 }
    ]
}

Arrangement (sleep arrangement)

{
    "arrangement": [
        {
            "title": "Bedroom 1",
            "subtitle": "1 king bed",
            "images": null
        },
        {
            "title": "Bedroom 2",
            "subtitle": "1 king bed",
            "images": null
        }
    ]
}

Location (surrounding area)

{
    "location": [
        {
            "title": "Black Mountain, North Carolina, United States",
            "content": "To be clear - this is an URBAN stay, walkable to downtown with a school and motel very close by. This unit is closest to Flat Creek Road. The Black Mountain Greenway is also adjacent to our property. You can access trails, parks, and downtown via this series of sidewalks! The closest grocery store is Ingles - only 1.5 miles away. The city of Asheville is only a 20 minute drive!",
            "items": null,
            "walkScoresContent": null
        },
        {
            "title": "Getting around",
            "content": "This A-frame has a designated driveway with space for 2-3 vehicles. Also, there are typically Ubers available for getting around town!",
            "items": null,
            "walkScoresContent": null
        }
    ]
}

Host (host profile)

{
    "additionalHosts": [
        {
            "avatar": {
                "badge": "SUPER_HOST",
                "url": "https://a0.muscache.com/im/pictures/user/fd66cc8a-f19e-4b11-b89a-2acd7efa9502.jpg?aki_policy=profile_x_medium",
                "userId": "164650025"
            },
            "name": "Chris"
        }
    ],
    "avatar": {
        "badge": null,
        "url": "https://a0.muscache.com/im/pictures/user/d01397c6-ba7b-48bf-b3ac-409ec53d2d83.jpg?aki_policy=profile_x_medium",
        "userId": "21959207"
    },
    "description": "Native New Yorker (and 4th generation New Yorker!) and business owner in Brooklyn, who loves to travel! I tend to prefer more local experiences than highly-trafficked tourism spots. Some of favorites trips have been road tripping around Puerto Rico, exploring the mountain towns of the Tatra Mountains in Poland, dancing in Mexico City, and staying in cabin in the woods in New England. \r<br />\r<br />I love hiking, biking, local foods, street art, and dancing! I am usually up for anything.\r<br />\r<br />I think many of the more seemingly simple experiences in life are overlooked, and some of the most profound travel opportunities come from listening to the local people who have created the culture (that's why I love AirBnb!).\r<br />\r<br />As a guest, I am very respectful and responsible and will often be out of the property exploring the neighborhood, nature, etc.\r<br />\r<br />My motto: \"The best things in life aren't things\"",
    "features": [
        {
            "title": "Language",
            "value": "English"
        }
    ],
    "image": null,
    "info": [
        {
            "title": "During your stay",
            "value": "The space is large enough so that the guest can have lots of privacy if needed, but if I'm out in the living or kitchen, feel free to ask me anything or just say hi!"
        }
    ],
    "subtitle": "Joined in September 2014",
    "tags": [
        "90 Reviews",
        "Identity verified"
    ],
    "title": "Hosted by Christopher"
}

Images (more pictures)

{
    "images": [
        {
            "url": "https://a0.muscache.com/pictures/miso/Hosting-52442080/original/9476ee0d-9284-43f9-b355-9f3d33a36146.jpeg",
            "metadata": {
                "caption": "Unit A",
                "imageType": "DETAIL",
                "isProfessional": false,
                "isVerified": null
            }
        },
        {
            "url": "https://a0.muscache.com/pictures/miso/Hosting-52442080/original/76348d24-dd74-4a17-93b6-8a87b196eaf2.jpeg",
            "metadata": {
                "caption": "Unit A",
                "imageType": "DETAIL",
                "isProfessional": false,
                "isVerified": null
            }
        },
        {
            "url": "https://a0.muscache.com/pictures/miso/Hosting-52442080/original/7ce6b421-5dd5-497e-a5c3-080d2cc3277e.jpeg",
            "metadata": {
                "caption": "Open floor concept with spiral staircase",
                "imageType": "DETAIL",
                "isProfessional": false,
                "isVerified": null
            }
        }
    ]
}

Reviews

{
    "reviews": [
        {
            "collectionTag": null,
            "comments": "We enjoyed our stay in the A-Frame in Black Mountain.  The unit was immaculately clean, well-appointed, and exactly as described.  It is a quick 5 min walk to downtown Black Mountain restaurants, breweries, and shops.  Communication and checkin/checkout were smooth and clear.",
            "id": "688418659332532723",
            "language": "en",
            "createdAt": "2022-08-07T20:04:59Z",
            "reviewee": {
                "deleted": false,
                "firstName": "Alexis",
                "hostName": "Alexis",
                "id": "228282763",
                "pictureUrl": "https://a0.muscache.com/im/pictures/user/e1cfcc55-20d5-41dc-9ec3-f3f1971b0420.jpg?aki_policy=profile_x_medium",
                "profilePath": "/users/show/228282763",
                "isSuperhost": false,
                "userProfilePicture": {
                    "baseUrl": "https://a0.muscache.com/im/pictures/user/e1cfcc55-20d5-41dc-9ec3-f3f1971b0420.jpg?aki_policy=profile_x_medium"
                }
            },
            "reviewer": {
                "deleted": false,
                "firstName": "Lisa",
                "hostName": "Lisa",
                "id": "51001360",
                "pictureUrl": "https://a0.muscache.com/im/pictures/user/92749d06-281f-4e9b-9e92-e59567e717ac.jpg?aki_policy=profile_x_medium",
                "profilePath": "/users/show/51001360",
                "isSuperhost": false,
                "userProfilePicture": {
                    "baseUrl": "https://a0.muscache.com/im/pictures/user/92749d06-281f-4e9b-9e92-e59567e717ac.jpg?aki_policy=profile_x_medium"
                }
            },
            "localizedReview": null,
            "rating": 5,
            "response": null,
            "roomTypeListingTitle": null,
            "highlightedReviewSentence": null,
            "highlightReviewMentioned": null,
            "subtitleItems": null,
            "channel": null
        },
        {
            "collectionTag": null,
            "comments": "Clean, convenient location, enjoyed our stay!",
            "id": "684041852841135472",
            "language": "en",
            "createdAt": "2022-08-01T19:09:03Z",
            "reviewee": {
                "deleted": false,
                "firstName": "Alexis",
                "hostName": "Alexis",
                "id": "228282763",
                "pictureUrl": "https://a0.muscache.com/im/pictures/user/e1cfcc55-20d5-41dc-9ec3-f3f1971b0420.jpg?aki_policy=profile_x_medium",
                "profilePath": "/users/show/228282763",
                "isSuperhost": false,
                "userProfilePicture": {
                    "baseUrl": "https://a0.muscache.com/im/pictures/user/e1cfcc55-20d5-41dc-9ec3-f3f1971b0420.jpg?aki_policy=profile_x_medium"
                }
            },
            "reviewer": {
                "deleted": false,
                "firstName": "Courtney",
                "hostName": "Courtney",
                "id": "19072648",
                "pictureUrl": "https://a0.muscache.com/im/users/19072648/profile_pic/1406601558/original.jpg?aki_policy=profile_x_medium",
                "profilePath": "/users/show/19072648",
                "isSuperhost": false,
                "userProfilePicture": {
                    "baseUrl": "https://a0.muscache.com/im/users/19072648/profile_pic/1406601558/original.jpg?aki_policy=profile_x_medium"
                }
            },
            "localizedReview": null,
            "rating": 5,
            "response": "Thank you, Courtney! I'm so glad you enjoyed our convenient location!",
            "roomTypeListingTitle": null,
            "highlightedReviewSentence": null,
            "highlightReviewMentioned": null,
            "subtitleItems": null,
            "channel": null
        }
    ]
}

Updates & Bug Fixes

  • [ tomorrow ] Updates: output examples
  • [ yesterday ] Bug Fixed: superhost parameter not recognized
  • [ yesterday ] Update: changed reviews (number of reviews) parameter to integer. 0=disabled

Industries

See how The AirBnb Explorer is used in industries around the world