Get an Airbnb Stay Calendar and Night Restrictions
View all Airbnb Search, Prices & Reviews endpoints →Provide a listingId from stays-search. Optional year and month select the starting calendar month, and count requests 1 to 12 months; documented defaults use the current year/month and 12 months. The documented body contains data.calendar_months with condition_ranges, start_date, end_date and conditions including min_nights, max_nights, closed_to_arrival and closed_to_departure. Inspect returned calendar content to identify candidate stay windows. This endpoint was not live-verified in the current set. Unavailable dates can reflect blocked calendars or restrictions and do not prove confirmed bookings, actual occupancy or earned revenue.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/airbnb-search/stays-availability-calendar API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/stays-availability-calendar?key=<API_KEY>&listingId=<listingId>&count=12'
Query Result
Use Cases
- Populate a multi-month stay planning view with the calendar information returned for one selected listing.
- Screen candidate trip windows against minimum-night and arrival/departure restrictions before requesting a quote.
- Compare timestamped calendar observations for a shortlist without labeling blocked dates as reservations.
- Reduce an accommodation date picker's unsuitable windows using returned conditions and a later dated-price recheck.
Frequently asked questions
How do I choose the calendar period?
Send listingId plus optional year, month and count. count is documented from 1 to 12; omitting the period uses the current year/month and the documented 12-month span.
Can I derive actual occupancy from unavailable calendar dates?
No. Unavailable dates may reflect host blocks, rules or other restrictions. The documented calendar is not evidence of a confirmed reservation, completed stay or revenue, and its current endpoint behavior still needs separate verification.