# 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.

- Page: https://fous.com/methods/airbnb.com/get-listing
- Method: `airbnb.com/get_listing`, version 1
- Website: airbnb.com
- Returns: title, place type, rooms, amenities, rules, ratings, host, prices, photos, location
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `adults` | integer | no |  | Number of adults, for example 2. Default 2. |
| `listing` | string | yes | `"https://www.airbnb.com/rooms/1081449253104266697"` | Airbnb listing link, for example https://www.airbnb.com/rooms/27637065. |
| `check_in` | string | no |  | Arrival date, for example 2026-11-12. |
| `currency` | string | no |  | Three-letter currency code, for example USD. Default "USD". |
| `check_out` | string | no |  | Departure date, for example 2026-11-16. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "listing": "https://www.airbnb.com/rooms/1081449253104266697"
}
```

Its output:

```json
{
  "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
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
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"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## 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.

## Input schema

```json
{
  "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

```json
{
  "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"
      ]
    }
  }
}
```

## See more

- [Airbnb API: Search stays](https://fous.com/methods/airbnb.com/search-stays.md): Searches 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 API: Check listing availability](https://fous.com/methods/airbnb.com/check-listing-availability.md): Checks 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.
- [Craigslist API: Get listing details](https://fous.com/methods/craigslist.org/get-listing.md): Gets the public details of a Craigslist listing from its link. Deleted or expired listings are not returned, and hidden contact details are not included.
- [Booking.com API: Get property details](https://fous.com/methods/booking.com/get-property.md): Gets 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.
- [eBay API: Get listing details](https://fous.com/methods/ebay.com/get-listing.md): Gets 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.
- [Agoda API: Get room prices](https://fous.com/methods/agoda.com/get-room-prices.md): Finds 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.
- [Booking.com API: Search stays](https://fous.com/methods/booking.com/search-stays.md): Searches 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.
- [Priceline API: Search hotels](https://fous.com/methods/priceline.com/search-hotels.md): Find 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.
- [All Airbnb methods](https://fous.com/methods/airbnb.com.md)