Get an Airbnb reservation
Input
code requiredReservation confirmation code, e.g. HMEZNST29K. It is in the trip's page on Airbnb and in the booking email; Confirm an Airbnb booking returns it.
translate optionalTrue to get the text the host wrote (rules, requests, manual, directions) in Airbnb's English translation; false (default) for the host's own words.
Default: falseOutput
code requiredlat optionallng optionalhost optionaltitle optionalThe stay's title, e.g. Home in Munich.
guests optionalstatus optionalThe reservation's status as Airbnb names it, e.g. ACCEPT for a confirmed stay.
address optionalroom_id optionalThe listing's room id, as Get Airbnb listing takes it.
check_in optionalcheckout optionaltimezone optionalThe listing's IANA time zone, e.g. Europe/Berlin.
house_rules optionalThe house rules and requests, in Airbnb's sections: the rules (guests, pets, smoking, events...) and the host's own requests for the stay.
house_manual optionalThe house manual in full; null when the host wrote none.
listing_type optionale.g. Entire rental unit in Munich.
check_in_method optionale.g. Host greets you, Self check-in with lockbox.
host_directions optionalHow to get there, as the host wrote it; null when the host wrote none.
payment_summary optionale.g. Total cost: €735.50, in the currency paid.
cancellation_policy optionalAirbnb's summary of what a cancellation refunds now, e.g. This reservation is non-refundable.
checkout_instructions optionalFAQ
Search Airbnb listings
Search Airbnb stays in a location, with or without dates, with the filters Airbnb offers: guests, price range, room type, bedrooms, beds, bathrooms, Instant Book, guest favorites, amenities, property type, tags, host language and neighborhood (List Airbnb search filters gives their values). A map area (the north-east and south-west corners of a rectangle) limits the search to the listings inside it, as moving Airbnb's map does, for example around an office whose coordinates google.com/get_place gives. Returns one page of up to 18 listings (room id, name, price line, rating and review count, coordinates, badges, room details or next free dates, photos), the total count of matching listings, the number of pages (Airbnb stops at about 15) and the place Airbnb searched. A listing's coordinates feed google.com/get_directions for the trip to a place; Airbnb blurs them by a few hundred meters. A filter or a map area nothing matches returns an empty list. A location Airbnb cannot place fails with an error instead of returning its worldwide default list. Prices are in the currency you ask for (USD by default).
Get Airbnb listing
Get one Airbnb listing by room id: name, property and room type, capacity, ratings and per-category ratings, host, photos, description, sleeping arrangement, amenities (with the ones not included), things to know (house rules, safety, cancellation summary), location, and the 12-month availability calendar, every day with its available flag and minimum stay. With checkin and checkout it also returns the booking quote for those dates and guests (price lines and total, or available false with Airbnb's reason) and the cancellation policy's refund milestones. Airbnb opens calendars about 12 months ahead; dates beyond that fail with an error that says so. Prices are in the currency you ask for (USD by default). A listing that does not exist or was removed fails with an error that says so.
Get Airbnb listing reviews
Read the guest reviews of one Airbnb listing by room id, one page of up to 24 at a time, in an order the reviews panel offers: most relevant, most recent, highest rated or lowest rated. Each review gives the guest's first name, the line under the name (their home town, or how long they have been on Airbnb), the star rating, the date, the trip type Airbnb highlights (for example "Stayed with kids"), the text in its original language, Airbnb's English translation when the review is in another language, and the host's response. Also returns the total number of reviews and the topics guests mention most, with their counts. Lowest rated first is the quickest way to see a listing's complaints. A page after the last review returns an empty list, and a listing with no reviews yet returns an empty list with a total of 0. A listing that does not exist or was removed fails with an error that says so.