Google Hotels Property API Documentation

GET /api/v1/search?engine=google_hotels_property

Google Hotels Property API allows 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 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.

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 is 6 (including children).
- For 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 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).

Zero Data Retention

Name

zero_retention

Enterprise Only

Enterprise Only

Required

Optional

Description

Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Property

GET

https://www.searchapi.io/api/v1/search?check_in_date=2025-11-19&check_out_date=2025-11-26&engine=google_hotels_property&property_token=ChcI7uLR18qD4MG_ARoKL20vMGMwMmh5bBAB

Request

import requests url = "https://www.searchapi.io/api/v1/search" params = { "engine": "google_hotels_property", "property_token": "ChcI7uLR18qD4MG_ARoKL20vMGMwMmh5bBAB", "check_in_date": "2025-11-19", "check_out_date": "2025-11-26" } response = requests.get(url, params=params) print(response.text)

Response

{ "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&currency=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

GET

https://www.searchapi.io/api/v1/search?check_in_date=2025-11-19&check_out_date=2025-11-26&engine=google_hotels_property&property_token=ChcI7uLR18qD4MG_ARoKL20vMGMwMmh5bBAB

Request

import requests url = "https://www.searchapi.io/api/v1/search" params = { "engine": "google_hotels_property", "property_token": "ChcI7uLR18qD4MG_ARoKL20vMGMwMmh5bBAB", "check_in_date": "2025-11-19", "check_out_date": "2025-11-26" } response = requests.get(url, params=params) print(response.text)

Response

{ "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." } }, ... ] }

Vacation Rentals Nearby

GET

https://www.searchapi.io/api/v1/search?check_in_date=2025-11-19&check_out_date=2025-11-26&engine=google_hotels_property&property_token=ChgIyNyJsOmIxYH6ARoLL2cvMXd2X3QwMGIQAQ

Request

import requests url = "https://www.searchapi.io/api/v1/search" params = { "engine": "google_hotels_property", "property_token": "ChgIyNyJsOmIxYH6ARoLL2cvMXd2X3QwMGIQAQ", "check_in_date": "2025-11-19", "check_out_date": "2025-11-26" } response = requests.get(url, params=params) print(response.text)

Response

{ "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"] }, ... ] }