App Logo
airbnb.com

Get Airbnb listing (+availability)

Fetch one Airbnb listing by room id: title, propertyType, capacity, rating and per-category ratings, host, images, description, sleeping arrangement, house rules, location (lat/lng), and the month-by-month availability calendar (per-day available/minNights/checkin-checkout). The only_available arg trims the calendar to bookable days.

Input

id required

Airbnb room id (numeric).

adults optional

Number of adults. Default 2.

Default: 2
checkin optional

Check-in ISO YYYY-MM-DD. Pair with checkout. Sets the URL dates; availability is returned regardless.

checkout optional

Check-out ISO YYYY-MM-DD.

only_available optional

When true, the availability calendar includes only bookable days (drops blocked days and empty months) — much smaller output. Default false returns every day with its available flag.

Default: false

Output

id required
url required
availability required
lat optional
lng optional
host optional
title optional
images optional
rating optional
roomType optional
sleeping optional
houseRules optional
description optional
reviewCount optional
propertyType optional
personCapacity optional
categoryRatings optional
locationSummary optional
metaDescription optional
locationSubtitle optional

Related scripts

airbnb.com

Search Airbnb listings

Search Airbnb stays for a location and date range. Returns url, page, count, maxPage, and listings (each with id, url, title, name, subtitle, lat, lng, rating, reviewCount, price, originalPrice, badges, details, hostType, imageUrl). One page returns up to 18 listings and Airbnb caps results at roughly 15 pages; paginate via the page arg.

Start building not clicking

Get started for free