# Agoda API: Search hotels

> Finds available Agoda stays in a city for your dates, with prices before taxes and fees, star and guest ratings, and free-cancellation status.

Unofficial. Not affiliated with or endorsed by Agoda.

- Page: https://fous.com/methods/agoda.com/search-hotels
- Method: `agoda.com/search_hotels`, version 1
- Website: agoda.com
- Returns: name, type, star rating, review score, area, price per night, total price, free cancellation, 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 |
|---|---|---|---|---|
| `city` | string | yes | `"Bangkok"` | City to search, for example Bangkok. |
| `sort` | string | no |  | Results order, for example lowest_price. One of "recommended", "lowest_price", "best_rated". Default "recommended". |
| `rooms` | integer | no |  | Number of rooms, for example 1. Default 1. |
| `adults` | integer | no |  | Number of adults, for example 2. Default 2. |
| `check_in` | string | yes | `"2026-11-12"` | Arrival date (YYYY-MM-DD), for example 2026-11-12. |
| `currency` | string | no |  | Three-letter currency code, for example USD. Default "USD". |
| `check_out` | string | yes | `"2026-11-15"` | Departure date (YYYY-MM-DD), for example 2026-11-15. |
| `max_results` | integer | no |  | Maximum stays to return, for example 20. Default 20. |

## Output

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

```json
{
  "city": "Bangkok",
  "check_in": "2026-11-12",
  "check_out": "2026-11-15"
}
```

Its output:

```json
{
  "hotels": [
    {
      "area": "Sukhumvit",
      "link": "https://www.agoda.com/jw-marriott-hotel-bangkok/hotel/bangkok-th.html?checkIn=2026-11-12&checkOut=2026-11-15&rooms=1&adults=2&currency=USD",
      "name": "JW Marriott Hotel Bangkok",
      "type": "Hotel",
      "currency": "USD",
      "property_id": 10664,
      "star_rating": 5,
      "total_price": 729.57,
      "review_count": 3096,
      "review_label": "Exceptional",
      "review_score": 9,
      "price_per_night": 243.19,
      "free_cancellation": true
    },
    {
      "area": "Siam",
      "link": "https://www.agoda.com/courtyard-by-marriott-bangkok/hotel/bangkok-th.html?checkIn=2026-11-12&checkOut=2026-11-15&rooms=1&adults=2&currency=USD",
      "name": "Courtyard by Marriott Bangkok",
      "type": "Hotel",
      "currency": "USD",
      "property_id": 84277,
      "star_rating": 0,
      "total_price": 372.24,
      "review_count": 7665,
      "review_label": "Excellent",
      "review_score": 8.7,
      "price_per_night": 124.08,
      "free_cancellation": true
    },
    {
      "area": "Sukhumvit",
      "link": "https://www.agoda.com/the-okura-prestige-bangkok/hotel/bangkok-th.html?checkIn=2026-11-12&checkOut=2026-11-15&rooms=1&adults=2&currency=USD",
      "name": "The Okura Prestige Bangkok",
      "type": "Hotel",
      "currency": "USD",
      "property_id": 294217,
      "star_rating": 5,
      "total_price": 768.45,
      "review_count": 11513,
      "review_label": "Exceptional",
      "review_score": 9.2,
      "price_per_night": 256.15,
      "free_cancellation": true
    }
  ]
}
```

## 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":"agoda.com/search_hotels","input":{"city":"Bangkok","check_in":"2026-11-12","check_out":"2026-11-15"}}'
```

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 the cheapest hotels in Bangkok for 2 adults from March 4 to March 8, 2026, prices in THB
- On Agoda, what are the best-rated places to stay in Kyoto for check-in 2026-04-10 and check-out 2026-04-14? Just show the top 10.
- I need 2 rooms for 4 adults in Singapore, Dec 20–23 2026. Which hotels have free cancellation and what's the total price?
- Search agoda.com for stays in Bali (Denpasar) from 2026-07-01 to 2026-07-07 for one adult, sorted by lowest price, in AUD
- Hotels in Seoul for Nov 12 to Nov 15 2026, two guests — show star rating, review score, neighborhood, and nightly rate in USD

## Input schema

```json
{
  "type": "object",
  "required": [
    "city",
    "check_in",
    "check_out"
  ],
  "properties": {
    "city": {
      "type": "string",
      "description": "City to search, for example Bangkok."
    },
    "sort": {
      "enum": [
        "recommended",
        "lowest_price",
        "best_rated"
      ],
      "type": "string",
      "default": "recommended",
      "description": "Results order, for example lowest_price."
    },
    "rooms": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Number of rooms, for example 1."
    },
    "adults": {
      "type": "integer",
      "default": 2,
      "maximum": 10,
      "minimum": 1,
      "description": "Number of adults, for example 2."
    },
    "check_in": {
      "type": "string",
      "description": "Arrival date (YYYY-MM-DD), for example 2026-11-12."
    },
    "currency": {
      "type": "string",
      "default": "USD",
      "description": "Three-letter currency code, for example USD."
    },
    "check_out": {
      "type": "string",
      "description": "Departure date (YYYY-MM-DD), for example 2026-11-15."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum stays to return, for example 20."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "hotels"
  ],
  "properties": {
    "hotels": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "type",
          "star_rating",
          "review_score",
          "review_label",
          "review_count",
          "area",
          "price_per_night",
          "total_price",
          "currency",
          "free_cancellation",
          "link",
          "property_id"
        ],
        "properties": {
          "area": {
            "type": [
              "string",
              "null"
            ],
            "description": "Area or neighborhood."
          },
          "link": {
            "type": "string",
            "description": "Agoda property page for the stay."
          },
          "name": {
            "type": "string",
            "description": "Property name."
          },
          "type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Property type."
          },
          "currency": {
            "type": "string",
            "description": "Currency code for prices."
          },
          "property_id": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Agoda property ID.",
            "x-fous-developer": true
          },
          "star_rating": {
            "type": [
              "number",
              "null"
            ],
            "description": "Property star rating."
          },
          "total_price": {
            "type": "number",
            "description": "Total stay price for all selected rooms before taxes and fees."
          },
          "review_count": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Number of guest reviews."
          },
          "review_label": {
            "type": [
              "string",
              "null"
            ],
            "description": "Guest rating label."
          },
          "review_score": {
            "type": [
              "number",
              "null"
            ],
            "description": "Guest review score out of 10."
          },
          "price_per_night": {
            "type": "number",
            "description": "Price per room per night before taxes and fees."
          },
          "free_cancellation": {
            "type": "boolean",
            "description": "Whether the quoted cheapest room offer includes free cancellation."
          }
        },
        "additionalProperties": false
      },
      "description": "Available stays with quoted prices."
    }
  },
  "additionalProperties": false
}
```

## See more

- [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.
- [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.
- [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.
- [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.
- [Hostelworld API: Search hostels](https://fous.com/methods/hostelworld.com/search-hostels.md): Finds available hostels, hotels and guesthouses on Hostelworld in a city for given dates, with per-night dorm and private room prices, ratings, facilities and booking links.
- [Kayak API: Search hotels](https://fous.com/methods/kayak.com/search-hotels.md): Compares Kayak hotel nightly rates across booking sites for a city or neighborhood and stay dates (two adults, one room).
- [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.
- [All Agoda methods](https://fous.com/methods/agoda.com.md)