API Parameters - Scrapeless API

Parameters	Required	Desc
q	true	Parameter defines the search query. You can use anything that you would use in a regular Google Hotels search.
gl	false	Parameter defines the country to use for the Google Hotels search. It's a two-letter country code. (e.g., `us` for the United States, `uk` for United Kingdom, or `fr` for France) Head to the Google countries page for a full list of supported Google countries.
hl	false	Parameter defines the language to use for the Google Hotels search. It's a two-letter language code. (e.g., `en` for English, `es` for Spanish, or `fr` for French). Head to the Google languages page for a full list of supported Google languages.
currency	false	Parameter defines the currency of the returned prices. Default to `USD`. Head to the Google Travel Currencies page for a full list of supported currency codes.
check_in_date	true	Parameter defines the check-in date. The format is YYYY-MM-DD. e.g. `2025-03-05`
check_out_date	true	Parameter defines the check-out date. The format is YYYY-MM-DD. e.g. `2025-03-06`
adults	false	Parameter defines the number of adults. Default to `2`.
children	false	Parameter defines the number of children. Default to `0`.
children_ages	false	Parameter defines the ages of children. The age range is from `1` to `17`, with children who haven't reached 1 year old being considered as `1`. Example for single child only: `5` Example for multiple children (seperated by comma `,`): `5,8,10`
sort_by	false	Parameter is used for sorting the results. Default is sort by `Relevance`.Available options: `3` Lowest price `8` Highest rating `13` Most reviewed
min_price	false	Parameter defines the lower bound of price range.
max_price	false	Parameter defines the upper bound of price range.
property_types	false	Parameter defines to include only certain type of property in the results. Example for single property type only: `17` Example for multiple property types (seperated by comma `,`): `17,12,18`
amenities	false	Parameter defines to include only results that offer specified amenities. Example for single amenity only: `35` Example for multiple amenities (seperated by comma `,`): `35,9,19`
rating	false	Parameter is used for filtering the results to certain rating.Available options: `7` 3.5+ `8` 4.0+ `9` 4.5+
brands	false	Parameter defines the brands where you want your search to be concentrated. ID values are accessible inside `brands` array, located in our JSON output (e.g. `brands[0].id`). Example for single brand only: `33` Example for multiple brands (seperated by comma `,`): `33,67,101` This parameter isn't available for Vacation Rentals.
hotel_class	false	Parameter defines to include only certain hotel class in the results.Supported options: `2` 2-star `3` 3-star `4` 4-star `5` 5-starExample for single hotel class only: `2` Example for multiple hotel class (seperated by comma `,`): `2,3,4` This parameter isn't available for Vacation Rentals.
free_cancellation	false	Parameter defines to show results that offer free cancellation.This parameter isn't available for Vacation Rentals.
special_offers	false	Parameter defines to show results that have special offers.This parameter isn't available for Vacation Rentals.
eco_certified	false	Parameter defines to show results that are eco certified.This parameter isn't available for Vacation Rentals.
vacation_rentals	false	Parameter defines to search for Vacation Rentals results. Default search is for Hotels.
bedrooms	false	Parameter defines the minimum number of bedrooms. Default to `0`. This parameter only available for Vacation Rentals.
bathrooms	false	Parameter defines the minimum number of bathrooms. Default to `0`. This parameter only available for Vacation Rentals.
next_page_token	false	Parameter defines the next page token. It is used for retrieving the next page results.
property_token	false	Parameter is used to get property details which consists of name, address, phone, prices, nearby places, and etc.
engine	true	Set parameter to `google_hotels` to use the Google Hotels API engine.