Logo SearchApi

Google Hotels API Documentation

Google Hotels API uses the /api/v1/search?engine=google_hotels endpoint to retrieve detailed hotels information.

This includes data on property details, check-in/out times, guest information, pricing, amenities, and more. The API also provides a rich data that includes essential hotel metadata.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    Parameter defines the query you want to search. You can use anything that you would use in a regular Google Hotels search.

Date Range

  • Name
    check_in_date
    Required
    Required
    Description

    Defines the check-in date for the hotel stay in the format YYYY-MM-DD. This date marks the beginning of the reservation.

  • Name
    check_out_date
    Required
    Required
    Description

    The check-out date for the hotel stay in the format YYYY-MM-DD. This date marks the end of the reservation.

Localization

  • Name
    gl
    Required
    Optional
    Description

    The default parameter us defines the country of the search. Check the full list of supported Google Travel gl countries.

  • Name
    hl
    Required
    Optional
    Description

    The default parameter en defines the interface language of the search. Check the full list of supported Google Travel hl languages.

  • Name
    currency
    Required
    Optional
    Description

    Defines the currency of the returned prices. Default is USD. Check the full list of supported Google Travel currency values.

Filters

  • Name
    property_type
    Required
    Optional
    Description

    Defines property type that specifies the category of accommodation to search for. The hotel option also includes vacation rentals. Available options:

    • hotel Default
    • vacation_rental

  • Name
    sort_by
    Required
    Optional
    Description

    Defines the sorting order of the results. Available options:

    • relevance Default
    • lowest_price
    • highest_rating
    • most_reviewed

  • Name
    price_min
    Required
    Optional
    Description

    Defines the minimum price. Default is 0.

  • Name
    price_max
    Required
    Optional
    Description

    Defines the maximum price. Default is unlimited.

  • Name
    property_types
    Required
    Optional
    Description

    Defines a list of property types that allows multiple categories that are separated by a comma. For example: 1,2. Check the full list of supported Google Hotels property_types values.

  • Name
    amenities
    Required
    Optional
    Description

    Defines a list of amenities that allows multiple categories that are separated by a comma. For example: 1,2. Check the full list of supported Google Hotels amenities values.

  • Name
    rating
    Required
    Optional
    Description

    Defines the minimum rating of results to return. Available options:

    • 7 for 3.5+ stars
    • 8 for 4.0+ stars
    • 9 for 4.5+ stars

Hotel Filters

  • Name
    free_cancellation
    Required
    Optional
    Description

    Defines a filter indicating whether to display only hotels that offer free cancellation on bookings. Set it to true to include only hotels with free cancellation.

  • Name
    special_offers
    Required
    Optional
    Description

    Defines to show results that have special offers. Set it to true to include only hotels with special offers.

  • Name
    for_displaced_individuals
    Required
    Optional
    Description

    Defines to show results that are available for displaced individuals. Set it to true to include only hotels that are available for displaced individuals.

  • Name
    eco_certified
    Required
    Optional
    Description

    Defines to show hotels that are eco-certified. Set it to true to include only eco-certified hotels.

  • Name
    hotel_class
    Required
    Optional
    Description

    Defines the rating of the hotel. Multiple ratings can be used with comma, for example: 4,5. Available options:

    • 2 for 2 stars
    • 3 for 3 stars
    • 4 for 4 stars
    • 5 for 5 stars

  • Name
    brands
    Required
    Optional
    Description

    A comma-separated list of hotel brands to include in the search results, allowing users to filter by preferred hotel chains. The possible values can be obtained from the initial request response under the brands[0].id key.

Vacation Rentals Filters

  • Name
    bedrooms
    Required
    Optional
    Description

    Defines the minimum number of bedrooms. Default is 0.

  • Name
    bathrooms
    Required
    Optional
    Description

    Defines the minimum number of bathrooms. Default is 0.

Number of Guests

  • Name
    adults
    Required
    Optional
    Description

    The number of adults staying in the apartment. Default is 2.

    • For property_type=hotel, the maximum number of guests is 6 (including children).
    • For property_type=vacation_rental, the maximum number is 10.

  • Name
    children_ages
    Required
    Optional
    Description

    Defines the ages of children as a comma-separated list, e.g., 2,5 for two children aged 2 and 5. Available age range is 1–17.

    Note: This parameter is only applicable for property_type=hotel and will be ignored for other property types.

Pagination

  • Name
    next_page_token
    Required
    Optional
    Description

    This parameter is used to retrieve the next page of results. It is returned in the response when there are more results to display.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to google_hotels.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

API Examples

Search

Search

The brands response key is included only when the request specifies the property_type=hotel parameter.

GET
https://www.searchapi.io/api/v1/search?check_in_date=2025-04-07&check_out_date=2025-04-14&engine=google_hotels&q=Hotels+in+Manhattan+New+York
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_hotels",
  "q": "Hotels in Manhattan New York",
  "check_in_date": "2025-04-07",
  "check_out_date": "2025-04-14"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_KQrlGNWjgNE7uky7pZVeALdm",
    "status": "Success",
    "created_at": "2025-02-24T16:39:00Z",
    "request_time_taken": 1.28,
    "parsing_time_taken": 0.01,
    "total_time_taken": 1.29,
    "request_url": "https://www.google.com/travel/search?q=Hotels%20in%20New%20York",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_KQrlGNWjgNE7uky7pZVeALdm.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_KQrlGNWjgNE7uky7pZVeALdm"
  },
  "search_parameters": {
    "engine": "google_hotels",
    "q": "Hotels in New York",
    "check_in_date": "2025-3-1",
    "check_out_date": "2025-3-7",
    "currency": "USD",
    "hl": "en",
    "gl": "us",
    "adults": "2",
    "property_type": "hotel"
  },
  "search_information": {
    "total_results": 12442
  },
  "properties": [
    {
      "type": "hotel",
      "property_token": "ChcI58fbmefAnaw6GgsvZy8xdGRmcDVkcxAB",
      "data_id": "0x89c25a178668323d:0x3a5876067336e3e7",
      "name": "Holiday Inn New York City - Wall Street, an IHG Hotel",
      "link": "https://www.ihg.com/holidayinn/hotels/us/en/new-york/nycmf/hoteldetail?cm_mmc=GoogleMaps-_-HI-_-US-_-NYCMF",
      "description": "Contemporary hotel with a restaurant, business center & fitness room, plus free WiFi.",
      "gps_coordinates": {
        "latitude": 40.7089767,
        "longitude": -74.0091231
      },
      "city": "New York",
      "country": "US",
      "check_in_time": "3:00 PM",
      "check_out_time": "12:00 PM",
      "price_per_night": {
        "price": "$176",
        "extracted_price": 176,
        "price_before_taxes": "$135",
        "extracted_price_before_taxes": 135
      },
      "total_price": {
        "price": "$1,058",
        "extracted_price": 1058,
        "price_before_taxes": "$810",
        "extracted_price_before_taxes": 810
      },
      "deal": "19% less than usual",
      "deal_description": "Deal",
      "nearby_places": [
        {
          "name": "9/11 Memorial & Museum",
          "transportations": [
            {
              "type": "Walking",
              "duration": "6 min"
            }
          ]
        },
        ...
      ],
      "hotel_class": "3-star hotel",
      "extracted_hoteL_class": 3,
      "rating": 3.7,
      "reviews": 928,
      "reviews_histogram": {
        "1": 120,
        "2": 63,
        "3": 143,
        "4": 266,
        "5": 336
      },
      "location_rating": 4.7,
      "proximity_to_things_to_do_rating": 4.5,
      "proximity_to_transit_rating": 5,
      "airport_access_rating": 4.2,
      "reviews_breakdown": [
        {
          "name": "Location",
          "description": "Location",
          "total": 209,
          "positive": 176,
          "neutral": 18,
          "negative": 15
        },
        ...
      ],
      "amenities": [
        "Breakfast",
        "Free Wi‑Fi",
        ...
      ],
      "images": [
        {
          "thumbnail": "https://lh5.googleusercontent.com/p/AF1QipM5MiLx5zqu1efcVXXIk7AoVlwriBM-eHPFu4b5=s287-w287-h192-n-k-no-v1",
          "original": "https://lh5.googleusercontent.com/p/AF1QipM5MiLx5zqu1efcVXXIk7AoVlwriBM-eHPFu4b5=s10000"
        },
        ...
      ]
    }
  ],
  "brands": [
    {
      "id": 33,
      "title": "Accor Live Limitless",
      "children": [
        {
          "id": 8,
          "title": "Fairmont Hotels and Resorts"
        },
        ...
      ]
    },
    ...
  ],
  "pagination": {
    "records_from": 1,
    "records_to": 20,
    "next_page_token": "CBI="
  }
}

Hotels

Hotels
GET
https://www.searchapi.io/api/v1/search?check_in_date=2025-04-07&check_out_date=2025-04-14&engine=google_hotels&hotel_class=5&q=Hotels+in+Hawaii
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_hotels",
  "q": "Hotels in Hawaii",
  "check_in_date": "2025-04-07",
  "check_out_date": "2025-04-14",
  "hotel_class": "5"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "properties": [
    {
      "type": "hotel",
      "property_token": "ChkIgNHl66rSvIMMGg0vZy8xMWZmdjZsNGdrEAE",
      "data_id": "0x79540ef8fb534149:0xc06f292ad796880",
      "name": "‘Alohilani Resort Waikiki Beach",
      "link": "https://www.alohilaniresort.com/",
      "description": "Upmarket hotel offering restaurants & bars, plus tennis courts, an outdoor pool & an aquarium.",
      "gps_coordinates": {
        "latitude": 21.2747071,
        "longitude": -157.8233668
      },
      "city": "Hawaii",
      "country": "US",
      "check_in_time": "3:00 PM",
      "check_out_time": "11:00 AM",
      "price_per_night": {
        "price": "$331",
        "extracted_price": 331,
        "price_before_taxes": "$225",
        "extracted_price_before_taxes": 225
      },
      "total_price": {
        "price": "$1,986",
        "extracted_price": 1986,
        "price_before_taxes": "$1,349",
        "extracted_price_before_taxes": 1349
      },
      "nearby_places": [
        {
          "name": "Moana Surfrider, A Westin Resort & Spa, Waikiki Beach",
          "transportations": [
            {
              "type": "Walking",
              "duration": "6 min"
            }
          ]
        },
        {
          "name": "Kalakaua Ave + Opp Uluniu Ave",
          "transportations": [
            {
              "type": "Walking",
              "duration": "2 min"
            }
          ]
        },
        {
          "name": "Daniel K. Inouye International Airport",
          "transportations": [
            {
              "type": "Taxi",
              "duration": "23 min"
            },
            {
              "type": "Public Transport",
              "duration": "1 hr 6 min"
            }
          ]
        }
      ],
      "hotel_class": "5-star hotel",
      "extracted_hoteL_class": 5,
      "rating": 4.1,
      "reviews": 6440,
      "reviews_histogram": {
        "1": 479,
        "2": 301,
        "3": 578,
        "4": 1543,
        "5": 3539
      },
      "location_rating": 4.6,
      "proximity_to_things_to_do_rating": 4.4,
      "proximity_to_transit_rating": 4.9,
      "airport_access_rating": 4.2,
      "reviews_breakdown": [
        {
          "name": "Fitness",
          "description": "Fitness",
          "total": 955,
          "positive": 598,
          "neutral": 111,
          "negative": 246
        },
        ...
      ],
      "amenities": [
        "Free Wi‑Fi",
        "Parking ($)",
        "Outdoor pool",
        ...
      ],
      "images": [
        {
          "thumbnail": "https://lh5.googleusercontent.com/p/AF1QipN33BldQ4KYAZzk2MmlnFqLD3I9deLWkfrm4g8G=s287-w287-h192-n-k-no-v1",
          "original": "https://lh5.googleusercontent.com/p/AF1QipN33BldQ4KYAZzk2MmlnFqLD3I9deLWkfrm4g8G=s10000"
        },
        ...
      ]
    }
  ]
}

Vacation Rentals

Vacation Rentals
GET
https://www.searchapi.io/api/v1/search?check_in_date=2025-04-07&check_out_date=2025-04-14&engine=google_hotels&property_type=vacation_rental&q=Hawaii
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "google_hotels",
  "q": "Hawaii",
  "property_type": "vacation_rental",
  "check_in_date": "2025-04-07",
  "check_out_date": "2025-04-14"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "properties": [
    {
      "type": "vacation_rental",
      "property_token": "ChkQyImO4POu6PZgGg0vZy8xMXczZGtubXNuEAI",
      "name": "Beachfront Penthouse",
      "gps_coordinates": {
        "latitude": 20.97126007080078,
        "longitude": -156.6793823242188
      },
      "city": "Hawaii",
      "country": "US",
      "check_in_time": "4:00 PM",
      "check_out_time": "11:00 AM",
      "price_per_night": {
        "price": "$267",
        "extracted_price": 267,
        "price_before_taxes": "$178",
        "extracted_price_before_taxes": 178
      },
      "total_price": {
        "price": "$1,601",
        "extracted_price": 1601,
        "price_before_taxes": "$1,070",
        "extracted_price_before_taxes": 1070
      },
      "nearby_places": [
        {
          "name": "L. Honoapi'ilani Rd./Kahana Manor",
          "transportations": [
            {
              "type": "Walking",
              "duration": "2 min"
            }
          ]
        },
        ...
      ],
      "rating": 4.3592596,
      "reviews": 27,
      "location_rating": 3.4,
      "proximity_to_transit_rating": 4.7,
      "airport_access_rating": 2.9,
      "amenities": [
        "Balcony",
        "Elevator",
        ...
      ],
      "excluded_amenities": [
        "No air conditioning",
        "No airport shuttle",
        ...
      ],
      "essential_info": [
        "Entire apartment",
        "Sleeps 3",
        ...
      ],
      "images": [
        {
          "thumbnail": "https://lh4.googleusercontent.com/proxy/p9CUv9FBIs6SQLjlv3HF3VCKGh7QfM-owtDeR4wesA03pgX1pIDNdEyq4bvhFB6TNFfF5UU2vVtKM4OR57PJpwV2gOSC7KW0bmiNtINoYQQ-nhQIWyAX60BhewPRx4_jfz395mmmMB2B9IZ14vzvVBAWHnllauE=s287-w287-h192-n-k-no-v1",
          "original": "https://media.vrbo.com/lodging/39000000/38120000/38113500/38113423/ebad8f4a.jpg"
        },
        ...
      ]
    }
  ]
}