Airbnb Search Scraper

Scrape Airbnb listings from search results or specific listing URLs. Extract titles, prices, ratings, reviews, property details, amenities, host info, images, coordinates, and more.

Features

• Search Mode: Search Airbnb by location with date, guest, price, and property type filters
• Product URL Mode: Scrape specific Airbnb listing URLs directly
• Deep Scrape: Visit each listing detail page for full data (description, amenities, host info, reviews, images, coordinates)
• Light Scrape: Fast search-card-only extraction (fewer fields, much faster)
• First-Page Reviews: Optionally extract up to 10 reviews per listing
• Pagination: Automatically follows search result pages up to maxItems

Input Parameters

Parameter	Type	Default	Description
mode	string	search	search — search by location; productUrl — scrape specific listing URLs
location	string	Paris, France	Location to search for (used in search mode)
checkIn	string		Check-in date in YYYY-MM-DD format
checkOut	string		Check-out date in YYYY-MM-DD format
guests	integer	2	Number of guests
maxItems	integer	50	Maximum number of listings to scrape
priceMin	integer		Minimum price per night filter
priceMax	integer		Maximum price per night filter
propertyType	string	any	any, entire_home, private_room, shared_room
productUrls	array		Airbnb listing URLs (used in productUrl mode)
includeReviews	boolean	true	Extract first-page reviews for each listing
deepScrape	boolean	true	Visit detail pages for full data; false = search card only
proxyConfiguration	object		Proxy settings (residential proxies recommended)

Example Input — Search Mode

{
    "mode": "search",
    "location": "Paris, France",
    "checkIn": "2026-03-15",
    "checkOut": "2026-03-20",
    "guests": 2,
    "maxItems": 5,
    "includeReviews": true,
    "deepScrape": true,
    "propertyType": "any"
}

Example Input — Product URL Mode

{
    "mode": "productUrl",
    "productUrls": [
        "https://www.airbnb.com/rooms/1104883308160967951"
    ],
    "includeReviews": true,
    "deepScrape": true,
    "maxItems": 5
}

Example Output — Search Mode (deepScrape: false)

When deepScrape is false, only search card data is returned (fast):

{
    "position": 1,
    "title": "Chic Studio Near Eiffel Tower",
    "description": "Flat in Paris",
    "price": "€120",
    "originalPrice": null,
    "totalPrice": "€600",
    "nights": 5,
    "freeCancellation": false,
    "rating": 4.92,
    "reviewCount": 187,
    "type": "Entire flat in Paris",
    "bedrooms": 1,
    "beds": 1,
    "bathrooms": 1,
    "link": "https://www.airbnb.com/rooms/12345678",
    "thumbnail": "https://a0.muscache.com/im/pictures/miso/...",
    "thumbnails": [
        "https://a0.muscache.com/im/pictures/miso/..."
    ],
    "superhost": true,
    "guestFavourite": false
}

Example Output — Detail Mode (deepScrape: true)

When deepScrape is true, each listing includes full detail data:

{
    "position": 1,
    "title": "Chic Studio Near Eiffel Tower",
    "price": "€120",
    "rating": 4.92,
    "reviewCount": 187,
    "type": "Entire flat in Paris",
    "link": "https://www.airbnb.com/rooms/12345678",
    "thumbnail": "https://a0.muscache.com/im/pictures/miso/...",
    "superhost": true,
    "guestFavourite": false,
    "detail": true,
    "scrapedAt": "2025-01-15T10:30:00.000Z",
    "detailData": {
        "title": "Chic Studio Near Eiffel Tower",
        "description": "A beautifully renovated studio apartment in the heart of Paris, just steps from the Eiffel Tower...",
        "propertyType": "Entire serviced apartment",
        "locationName": "Paris, France",
        "maxGuests": 2,
        "bedrooms": 1,
        "beds": 1,
        "bathrooms": 1,
        "hostName": "Marie",
        "isSuperhost": true,
        "hostYearsHosting": 5,
        "isGuestFavourite": false,
        "rating": 4.92,
        "reviewCount": 187,
        "categoryRatings": {
            "cleanliness": 4.9,
            "accuracy": 5.0,
            "communication": 4.9,
            "location": 5.0,
            "value": 4.8
        },
        "price": "€600",
        "originalPrice": null,
        "priceLabel": "€600 for 5 nights",
        "amenities": [
            "Wifi",
            "Kitchen",
            "Washing machine",
            "Air conditioning",
            "Hair dryer",
            "Iron"
        ],
        "highlights": [
            "Self check-in",
            "Great location",
            "Fast wifi"
        ],
        "sleepingArrangement": "1 double bed",
        "cancellationPolicy": "Free cancellation before March 10",
        "houseRules": "No smoking, No parties, No pets",
        "checkoutTime": "11:00 am",
        "coordinates": {
            "lat": 48.8566,
            "lng": 2.3522
        },
        "images": [
            "https://a0.muscache.com/im/pictures/miso/..."
        ],
        "neighbourhoodDescription": "Located in the 7th arrondissement, one of the most elegant districts of Paris...",
        "hostAbout": "Welcome to Paris! I'm Marie and I've been hosting guests for 5 years...",
        "reviews": [
            {
                "author": "John",
                "authorLocation": "New York",
                "rating": 5,
                "date": "December 2024",
                "stayType": "Stayed 5 nights",
                "text": "Amazing location and beautiful apartment. Marie was very responsive."
            }
        ]
    }
}

Running Locally

cd airbnb-search-scraper
npm ci
npm start

Output will be in storage/datasets/default/.

Notes

• Residential proxies are strongly recommended — Airbnb actively blocks datacenter IPs
• deepScrape: true is slower but returns comprehensive data (description, amenities, host info, reviews, coordinates, images)
• deepScrape: false only returns search card data (fast, suitable for price/availability monitoring)
• Maximum concurrency is 6 to avoid rate limiting