Google Hotels Property API Documentation
Google Hotels Property API uses the /api/v1/search?engine=google_hotels_property
endpoint to retrieve detailed hotels information.
This includes data on property details, check-in/out times, guest information, pricing, offers, amenities, and more. The API also provides a rich data that includes essential hotel metadata.
API Parameters
Search Query
-
- Name
-
property_token
- Required
- Required
- Description
-
Parameter defines the property you want to search. You can find
property_token
values using Google Hotels API.
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 Travelgl
countries.
-
- Name
-
hl
- Required
- Optional
- Description
-
The default parameter
en
defines the interface language of the search. Check the full list of supported Google Travelhl
languages.
-
- Name
-
currency
- Required
- Optional
- Description
-
Defines the currency of the returned prices. Default is
USD
. Check the full list of supported Google Travelcurrency
values.
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.
Number of Guests
-
- Name
-
adults
- Required
- Optional
- Description
-
The number of adults staying in the apartment. Default is
2
.- For
type=hotels
, the maximum number of guests is6
(including children). - For
type=vacation_rental
, the maximum number is10
.
- For
-
- 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 is1–17
.
Note: This parameter is only applicable for hotels and will be ignored for other property types.
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_property
.
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
Property

https://www.searchapi.io/api/v1/search?check_in_date=2025-04-11&check_out_date=2025-04-18&engine=google_hotels_property&property_token=ChcI7uLR18qD4MG_ARoKL20vMGMwMmh5bBAB
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "google_hotels_property",
"property_token": "ChcI7uLR18qD4MG_ARoKL20vMGMwMmh5bBAB",
"check_in_date": "2025-04-11",
"check_out_date": "2025-04-18"
}
response = requests.get(url, params=params)
print(response.text)
{
"property": {
"type": "hotel",
"property_token": "ChcI7uLR18qD4MG_ARoKL20vMGMwMmh5bBAB",
"data_id": "0x88d9c05f7f77dc45:0xbf83801caaf4716e",
"name": "Mandarin Oriental, Miami",
"link": "https://www.mandarinoriental.com/en/miami/brickell-key?src=loc.yext.momia.ggl",
"description": "This luxury hotel is a mile from Bayfront Park and 2 miles from sports and live music at the Kaseya...",
"address": "500 Brickell Key Dr, Miami, FL 33131",
"phone": "(305) 913-8288",
"phone_link": "tel:+13059138288",
"gps_coordinates": {
"latitude": 25.7650174,
"longitude": -80.1853221
},
"country": "US",
"check_in_time": "3:00 PM",
"check_out_time": "11:00 AM",
"price_per_night": {
"price": "$532",
"extracted_price": 532,
"price_before_taxes": "$471",
"extracted_price_before_taxes": 471
},
"total_price": {
"price": "$3,724",
"extracted_price": 3724,
"price_before_taxes": "$3,296",
"extracted_price_before_taxes": 3296
},
"price_insights": {
"lowest_price": "$471",
"price_level": "typical",
"typical_price_range": {
"low_price": "$452",
"high_price": "$728"
}
},
"nearby_places": [
{
"category": "Point of interest",
"data_id": "0x88d9b65d4fea9813:0xf860ad840edd24e1",
"name": "Vizcaya Museum & Gardens",
"link": "https://www.google.com/search?q=Vizcaya+Museum+%26+Gardens&stick=H4sIAAAAAAAAAONgFmJQ4tTP1TcwNcgzzNVSzE620s_JT04syczPgzOsEktKihKTQcxiAN2OV2gyAAAA#fpstate=trskp&trifp=kpq%253DVizcaya%252BMuseum%252B%252526%252BGardens%2526skpm%253D/m/050n1m%2526t%253Dd",
"rating": 4.7,
"reviews": 14132,
"description": "Historic estate with formal gardens & sculptures, grottos & circa-1914 mansion turned museum.",
"gps_coordinates": {
"latitude": 25.7443866,
"longitude": -80.21047469999999
},
"thumbnail": "https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcSJmm8MbPNgdX818qXfIqNkHPqAbDK9-LvLrvZFRvyMRrWpAckq",
"transportations": [
{
"type": "Taxi",
"duration": "13 min"
},
{
"type": "Public Transport",
"duration": "23 min"
}
]
},
...
],
"hotel_class": "5-star hotel",
"extracted_hotel_class": 5,
"featured_offers": [
{
"source": "Hotels.com",
"tracking_link": "https://www.google.com/aclk?sa=l&ai=DChcSEwjrw7nqjLeMAxVfm1oFHT3IK1kYABABGgJ2dQ&co=1&ase=2&gclid=EAIaIQobChMI68O56oy3jAMVX5taBR09yCtZEAoYASABEgKWsvD_BwE&sig=AOD64_1qTA4yExdJ4PpK8Fxmb5iVSLcEvg&adurl",
"logo": "https://www.gstatic.com/travel-hotels/branding/f358dd45-ebd1-4af8-988d-d53154b73975.png",
"remarks": ["Save with Member Prices", "Save on the app"],
"num_guests": 2,
"price_per_night": {
"price": "$680",
"extracted_price": 680,
"price_before_taxes": "$602",
"extracted_price_before_taxes": 602
},
"total_price": {
"price": "$4,763",
"extracted_price": 4763,
"price_before_taxes": "$4,215",
"extracted_price_before_taxes": 4215
},
"has_free_cancellation": true,
"free_cancellation_until": {
"date": "Apr 9",
"time": "6:00 PM"
},
"rooms": [
{
"name": "Skyline View, Deluxe Room, 1 King Bed, View",
"link": "https://www.google.com/aclk?sa=l&ai=DChcSEwjrw7nqjLeMAxVfm1oFHT3IK1kYABACGgJ2dQ&co=1&ase=2&gclid=EAIaIQobChMI68O56oy3jAMVX5taBR09yCtZEAoYASACEgJrffD_BwE&sig=AOD64_1Ei5glpUyodneEffjjpwWKOEuCTQ&adurl",
"num_guests": 2,
"price_per_night": {
"price": "$680",
"extracted_price": 680,
"price_before_taxes": "$602",
"extracted_price_before_taxes": 602
},
"total_price": {
"price": "$4,763",
"extracted_price": 4763,
"price_before_taxes": "$4,215",
"extracted_price_before_taxes": 4215
}
},
...
]
},
...
],
"all_offers": [
{
"source": "Mandarinoriental.com",
"tracking_link": "https://www.google.com/travel/clk?pc=AA80OsxX9lDe0CZ6h1YPliqSdOXRMycEhqrYDNXVA...",
"link": "https://linkcenterus.derbysoftca.com/dplatform-linkcenter/booking.htm?hotelCode=MANDARINORIENTAL-526&providerHotelCode=MANDARINORIENTAL-526&checkInDate=2025-04-10&checkOutDate=2025-04-17&identifier=dh-google&price=3858.95&roomTypeCode=RO3K&ratePlanCode=20OMN3¤cy=USD&userCurrency=USD&language=en&userCountry=US&testClick=false&sitetype=localuniversal&deviceType=desktop&priceDisplayedTax=443.95&priceDisplayedTotal=3858.95&partnerId=derby-mandarinoriental&campaignid=&userlistid=&ifDefaultDate=selected&isPromoted=false&s_is_ad=false&adults=2&children=0&clk_src=&is_ds_account=true",
"logo": "https://www.gstatic.com/travel-hotels/branding/8598c9c9-12e6-4fc8-9cf5-f5fa8aecb8e2.png",
"is_official": true,
"num_guests": 2,
"price_per_night": {
"price": "$551",
"extracted_price": 551,
"price_before_taxes": "$488",
"extracted_price_before_taxes": 488
},
"total_price": {
"price": "$3,859",
"extracted_price": 3859,
"price_before_taxes": "$3,415",
"extracted_price_before_taxes": 3415
},
"has_free_cancellation": true,
"free_cancellation_until": {
"date": "Apr 9",
"time": "6:00 PM"
}
},
...
],
"images": [
{
"thumbnail": "https://lh3.googleusercontent.com/p/AF1QipNhnerNGSGOKI9u6LOKFdbokVAeqqgXaD6yrS-M=s287-w287-h192-n-k-no-v1",
"original": "https://lh5.googleusercontent.com/p/AF1QipNhnerNGSGOKI9u6LOKFdbokVAeqqgXaD6yrS-M=s10000"
},
...
],
"rating": 4.7,
"reviews": 3031,
"reviews_histogram": {
"1": 70,
"2": 39,
"3": 97,
"4": 343,
"5": 2482
},
"location_rating": 4,
"proximity_to_things_to_do_rating": 4.9,
"proximity_to_transit_rating": 4.7,
"airport_access_rating": 4.2,
"review_results": {
"reviews": [
{
"username": "Henrik",
"text": "\"Top food - even when ordering room service the quality is above what you expect.\""
},
...
],
"on_other_sites": [
{
"username": "Oliver B",
"source": "Tripadvisor",
"link": "https://www.tripadvisor.com/ShowUserReviews-g34438-d224877-r999429454?m=68573&staydates=2025_04_13_2025_04_14&uguests=1_2_0&supdv=desktop&supuc=US&supul=en",
"date": "a week ago",
"reviews": 3881,
"rating": 4.5,
"text": "Wonderful hotel in a perfect location. Excellent all around. Lovely big rooms, amazing food for breakfast. Staff were super helpful. Close to Brickell and you can enjoy a short walk into the city. No Brickell noise as well which is a huge bonus!"
},
...
]
},
"reviews_breakdown": [
{
"name": "Wellness",
"description": "Wellness",
"total_mentions": 84,
"positive": 71,
"neutral": 4,
"negative": 9
},
...
]
}
}
Top Things To Know

https://www.searchapi.io/api/v1/search?check_in_date=2025-04-11&check_out_date=2025-04-18&engine=google_hotels_property&property_token=ChcI7uLR18qD4MG_ARoKL20vMGMwMmh5bBAB
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "google_hotels_property",
"property_token": "ChcI7uLR18qD4MG_ARoKL20vMGMwMmh5bBAB",
"check_in_date": "2025-04-11",
"check_out_date": "2025-04-18"
}
response = requests.get(url, params=params)
print(response.text)
{
"top_things_to_know": [
{
"title": "Featured in 11 best spa hotels in Miami for relaxing and unwinding",
"link": "https://www.timeout.com/miami/hotels/spa-hotels-miami"
},
{
"title": "9 min drive to Bayfront Park"
},
{
"title": "One of the few hotels in the area with 24-hr room service",
"review": {
"username": "Denny Jacobs",
"text": "Spacious rooms, comfortable beds, top notch service and delicious food."
}
},
...
]
}
People Also Viewed

https://www.searchapi.io/api/v1/search?check_in_date=2025-04-11&check_out_date=2025-04-18&engine=google_hotels_property&property_token=ChgIyNyJsOmIxYH6ARoLL2cvMXd2X3QwMGIQAQ
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "google_hotels_property",
"property_token": "ChgIyNyJsOmIxYH6ARoLL2cvMXd2X3QwMGIQAQ",
"check_in_date": "2025-04-11",
"check_out_date": "2025-04-18"
}
response = requests.get(url, params=params)
print(response.text)
{
"people_also_viewed": [
{
"type": "hotel",
"property_token": "ChgI9a70ofij4PzoARoLL2cvMXRwaDJqbHEQAQ",
"data_id": "0x88d9b4f2b3b69f03:0xe8f9811f843d1775",
"name": "Metropole Suites South Beach",
"description": "Also a 4-star hotel, for $110 less",
"gps_coordinates": {
"latitude": 25.776157,
"longitude": -80.132369
},
"distance": "0.1 mi away",
"price_per_night": {
"price": "$192",
"extracted_price": 192,
"price_before_taxes": "$138",
"extracted_price_before_taxes": 138
},
"total_price": {
"price": "$1,344",
"extracted_price": 1344,
"price_before_taxes": "$969",
"extracted_price_before_taxes": 969
},
"hotel_class": "4-star hotel",
"extracted_hotel_class": 4,
"images": [
{
"thumbnail": "https://lh6.googleusercontent.com/proxy/PvzvbC5D88kRONJNv_GkqEb-H1s5kDCVnJ_1YpnmG10WZwRbm1AzyqOMJKY_87C1l8da9Budbqzl2dAAmH36DQlZGpKT0gpzQKjiys6tKSq6jzwK3gwSSiBoAZqvY1ivKWyg47MB2rtTuh-bK23vBKziGKzaMsJ2WhBftQIRiTgL76Sr2txf-5fOLlRgnBBhMKn1ssMFTdDRvg=s287-w287-h192-n-k-no-v1"
}
],
"rating": 4,
"reviews": 892
},
...
]
}
Vacation Rentals Nearby

https://www.searchapi.io/api/v1/search?check_in_date=2025-04-11&check_out_date=2025-04-18&engine=google_hotels_property&property_token=ChgIyNyJsOmIxYH6ARoLL2cvMXd2X3QwMGIQAQ
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "google_hotels_property",
"property_token": "ChgIyNyJsOmIxYH6ARoLL2cvMXd2X3QwMGIQAQ",
"check_in_date": "2025-04-11",
"check_out_date": "2025-04-18"
}
response = requests.get(url, params=params)
print(response.text)
{
"vacation_rentals_nearby": [
{
"type": "vacation_rental",
"property_token": "ChkQnoyD-L_smtMYGg0vZy8xMXdfY3AwN2IzEAI",
"name": "SOFI BEACH APARTMENT",
"gps_coordinates": {
"latitude": 25.773785,
"longitude": -80.13278199999999
},
"distance": "0.5 mi away",
"price_per_night": {
"price": "$273",
"extracted_price": 273,
"price_before_taxes": "$199",
"extracted_price_before_taxes": 199
},
"total_price": {
"price": "$1,912",
"extracted_price": 1912,
"price_before_taxes": "$1,395",
"extracted_price_before_taxes": 1395
},
"images": [
{
"thumbnail": "https://lh6.googleusercontent.com/proxy/DMpRZqQmA3o2XXkXqVUrCd98dqbB31lJUZqvFZa26xG7hjr2S6digHYmiKdzYmoqyH8UE8SeAM9T9A1IpzBJXJFgsjdOIl8fcXoG65nhizpmNgU_nnoB7P6078SkpenmY5Wv_nJVqeaAoixQwueB4RukGFrfOA=s287-w287-h192-k-no-v1",
"original": "https://p.fih.io/v2/nSr0o-3gbZN8o1xMecXCcG-BkDeQVo3k-wOeVogkTe7ajuFOX7O-WA8aRWhXz1jsToZif_TsA_xCWfhWRa0Zg63ptSYVsCE6OT7KHIJF5Cfx-X_9II7mjS2eFJ_0nJ2kSA5PrbHnF1f8CzF4en3ketkYyx1j1dLbUfhlOgkNcIcn9PwNtk_AU2csbUk6dd9sGqAEVmr2qjQMPI095Pdv3pEtFPIxOxxOPC-YWoFEg4zevghQ3nG9m-EOZqmf2HQdKfhO30Ezy-isqotHbUuB78O59snWY0hitvxpouOYbAd_AD1_EjW2Y-ApDpE9Rgh64AZ_KQd1YCICYvBoQ2byP9pRpm5NcMuP"
}
],
"rating": 3.6051733,
"reviews": 346,
"essential_info": ["Sleeps 4", "1 bedroom"]
},
...
]
}