Skip to main content
The Google Hotels API provides real-time access to structured Google Hotels search results, including property listings, prices, ratings, amenities, and pagination.

​
Get Your API Key

Sign in at hasdata.com, go to your account settings, and copy your API key. All requests must include your key in the x-api-key header.

​
Request Cost and API Credits

Each request to the Google Hotels API consumes API Credits from your account balance.
  • Cost per request: 10 API Credits
  • Credits are deducted only for successful requests.
  • Your total available credits depend on your active plan.
You can use your credits across all HasData APIs. The same credit balance is shared platform-wide.
Unused credits do not roll over. Any remaining credits expire at the end of the current billing period.
To monitor your credit usage and remaining balance, sign in to your account dashboard at app.hasdata.com.

​
Make Your First Request

curl --request GET -G \
  --url 'https://api.hasdata.com/scrape/google/hotels' \
  --data-urlencode 'q=Hotels in New York' \
  --data-urlencode 'checkInDate=2026-08-15' \
  --data-urlencode 'checkOutDate=2026-08-20' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <your-api-key>'

​
API Parameters

ParameterDefault ValueRequiredDescription
qHotels in New YorkYesThe search query for Google Hotels (e.g., a city, neighborhood, or hotel name).
checkInDate2026-08-15YesThe check-in date in ‘yyyy-MM-dd’ format.
checkOutDate2026-08-20YesThe check-out date in ‘yyyy-MM-dd’ format.
gl-NoThe two-letter country code for the country you want to limit the search to.
hl-NoThe two-letter language code for the language you want to use for the search.
currency-NoParameter defines the currency of the returned prices
adults-NoNumber of adult guests (1-6).
children-NoNumber of child guests (1-5). Total guests (adults + children) cannot exceed 6.
childrenAges-NoComma-separated list of children ages (e.g., 5,8,12). Must match the number of children.
sortBy-NoSort hotel results. Options:

- lowestPrice — lowest price
- highestRating — highest rating
- mostReviewed — most reviewed
minPrice-NoMinimum price per night, in the selected currency.
maxPrice-NoMaximum price per night, in the selected currency.
propertyType[]-NoList of property types to filter by (e.g., hotelResort,hotelMotel).

Values prefixed hotel* apply when searching hotels (the default mode). Values prefixed rental* apply when vacationRentals=true.

The two sets are disjoint because Google Hotels exposes different property-type catalogs for each mode — pass values matching the mode you’re querying.
amenity[]-NoList of amenities to filter by (e.g., hotelFreeWifi,hotelPool).

Values prefixed hotel* apply when searching hotels (the default mode). Values prefixed rental* apply when vacationRentals=true.

The two sets are disjoint because Google Hotels exposes different amenity catalogs for each mode — pass values matching the mode you’re querying.
rating-NoFilter by minimum overall guest rating. Options:

- threePointFivePlus — 3.5 stars or higher
- fourPlus — 4.0 stars or higher
- fourPointFivePlus — 4.5 stars or higher
brands-NoComma-separated list of brand IDs to filter by. Brand IDs are returned in the response under brands for the same query.
hotelClass-NoComma-separated list of hotel star classes to include (e.g., 2,3,4,5).
freeCancellation-NoShow only properties offering free cancellation.
specialOffers-NoShow only properties with special offers.
ecoCertified-NoShow only eco-certified properties.
vacationRentals-NoSearch vacation rentals instead of hotels.
bedrooms-NoMinimum number of bedrooms (vacation rentals only).
bathrooms-NoMinimum number of bathrooms (vacation rentals only).
nextPageToken-NoToken to fetch the next page of hotel results. Returned in the pagination field of a previous response.
propertyToken-NoToken used to retrieve details for a specific property. Returned in each property in the results.