Get Airbnb listing availability
Get an Airbnb listing's availability calendar day by day, with minimum and maximum stays.
Headers
Get your API keyAPI key (`sfk_...`)
Airbnb listing id: the number in the listing URL (`airbnb.com/rooms/1900063`), e.g. `1900063`. The full listing URL also works. Search results return it as `listingId`.
pattern: ^[1-9]\d{0,19}$
First month to show, `YYYY-MM`, from last month to 23 months ahead. Default: this month (UTC).
pattern: ^(\d{4})-(0[1-9]|1[0-2])$
How many months to show, 1 to 12. Default 12.
≥ 1 · ≤ 12
Endpoint-specific response payload.
`not_found` when no listing has this id or the host removed it.
one of: found, not_found
The listing id asked for.
First month shown, `YYYY-MM`.
Months shown.
Days in the range that are free.
Every day of the months shown, in order. Past days are never available.
Day, `YYYY-MM-DD`.
Whether the night is free.
Whether a stay can start this day.
Whether a stay can end this day.
Whether the day can be booked; null when the site does not say.
Shortest stay starting this day, in nights.
Longest stay starting this day, in nights.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/airbnb/listings/1900063/availability?months=3" \
-H "x-api-key: YOUR_API_KEY"Responses
An Airbnb listing's availability calendar.