Airbnb API: Get listing
Gets public details for one Airbnb listing from its link. When dates are given, it also returns dated prices and cancellation terms if Airbnb offers a quote.
Unofficial. Not affiliated with or endorsed by Airbnb.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Adults optional
adults Number of adults, for example 2.
2 (default)
Whole number 1 or more.
- Listing, required
listing Airbnb listing link, for example https://www.airbnb.com/rooms/27637065.
https://www.airbnb.com/rooms/1081449253104266697
- Check in optional
check_in Arrival date, for example 2026-11-12.
Not set
- Currency optional
currency Three-letter currency code, for example USD.
USD (default)
Exactly 3 characters.
- Check Out optional
check_out Departure date, for example 2026-11-16.
Not set
Input as JSON
{ "listing": "https://www.airbnb.com/rooms/1081449253104266697" }Output
{ "area": "New York", "beds": 1, "city": "Brooklyn", "title": "( Relaxing & Cozy Spa Lux suite : )", "photos": [ "https://a0.muscache.com/im/pictures/5ff8a7a9-74a7-43e8-95ca-757319168972.jpg" , "https://a0.muscache.com/im/pictures/2db7c51e-ca42-4b3e-b9de-c7c60f3b0329.jpg" , "https://a0.muscache.com/im/pictures/hosting/Hosting-1081449253104266697/original/39ce0933-86f7-4375-a9df-2f206ec13abf.jpeg" ], "bedrooms": 1, "currency": null, "latitude": 40.6811, "amenities": [ "Hair dryer", "Shampoo", "Conditioner" ], "bathrooms": 1, "host_name": "Noah", "longitude": -73.9387, "superhost": true, "listing_id": "1081449253104266697", "place_type": "Entire guest suite in Brooklyn, New York", "description": ".Newly renovated brownstone, modern decor, located just 15 minutes from Manhattan, 1 block away(C train) in the most desirable part of Brooklyn with great restaurants and bars. Spa bathroom, High-speed WiFi access, 65 OLED Apple TV and a state-of-the-art movie projector & sound system. Relax in a sp…", "house_rules": [ "Up to 2 overnight guests", "Pets allowed", "2 maximum" ], "total_price": null, "listing_link": "https://www.airbnb.com/rooms/1081449253104266697" , "review_count": 104, "value_rating": 4.58, "check_in_time": null, "check_out_time": null, "maximum_guests": 2, "overall_rating": 4.88, "accuracy_rating": 4.87, "check_in_rating": 4.88, "location_rating": 4.69, "price_per_night": null, "host_joined_year": null, "cleanliness_rating": 4.91, "cancellation_policy": null, "communication_rating": 4.96}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"airbnb.com/get_listing","input":{"listing":"https://www.airbnb.com/rooms/1081449253104266697"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "airbnb.com/get_listing" , "input": { "listing": "https://www.airbnb.com/rooms/1081449253104266697" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "airbnb.com/get_listing" , "input": { "listing": "https://www.airbnb.com/rooms/1081449253104266697" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run airbnb.com/get_listing# with {"listing":"https://www.airbnb.com/rooms/1081449253104266697"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "listing" ], "properties": { "adults": { "type": "integer", "default": 2, "minimum": 1, "description": "Number of adults, for example 2." }, "listing": { "type": "string", "description": "Airbnb listing link, for example https://www.airbnb.com/rooms/27637065." }, "check_in": { "type": "string", "description": "Arrival date, for example 2026-11-12." }, "currency": { "type": "string", "default": "USD", "maxLength": 3, "minLength": 3, "description": "Three-letter currency code, for example USD." }, "check_out": { "type": "string", "description": "Departure date, for example 2026-11-16." } }}Output schema
{ "type": "object", "properties": { "area": { "type": [ "string", "null" ] }, "beds": { "type": [ "integer", "null" ] }, "city": { "type": [ "string", "null" ] }, "title": { "type": [ "string", "null" ] }, "photos": { "type": "array", "items": { "type": "string" } }, "bedrooms": { "type": [ "integer", "null" ] }, "currency": { "type": [ "string", "null" ] }, "latitude": { "type": [ "number", "null" ] }, "amenities": { "type": "array", "items": { "type": "string" } }, "bathrooms": { "type": [ "number", "null" ] }, "host_name": { "type": [ "string", "null" ] }, "longitude": { "type": [ "number", "null" ] }, "superhost": { "type": [ "boolean", "null" ] }, "listing_id": { "type": [ "string", "null" ] }, "place_type": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "house_rules": { "type": "array", "items": { "type": "string" } }, "total_price": { "type": [ "number", "null" ] }, "listing_link": { "type": [ "string", "null" ] }, "review_count": { "type": [ "integer", "null" ] }, "value_rating": { "type": [ "number", "null" ] }, "check_in_time": { "type": [ "string", "null" ] }, "check_out_time": { "type": [ "string", "null" ] }, "maximum_guests": { "type": [ "integer", "null" ] }, "overall_rating": { "type": [ "number", "null" ] }, "accuracy_rating": { "type": [ "number", "null" ] }, "check_in_rating": { "type": [ "number", "null" ] }, "location_rating": { "type": [ "number", "null" ] }, "price_per_night": { "type": [ "number", "null" ] }, "host_joined_year": { "type": [ "integer", "null" ] }, "cleanliness_rating": { "type": [ "number", "null" ] }, "cancellation_policy": { "type": [ "string", "null" ] }, "communication_rating": { "type": [ "number", "null" ] } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
airbnb.com/get_listing- Returns
- title, place type, rooms, amenities, rules, ratings, host, prices, photos, location
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method airbnb.com/get_listing with the inputs above.
Ask your agent
- Can you pull up the full details for this Airbnb place https://www.airbnb.com/rooms/27637065 including amenities, house rules, and host info?
- I'm comparing a cabin listing for 3 adults arriving 2026-03-14 and leaving 2026-03-18. What's the total price in EUR and what's the cancellation policy?
- Show me the photos, number of bedrooms and bathrooms, and guest ratings for listing 27637065.
- What's the neighborhood and exact location of this rental, and how many reviews does it have? Price in GBP for 2026-07-02 to 2026-07-05 for two adults would help too.
- Get me the place type, amenities list, and check-in rules for https://www.airbnb.com/rooms/27637065 so I can decide if it suits a family trip.
See more
All Airbnb methodsSearches public Airbnb homes for a destination and travel dates. Each stay comes with its price, rating, room details and listing link. Prices are the displayed trip totals, including fees.
airbnb.com/search_staysChecks a public Airbnb listing's calendar for one or more months: available nights per month and, for each day from today on, whether check-in and check-out are possible, the minimum stay, and the nightly price when Airbnb shows one.
airbnb.com/check_listing_availabilityGets the public details of a Craigslist listing from its link. Deleted or expired listings are not returned, and hidden contact details are not included.
craigslist.org/get_listingGets one Booking.com property's details by name and city or Booking.com link: type, stars, address, description, review scores, facilities, house rules, rooms and photos. Room prices and cancellation terms are shown only when available for the selected dates.
booking.com/get_propertyGets the full public details of an eBay listing by link or item number: price, sale type, bids, condition, shipping, delivery, returns, location, item specifics, the seller's description, photos, seller and listing status. Shipping and delivery text may vary by destination; unavailable details are null.
ebay.com/get_listingFinds room offers and nightly prices for one Agoda hotel on selected dates. Totals are calculated from displayed nightly prices before taxes and fees; final checkout totals may differ.
agoda.com/get_room_pricesSearches Booking.com stays by destination and dates, with guest counts, price, review, cancellation, sorting and paging. Displayed prices generally exclude some taxes and fees; children are searched as age 8.
booking.com/search_staysFind publicly priced Priceline hotels in a place for your travel dates, with guest ratings, nightly and total USD prices, and cancellation information. Excludes hotels hidden behind anonymous deals and sign-in-only prices.
priceline.com/search_hotels