Google Hotels API

Google Hotels API

Search a destination, open a property, pull a whole price calendar and read its reviews. Every Google Hotels result as JSON, with base price, taxes, fees and total kept separate.

  • Data from Google Hotels

$4.00 per 1,000 calls with a credit pack, down to $1.33 on the Business plan

Free trial: 50 calls, no card. Failed requests are free. Credit packs from $15.

Endpoints and prices checked against the API on .

Try it without signing upHotel price API: rate shopping and parity

Try it, no sign-up

A year of hotel prices in one call

A real answer from POST /v1/calendar: 330 nights of prices for one hotel. Pick a hotel; the data is refreshed daily, and you can curl the same JSON.

Loading a real answer…

Google Hotels is the most complete free view of hotel prices: one page shows a property next to every OTA and the hotel’s own site. The Google Hotels API turns that into data you can store. A destination search returns about 20 properties per page with prices, star class, ratings, amenities, coordinates and a property token. The token opens the property page, the price calendar and the reviews.

The calendar is the difference for revenue teams. A per-date SERP API needs one request for every check-in date. The calendar endpoint returns up to 330 nights for one hotel in a single 5-credit call, each night with its observed price and provenance.

What you get

property_token
stable id for the property, reused by the calendar, property and reviews calls
price_per_night / total_price
displayed and exact prices, with before-taxes values
hotel_class, rating, reviews
star class, guest rating and review count
reviews_breakdown, amenities
what guests mention and what the hotel offers
gps_coordinates, nearby_places
location and how to get there
all_offers
each seller on the property page with its price (property endpoint)
calendar[]
one entry per night with base, tax, fees and total (calendar endpoint)
next_page_token
cursor for the next page of a destination search

One call, structured JSON

POST /v1/serp/google_hotels, 4 credits per successful call.

One POST /v1/serp/google_hotels call from start to finish: the inputs you send, a failed attempt retried on our side and charged nothing, and typed JSON back with name, deal, hotel_class and rating, for 4 credits. Values from the API's own example.
curl -X POST "https://api.scrapercompany.com/v1/serp/google_hotels" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "hotels in Montreal",
    "adults": 2,
    "currency": "CAD",
    "gl": "ca",
    "check_in_date": "2027-01-18",
    "check_out_date": "2027-01-20"
  }'
Response (trimmed)
{
  "search_metadata": {
    "status": "Success",
    "created_at": "2026-09-30T22:46:08Z",
    "request_time_taken": 1.89,
    "total_time_taken": 1.89
  },
  "search_parameters": {
    "engine": "google_hotels",
    "q": "hotels in Montreal",
    "check_in_date": "2027-03-20",
    "check_out_date": "2027-03-22",
    "adults": 2,
    "currency": "CAD",
    "gl": "ca",
    "hl": "en",
    "sort_by": "relevance"
  },
  "search_information": {
    "total_results": 5778,
    "location": "Montreal",
    "currency_matches_request": true
  },
  "properties": [
    {
      "type": "hotel",
      "property_token": "ChgImtDg_rW5k8iWARoLL2cvMXRzamQ4NncQAQ",
      "data_id": "0x4cc9178df6e67b8d:0x96904dcb5fd8281a",
      "name": "Radisson Hotel Montreal Airport",
      "link": "https://www.choicehotels.com/quebec/montreal/radisson-hotels/cnc37?mc=llgoxxpx",
      "description": "Modern lodging with a restaurant & an indoor pool, plus free WiFi & an airport shuttle.",
      "gps_coordinates": {
        "latitude": 45.4851544,
        "longitude": -73.6909316
      },
      "city": "Montreal",
      "country": "CA",
      "check_in_time": "3:00 PM",
      "check_out_time": "11:00 AM",
      "price_per_night": {
        "price": "$121",
        "extracted_price": 121,
        "price_before_taxes": "$102",
        "extracted_price_before_taxes": 101.67969
      },
      "total_price": {
        "price": "$242",
        "extracted_price": 242,
        "price_before_taxes": "$203",
        "extracted_price_before_taxes": 203.36
      },
      "deal": "27% less than usual",
      "deal_description": "Great Deal",
      "nearby_places": [
        {
          "name": "Côte-de-Liesse / No 6400",
          "transportations": [
            {
              "type": "Walking",
              "duration": "2 min"
            }
          ]
        }
      ],
      "hotel_class": "4-star hotel",
      "extracted_hotel_class": 4,
      "rating": 3.5,
      "reviews": 2535,
      "reviews_histogram": {
        "1": 443,
        "2": 220,
        "3": 396,
        "4": 674,
        "5": 802
      },
      "location_rating": 3.1,
      "proximity_to_things_to_do_rating": 3.2,
      "proximity_to_restaurants_rating": 2.8,
      "proximity_to_transit_rating": 2.5,
      "airport_access_rating": 4.6,
      "reviews_breakdown": [
        {
          "name": "Fitness",
          "description": "Fitness",
          "total": 199,
          "positive": 119,
          "neutral": 13,
          "negative": 67
        },
        {
          "name": "Pool",
          "description": "Pool",
          "total": 107,
          "positive": 78,
          "neutral": 7,
          "negative": 22
        }
      ],
      "amenities": [
        "Breakfast ($)",
        "Free Wi-Fi"
      ],
      "images": [
        {
          "thumbnail": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWk0lycQOr7G_2oWSLSEpBlBBfN0wY5jwgISonycKD0xeg__AHXxCEpS3XqlR9IcD1alML-r6P2EvsCMBx_Lt3KN8sOYNRZU4Jouiz7gc8JcjOskWyeb7HyYDCnqD1bR4L-24cbbvm9TvXHm=s287-w287-h192-n-k-no-v1",
          "original": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWk0lycQOr7G_2oWSLSEpBlBBfN0wY5jwgISonycKD0xeg__AHXxCEpS3XqlR9IcD1alML-r6P2EvsCMBx_Lt3KN8sOYNRZU4Jouiz7gc8JcjOskWyeb7HyYDCnqD1bR4L-24cbbvm9TvXHm=s10000"
        }
      ],
      "thumbnail": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWk0lycQOr7G_2oWSLSEpBlBBfN0wY5jwgISonycKD0xeg__AHXxCEpS3XqlR9IcD1alML-r6P2EvsCMBx_Lt3KN8sOYNRZU4Jouiz7gc8JcjOskWyeb7HyYDCnqD1bR4L-24cbbvm9TvXHm=s150-w92-h150-n-k-no",
      "currency": "CAD"
    },
    {
      "type": "vacation_rental",
      "property_token": "ChkQzZioqLvP4IUiGg0vZy8xMXpjZmhoMzJwEAI",
      "name": "HoMa Loft 206 – Bright, Modern & Easy Parking",
      "link": "https://www.host-me.ca/properties/69e924482b031c00122c840e",
      "gps_coordinates": {
        "latitude": 45.54264831542969,
        "longitude": -73.53958129882812
      },
      "city": "Montreal",
      "country": "CA",
      "check_in_time": "4:00 PM",
      "check_out_time": "10:00 AM",
      "price_per_night": {
        "price": "$152",
        "extracted_price": 152.34,
        "price_before_taxes": "$138",
        "extracted_price_before_taxes": 138.49
      },
      "total_price": {
        "price": "$305",
        "extracted_price": 304.68,
        "price_before_taxes": "$277",
        "extracted_price_before_taxes": 276.98
      },
      "nearby_places": [
        {
          "name": "Montréal-Pierre Elliott Trudeau International Airport",
          "transportations": [
            {
              "type": "Taxi",
              "duration": "35 min"
            },
            {
              "type": "Public transport",
              "duration": "1 hr 30 min"
            }
          ]
        }
      ],
      "location_rating": 2.9,
      "proximity_to_restaurants_rating": 2.5,
      "airport_access_rating": 3.9,
      "amenities": [
        "Air conditioning",
        "Kid-friendly"
      ],
      "excluded_amenities": [
        "No balcony",
        "No crib"
      ],
      "essential_info": [
        "Entire apartment",
        "Sleeps 2"
      ],
      "images": [
        {
          "thumbnail": "https://lh3.googleusercontent.com/grass-proxy/AIM7gW39AJ5sNUqWYbyQkdBH2YHq7dV63MGIYm0DnOBPevzdmKuKVhPt19sLNF1TWMEzHBW2kN-KopL4tXsF2coEPixiQxcAV6aM2SWxYoWA73riNVMyRVNI3QHt-96hRHLb5couboHdgW6G-tN6pu_pOwPJZdNGqL_RGKM9UOM7G9cUNeoBDdsqXM6hNg=s287-w287-h192-n-k-no-v1",
          "original": "https://lh3.googleusercontent.com/grass-proxy/AIM7gW39AJ5sNUqWYbyQkdBH2YHq7dV63MGIYm0DnOBPevzdmKuKVhPt19sLNF1TWMEzHBW2kN-KopL4tXsF2coEPixiQxcAV6aM2SWxYoWA73riNVMyRVNI3QHt-96hRHLb5couboHdgW6G-tN6pu_pOwPJZdNGqL_RGKM9UOM7G9cUNeoBDdsqXM6hNg=s10000"
        }
      ],
      "thumbnail": "https://lh3.googleusercontent.com/grass-proxy/AIM7gW39AJ5sNUqWYbyQkdBH2YHq7dV63MGIYm0DnOBPevzdmKuKVhPt19sLNF1TWMEzHBW2kN-KopL4tXsF2coEPixiQxcAV6aM2SWxYoWA73riNVMyRVNI3QHt-96hRHLb5couboHdgW6G-tN6pu_pOwPJZdNGqL_RGKM9UOM7G9cUNeoBDdsqXM6hNg=s150-w92-h150-n-k-no",
      "prices": [
        {
          "source": "host-me",
          "raw_source": "host-me",
          "displayed_prices": [
            "$138",
            "$152"
          ],
          "partner_id": "420480647",
          "logo": "//www.gstatic.com/travel-hotels/branding/icon_default.png",
          "price_per_night": "$152",
          "price_per_night_before_taxes": "$138",
          "extracted_price_per_night": 152,
          "extracted_price_per_night_before_taxes": 138,
          "has_free_cancellation": true,
          "free_cancellation_until": "Oct 16",
          "free_cancellation_time": "4:00 PM",
          "is_featured": true
        }
      ],
      "currency": "CAD"
    }
  ],
  "brands": [
    {
      "id": 33,
      "title": "Accor Live Limitless",
      "children": [
        {
          "id": 8,
          "title": "Fairmont Hotels and Resorts"
        },
        {
          "id": 47,
          "title": "Novotel"
        }
      ]
    },
    {
      "id": 18,
      "title": "Best Western International",
      "children": [
        {
          "id": 155,
          "title": "Best Western"
        },
        {
          "id": 104,
          "title": "Best Western Plus"
        }
      ]
    }
  ],
  "pagination": {
    "records_from": 1,
    "records_to": 20,
    "next_page_token": "CBI="
  }
}

Every field, documented before you buy

What one POST /v1/serp/google_hotels call returns: 44 fields with their type and a value from the example above, then every input the call takes.

In the response

FieldTypeExampleWhat it is
search_informationobject
search_information.total_resultsinteger | null5778Total properties Google reports for the search.
search_information.locationstring | null"Montreal"Place Google resolved q to.
search_information.currency_matches_requestbooleantrueFalse when Google returned a currency other than the one requested.
propertiesarray of objectAbout 20 per page.
properties[].typestring"hotel"Google blends vacation rentals into the default list; this says which each result is.
properties[].property_tokenstring"ChgImtDg_rW5k8iWARoLL2cvMXRzamQ4NncQAQ"Google property token; pass it to /v1/serp/google_hotels_property or /v1/calendar.
properties[].data_idstring"0x4cc9178df6e67b8d:0x96904dcb5fd8281a"Google Maps data id (0x...:0x...).
properties[].namestring"Radisson Hotel Montreal Airport"Name as the site shows it.
properties[].linkstring"https://www.choicehotels.com/quebec/mon…"The property's own website.
properties[].descriptionstring"Modern lodging with a restaurant & an i…"Description text as the site shows it.
properties[].gps_coordinatesobjectLatitude and longitude in decimal degrees.
Show all 44 fields
properties[].citystring"Montreal"The place Google resolved q to (same as search_information.location), not a per-property city.
properties[].countrystring"CA"ISO 3166-1 alpha-2 country code.
properties[].check_in_timestring"3:00 PM"As displayed, e.g.
properties[].check_out_timestring"11:00 AM"
properties[].price_per_nightobjectPresent only when the stay total is known.
properties[].total_priceobjectPresent only when the stay total is known.
properties[].dealstring"27% less than usual"Deal text, e.g.
properties[].deal_descriptionstring"Great Deal"Badge Google renders: Deal, Great Deal, Great Price, or another label.
properties[].nearby_placesarray of object
properties[].hotel_classstring"4-star hotel"As displayed, e.g.
properties[].extracted_hotel_classinteger4Star class, 1-5.
properties[].ratingnumber3.5Guest rating out of 5.
properties[].reviewsinteger2535
properties[].reviews_histogramobjectReview count per star rating, keyed 1-5.
properties[].location_ratingnumber3.1Overall location score, out of 5.
properties[].proximity_to_things_to_do_ratingnumber3.2Score for proximity to things to do, out of 5.
properties[].proximity_to_restaurants_ratingnumber2.8Score for proximity to restaurants, out of 5.
properties[].proximity_to_transit_ratingnumber2.5Score for proximity to public transit, out of 5.
properties[].airport_access_ratingnumber4.6Score for airport access, out of 5.
properties[].reviews_breakdownarray of objectEmpty when Google gave none.
properties[].amenitiesarray of stringHotel amenity names are always English; rentals use Google's own labels.
properties[].imagesarray of object
properties[].thumbnailstring"https://lh3.googleusercontent.com/gps-c…"Address of a thumbnail image.
properties[].currencystring"CAD"ISO 4217 code of every price on the property.
brandsarray of object
brands[].idinteger33Google brand id.
brands[].titlestring"Accor Live Limitless"Brand name; empty string when Google did not name it.
brands[].childrenarray of objectSub-brands.
paginationobjectPages overlap by a few results (page 2 starts before page 1 ends); de-duplicate by property_token.
pagination.records_frominteger | null11-based position of the first result on this page.
pagination.records_tointeger | null201-based position of the last result on this page.
pagination.next_page_tokenstring | null"CBI="Send it back (as page_token on /v1/hotels/search, next_page_token on /v1/serp/google_hotels) with the same query, stay, party and filters for the next page.

Arrays show their first item; every item has the same fields. Full schema in the API reference

In the request

InputTypeRequiredWhat it does
qstringYesDestination query exactly as a traveller would type it into Google Hotels, e.g.Min length 2, max length 200.
adultsintegerNoAdults in the room.Default 2. Min 1, max 10.
currencystringNoISO 4217 code for the returned prices.Default USD.
glstringNoTwo-letter Google country (market).Default us.
hlstringNoInterface language.Default en. Pattern ^[a-z]{2,3}(-[A-Za-z]{2,4})?$.
sort_bystringNoResult order, as Google's Sort by control.Default relevance.
price_mininteger | nullNoMinimum nightly price in currency.Min 0.
price_maxinteger | nullNoMaximum nightly price in currency.Min 0.
free_cancellationbooleanNoOnly properties Google lists with free cancellation.Default false.
special_offersbooleanNoOnly properties with a special offer.Default false.
eco_certifiedbooleanNoOnly eco-certified properties.Default false.
enginestringNoAccepted for SERP API compatibility; must be google_hotels.Default google_hotels.
property_typestringNohotel (default) is Google's own list, which Google may blend with vacation rentals; each result states its type.Default hotel.
check_in_datestring (date)YesFirst night of the stay, YYYY-MM-DD.
check_out_datestring (date)YesDeparture date, after check_in_date; at most 30 nights.
children_agesstring | array of integer | nullNoComma-separated child ages, 0-17 (SERP API: 2,5).
ratinginteger | nullNoSERP API rating code: 7 (3.5+), 8 (4.0+), 9 (4.5+).
hotel_classstring | array of integer | nullNoComma-separated star classes, 2-5.
amenitiesstring | array of integer | nullNoComma-separated amenity ids (same ids as SERP API/SerpApi, e.g.
property_typesstring | array of integer | nullNoComma-separated property-type ids, e.g.
brandsstring | array of integer | nullNoNot supported: Google ignores brand filters on this search, so a non-empty value is refused with 422.
for_displaced_individualsbooleanNoNot supported; true is refused with 422.Default false.
bedroomsinteger | nullNoVacation-rental filter.Min 0.
bathroomsinteger | nullNoVacation-rental filter.Min 0.
bounding_boxstring | nullNoNot supported; search by q.
next_page_tokenstring | nullNoOpaque cursor from pagination.next_page_token of the previous page.Pattern ^[A-Za-z0-9_\-+/=]{1,200}$.
zero_retentionbooleanNoAccepted for SERP API compatibility; search results are never persisted.Default false.

Endpoints and price per call

Credits per successful call, and what 1,000 calls cost: from a credit pack down to the Business plan. Failed requests cost nothing.

EndpointWhat it returnsCreditsPer 1,000 calls
Destination search
POST /v1/serp/google_hotels
Hotels for a place and dates, about 20 per page, with filters and sorting4 credits$8.00 – $2.66
Property page
POST /v1/serp/google_hotels_property
Every seller’s price for one stay, rooms and hotel details5 credits$10.00 – $3.33
Price calendar
POST /v1/serp/google_hotels_calendar
Nightly prices for one hotel, 90 nights by default and up to 3308 credits$16.00 – $5.33
Reviews
POST /v1/hotels/reviews
Guest reviews from Google and the sites it syndicates, up to 10 pages per callfrom 2 creditsfrom $4.00 – $1.33

See all plans

Your first call in three steps

  1. 01

    Get an API key

    Create an account and verify your email, then copy a key from the dashboard. The free trial is 50 calls or 14 days, whichever ends first, no card needed.

  2. 02

    Send POST /v1/serp/google_hotels

    Put the key in the x-api-key header and pass q, check_in_date and check_out_date. Every other input is optional and listed above.

  3. 03

    Read the JSON

    The answer is one JSON object with search_information, properties, brands and pagination, typed and named the same way on every call. A failed call costs 0 credits, so retrying is free.

Limits and coverage

Where it works
Worldwide; market and currency are selectable, taxes and fees normalized per market
  • Up to 10 adults per call (adults)
  • One calendar call replaces one request per night.
  • Destination search returns about 20 properties a page with price, rating, class and amenity filters, each with the property token the calendar takes.
  • Offers and rooms break one night down by seller, the OTAs and the hotel's own site; offers cost 10 credits (14 with require_rooms).
  • SERP-compatible shapes are served at /v1/serp/google_hotels, /v1/serp/google_hotels_calendar and /v1/serp/google_hotels_property.
Is there an official Google Hotels API?

Google offers hotel APIs to partners who send it prices, not to developers who want to read them. To collect the prices shown on Google Hotels you need a service like this one that returns the public results as data.

How do I get a property token?

Run a destination search and take property_token from any result, or look a hotel up by name and city with the property lookup endpoint. The token is stable, so you can store it and reuse it for calendars and reviews.

How far ahead can I price a hotel?

The calendar returns 90 nights by default and up to 330 nights in one call. Nights with no availability come back as unavailable dates instead of missing silently.

Are taxes and fees included in the prices?

Both are returned. Prices keep the base rate, taxes, mandatory fees and total separately, and say whether the displayed price already includes tax for the market you asked for.

Do failed requests cost credits?

No. A failed or blocked call (any 4xx or 5xx response) costs 0 credits, and so does a search page that comes back empty. You pay only for successful results.

How do I get an API key?

Create an account on the sign-up page and verify your email. You get a free trial of 50 calls or 14 days, whichever ends first, no card needed on the travel endpoints (hotels, vacation rentals, flights, reviews) and 10 calls to the other sources; for everything else, and after the trial, buy a credit pack (from $15) or pick a plan. You create and rotate keys yourself in the dashboard.

More APIs on the same key

All APIs
Google Flights API

Every itinerary Google Flights shows for a route and date, with legs, layovers, emissions and price insights, then the return leg and the booking options behind the fare you pick.

Google Maps API

Search Google Maps the way a person does, “coffee shops in Boston” or “hotels near Fenway”, and get every place as JSON with its address, coordinates, rating, phone number and website.

Google Search API

Organic results, People Also Ask, the AI Overview and related searches for any query, localized to a country or a city, as JSON. Autocomplete and Google News on the same key.

Web scraping API

Send a URL, get the page back as HTML, markdown or text. If an attempt does not return the page, the request is tried again automatically, and you pay only for a page that comes back with content.

Start with 50 free calls

Create an account and verify your email: your own API keys and a free trial of 50 calls or 14 days, whichever ends first, no card needed. Then buy a credit pack from $15 or pick a plan from $49 a month.