# Google API: Search Google Hotels > 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. Unofficial. Not affiliated with or endorsed by Google. - Page: https://fous.com/methods/google.com/search-hotels - Method: `google.com/search_hotels`, version 1 - Website: google.com - Returns: search link; hotels with name, stars, guest rating, review count, nightly and total price, currency, cheapest booking site, amenities, address, Google Hotels link, property token, latitude, longitude - 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 | |---|---|---|---|---| | `adults` | integer | no | | Adults, for example 2. Default 2. | | `check_in` | string | yes | `"2026-12-02"` | Check-in date (YYYY-MM-DD), for example 2026-11-12. | | `currency` | string | no | | Three-letter currency code, for example USD. Default "USD". | | `location` | string | yes | `"Tokyo"` | City or area, for example Paris. | | `check_out` | string | yes | `"2026-12-04"` | Check-out date (YYYY-MM-DD), for example 2026-11-15. | | `min_stars` | integer | no | `3` | Minimum hotel class, for example 4. | | `max_results` | integer | no | `50` | Maximum hotels, for example 20. Default 20. | | `min_guest_rating` | number | no | `4` | Minimum rating out of five, for example 4.2. | | `max_price_per_night` | number | no | `300` | Maximum nightly price, for example 250. | ## Output From a run on Oct 31, 2026, shortened. Its input: ```json { "check_in": "2026-12-02", "location": "Tokyo", "check_out": "2026-12-04", "min_stars": 3, "max_results": 50, "min_guest_rating": 4, "max_price_per_night": 300 } ``` Its output: ```json { "hotels": [ { "name": "Mitsui Garden Hotel Toyosu Premier", "stars": 5, "currency": "USD", "latitude": 35.65513, "amenities": [ "Public bath", "Free Wi-Fi", "Parking" ], "longitude": 139.7946277, "total_price": 321, "guest_rating": 4.3, "review_count": 1262, "price_per_night": 146, "google_hotels_link": "https://www.google.com/travel/hotels/entity/ChoI7tTyvLiSqvrEARoNL2cvMTFoOTMwMTI4ZxAB?q=hotels+in+Tokyo&hl=en&curr=USD&ts=CAESCgoCCAMKAggDEAAaUAoyEi4yJTB4NjA1ZDFiODdmMDJlNTdlNzoweDJlMDE2MThiMjI1NzFiODk6BVRva3lvGgASGhIUCgcI6g8QDBgCEgcI6g8QDBgEGAIyAggBKg0KCToDVVNEYgIIARoA&ei=Ivq6atX5NO615LcPgoP-sAU&sa=…", "cheapest_booking_site": "Mitsui Garden Hotel Toyosu Premier", "google_property_token": "ChoI7tTyvLiSqvrEARoNL2cvMTFoOTMwMTI4ZxAB", "neighborhood_or_address": "Japan, 〒135-0061 Tokyo, Koto City, Toyosu, 2 Chome−2−1 ベイサイドクロスタワ" }, { "name": "ONE@Tokyo by insomnia", "stars": 3, "currency": "USD", "latitude": 35.711788899999995, "amenities": [ "Free Wi-Fi", "Parking", "Accessible" ], "longitude": 139.81597779999998, "total_price": 222, "guest_rating": 4.3, "review_count": 1004, "price_per_night": 101, "google_hotels_link": "https://www.google.com/travel/hotels/entity/ChoI84KEy5HjiaeGARoNL2cvMTFkeGp4MnEyXxAB?q=hotels+in+Tokyo&hl=en&curr=USD&ts=CAESCgoCCAMKAggDEAAaUAoyEi4yJTB4NjA1ZDFiODdmMDJlNTdlNzoweDJlMDE2MThiMjI1NzFiODk6BVRva3lvGgASGhIUCgcI6g8QDBgCEgcI6g8QDBgEGAIyAggBKg0KCToDVVNEYgIIARoA&ei=Ivq6atX5NO615LcPgoP-sAU&sa=…", "cheapest_booking_site": "ONE@Tokyo by insomnia", "google_property_token": "ChoI84KEy5HjiaeGARoNL2cvMTFkeGp4MnEyXxAB", "neighborhood_or_address": "1 Chome-19-3 Oshiage, Sumida City, Tokyo 131-0045, Japan" }, { "name": "Shinjuku Granbell Hotel", "stars": 4, "currency": "USD", "latitude": 35.6964448, "amenities": [ "Free Wi-Fi", "Parking ($)", "Bar" ], "longitude": 139.70572439999998, "total_price": 214, "guest_rating": 4, "review_count": 3476, "price_per_night": 98, "google_hotels_link": "https://www.google.com/travel/hotels/entity/ChkI_Zmo7NeSqYDfARoML2cvMXB0X18zcGttEAE?q=hotels+in+Tokyo&hl=en&curr=USD&ts=CAESCgoCCAMKAggDEAAaUAoyEi4yJTB4NjA1ZDFiODdmMDJlNTdlNzoweDJlMDE2MThiMjI1NzFiODk6BVRva3lvGgASGhIUCgcI6g8QDBgCEgcI6g8QDBgEGAIyAggBKg0KCToDVVNEYgIIARoA&ei=Ivq6atX5NO615LcPgoP-sAU&sa=X…", "cheapest_booking_site": "GRANBELL HOTEL SHINJUKU", "google_property_token": "ChkI_Zmo7NeSqYDfARoML2cvMXB0X18zcGttEAE", "neighborhood_or_address": "2 Chome-14-5 Kabukicho, Shinjuku City, Tokyo 160-0021, Japan" } ], "search_link": "https://www.google.com/travel/search?q=hotels+in+Tokyo&hl=en&curr=USD&ts=CAESCgoCCAMKAggDEAAaUAoyEi4yJTB4NjA1ZDFiODdmMDJlNTdlNzoweDJlMDE2MThiMjI1NzFiODk6BVRva3lvGgASGhIUCgcI6g8QDBgCEgcI6g8QDBgEGAIyAggBKg0KCToDVVNEYgIIARoA" } ``` ## 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":"google.com/search_hotels","input":{"check_in":"2026-12-02","location":"Tokyo","check_out":"2026-12-04","min_stars":3,"max_results":50,"min_guest_rating":4,"max_price_per_night":300}}' ``` 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 hotels in Lisbon for March 14 to March 18, 2026, for 2 adults, at least 4 stars and under 180 EUR per night. - What are the cheapest places to stay in Kyoto from 2026-04-02 to 2026-04-06 for one person? Show prices in JPY and which booking site has the best rate. - Search Google Hotels for Chicago, check-in October 9 and check-out October 12, 3 adults, guest rating 4.3 or higher. Give me up to 15 options. - I need a hotel in Barcelona's Gothic Quarter for 4 adults, June 20–25, 2026. Max $300 a night, and list amenities and addresses. - Using Google, pull 5-star hotels in Dubai for 2026-12-28 through 2027-01-02 for two guests, with total stay cost and map coordinates. ## Input schema ```json { "type": "object", "required": [ "location", "check_in", "check_out" ], "properties": { "adults": { "type": "integer", "default": 2, "maximum": 10, "minimum": 1, "description": "Adults, for example 2." }, "check_in": { "type": "string", "description": "Check-in date (YYYY-MM-DD), for example 2026-11-12." }, "currency": { "type": "string", "default": "USD", "description": "Three-letter currency code, for example USD." }, "location": { "type": "string", "description": "City or area, for example Paris." }, "check_out": { "type": "string", "description": "Check-out date (YYYY-MM-DD), for example 2026-11-15." }, "min_stars": { "type": "integer", "maximum": 5, "minimum": 1, "description": "Minimum hotel class, for example 4." }, "max_results": { "type": "integer", "default": 20, "maximum": 50, "minimum": 1, "description": "Maximum hotels, for example 20." }, "min_guest_rating": { "type": "number", "maximum": 5, "minimum": 1, "description": "Minimum rating out of five, for example 4.2." }, "max_price_per_night": { "type": "number", "minimum": 0, "description": "Maximum nightly price, for example 250." } } } ``` ## Output schema ```json { "type": "object", "required": [ "search_link", "hotels" ], "properties": { "hotels": { "type": "array", "items": { "type": "object", "required": [ "name", "stars", "guest_rating", "review_count", "price_per_night", "total_price", "currency", "cheapest_booking_site", "amenities", "neighborhood_or_address", "google_hotels_link", "google_property_token", "latitude", "longitude" ], "properties": { "name": { "type": "string", "description": "Hotel name." }, "stars": { "type": [ "integer", "null" ], "description": "Hotel class." }, "currency": { "type": "string", "description": "Currency of prices." }, "latitude": { "type": [ "number", "null" ], "description": "Latitude." }, "amenities": { "type": "array", "items": { "type": "string" }, "description": "Main amenities." }, "longitude": { "type": [ "number", "null" ], "description": "Longitude." }, "total_price": { "type": [ "number", "null" ], "description": "Stay total with taxes and fees." }, "guest_rating": { "type": [ "number", "null" ], "description": "Guest rating out of five." }, "review_count": { "type": [ "integer", "null" ], "description": "Number of reviews." }, "price_per_night": { "type": [ "number", "null" ], "description": "Nightly price." }, "google_hotels_link": { "type": "string", "description": "Property link on Google Hotels." }, "cheapest_booking_site": { "type": [ "string", "null" ], "description": "Booking site with lowest quoted price." }, "google_property_token": { "type": [ "string", "null" ], "description": "Google property token." }, "neighborhood_or_address": { "type": [ "string", "null" ], "description": "Address or neighborhood." } } }, "description": "Hotels in Google order." }, "search_link": { "type": "string", "description": "Google Hotels search link." } } } ``` ## See more - [Google API: Get hotel reviews from Google Hotels](https://fous.com/methods/google.com/get-hotel-reviews.md): Finds a hotel on Google Hotels by name and city and returns its guest reviews in the chosen order, its Google rating and review count, and topic ratings averaged from the returned reviews that rate each topic. - [Google API: Search Google Flights](https://fous.com/methods/google.com/search-flights.md): Finds Google Flights options for a route and date with prices, local times, stops and emissions. Round-trip searches list outbound choices with their displayed round-trip fares. - [Google API: Get cheapest flight dates in a month](https://fous.com/methods/google.com/get-cheapest-dates.md): Finds the lowest Google Flights fare for each departure date in a month between two places, for one-way trips or a fixed trip length, with the cheapest option and any price insight shown. - [Google API: List cheap flight destinations](https://fous.com/methods/google.com/list-cheap-destinations.md): Lists cheap round-trip destinations from a city on Google Travel Explore, sorted by fare, optionally within a region, travel month, trip length and nonstop only. Links search Google Flights for the shown dates. - [Google API: Search places](https://fous.com/methods/google.com/search-places.md): Finds businesses and places near a location on Google Maps, in Google Maps order, with rating, hours, contact details and links when shown. - [Google API: Get place](https://fous.com/methods/google.com/get-place.md): Looks up a public Google Maps place by name and location and returns its profile: address, rating, hours, phone, website and photos. - [Google API: Get directions](https://fous.com/methods/google.com/get-directions.md): Gets up to three Google Maps routes between two places, with distances, travel times and step-by-step directions. - [Google API: Search Google Books](https://fous.com/methods/books.google.com/search-books.md): Searches Google Books by words, author, subject or ISBN, with language, free-ebook and newest-first options. Ratings counts are not shown by the public book feed; newest sorts the available matches by publication date. - [All Google methods](https://fous.com/methods/google.com.md)