Logo SearchApi

Airbnb API Documentation

GET   /api/v1/search?engine=airbnb

The Airbnb API gives access to property listings, real-time prices, availability calendars, reviews, and detailed property info. Search for homes anywhere in the world using flexible location and filter options.

API Parameters

Location

  • Name
    q
    Required
    Required
    Description

    This parameter is used for the location you want to search for on Airbnb. Optional when bounding_box is provided.

  • Name
    bounding_box
    Required
    Required
    Description

    This parameter is used to specify the bounding box for the search. The format is [[lat,long],[lat,long]]. The first coordinate is the top-right corner of the bounding box, and the second coordinate is the bottom-left corner of the bounding box.

    Optional when q is provided. If both are passed, the bounding_box parameter takes precedence, and q should be within the bounding box.

Localization

  • Name
    airbnb_domain
    Required
    Optional
    Description

    This parameter defines the Airbnb domain to search on. Airbnb has multiple domains for different countries/regions and languages. Check the full list of supported Airbnb domains.

  • Name
    currency
    Required
    Optional
    Description

    This parameter defines the currency for pricing information. Check the full list of supported currencies.

Dates

  • Name
    check_in_date
    Required
    Optional
    Description

    Defines the check-in date for the Airbnb stay in the format YYYY-MM-DD. This date marks the beginning of the reservation. Can not be used together with time_period.

  • Name
    check_out_date
    Required
    Optional
    Description

    The check-out date for the Airbnb stay in the format YYYY-MM-DD. This date marks the end of the reservation.
    Parameter check_in_date must also be provided when using the check_out_date parameter. Defaults to the day after check_in_date if not provided.

  • Name
    time_period
    Required
    Optional
    Description

    This parameter restricts results to specific time periods in any given date. Can not be used together with check_in_date and check_out_date. Supported values are:

    • weekend_trip - 2 nights on a weekend.
    • one_week - 5 nights.
    • one_month - 28 nights.

Guests

  • Name
    adults
    Required
    Optional
    Description

    The number of adults (Ages 13 and above) staying at the Airbnb property. Up to 16 adults are allowed.
    Defaults to 1 if children, infants or pets are provided.

  • Name
    children
    Required
    Optional
    Description

    The number of children (Ages 2-12) staying at the Airbnb property. Up to 15 children are allowed.

  • Name
    infants
    Required
    Optional
    Description

    The number of infants (Ages under 2) staying at the Airbnb property. Up to 5 infants are allowed.

  • Name
    pets
    Required
    Optional
    Description

    The number of pets staying at the Airbnb property. Up to 5 pets are allowed.

Price

  • Name
    price_min
    Required
    Optional
    Description

    This parameter controls the minimum price of the properties returned.

  • Name
    price_max
    Required
    Optional
    Description

    This parameter controls the maximum price of the properties returned.

Accommodations

  • Name
    type_of_place
    Required
    Optional
    Description

    This parameter controls the type of place you want to rent. Acceptable values are any, room or entire_home. Defaults to any.

  • Name
    property_types
    Required
    Optional
    Description

    This parameter controls the type of property you want to rent. Acceptable values are house, guesthouse, apartment or hotel.
    Multiple values can be applied by separating them with commas (e.g., house,apartment).

  • Name
    bedrooms
    Required
    Optional
    Description

    The number of bedrooms the Airbnb property has. Acceptable values are 0-8.

  • Name
    beds
    Required
    Optional
    Description

    The number of beds the Airbnb property has. Acceptable values are 0-8.

  • Name
    bathrooms
    Required
    Optional
    Description

    The number of bathrooms the Airbnb property has. Acceptable values are 0-8.

Filters

  • Name
    amenities
    Required
    Optional
    Description

    This parameter allows you to filter properties by amenties they offer. Multiple amenties can be applied by separating them with commas (e.g., wifi,air_conditioning). Check the full list of amenities supported by Airbnb.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to airbnb.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?adults=2&check_in_date=2025-10-29&check_out_date=2025-11-05&engine=airbnb&q=Rio+de+Janeiro
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "airbnb",
  "q": "Rio de Janeiro",
  "check_in_date": "2025-10-29",
  "check_out_date": "2025-11-05",
  "adults": 2
}

response = requests.get(url, params=params)
print(response.text)
Response
{
    "search_metadata": {
        "id": "search_vr7K8ndWgWe1idN83P45k2mY",
        "status": "Success",
        "created_at": "2025-10-10T18:46:11Z",
        "request_time_taken": 1.3,
        "parsing_time_taken": 0.1,
        "total_time_taken": 1.4,
        "request_url": "https://www.airbnb.com/s/Rio-de-Janeiro/homes?checkin=2025-10-21&checkout=2025-10-28",
        "html_url": "https://www.searchapi.io/api/v1/searches/search_vr7K8ndWgWe1idN83P45k2mY.html",
        "json_url": "https://www.searchapi.io/api/v1/searches/search_vr7K8ndWgWe1idN83P45k2mY"
    },
    "search_parameters": {
        "engine": "airbnb",
        "airbnb_domain": "airbnb.com",
        "q": "Rio de Janeiro",
        "check_in_date": "2025-10-21",
        "check_out_date": "2025-10-28"
    },
    "search_information": {
        "query_displayed": "Homes in Rio de Janeiro",
        "results":"Over 1,000 homes in Rio de Janeiro",
        "time_period": "Oct 21 – 28",
        "check_in_date": "2025-10-21",
        "check_out_date": "2025-10-28",
        "guests": "Add guests"
    },
    "properties": [
        {
            "position": 1,
            "id": "1323387359662817121",
            "title": "Cozy & Modern Studio In The Middle of Copacabana",
            "description": "Apartment in Copacabana",
            "link": "https://www.airbnb.com/rooms/1323387359662817121",
            "rating": 4.89,
            "reviews": 9,
            "price": {
                "total_price": "$310",
                "extracted_total_price": 310,
                "qualifier": "for 7 nights",
                "extracted_qualifier": 7,
                "original_price": "$347",
                "extracted_original_price": 347,
                "price_per_qualifier": "7 nights x $49.45",
                "extracted_price_per_qualifier": 49.45,
                "breakdown": [
                    {
                        "description": "Price after discount",
                        "price": "$309.93",
                        "extracted_price": 309.93
                    }
                ]
            },
            "accommodations": [
                "1 bedroom",
                "1 bed"
            ],
            "gps_coordinates": {
                "latitude": -22.9697,
                "longitude": -43.1856
            },
            "badges": [
                "Superhost"
            ],
            "images": [
                "https://a0.muscache.com/im/pictures/hosting/Hosting-U3RheVN1cHBseUxpc3Rpbmc6MTMyMzM4NzM1OTY2MjgxNzEyMQ%3D%3D/original/ca845ada-f923-4a5d-b2de-88b72ee969a6.jpeg",
                ...
            ]
        },
        ...
    ],
    "pagination": {
        "next_page_token": "eyJmZWRlcmF0ZWRfc0ifQ..."
    }
}

Search with Bounding Box

Search with Bounding Box
GET
https://www.searchapi.io/api/v1/search?bounding_box=%5B%5B41.42%2C2.20%5D%2C%5B41.36%2C2.14%5D%5D&engine=airbnb
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "airbnb",
  "bounding_box": "[[41.42,2.20],[41.36,2.14]]"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
    "search_parameters": {
        "engine": "airbnb",
        "airbnb_domain": "airbnb.com",
        "bounding_box": "[[41.42,2.20],[41.36,2.14]]",
        "time_period": "one_week"
    },
    "search_information": {
        "query_displayed": "Homes in map area",
        "results": "Over 1,000 homes",
        "time_period": "Any week",
        "guests": "Add guests"
    },
    "properties": [
        {
            "position": 1,
            "id": "49963630",
            "title": "Penthouse with large terrace in Gracia",
            "description": "Barcelona, Spain",
            "link": "https://www.airbnb.com/rooms/49963630",
            "rating": 4.98,
            "time_period": "Dec 5 – 10",
            "check_in_date": "2025-12-05",
            "check_out_date": "2025-12-10",
            "price": {
                "total_price": "$1,591 USD",
                "extracted_total_price": 1591,
                "qualifier": "for 5 nights",
                "extracted_qualifier": 5,
                "price_per_qualifier": "5 nights x $318.09",
                "extracted_price_per_qualifier": 318.09
            },
            "distance": "8,522 miles away",
            "extracted_distance": 8522,
            "gps_coordinates": {
                "latitude": 41.4025,
                "longitude": 2.1525
            },
            "badges": [
                "Guest favorite"
            ],
            "images": [
                "https://a0.muscache.com/im/pictures/miso/Hosting-49963630/original/b23c7d8d-aad2-4cb8-b7a7-a0e7bd7633ee.jpeg",
                ...
            ]
        },
        ...
    ],
    "pagination": {
        "next_page_token": "eyJmZWRlcmF0ZWRfc2VhcmNoX2lkIjoiNDk5ZTk1ZDktZDEwMi00NTYzLTgwNDUtNzIxZjMwZjg1YTY1IiwiZmVkZXJhdGVkX3NlYXJjaF9zZXNzaW9uX2lkIjoiMjljYzhiYWEtOGZmMC00MjMxLWJlMDQtYzBjNTkzMWEwMzVhIiwiY3Vyc29yIjoiZXlKelpXTjBhVzl1WDI5bVpuTmxkQ0k2TUN3aWFYUmxiWE5mYjJabWMyVjBJam94T0N3aWRtVnljMmx2YmlJNk1YMD0ifQ=="
    }
}

Search with Time Period

Search with Time Period
GET
https://www.searchapi.io/api/v1/search?engine=airbnb&q=Girona&time_period=weekend_trip
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "airbnb",
  "q": "Girona",
  "time_period": "weekend_trip"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
    "search_parameters": {
        "engine": "airbnb",
        "airbnb_domain": "airbnb.com",
        "q": "Girona",
        "time_period": "weekend_trip"
    },
    "search_information": {
        "query_displayed": "Homes in Girona",
        "results": "Over 1,000 homes in Girona",
        "time_period": "Any weekend",
        "guests": "Add guests"
    },
    "properties": [
        {
            "position": 1,
            "id": "25914412",
            "title": "Tarlà - Shared Female Room",
            "description": "Hotel room in Girona",
            "link": "https://www.airbnb.com/rooms/25914412",
            "rating": 4.74,
            "reviews": 115,
            "time_period": "Nov 14 – 16",
            "check_in_date": "2025-11-14",
            "check_out_date": "2025-11-16",
            "price": {
                "total_price": "$82",
                "extracted_total_price": 82,
                "qualifier": "for 2 nights",
                "extracted_qualifier": 2,
                "price_per_qualifier": "2 nights x $40.76",
                "extracted_price_per_qualifier": 40.76
            },
            "accommodations": [
                "1 bedroom",
                "4 beds"
            ],
            "gps_coordinates": {
                "latitude": 41.97673,
                "longitude": 2.81245
            },
            "badges": [
                "Superhost"
            ],
            "images": [
                "https://a0.muscache.com/im/pictures/80c024dc-37d5-44cd-985a-ebfa7185fe34.jpg",
                ...
            ]
        },
        ...
    ]
}