/agoda/hotels/rooms
Get the live room rate grid for an Agoda hotel by property id (or hotel URL) for specific check-in / check-out dates and occupancy. Returns each available room type with its size, view and bed features, amenities, photos, guest review score and the list of bookable rate offers. Every offer carries the nightly price and currency, meal plan, cancellation policy, pay-later / pay-at-hotel flags, whether a credit card is required, the supplier and how many rooms are left. Prices and availability depend on the requested dates and occupancy.
Price: 1 credit
💡 AI Hint: Fetch the per-room rate grid for one Agoda hotel by numeric property id (or a hotel URL containing hotelId) for given check_in and check_out dates. Set adults, children_ages (one age per child) and rooms for the occupancy, and count for how many room types to return. Returns a list of room types, each with id, room_type, is_sold_out, room_size, review_score, features, facilities, amenities, images, min_price and offers. Each offer has rate_plan_id, price, currency, price_text, price_info, meal, is_breakfast_included, cancellation, is_free_cancellation, is_pay_later, is_pay_at_hotel, is_credit_card_required, supplier_id, remaining_room_count and benefits. An empty result means the hotel has no rooms available for the selected dates.
⚠️ Common errors: 412: Hotel not found (well-formed but nonexistent property id)
Authorizations
API token from the dashboard
Headers
Body
Agoda property id or a hotel URL containing it
1"8000"
"https://www.agoda.com/the-ritz-carlton-osaka/hotel/osaka-jp.html?hotelId=8000"
Check-in date in YYYY-MM-DD format
"2026-06-25"
Check-out date in YYYY-MM-DD format
"2026-06-27"
Max number of room types to return
x >= 1Max scrapping execution timeout (in seconds)
20 <= x <= 1500Number of adult guests
x >= 1Age of each child guest (one entry per child)
Number of rooms requested
x >= 1