# Airbnb API: Check listing availability > Checks a public Airbnb listing's calendar for one or more months: available nights per month and, for each day from today on, whether check-in and check-out are possible, the minimum stay, and the nightly price when Airbnb shows one. Unofficial. Not affiliated with or endorsed by Airbnb. - Page: https://fous.com/methods/airbnb.com/check-listing-availability - Method: `airbnb.com/check_listing_availability`, version 1 - Website: airbnb.com - Returns: listing title, listing link, available nights per month, days (date, check-in, check-out, minimum nights, price per night, currency) - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1ยข with pay as you go); failed runs are free - Verified: Nov 2, 2026 ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `month` | string | no | `"2026-11"` | First calendar month in YYYY-MM, for example 2026-11; defaults to the current month. | | `months` | integer | no | `2` | Number of months to check, for example 2; defaults to 1 (up to 12). Default 1. | | `listing` | string | yes | `"https://www.airbnb.com/rooms/1259514380601735776"` | Airbnb listing link, for example https://www.airbnb.com/rooms/1259514380601735776. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "month": "2026-11", "months": 2, "listing": "https://www.airbnb.com/rooms/1259514380601735776" } ``` Its output: ```json { "days": [ { "date": "2026-11-01", "currency": null, "minimum_nights": 3, "price_per_night": null, "available_for_check_in": false, "available_for_check_out": false }, { "date": "2026-11-02", "currency": null, "minimum_nights": 3, "price_per_night": null, "available_for_check_in": false, "available_for_check_out": false }, { "date": "2026-11-03", "currency": null, "minimum_nights": 3, "price_per_night": null, "available_for_check_in": false, "available_for_check_out": false } ], "listing_link": "https://www.airbnb.com/rooms/1259514380601735776", "listing_title": "Luxury top-floor apt. in heart of Marina w/ views!", "available_nights_per_month": [ { "count": 1, "month": "2026-11" }, { "count": 0, "month": "2026-12" } ] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"airbnb.com/check_listing_availability","input":{"month":"2026-11","months":2,"listing":"https://www.airbnb.com/rooms/1259514380601735776"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Is https://www.airbnb.com/rooms/53817264 free any weekends in March 2026? Need check-in dates and nightly prices. - Show me which nights are open at this cabin for the next 3 months starting 2026-06, with minimum stay requirements: https://www.airbnb.com/rooms/1259514380601735776 - Can I check in on Dec 20 and out on Dec 27 at airbnb.com/rooms/41029837? Please also show the minimum-night rule for those dates. - How many available nights does listing 718263540119283746 have each month from September through December 2026? Link is https://www.airbnb.com/rooms/718263540119283746 - Pull this month's calendar for https://www.airbnb.com/rooms/29475610, including daily prices and which days allow checkout. ## Input schema ```json { "type": "object", "required": [ "listing" ], "properties": { "month": { "type": "string", "description": "First calendar month in YYYY-MM, for example 2026-11; defaults to the current month." }, "months": { "type": "integer", "default": 1, "maximum": 12, "minimum": 1, "description": "Number of months to check, for example 2; defaults to 1 (up to 12)." }, "listing": { "type": "string", "description": "Airbnb listing link, for example https://www.airbnb.com/rooms/1259514380601735776." } } } ``` ## Output schema ```json { "type": "object", "required": [ "listing_title", "listing_link", "available_nights_per_month", "days" ], "properties": { "days": { "type": "array", "items": { "type": "object", "required": [ "date", "available_for_check_in", "available_for_check_out", "minimum_nights", "price_per_night", "currency" ], "properties": { "date": { "type": "string" }, "currency": { "type": [ "string", "null" ] }, "minimum_nights": { "type": [ "integer", "null" ] }, "price_per_night": { "type": [ "number", "null" ] }, "available_for_check_in": { "type": "boolean" }, "available_for_check_out": { "type": "boolean" } } } }, "listing_link": { "type": "string" }, "listing_title": { "type": "string" }, "available_nights_per_month": { "type": "array", "items": { "type": "object", "required": [ "month", "count" ], "properties": { "count": { "type": "integer" }, "month": { "type": "string" } } } } } } ``` ## See more - [Airbnb API: Get listing](https://fous.com/methods/airbnb.com/get-listing.md): Gets public details for one Airbnb listing from its link. When dates are given, it also returns dated prices and cancellation terms if Airbnb offers a quote. - [Airbnb API: Search stays](https://fous.com/methods/airbnb.com/search-stays.md): Searches public Airbnb homes for a destination and travel dates. Each stay comes with its price, rating, room details and listing link. Prices are the displayed trip totals, including fees. - [Recreation.gov API: Check campsite availability](https://fous.com/methods/recreation.gov/check-campsite-availability.md): Finds Recreation.gov campsites free for every night of a stay at a campground, with site details. Nightly prices are shown only when a campground lists a single nightly rate. Availability can change before booking. - [Ryanair API: Get fare calendar](https://fous.com/methods/ryanair.com/get-fare-calendar.md): Gets the lowest one-way fare on each day of a month for a direct Ryanair route. For a city with several airports, it returns the airport pair with the lowest fare that month. - [Nasdaq API: Get IPO calendar](https://fous.com/methods/nasdaq.com/get-ipo-calendar.md): Lists Nasdaq's US IPO calendar entries for a month and listing stage (upcoming, priced, filed or withdrawn), with dates, prices, shares, offer amounts and Nasdaq links, sorted by date. Filed and withdrawn entries may not show a price or exchange. - [Agoda API: Get room prices](https://fous.com/methods/agoda.com/get-room-prices.md): Finds room offers and nightly prices for one Agoda hotel on selected dates. Totals are calculated from displayed nightly prices before taxes and fees; final checkout totals may differ. - [Google API: Get cheapest flight dates in a month](https://fous.com/methods/google.com/get-cheapest-dates.md): Finds the lowest Google Flights fare for each departure date in a month between two places, for one-way trips or a fixed trip length, with the cheapest option and any price insight shown. - [Priceline API: Search hotels](https://fous.com/methods/priceline.com/search-hotels.md): Find publicly priced Priceline hotels in a place for your travel dates, with guest ratings, nightly and total USD prices, and cancellation information. Excludes hotels hidden behind anonymous deals and sign-in-only prices. - [All Airbnb methods](https://fous.com/methods/airbnb.com.md)