Logo SearchApi

Airbnb Property Availability Calendar API Documentation

GET   /api/v1/search?engine=airbnb_property_availability_calendar
OpenAPI Initiative Download OpenAPI Spec

The Airbnb Property Availability Calendar API returns the day-by-day booking calendar for an Airbnb property — including which dates are available, bookable, and the minimum / maximum stay constraints. Use it to plan trips, monitor opening windows, or build a visual calendar.

API Parameters

Search Query

  • Name
    property_id
    Required
    Required
    Description

    Parameter defines the ID of the property you want to retrieve the availability calendar for. This is the unique identifier for the property on Airbnb and it can be retrieved using the Airbnb Search API or in the URL on https://www.airbnb.com/rooms/property_id.

Date Range

  • Name
    start_month
    Required
    Optional
    Description

    Parameter defines the starting month of the calendar window. Must be an integer between 1 and 12. Defaults to the current month.

  • Name
    start_year
    Required
    Optional
    Description

    Parameter defines the starting year of the calendar window. Must be a 4 digit year. Defaults to the current year.

  • Name
    months
    Required
    Optional
    Description

    Parameter defines the number of months to retrieve starting from start_month / start_year. Must be an integer between 1 and 12. Defaults to 12.

Localization

  • Name
    airbnb_domain
    Required
    Optional
    Description

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

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_property_availability_calendar.

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?engine=airbnb_property_availability_calendar&property_id=357576
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "airbnb_property_availability_calendar",
  "property_id": "357576"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_kQzy2PnvoBkZCXvD3Yx0EK15",
    "status": "Success",
    "created_at": "2026-05-28T11:39:04Z",
    "request_time_taken": 1.98,
    "parsing_time_taken": 0.01,
    "total_time_taken": 1.99,
    "request_url": "https://www.airbnb.com/rooms/357576",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_kQzy2PnvoBkZCXvD3Yx0EK15.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_kQzy2PnvoBkZCXvD3Yx0EK15"
  },
  "search_parameters": {
    "engine": "airbnb_property_availability_calendar",
    "airbnb_domain": "airbnb.com",
    "property_id": "357576",
    "start_month": 5,
    "start_year": 2026,
    "months": 12
  },
  "months": [
    {
      "year": 2026,
      "month": 5,
      "days": [
        {
          "date": "2026-05-01",
          "is_available": false,
          "is_available_for_checkin": false,
          "is_available_for_checkout": false,
          "is_bookable": false,
          "min_nights": 1,
          "max_nights": 1125
        },
        {
          "date": "2026-05-02",
          "is_available": false,
          "is_available_for_checkin": false,
          "is_available_for_checkout": false,
          "is_bookable": false,
          "min_nights": 1,
          "max_nights": 1125
        }
      ]
    },
    {
      "year": 2026,
      "month": 6,
      "days": [
        {
          "date": "2026-06-01",
          "is_available": false,
          "is_available_for_checkin": false,
          "is_available_for_checkout": false,
          "is_bookable": false,
          "min_nights": 3,
          "max_nights": 1125
        },
        {
          "date": "2026-06-03",
          "is_available": true,
          "is_available_for_checkin": true,
          "is_available_for_checkout": false,
          "is_bookable": true,
          "min_nights": 1,
          "max_nights": 1125
        }
      ]
    }
  ]
}

Custom Date Range

Custom Date Range
GET
https://www.searchapi.io/api/v1/search?engine=airbnb_property_availability_calendar&months=3&property_id=357576&start_month=7&start_year=2026
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "airbnb_property_availability_calendar",
  "property_id": "357576",
  "start_month": "7",
  "start_year": "2026",
  "months": "3"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_wr07vRBGpw4dc9qrgb6ZlXJj",
    "status": "Success",
    "created_at": "2026-05-28T11:39:07Z",
    "request_time_taken": 1.92,
    "parsing_time_taken": 0.0,
    "total_time_taken": 1.92,
    "request_url": "https://www.airbnb.com/rooms/357576",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_wr07vRBGpw4dc9qrgb6ZlXJj.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_wr07vRBGpw4dc9qrgb6ZlXJj"
  },
  "search_parameters": {
    "engine": "airbnb_property_availability_calendar",
    "airbnb_domain": "airbnb.com",
    "property_id": "357576",
    "start_month": 6,
    "start_year": 2026,
    "months": 3
  },
  "months": [
    {
      "year": 2026,
      "month": 6,
      "days": [
        {
          "date": "2026-06-01",
          "is_available": false,
          "is_available_for_checkin": false,
          "is_available_for_checkout": false,
          "is_bookable": false,
          "min_nights": 3,
          "max_nights": 1125
        },
        {
          "date": "2026-06-03",
          "is_available": true,
          "is_available_for_checkin": true,
          "is_available_for_checkout": false,
          "is_bookable": true,
          "min_nights": 1,
          "max_nights": 1125
        }
      ]
    },
    {
      "year": 2026,
      "month": 7,
      "days": [
        {
          "date": "2026-07-01",
          "is_available": true,
          "is_available_for_checkin": false,
          "is_available_for_checkout": true,
          "is_bookable": true,
          "min_nights": 3,
          "max_nights": 1125
        },
        {
          "date": "2026-07-04",
          "is_available": false,
          "is_available_for_checkin": false,
          "is_available_for_checkout": false,
          "is_bookable": false,
          "min_nights": 2,
          "max_nights": 1125
        }
      ]
    }
  ]
}