Prepare an Airbnb booking
Input
id requiredAirbnb room id (search_listings returns it).
checkin requiredcheckout requiredpets optionaladults optionalinfants optionalchildren optionalcurrency optionalOutput
id requiredcheckin requiredcheckout requiredavailable requiredFalse when Airbnb will not book these dates and guests; then only unavailableReason is filled and no confirm page is opened.
priceItems requiredpaymentPlans requiredtotal optionalguests optionaldueToday optionalWhat the selected payment plan charges when you confirm.
checkoutUrl optionalThe confirm-and-pay page Airbnb opened for this booking.
hostMessage optionalThe host's own note shown above the message box.
paymentMethod optionalmessageRequired optionalTrue when Airbnb will not confirm without a message to the host.
unavailableReason optionalAirbnb's code, e.g. DATE. Null when Airbnb gives none.
cancellationPolicy optionalAirbnb's policy code, e.g. CANCEL_FLEXIBLE. Get Airbnb listing with these dates gives its refund milestones.
FAQ
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). 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 filter 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.
Cancel an Airbnb reservation
Cancel one of your Airbnb stay reservations by confirmation code, as the guest. Returns the refund Airbnb grants under the reservation's cancellation policy (what you paid, what comes back) and the reservation's status afterwards. A reservation that is already cancelled, or that Airbnb no longer lets you cancel, fails with a clear error and nothing changes. The host is told at once.