GET

Airbnb Listing Calendar API

Get real-time calendar availability and stay requirements for any Airbnb listing.

Overview

Real-time Availability

Calendar data is fetched in real-time from Airbnb. Availability and prices may change frequently.

The Airbnb Calendar endpoint returns per-day availability for up to 12 months, including minimum night requirements and check-in eligibility. Perfect for building availability calendars and checking booking windows.

Endpoint URL

GET https://api.stayapi.com/v1/airbnb/listing/{listing_id}/calendar

Parameters

Parameter	Type	Required	Description
listing_id	integer	Required	Airbnb listing ID (path parameter)
months	integer	Optional	Number of months to fetch (1-12, default: 12)

Response Structure

Calendar Data

months - Array of month objects with daily availability
date - Date in YYYY-MM-DD format
available - Whether the day is available for booking
available_for_checkin - Whether guests can check in on this date
bookable - Whether the date can be booked
min_nights - Minimum nights required for check-in on this date

Request

curl -X GET "https://api.stayapi.com/v1/airbnb/listing/22120898/calendar?months=3" \
  -H "x-api-key: YOUR_API_KEY"

const listingId = 22120898;
const params = new URLSearchParams({
  months: "3"
});

const response = await fetch(
  `https://api.stayapi.com/v1/airbnb/listing/${listingId}/calendar?${params}`,
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();

for (const month of data.months) {
  const available = month.days.filter(d => d.available).length;
  console.log(`${month.year}-${month.month}: ${available} days available`);
}

import requests

listing_id = 22120898
url = f"https://api.stayapi.com/v1/airbnb/listing/{listing_id}/calendar"
headers = {"x-api-key": "YOUR_API_KEY"}
params = {
    "months": 3
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

for month in data["months"]:
    available = sum(1 for d in month["days"] if d["available"])
    print(f"{month['year']}-{month['month']}: {available} days available")

<?php
$listingId = 22120898;
$url = "https://api.stayapi.com/v1/airbnb/listing/" . $listingId . "/calendar";
$params = http_build_query([
    "months" => 3
]);

$ch = curl_init($url . "?" . $params);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-api-key: YOUR_API_KEY"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);
curl_close($ch);

foreach ($data["months"] as $month) {
    $available = count(array_filter($month["days"], fn($d) => $d["available"]));
    echo $month["year"] . "-" . $month["month"] . ": " . $available . " days available\n";
}
?>

require "net/http"
require "json"
require "uri"

listing_id = 22120898
uri = URI("https://api.stayapi.com/v1/airbnb/listing/\#{listing_id}/calendar")
uri.query = URI.encode_www_form({
  months: 3
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "YOUR_API_KEY"

response = http.request(request)
data = JSON.parse(response.body)

data["months"].each do |month|
  available = month["days"].count { |d| d["available"] }
  puts "\#{month['year']}-\#{month['month']}: \#{available} days available"
end

Response

{
  "success": true,
  "listing_id": 22120898,
  "months": [
    {
      "month": 3,
      "year": 2026,
      "days": [
        {
          "date": "2026-03-06",
          "available": true,
          "available_for_checkin": true,
          "bookable": true,
          "min_nights": 2
        },
        {
          "date": "2026-03-07",
          "available": false,
          "available_for_checkin": false,
          "bookable": false,
          "min_nights": null
        }
      ]
    }
  ]
}

{
  "type": "https://api.stayapi.com/errors/upstream-error",
  "title": "Upstream Error",
  "status": 502,
  "detail": "Failed to fetch calendar",
  "error_code": "UPSTREAM_ERROR",
  "provider": "airbnb"
}