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

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

Property
GET
https://www.searchapi.io/api/v1/search?check_in_date=2025-07-25&check_out_date=2025-08-01&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-07-25",
  "check_out_date": "2025-08-01"
}

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

Top Things To Know
GET
https://www.searchapi.io/api/v1/search?check_in_date=2025-07-25&check_out_date=2025-08-01&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-07-25",
  "check_out_date": "2025-08-01"
}

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

People Also Viewed

People Also Viewed
GET
https://www.searchapi.io/api/v1/search?check_in_date=2025-07-25&check_out_date=2025-08-01&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-07-25",
  "check_out_date": "2025-08-01"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "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

Vacation Rentals Nearby
GET
https://www.searchapi.io/api/v1/search?check_in_date=2025-07-25&check_out_date=2025-08-01&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-07-25",
  "check_out_date": "2025-08-01"
}

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