Search Google Hotels (SerpAPI)
google_hotels_searchSearch Google Hotels live via SerpAPI. Returns properties (hotels and, with vacation_rentals, rentals) with names, prices/rates, overall ratings, review counts, amenities, images and location, plus the brands/property_types/amenities filter ids you can feed back in. Requires q (a destination, area or hotel name), check_in_date and check_out_date (YYYY-MM-DD). Every property in the results carries a property_token: pass it back here (keeping the same check_in_date/check_out_date) to get that one property's full details, or hand it to google_hotels_photos and google_hotels_reviews. Paginate with next_page_token. Prices are in currency (default USD). Result shape: { source, fetchedAt, query, search_metadata, search_parameters, search_information, brands, ads, properties: [...], serpapi_pagination } — the list key is properties (ads are separate). Each property: { type, name, property_token, link, gps_coordinates, rate_per_night: { lowest, extracted_lowest }, total_rate, prices: [{ source, num_guests, rate_per_night }], overall_rating, reviews, hotel_class (label), extracted_hotel_class (number), amenities, images: [{ thumbnail, original_image }], nearby_places, description }. With property_token the single property's fields come back at the top level instead of properties.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | Yes | Search query: a destination, area, or hotel name (e.g. 'Bali resorts', 'hotels in Paris'). | |
| gl | No | Country code for the search, e.g. 'us', 'uk', 'de'. | |
| hl | No | Language code, e.g. 'en', 'es', 'pt-br'. | |
| adults | No | Number of adults. Default 2. | |
| brands | No | Filter by hotel brand: comma-separated brand ids (see brands in a prior response). Not applicable to vacation rentals. | |
| rating | No | Minimum overall rating: 7 = 3.5+, 8 = 4.0+, 9 = 4.5+. | |
| sort_by | No | Sort order: 3 = lowest price, 8 = highest rating, 13 = most reviewed. Omit for SerpAPI's default relevance ranking. | |
| bedrooms | No | Minimum number of bedrooms. Vacation rentals only. Default 0. | |
| children | No | Number of children. Default 0. | |
| currency | No | Currency of returned prices (ISO code, e.g. 'USD', 'EUR'). Default USD. | |
| no_cache | No | Force a fresh SerpAPI fetch and bypass this server's result cache. Default false. | |
| amenities | No | Filter by amenities: comma-separated amenity ids (see amenities in a prior response). | |
| bathrooms | No | Minimum number of bathrooms. Vacation rentals only. Default 0. | |
| max_price | No | Maximum price per night in the selected currency. | |
| min_price | No | Minimum price per night in the selected currency. | |
| zero_trace | No | Enterprise-only ZeroTrace mode: don't store search params/metadata on SerpAPI. Default false. | |
| hotel_class | No | Filter by hotel class (stars): comma-separated values from 2 to 5, e.g. '4,5'. | |
| check_in_date | Yes | Check-in date, YYYY-MM-DD. | |
| children_ages | No | Ages of the children as comma-separated values, e.g. '5,8'. Each age 1-17; the count should match `children`. | |
| eco_certified | No | Only show eco-certified properties. Default false. | |
| check_out_date | Yes | Check-out date, YYYY-MM-DD. | |
| property_token | No | Token for a single property from a prior search result; returns that property's full details. Still pass check_in_date and check_out_date. | |
| property_types | No | Filter by property type: comma-separated type ids (see property_types in a prior response). | |
| special_offers | No | Only show properties with special offers. Default false. | |
| next_page_token | No | Token from a prior response to fetch the next page of results. | |
| vacation_rentals | No | Search vacation rentals instead of hotels. Default false (hotels). | |
| free_cancellation | No | Only show properties offering free cancellation. Default false. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ads | No | ||
| query | Yes | ||
| brands | No | ||
| source | Yes | ||
| fetchedAt | Yes | ||
| properties | No | ||
| search_metadata | No | ||
| search_parameters | No | ||
| search_information | No | ||
| serpapi_pagination | No |