Google Hotels API
The Google Hotels API retrieves hotel search results from Google Hotels including property listings, pricing, ratings, amenities, and detailed property information. Costs 5 API credits per request.
Endpoint:
https://api.scrapingdog.com/google_hotelsAPI Parameters
π
Scrapingdog Parameters
api_keyRequiredThis is your API key.
Type: StringhtmlOptionalThis will return the full HTML of the Google page.
Default Value -false
Type - Boolean
π
Search Query
queryRequiredThis parameter specifies the search query. You can enter anything you would normally use in a standard Google Hotels search.
Type - String
π
Geographic Location and Localization
countryOptionalThis parameter specifies the country for the Google search using a two-letter country code (e.g., US for the United States, UK for the United Kingdom, or FR for France).
Default Value -us
Type - StringlanguageOptionalLanguage of the results. Possible Values -en,es,fr,de, etc.
Default Value -en
Type - StringcurrencyOptionalThis parameter sets the currency for the returned prices. For a complete list, see the Supported Google Travel Currency Codes.
Default:USD
Type - String
π
Advanced Google Parameters
check_in_dateRequiredThis parameter specifies the check-in date in the format YYYY-MM-DD (e.g.,2025-08-15).
Type - Stringcheck_out_dateRequiredThis parameter specifies the check-out date, using the format YYYY-MM-DD (e.g.,2025-08-16).
Type - StringadultsOptionalThis parameter specifies the number of adults, with a default value of 2.
Type - StringchildrenOptionalThis parameter specifies the number of children, with a default value of 0.
Type - Stringchildren_agesOptionalThis parameter specifies the ages of children. The valid range is 1 to 17. Examples: single child:5; multiple:5,8,10.
Type - String
β
οΈ Advanced Filters
sort_byOptionalParameter specifies how the results should be sorted. By default, results are sorted by Relevance.
Available options:- 3 β Sort by lowest price
- 8 β Sort by highest rating
- 13 β Sort by most reviews
min_priceOptionalParameter sets the minimum price in the range.
Type - Stringmax_priceOptionalSpecifies the maximum price in the range.
Type - Stringproperty_typesOptionalSpecifies the property type(s) to include in the results. For a complete list, see Supported Google Hotels Property Types or Supported Google Vacation Rentals Property Types.
Type - StringamenitiesOptionalThis parameter allows you to filter results so that only listings with the selected amenities are included. For a complete list, see Supported Google Hotels Amenities or Supported Google Vacation Rentals Amenities.
Type - StringratingOptionalParameter is used for filtering the results to a certain rating.
Available options:- 7 β 3.5+
- 8 β 4.0+
- 9 β 4.5+
π¨
Hotel Filters
brandsOptionalThis parameter specifies the brands you want to focus your search on. Examples: single:33; multiple:33,67,101.
Note: This parameter is not supported for Vacation Rentals.
Type - Stringhotel_classOptionalThis parameter filters results to include only hotels of specific star ratings.
Available options:2β 2-star,3β 3-star,4β 4-star,5β 5-star.
Note: This parameter is not supported for Vacation Rentals.
Type - Stringfree_cancellationOptionalThis parameter filters results to include only listings that offer free cancellation.
Note: This option is not available for Vacation Rentals.
Type - Booleanspecial_offersOptionalThis parameter limits results to listings that include special offers.
Note: This option is not available for Vacation Rentals.
Type - Booleaneco_certifiedOptionalThis parameter filters results to include only listings that are eco-certified.
Note: This option is not supported for Vacation Rentals.
Type - Boolean
π
οΈ Vacation Rentals Filters
vacation_rentalsOptionalThis parameter specifies whether to search for Vacation Rentals. By default, the search is set to Hotels.
Default Value -false
Type - StringbedroomsOptionalThis parameter sets the minimum number of bedrooms.
Default Value -false
Note: This option is available only for Vacation Rentals.
Type - StringbathroomsOptionalThis parameter specifies the minimum number of bathrooms.
Default Value -false
Note: This option is only available for Vacation Rentals.
Type - String
π
Pagination
next_page_tokenOptionalThe next_page_token is used to get the next page results.
Type: String
π’
Property Details
property_tokenOptionalThis parameter retrieves detailed property information, including name, address, phone number, prices, nearby places, and more.
Type: String
API Examples
Code to Integrate
curl "https://api.scrapingdog.com/google_hotels?api_key=APIKEY&query=Hotels+in+New+York&check_in_date=2025-08-19&check_out_date=2025-08-20"
import requests url = "https://api.scrapingdog.com/google_hotels" params = { "api_key": "APIKEY", "query": "Hotels in New York", "check_in_date": "2025-08-19", "check_out_date": "2025-08-20" } response = requests.get(url, params=params) if response.status_code == 200: print(response.json())
const axios = require('axios'); axios.get('https://api.scrapingdog.com/google_hotels', { params: { api_key: 'APIKEY', query: 'Hotels in New York', check_in_date: '2025-08-19', check_out_date: '2025-08-20' } }).then(response => console.log(response.data)) .catch(error => console.error(error.message));
<?php $url = 'https://api.scrapingdog.com/google_hotels/?' . http_build_query([ 'api_key' => 'APIKEY', 'query' => 'Hotels in New York', 'check_in_date' => '2025-08-19', 'check_out_date' => '2025-08-20', ]); $ch = curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); echo curl_exec($ch); curl_close($ch);
require 'net/http' require 'uri' url = URI.parse("https://api.scrapingdog.com/google_hotels/") url.query = URI.encode_www_form( 'api_key' => 'APIKEY', 'query' => 'Hotels in New York', 'check_in_date' => '2025-08-19', 'check_out_date' => '2025-08-20' ) http = Net::HTTP.new(url.host, url.port) http.use_ssl = true puts http.request(Net::HTTP::Get.new(url)).body
import java.io.*; import java.net.*; public class Main { public static void main(String[] args) throws Exception { String apiUrl = "https://api.scrapingdog.com/google_hotels/?api_key=APIKEY&query=Hotels+in+New+York&check_in_date=2025-08-19&check_out_date=2025-08-20"; URL url = new URL(apiUrl); HttpURLConnection conn = (HttpURLConnection) url.openConnection(); conn.setRequestMethod("GET"); BufferedReader reader = new BufferedReader(new InputStreamReader(conn.getInputStream())); String line; while ((line = reader.readLine()) != null) System.out.println(line); conn.disconnect(); } }
API Response
{
"ads": [
{
"title": "Howard Johnson by Wyndham Newark Airport",
"source": "Booking.com",
"price": "$98",
"reviews": 1812,
"overall_rating": 3,
"amenities": ["Beach access", "Restaurant", "Hot Tub"],
"hotel_class": 2,
"free_cancellation": false
}
]
}