# Agoda API: Get room prices > 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. Unofficial. Not affiliated with or endorsed by Agoda. - Page: https://fous.com/methods/agoda.com/get-room-prices - Method: `agoda.com/get_room_prices`, version 1 - Website: agoda.com - Returns: hotel name, address, link, room offers with bed type, max guests, nightly and total price, breakfast, free cancellation and deadline, rooms left - 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"` | Hotel city, for example Bangkok. | | `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-24"` | Arrival date (YYYY-MM-DD), for example 2026-10-20. | | `currency` | string | no | | Price currency code, for example USD. Default "USD". | | `check_out` | string | yes | `"2026-11-26"` | Departure date (YYYY-MM-DD), for example 2026-10-22. | | `hotel_name` | string | yes | `"Mandarin Oriental"` | Hotel name or Agoda hotel link, for example Mandarin Oriental. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "city": "Bangkok", "check_in": "2026-11-24", "check_out": "2026-11-26", "hotel_name": "Mandarin Oriental" } ``` Its output: ```json { "offers": [ { "room_id": "34807581", "bed_type": "1 king bed", "currency": "USD", "room_type": "Deluxe Premier room King", "agoda_link": "https://www.agoda.com/mandarin-oriental-bangkok_12/hotel/bangkok-th.html?checkIn=2026-10-20&checkOut=2026-10-22&adults=2&rooms=1¤cyCode=USD&los=2", "rooms_left": null, "total_price": 1020, "maximum_guests": 3, "price_per_night": 510, "free_cancellation": "yes", "breakfast_included": "yes", "free_cancellation_deadline": "2026-10-13" }, { "room_id": "3094132", "bed_type": "2 single beds or 1 double bed", "currency": "USD", "room_type": "Deluxe Premier room Twin", "agoda_link": "https://www.agoda.com/mandarin-oriental-bangkok_12/hotel/bangkok-th.html?checkIn=2026-10-20&checkOut=2026-10-22&adults=2&rooms=1¤cyCode=USD&los=2", "rooms_left": null, "total_price": 1020, "maximum_guests": 3, "price_per_night": 510, "free_cancellation": "yes", "breakfast_included": "yes", "free_cancellation_deadline": "2026-10-13" }, { "room_id": "34807581", "bed_type": "1 king bed", "currency": "USD", "room_type": "Deluxe Premier room King", "agoda_link": "https://www.agoda.com/mandarin-oriental-bangkok_12/hotel/bangkok-th.html?checkIn=2026-10-20&checkOut=2026-10-22&adults=2&rooms=1¤cyCode=USD&los=2", "rooms_left": null, "total_price": 1084, "maximum_guests": 3, "price_per_night": 542, "free_cancellation": "no", "breakfast_included": "no", "free_cancellation_deadline": null } ], "address": "48 Oriental Avenue, Bangkok Riverside, Bangkok, Thailand, 10500", "agoda_link": "https://www.agoda.com/mandarin-oriental-bangkok_12/hotel/bangkok-th.html?checkIn=2026-10-20&checkOut=2026-10-22&adults=2&rooms=1¤cyCode=USD&los=2", "hotel_name": "Mandarin Oriental, Bangkok", "property_id": 10713 } ``` ## 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/get_room_prices","input":{"city":"Bangkok","check_in":"2026-11-24","check_out":"2026-11-26","hotel_name":"Mandarin Oriental"}}' ``` 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 rooms are available at the Shangri-La Kuala Lumpur from 2026-11-03 to 2026-11-06, and how much per night? 2 adults, 1 room. - Check Agoda for room rates at Hotel Gracery Shinjuku in Tokyo, checking in March 14 2026 and out March 18, prices in JPY please. - I need 2 rooms for 4 adults at The Peninsula Hong Kong, Dec 20–23 2026. Which offers include breakfast and free cancellation, and what's the cancellation deadline? - Pull up nightly and total prices on agoda.com for Amari Phuket, 2026-08-10 to 2026-08-15, 2 adults, in EUR. Also tell me how many rooms are left for each option. - Looking at Capella Singapore for one adult, Jan 5 to Jan 7 2027 — list the room types with bed type, max occupancy, and price in SGD. ## Input schema ```json { "type": "object", "required": [ "hotel_name", "city", "check_in", "check_out" ], "properties": { "city": { "type": "string", "description": "Hotel city, for example Bangkok." }, "rooms": { "type": "integer", "default": 1, "minimum": 1, "description": "Number of rooms, for example 1." }, "adults": { "type": "integer", "default": 2, "minimum": 1, "description": "Number of adults, for example 2." }, "check_in": { "type": "string", "description": "Arrival date (YYYY-MM-DD), for example 2026-10-20." }, "currency": { "type": "string", "default": "USD", "maxLength": 3, "minLength": 3, "description": "Price currency code, for example USD." }, "check_out": { "type": "string", "description": "Departure date (YYYY-MM-DD), for example 2026-10-22." }, "hotel_name": { "type": "string", "description": "Hotel name or Agoda hotel link, for example Mandarin Oriental." } } } ``` ## Output schema ```json { "type": "object", "required": [ "hotel_name", "address", "agoda_link", "property_id", "offers" ], "properties": { "offers": { "type": "array", "items": { "type": "object", "required": [ "room_type", "bed_type", "maximum_guests", "price_per_night", "total_price", "currency", "breakfast_included", "free_cancellation", "free_cancellation_deadline", "rooms_left", "agoda_link", "room_id" ], "properties": { "room_id": { "type": [ "string", "null" ] }, "bed_type": { "type": [ "string", "null" ] }, "currency": { "type": "string" }, "room_type": { "type": "string" }, "agoda_link": { "type": "string" }, "rooms_left": { "type": [ "integer", "null" ] }, "total_price": { "type": "number" }, "maximum_guests": { "type": [ "integer", "null" ] }, "price_per_night": { "type": "number" }, "free_cancellation": { "enum": [ "yes", "no" ], "type": "string" }, "breakfast_included": { "enum": [ "yes", "no" ], "type": "string" }, "free_cancellation_deadline": { "type": [ "string", "null" ] } }, "additionalProperties": false } }, "address": { "type": [ "string", "null" ] }, "agoda_link": { "type": "string" }, "hotel_name": { "type": "string" }, "property_id": { "type": "integer" } }, "additionalProperties": false } ``` ## See more - [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. - [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. - [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. - [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). - [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. - [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. - [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. - [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. - [All Agoda methods](https://fous.com/methods/agoda.com.md)