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.

Input

location required

Destination (city / region / neighborhood), e.g. 'Paris' or 'Lisbon, Portugal'. Spaces become dashes in the URL slug.

page optional

Result page (up to 18 listings/page; Airbnb caps at ~15 pages). Default 1.

Default: 1

pets optional

Number of pets.

query optional

Extra free-text query refinement.

adults optional

Number of adults. Default 2.

Default: 2

checkin optional

Check-in date ISO YYYY-MM-DD. Pair with checkout for date-aware results/pricing.

infants optional

Number of infants.

checkout optional

Check-out date ISO YYYY-MM-DD.

children optional

Number of children.

amenities optional

Airbnb amenity-filter ids (the site's own filter pills), AND-combined as &amenities[]=<id>. Ids are sparse/non-sequential — common ones: 5=Air conditioning, 4=Wifi, 8=Kitchen, 9=Free parking, 7=Pool, 25=Hot tub, 30=Heating, 33=Washer, 34=Dryer, 58=TV, 51=Self check-in, 47=Dedicated workspace, 15=Gym, 16=Breakfast, 99=BBQ grill, 97=EV charger, 286=Crib, 45=Hair dryer, 46=Iron, 11=Smoking allowed, 27=Indoor fireplace, 35=Smoke alarm, 36=Carbon monoxide alarm.

category_tag optional

Airbnb category tag filter (e.g. 'Tag:8225').

titleStartsWith optional

Client-side filter: keep only listings whose title starts with this string.

l2_property_type_id optional

Property-type filter id.

Output

url required

page required

count required

listings required

maxPage optional

Start building not clicking

Get started for free

Related scripts

Get Airbnb listing (+availability)

Start building not clicking