get_hotels

Fetches detailed data for specific hotel IDs without performing a search. Use this to load additional data blocks for hotels already discovered via search_hotels.

Parameters

Parameter	Type	Required	Description
hotelIds	string[]	Yes	Hotel IDs to fetch data for
include	string[]	No	Data blocks to return (same options as search_hotels)
checkIn	string	No	Check-in date (YYYY-MM-DD)
checkOut	string	No	Check-out date
dayDistance	number	No	Days from today for check-in (e.g., 7 for next week)
nights	number	No	Stay duration (default: 3)
rooms	object[]	No	Room configuration
currency	string	No	ISO 4217 currency code
offers	object	No	Offer retrieval options (mode, sort, filters)
reviews	object	No	Review options (max, sortBy, ratings, searchTerms)
media	object	No	Media options (maxImages)
searchMode	string	No	fast (default) or deep — exhaustive search across all providers

Use cases

Load reviews for a hotel from previous search

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_hotels",
    "arguments": {
      "hotelIds": ["hotel_abc123"],
      "include": ["review", "insight"],
      "reviews": {
        "max": 20,
        "sortBy": "recency"
      }
    }
  }
}

Get rooms and FAQ for multiple hotels

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "get_hotels",
    "arguments": {
      "hotelIds": ["hotel_abc123", "hotel_def456"],
      "include": ["room", "faq"],
      "checkIn": "2026-04-01",
      "nights": 3,
      "rooms": [{"adults": 2}]
    }
  }
}

Refresh offers with different filters

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "get_hotels",
    "arguments": {
      "hotelIds": ["hotel_abc123"],
      "include": ["offer"],
      "checkIn": "2026-04-01",
      "nights": 3,
      "offers": {
        "mode": "all",
        "filters": {
          "freeCancellation": "included",
          "mealIncluded": "included"
        }
      }
    }
  }
}

Response

Same structure as search_hotels - returns a hotels array with the requested data blocks populated. See Data Types for field details.