Scrapingdog

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_hotels

API Parameters

πŸ”‘

Scrapingdog Parameters

  • api_key Required
    This is your API key.

    Type: String
  • html Optional
    This will return the full HTML of the Google page.

    Default Value - false

    Type - Boolean
πŸ”

Search Query

  • query Required
    This 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

  • country Optional
    This 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 - String
  • language Optional
    Language of the results. Possible Values - en, es, fr, de, etc.

    Default Value - en

    Type - String
  • currency Optional
    This 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_date Required
    This parameter specifies the check-in date in the format YYYY-MM-DD (e.g., 2025-08-15).

    Type - String
  • check_out_date Required
    This parameter specifies the check-out date, using the format YYYY-MM-DD (e.g., 2025-08-16).

    Type - String
  • adults Optional
    This parameter specifies the number of adults, with a default value of 2.

    Type - String
  • children Optional
    This parameter specifies the number of children, with a default value of 0.

    Type - String
  • children_ages Optional
    This 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_by Optional
    Parameter 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
    Type - String
  • min_price Optional
    Parameter sets the minimum price in the range.

    Type - String
  • max_price Optional
    Specifies the maximum price in the range.

    Type - String
  • property_types Optional
    Specifies 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 - String
  • amenities Optional
    This 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 - String
  • rating Optional
    Parameter is used for filtering the results to a certain rating.

    Available options:
    • 7 – 3.5+
    • 8 – 4.0+
    • 9 – 4.5+
    Type - String
🏨

Hotel Filters

  • brands Optional
    This 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 - String
  • hotel_class Optional
    This 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 - String
  • free_cancellation Optional
    This parameter filters results to include only listings that offer free cancellation.

    Note: This option is not available for Vacation Rentals.

    Type - Boolean
  • special_offers Optional
    This parameter limits results to listings that include special offers.

    Note: This option is not available for Vacation Rentals.

    Type - Boolean
  • eco_certified Optional
    This 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_rentals Optional
    This parameter specifies whether to search for Vacation Rentals. By default, the search is set to Hotels.

    Default Value - false

    Type - String
  • bedrooms Optional
    This parameter sets the minimum number of bedrooms.

    Default Value - false

    Note: This option is available only for Vacation Rentals.

    Type - String
  • bathrooms Optional
    This parameter specifies the minimum number of bathrooms.

    Default Value - false

    Note: This option is only available for Vacation Rentals.

    Type - String
πŸ“„

Pagination

  • next_page_token Optional
    The next_page_token is used to get the next page results.

    Type: String
🏒

Property Details

  • property_token Optional
    This 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"
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
    }
  ]
}