Google Hotels

Search

Get Google hotels Search data, including prices, ratings, and availability details, for travel comparison and hospitality market analysis.

get/api/v1/google/hotels/search

Request

  • Base URL: http://api.justserpapi.com
  • URL: http://api.justserpapi.com/api/v1/google/hotels/search
  • Auth: none declared

Query parameters

querystring required

The destination or specific hotel name you are searching for (e.g., 'Paris', 'Hilton New York').

check_in_datestring required

The hotel check-in date in 'YYYY-MM-DD' format (e.g., '2026-05-20').

check_out_datestring required

The hotel check-out date in 'YYYY-MM-DD' format (e.g., '2026-05-25').

next_page_tokenstring

The token used to retrieve the next page of hotel results. This token is found in the 'next_page_token' field of a previous response.

adultsinteger

The number of adults staying in the room.

childreninteger

The number of children staying in the room.

children_agesstring

The ages of the children, separated by commas (e.g., '5,10'). The number of ages must match the 'children' parameter.

htmlboolean

Set to true to return the raw HTML of the Google search results page alongside the structured data.

languagestring

Set the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See <a href="/reference/google-language">Google Language</a>.

countrystring

Set the target country code (e.g., 'us', 'uk') to localize results. See <a href="/reference/google-countries">Google Countries</a>.

currencystring

The three-letter ISO currency code for displaying prices (e.g., 'USD', 'EUR'). See <a href="/reference/hotels/google-hotels-currency">Google Hotels Currency</a>.

sort_by'LOWEST_PRICE' | 'HIGHEST_RATING' | 'MOST_REVIEWS'

Google Hotels sort order.

The criteria to sort hotel results.

Available Values:

  • LOWEST_PRICE: Lowest price. Legacy value 3 is also accepted.
  • HIGHEST_RATING: Highest rating. Legacy value 8 is also accepted.
  • MOST_REVIEWS: Most reviews. Legacy value 13 is also accepted.
min_pricestring

Minimum price filter for the hotel stay.

max_pricestring

Maximum price filter for the hotel stay.

property_typesstring

Filter by hotel property types. See the <a href="/reference/hotels/google-hotels-property-types">Google Property Types</a> for the full list of supported hotel property types. For vacation rentals, refer to the <a href="/reference/hotels/google-hotels-vacation-rentals-property-types">Google Hotels Vacation Rentals Property Types</a>.

amenitiesstring

Filter by specific amenities (e.g., '35' for free Wi-Fi). <a href="/reference/hotels/google-hotels-amenities">Google Hotels Amenities</a> (hotel amenities). <a href="/reference/hotels/google-hotels-vacation-rentals-amenities">Google Hotels Vacation Rentals Amenities</a> (vacation rental amenities)

rating'AT_LEAST_3_5' | 'AT_LEAST_4_0' | 'AT_LEAST_4_5'

Google Hotels minimum guest rating filter.

Filter by minimum guest rating.

Available Values:

  • AT_LEAST_3_5: 3.5+ guest rating. Legacy value 7 is also accepted.
  • AT_LEAST_4_0: 4.0+ guest rating. Legacy value 8 is also accepted.
  • AT_LEAST_4_5: 4.5+ guest rating. Legacy value 9 is also accepted.
brandsstring

Filter by specific hotel brand IDs. IDs can be comma-separated.

hotel_classstring

Filter by hotel star ratings. Supported values: '2', '3', '4', '5'. Can be comma-separated.

free_cancellationstring

Filter for hotels that offer free cancellation. Set to '1' or 'true' to enable.

special_offersstring

Filter for hotels currently offering special deals or discounts. Set to '1' or 'true' to enable.

eco_certifiedstring

Filter for hotels that are eco-certified. Set to '1' or 'true' to enable.

vacation_rentalsboolean

Set to true to search for vacation rentals instead of standard hotels.

bedroomsstring

Minimum number of bedrooms required (applies to vacation rentals).

bathroomsstring

Minimum number of bathrooms required (applies to vacation rentals).

property_tokenstring

The unique token for a specific hotel property to fetch detailed information.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.