Airbnb

Get Airbnb listing availability

Get an Airbnb listing's availability calendar day by day, with minimum and maximum stays.

GET/v1/airbnb/listings/{listingId}/availability
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
listingIdstringrequiredpath

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}$

monthstringoptionalquery

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])$

monthsintegeroptionalquery

How many months to show, 1 to 12. Default 12.

≥ 1 · ≤ 12

Response fields
20

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when no listing has this id or the host removed it.

one of: found, not_found

datalistingId
string

The listing id asked for.

datamonth
string

First month shown, `YYYY-MM`.

datamonths
integer

Months shown.

dataavailableDays
integer

Days in the range that are free.

Every day of the months shown, in order. Past days are never available.

datadays[]date
string

Day, `YYYY-MM-DD`.

datadays[]available
boolean

Whether the night is free.

datadays[]availableForCheckIn
booleannullable

Whether a stay can start this day.

datadays[]availableForCheckOut
booleannullable

Whether a stay can end this day.

datadays[]bookable
booleannullable

Whether the day can be booked; null when the site does not say.

datadays[]minNights
integernullable

Shortest stay starting this day, in nights.

datadays[]maxNights
integernullable

Longest stay starting this day, in nights.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.