Retrieve rates for hotels

Overview

Search for hotel rates and availability across multiple hotels. This is your primary endpoint for finding bookable hotel rooms with real-time pricing.

When to Use

• Display hotel listings with prices on your search results page
• Show detailed rate options for specific hotels users are viewing
• Support multi-room bookings for families or groups
• Filter hotels by location, amenities, ratings, or AI-powered semantic search

What You Get

• Real-time rates with availability and pricing
• Multiple room options per hotel, sorted by price
• Complete booking details including cancellation policies, meal plans, and room types
• Hotel information (name, photos, address, ratings) when searching by filters

Key Features

• Multiple search methods: Search by hotel IDs, city/country, coordinates, Place ID, IATA code, or natural language (AI search)
• Flexible filtering: Filter by star rating, facilities, hotel chains, accessibility, and more
• Multi-room support: Book multiple rooms with different guest configurations in one request
• Performance optimized: Default limit of 200 hotels (expandable to 5,000), recommended timeout of 6-12 seconds

Quick Start

Required fields: checkin, checkout, currency, guestNationality, occupancies, plus one location method (hotel IDs, city/country, coordinates, Place ID, or IATA code)

Tip: When searching by filters (like aiSearch or cityName), hotel data is automatically included. For direct hotel ID searches, set includeHotelData=true to include hotel names and photos.