Logo SearchApi

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).

API Examples

Property

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

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-05-02&check_out_date=2025-05-09&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-05-02",
  "check_out_date": "2025-05-09"
}

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-05-02&check_out_date=2025-05-09&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-05-02",
  "check_out_date": "2025-05-09"
}

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-05-02&check_out_date=2025-05-09&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-05-02",
  "check_out_date": "2025-05-09"
}

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