Airbnb hub

Airbnb Availability API

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

GET /v1/airbnb/listings/{listingId}/availability

1 credit Failed requests are free Found, empty and not-found answers are all charged

About this endpoint

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.

Price

From $1.35 per 1,000 requests

1 credit per request. Failed requests are free.

Scale pack
$1.64 / 1,000
Growth pack
$2.36 / 1,000

The lowest rate is on annual plans; packs are pay as you go.

Example request

Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.

Request
cURL

Example response

A 200 response. Live responses have the same shape with current data.

Request
JSON

Airbnb Availability API 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.