# Booking.com API: Get property details

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

Unofficial. Not affiliated with or endorsed by Booking.com.

- Page: https://fous.com/methods/booking.com/get-property
- Method: `booking.com/get_property`, version 1
- Website: booking.com
- Returns: property name, type, stars, address, description, review score, word and count, category scores, popular facilities, facility groups, house rules, rooms, photo links, link
- 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 adult guests. Example: 2. Default 2. |
| `check_in` | string | no |  | Arrival date for room prices (YYYY-MM-DD). Example: 2026-11-10. |
| `currency` | string | no |  | Currency for room prices. Example: USD. Default "USD". |
| `property` | string | yes | `"Hotel Artemide Rome"` | Property name with its city, or a Booking.com property link. Example: Hotel Artemide Rome. |
| `check_out` | string | no |  | Departure date for room prices (YYYY-MM-DD). Example: 2026-11-12. |

## Output

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

```json
{
  "property": "Hotel Artemide Rome"
}
```

Its output:

```json
{
  "rooms": [
    {
      "beds": "1 queen bed",
      "name": "Basic Double Room",
      "price": null,
      "size_m2": 13,
      "currency": null,
      "max_guests": 2,
      "cancellation_terms": null
    },
    {
      "beds": "1 queen bed",
      "name": "Comfort Double Room",
      "price": null,
      "size_m2": 15,
      "currency": null,
      "max_guests": 2,
      "cancellation_terms": null
    },
    {
      "beds": "2 twin beds",
      "name": "Comfort Twin Room",
      "price": null,
      "size_m2": 15,
      "currency": null,
      "max_guests": 2,
      "cancellation_terms": null
    }
  ],
  "address": "Via Nazionale 22, Central Station, 00184 Rome, Italy",
  "description": "The Artemide is in a 19th-century building on the vibrant Via Nazionale. A free minibar and free Wi-Fi access are available in each of the elegant rooms. Guests can book a session in the Artemis Spa, offering a sauna, hot tub, Turkish bath and a variety of treatments. Rooms are air-conditioned and d…",
  "house_rules": {
    "pets": "Pets are not allowed.",
    "check_in": "From 2:00 PM to 11:30 PM Guests are required to show a photo ID and credit card at check-in. You need to let the property know what time you'll be arriving in advance.",
    "children": "Child policies Children of all ages are welcome. Children 3 and above will be charged as adults at this property. To see correct prices and occupancy info, add the number and ages of children in your group to your search. Crib and extra bed policies 0 - 2 years Crib upon request Free The number of c…",
    "check_out": "From 12:00 AM to 12:00 PM",
    "cancellation_and_prepayment": "Cancellation and prepayment policies vary according to accommodation type. Enter your stay dates and check the conditions of your selected option."
  },
  "photo_links": [
    "https://cf.bstatic.com/xdata/images/hotel/max1024x768/64107180.jpg?k=bc957e3f08024b859b56f18c46f222dba97653e5e23037d1c6f51ac4971252d8&o=",
    "https://cf.bstatic.com/xdata/images/hotel/max500/64108367.jpg?k=454234773f3242d349966e31f661143ce05383d50f188c9a3898ae238a70248f&o=",
    "https://cf.bstatic.com/xdata/images/hotel/max500/64109016.jpg?k=d3d47d8ce94f1fd72f5d2d37188076942d9a847f376b397256678d312a35d52b&o="
  ],
  "review_word": "Wonderful",
  "star_rating": 4,
  "booking_link": "https://www.booking.com/hotel/it/artemide.html",
  "review_count": 1684,
  "review_score": 9.2,
  "property_name": "Hotel Artemide",
  "property_type": "Hotel",
  "category_scores": {
    "Staff": 9.7,
    "Comfort": 9.5,
    "Location": 9.5,
    "Free Wifi": 9.5,
    "Facilities": 9.3,
    "Cleanliness": 9.5,
    "Value for money": 8.6
  },
  "facility_groups": [
    {
      "group": "General",
      "facilities": [
        "Shuttle service",
        "Shared lounge/TV area",
        "Air conditioning"
      ]
    },
    {
      "group": "Bathroom",
      "facilities": [
        "Toilet paper",
        "Towels",
        "Bath or shower"
      ]
    },
    {
      "group": "Bedroom",
      "facilities": [
        "Linens",
        "Wardrobe or closet"
      ]
    }
  ],
  "most_popular_facilities": [
    "Free Wifi",
    "Airport shuttle",
    "Spa and wellness center"
  ]
}
```

## 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":"booking.com/get_property","input":{"property":"Hotel Artemide Rome"}}'
```

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

- What facilities and house rules does Hotel Adlon Kempinski in Berlin have? Also show me the guest review scores by category.
- Pull up the Booking.com page for Riad Yasmine in Marrakech — I want the star rating, address, description and photos.
- Check room prices and cancellation terms at The Hoxton Shoreditch London for 2 adults, checking in 2026-09-14 and out 2026-09-17, in GBP.
- I'm thinking of staying at Casa Gracia Barcelona. What kind of property is it, what's its review score and how many reviews, and what rooms do they offer?
- Get full details for this listing: https://www.booking.com/hotel/jp/park-hyatt-tokyo.html — rooms and prices for 3 adults from 2027-03-02 to 2027-03-06 in JPY.

## Input schema

```json
{
  "type": "object",
  "required": [
    "property"
  ],
  "properties": {
    "adults": {
      "type": "integer",
      "default": 2,
      "minimum": 1,
      "description": "Number of adult guests. Example: 2."
    },
    "check_in": {
      "type": "string",
      "description": "Arrival date for room prices (YYYY-MM-DD). Example: 2026-11-10."
    },
    "currency": {
      "type": "string",
      "default": "USD",
      "description": "Currency for room prices. Example: USD."
    },
    "property": {
      "type": "string",
      "minLength": 1,
      "description": "Property name with its city, or a Booking.com property link. Example: Hotel Artemide Rome."
    },
    "check_out": {
      "type": "string",
      "description": "Departure date for room prices (YYYY-MM-DD). Example: 2026-11-12."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "properties": {
    "rooms": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "beds": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "price": {
            "type": [
              "number",
              "null"
            ]
          },
          "size_m2": {
            "type": [
              "number",
              "null"
            ]
          },
          "currency": {
            "type": [
              "string",
              "null"
            ]
          },
          "max_guests": {
            "type": [
              "integer",
              "null"
            ]
          },
          "cancellation_terms": {
            "type": [
              "string",
              "null"
            ]
          }
        }
      }
    },
    "address": {
      "type": [
        "string",
        "null"
      ]
    },
    "description": {
      "type": [
        "string",
        "null"
      ]
    },
    "house_rules": {
      "type": "object",
      "properties": {
        "pets": {
          "type": [
            "string",
            "null"
          ]
        },
        "check_in": {
          "type": [
            "string",
            "null"
          ]
        },
        "children": {
          "type": [
            "string",
            "null"
          ]
        },
        "check_out": {
          "type": [
            "string",
            "null"
          ]
        },
        "cancellation_and_prepayment": {
          "type": [
            "string",
            "null"
          ]
        }
      }
    },
    "photo_links": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "review_word": {
      "type": [
        "string",
        "null"
      ]
    },
    "star_rating": {
      "type": [
        "integer",
        "null"
      ]
    },
    "booking_link": {
      "type": [
        "string",
        "null"
      ]
    },
    "review_count": {
      "type": [
        "integer",
        "null"
      ]
    },
    "review_score": {
      "type": [
        "number",
        "null"
      ]
    },
    "property_name": {
      "type": [
        "string",
        "null"
      ]
    },
    "property_type": {
      "type": [
        "string",
        "null"
      ]
    },
    "category_scores": {
      "type": "object",
      "additionalProperties": {
        "type": [
          "number",
          "null"
        ]
      }
    },
    "facility_groups": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "group": {
            "type": "string"
          },
          "facilities": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    },
    "most_popular_facilities": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}
```

## See more

- [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.
- [Airbnb API: Get listing](https://fous.com/methods/airbnb.com/get-listing.md): 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.
- [Agoda API: Search hotels](https://fous.com/methods/agoda.com/search-hotels.md): Finds available Agoda stays in a city for your dates, with prices before taxes and fees, star and guest ratings, and free-cancellation status.
- [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.
- [Expedia API: Search hotels](https://fous.com/methods/expedia.com/search-hotels.md): Finds Expedia hotels in a destination for given dates, with public USD prices, reviews, property class, refund status and links. Nightly prices are per room; totals include all requested rooms, taxes and fees.
- [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.
- [Google API: Get hotel reviews from Google Hotels](https://fous.com/methods/google.com/get-hotel-reviews.md): Finds a hotel on Google Hotels by name and city and returns its guest reviews in the chosen order, its Google rating and review count, and topic ratings averaged from the returned reviews that rate each topic.
- [Trip.com API: Search hotels](https://fous.com/methods/trip.com/search-hotels.md): Finds hotels in a city on Trip.com for given dates, with prices, guest ratings, reviews and booking links. Only the initial public listing is read, so large limits may return fewer hotels.
- [All Booking.com methods](https://fous.com/methods/booking.com.md)
