# Kayak API: Search hotels

> Compares Kayak hotel nightly rates across booking sites for a city or neighborhood and stay dates (two adults, one room).

Unofficial. Not affiliated with or endorsed by Kayak.

- Page: https://fous.com/methods/kayak.com/search-hotels
- Method: `kayak.com/search_hotels`, version 1
- Website: kayak.com
- Returns: hotel name, stars, guest rating, neighbourhood, lowest nightly USD price and site, Kayak 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 |
|---|---|---|---|---|
| `sort` | string | no |  | Order hotels by recommendation, lowest price, or guest score. One of "recommended", "cheapest", "top_rated". Default "recommended". |
| `check_in` | string | yes | `"2026-11-10"` | Arrival date, for example 2026-11-10. |
| `location` | string | yes | `"Chicago"` | City or area to search, for example Chicago. |
| `check_out` | string | yes | `"2026-11-12"` | Departure date, for example 2026-11-12. |
| `min_stars` | integer | no |  | Minimum hotel class from 1 to 5 stars. |
| `max_results` | integer | no |  | Maximum hotels to return. Default 20. |

## Output

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

```json
{
  "check_in": "2026-11-10",
  "location": "Chicago",
  "check_out": "2026-11-12"
}
```

Its output:

```json
{
  "hotels": [
    {
      "name": "Chicago South Loop Hotel",
      "stars": 3,
      "kayak_link": "https://www.kayak.com/Chicago-Hotels-Chicago-South-Loop-Hotel.300284.ksp",
      "guest_rating": 6.1,
      "neighbourhood": "Douglas",
      "kayak_hotel_id": "300284",
      "lowest_price_site": "Booking.com",
      "number_of_reviews": 4623,
      "guest_rating_label": "Okay",
      "total_stay_price_usd": null,
      "lowest_nightly_price_usd": 119
    },
    {
      "name": "Renaissance Chicago O'Hare Suites Hotel",
      "stars": 4,
      "kayak_link": "https://www.kayak.com/Chicago-Hotels-Renaissance-Chicago-O-Hare-Suites-Hotel.26414.ksp",
      "guest_rating": 8.2,
      "neighbourhood": "O'Hare",
      "kayak_hotel_id": "26414",
      "lowest_price_site": "Priceline",
      "number_of_reviews": 1367,
      "guest_rating_label": "Very good",
      "total_stay_price_usd": null,
      "lowest_nightly_price_usd": 255
    },
    {
      "name": "River Hotel",
      "stars": 4,
      "kayak_link": "https://www.kayak.com/Chicago-Hotels-River-Hotel.286778.ksp",
      "guest_rating": 8.3,
      "neighbourhood": "Loop",
      "kayak_hotel_id": "286778",
      "lowest_price_site": "Priceline",
      "number_of_reviews": 7624,
      "guest_rating_label": "Very good",
      "total_stay_price_usd": null,
      "lowest_nightly_price_usd": 195
    }
  ]
}
```

## 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":"kayak.com/search_hotels","input":{"check_in":"2026-11-10","location":"Chicago","check_out":"2026-11-12"}}'
```

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

- Find me hotels in Lisbon for two adults from March 14 to March 17, sorted by lowest nightly price
- What are the cheapest 4-star hotels in downtown Chicago for November 10 to 12?
- Show top-rated hotels in Kayak for a weekend stay in Austin, check-in 2026-09-04, check-out 2026-09-06
- I need a list of hotels near the Shibuya neighbourhood in Tokyo, at least 3 stars, for one room over five nights in April
- Compare nightly rates for hotels in Denver from 2026-12-20 to 2026-12-23 and give me the top 10 by guest rating

## Input schema

```json
{
  "type": "object",
  "required": [
    "location",
    "check_in",
    "check_out"
  ],
  "properties": {
    "sort": {
      "enum": [
        "recommended",
        "cheapest",
        "top_rated"
      ],
      "type": "string",
      "default": "recommended",
      "description": "Order hotels by recommendation, lowest price, or guest score."
    },
    "check_in": {
      "type": "string",
      "description": "Arrival date, for example 2026-11-10."
    },
    "location": {
      "type": "string",
      "description": "City or area to search, for example Chicago."
    },
    "check_out": {
      "type": "string",
      "description": "Departure date, for example 2026-11-12."
    },
    "min_stars": {
      "type": "integer",
      "maximum": 5,
      "minimum": 1,
      "description": "Minimum hotel class from 1 to 5 stars."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum hotels to return."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "hotels"
  ],
  "properties": {
    "hotels": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "stars": {
            "type": [
              "number",
              "null"
            ]
          },
          "kayak_link": {
            "type": "string"
          },
          "guest_rating": {
            "type": [
              "number",
              "null"
            ]
          },
          "neighbourhood": {
            "type": [
              "string",
              "null"
            ]
          },
          "kayak_hotel_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "lowest_price_site": {
            "type": "string"
          },
          "number_of_reviews": {
            "type": [
              "integer",
              "null"
            ]
          },
          "guest_rating_label": {
            "type": [
              "string",
              "null"
            ]
          },
          "total_stay_price_usd": {
            "type": [
              "number",
              "null"
            ]
          },
          "lowest_nightly_price_usd": {
            "type": "number"
          }
        }
      }
    }
  }
}
```

## See more

- [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.
- [Google API: Search Google Hotels](https://fous.com/methods/google.com/search-hotels.md): Finds places to stay in a city or area for given dates on Google Hotels, with nightly and total prices, hotel class, guest ratings, amenities, address and cheapest booking site. Optional filters for price, stars and rating; vacation rentals are left out. Prices and availability can change.
- [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.
- [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.
- [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.
- [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.
- [Marriott API: Search hotels](https://fous.com/methods/marriott.com/search-hotels.md): Finds Marriott-family hotels for a place and stay dates in Marriott's search order, with standard public nightly rates (before taxes) and hotel details.
