# Airbnb Listing Availability API (https://www.socialcrawl.dev/platforms/airbnb/listing-availability)

> Returns an Airbnb listing's calendar night by night for up to 12 months: whether each night is available and bookable, whether a stay can start or end on it, and the minimum and maximum stay. A closed night that still allows check-out is the last night of someone's booking. Nights beyond the host's own booking window come back unavailable, so a long closed run at the end usually marks the window's edge, not bookings. There is no per-night price here; GET /v1/airbnb/listing with dates prices a stay.

TL;DR: `GET /v1/airbnb/listing/availability` costs 5 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | no | The Airbnb listing id, for example 33579922. Send id or url. |
| `url` | no | An Airbnb listing link, for example https://www.airbnb.com/rooms/33579922. |
| `from` | no | Any date inside the first month to return, YYYY-MM-DD. Default this month. |
| `months` | no | Months to return, 1 to 12. Default 12. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/airbnb/listing/availability" \
  --data-urlencode "id=33579922" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get an Airbnb listing's availability calendar?

Call GET /v1/airbnb/listing/availability and send id or url for the listing. It returns the calendar night by night for up to 12 months in one call, with no next page.

### What does each night include?

Whether the night is available and bookable, whether a stay can start or end on it, and the minimum and maximum stay.

### What does a closed night that still allows check-out mean?

It is the last night of someone's booking.

### Does the calendar tell me bookings or prices?

Not exactly. Nights beyond the host's own booking window come back unavailable, so a long closed run at the end usually marks the window's edge, not bookings. There is no per-night price here, and GET /v1/airbnb/listing with dates prices a stay.

### How much does this Airbnb endpoint cost?

Each call costs 5 credits on the advanced tier. There is no subscription, and 100 free credits cover 20 calls.

See the full Airbnb API: https://www.socialcrawl.dev/platforms/airbnb

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I get an Airbnb availability calendar with an API?
- Can I see which nights an Airbnb listing is available?