> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/airbnb/listings-listingid-availability>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/airbnb/listings-listingid-availability.mdx>

---

# Airbnb Availability API

Which nights a listing is free, for up to a year, one row a day.

`GET /v1/airbnb/listings/{listingId}/availability` takes the listing id or URL, `month` (`YYYY-MM`, the first month to show, from last month to 23 months ahead; this month by default) and `months` (1 to 12, default 12). Each day has its `date`, whether it is `available`, whether a stay can start (`availableForCheckIn`) or end (`availableForCheckOut`) that day, `bookable` and the `minNights` and `maxNights` for a stay starting then.

`data.availableDays` counts the free days in the range. Past days are never available. A removed listing answers `lookupStatus: not_found`. The calendar carries no prices, which depend on the stay: search with dates for those.

## Request

- **Endpoint:** `GET /v1/airbnb/listings/{listingId}/availability`
- **Credits:** 1 credit
Failed requests are free
Found, empty and not-found answers are all charged
- **Input:** by listing id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/airbnb/listings/listingid/availability/get)
- **Platform page:** [/platforms/airbnb](https://www.socialfetch.dev/platforms/airbnb)

## FAQ

### How far ahead does the calendar go?

Up to twelve months per request, starting from any month between last month and 23 months ahead. Ask again with a later month for the rest.

### Can I estimate occupancy from it?

The calendar shows which nights are not free, whether booked or blocked by the host; it cannot tell the two apart. Track it over time to see nights change from free to taken.

### Does the calendar include prices?

No. Prices depend on the dates and guests of a stay. Use the search endpoint with checkIn, checkOut and guests to price a stay.

### How many credits does a request cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
