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

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"
}'{
"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
| Field | Type | Example | What it is |
|---|---|---|---|
| search_information | object | ||
| search_information.total_results | integer | null | 5778 | Total properties Google reports for the search. |
| search_information.location | string | null | "Montreal" | Place Google resolved q to. |
| search_information.currency_matches_request | boolean | true | False when Google returned a currency other than the one requested. |
| properties | array of object | About 20 per page. | |
| properties[].type | string | "hotel" | Google blends vacation rentals into the default list; this says which each result is. |
| properties[].property_token | string | "ChgImtDg_rW5k8iWARoLL2cvMXRzamQ4NncQAQ" | Google property token; pass it to /v1/serp/google_hotels_property or /v1/calendar. |
| properties[].data_id | string | "0x4cc9178df6e67b8d:0x96904dcb5fd8281a" | Google Maps data id (0x...:0x...). |
| properties[].name | string | "Radisson Hotel Montreal Airport" | Name as the site shows it. |
| properties[].link | string | "https://www.choicehotels.com/quebec/mon…" | The property's own website. |
| properties[].description | string | "Modern lodging with a restaurant & an i…" | Description text as the site shows it. |
| properties[].gps_coordinates | object | Latitude and longitude in decimal degrees. |
Show all 44 fields
| properties[].city | string | "Montreal" | The place Google resolved q to (same as search_information.location), not a per-property city. |
| properties[].country | string | "CA" | ISO 3166-1 alpha-2 country code. |
| properties[].check_in_time | string | "3:00 PM" | As displayed, e.g. |
| properties[].check_out_time | string | "11:00 AM" | |
| properties[].price_per_night | object | Present only when the stay total is known. | |
| properties[].total_price | object | Present only when the stay total is known. | |
| properties[].deal | string | "27% less than usual" | Deal text, e.g. |
| properties[].deal_description | string | "Great Deal" | Badge Google renders: Deal, Great Deal, Great Price, or another label. |
| properties[].nearby_places | array of object | ||
| properties[].hotel_class | string | "4-star hotel" | As displayed, e.g. |
| properties[].extracted_hotel_class | integer | 4 | Star class, 1-5. |
| properties[].rating | number | 3.5 | Guest rating out of 5. |
| properties[].reviews | integer | 2535 | |
| properties[].reviews_histogram | object | Review count per star rating, keyed 1-5. | |
| properties[].location_rating | number | 3.1 | Overall location score, out of 5. |
| properties[].proximity_to_things_to_do_rating | number | 3.2 | Score for proximity to things to do, out of 5. |
| properties[].proximity_to_restaurants_rating | number | 2.8 | Score for proximity to restaurants, out of 5. |
| properties[].proximity_to_transit_rating | number | 2.5 | Score for proximity to public transit, out of 5. |
| properties[].airport_access_rating | number | 4.6 | Score for airport access, out of 5. |
| properties[].reviews_breakdown | array of object | Empty when Google gave none. | |
| properties[].amenities | array of string | Hotel amenity names are always English; rentals use Google's own labels. | |
| properties[].images | array of object | ||
| properties[].thumbnail | string | "https://lh3.googleusercontent.com/gps-c…" | Address of a thumbnail image. |
| properties[].currency | string | "CAD" | ISO 4217 code of every price on the property. |
| brands | array of object | ||
| brands[].id | integer | 33 | Google brand id. |
| brands[].title | string | "Accor Live Limitless" | Brand name; empty string when Google did not name it. |
| brands[].children | array of object | Sub-brands. | |
| pagination | object | Pages overlap by a few results (page 2 starts before page 1 ends); de-duplicate by property_token. | |
| pagination.records_from | integer | null | 1 | 1-based position of the first result on this page. |
| pagination.records_to | integer | null | 20 | 1-based position of the last result on this page. |
| pagination.next_page_token | string | 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
| Input | Type | Required | What it does |
|---|---|---|---|
| q | string | Yes | Destination query exactly as a traveller would type it into Google Hotels, e.g.Min length 2, max length 200. |
| adults | integer | No | Adults in the room.Default 2. Min 1, max 10. |
| currency | string | No | ISO 4217 code for the returned prices.Default USD. |
| gl | string | No | Two-letter Google country (market).Default us. |
| hl | string | No | Interface language.Default en. Pattern ^[a-z]{2,3}(-[A-Za-z]{2,4})?$. |
| sort_by | string | No | Result order, as Google's Sort by control.Default relevance. |
| price_min | integer | null | No | Minimum nightly price in currency.Min 0. |
| price_max | integer | null | No | Maximum nightly price in currency.Min 0. |
| free_cancellation | boolean | No | Only properties Google lists with free cancellation.Default false. |
| special_offers | boolean | No | Only properties with a special offer.Default false. |
| eco_certified | boolean | No | Only eco-certified properties.Default false. |
| engine | string | No | Accepted for SERP API compatibility; must be google_hotels.Default google_hotels. |
| property_type | string | No | hotel (default) is Google's own list, which Google may blend with vacation rentals; each result states its type.Default hotel. |
| check_in_date | string (date) | Yes | First night of the stay, YYYY-MM-DD. |
| check_out_date | string (date) | Yes | Departure date, after check_in_date; at most 30 nights. |
| children_ages | string | array of integer | null | No | Comma-separated child ages, 0-17 (SERP API: 2,5). |
| rating | integer | null | No | SERP API rating code: 7 (3.5+), 8 (4.0+), 9 (4.5+). |
| hotel_class | string | array of integer | null | No | Comma-separated star classes, 2-5. |
| amenities | string | array of integer | null | No | Comma-separated amenity ids (same ids as SERP API/SerpApi, e.g. |
| property_types | string | array of integer | null | No | Comma-separated property-type ids, e.g. |
| brands | string | array of integer | null | No | Not supported: Google ignores brand filters on this search, so a non-empty value is refused with 422. |
| for_displaced_individuals | boolean | No | Not supported; true is refused with 422.Default false. |
| bedrooms | integer | null | No | Vacation-rental filter.Min 0. |
| bathrooms | integer | null | No | Vacation-rental filter.Min 0. |
| bounding_box | string | null | No | Not supported; search by q. |
| next_page_token | string | null | No | Opaque cursor from pagination.next_page_token of the previous page.Pattern ^[A-Za-z0-9_\-+/=]{1,200}$. |
| zero_retention | boolean | No | Accepted 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.
| Endpoint | What it returns | Credits | Per 1,000 calls |
|---|---|---|---|
| Destination search POST /v1/serp/google_hotels | Hotels for a place and dates, about 20 per page, with filters and sorting | 4 credits | $8.00 – $2.66 |
| Property page POST /v1/serp/google_hotels_property | Every seller’s price for one stay, rooms and hotel details | 5 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 330 | 8 credits | $16.00 – $5.33 |
| Reviews POST /v1/hotels/reviews | Guest reviews from Google and the sites it syndicates, up to 10 pages per call | from 2 credits | from $4.00 – $1.33 |
Your first call in three steps
- 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.
- 02
Send POST /v1/serp/google_hotels
Put the key in the
x-api-keyheader and passq,check_in_dateandcheck_out_date. Every other input is optional and listed above. - 03
Read the JSON
The answer is one JSON object with
search_information,properties,brandsandpagination, 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 it legal to scrape Google Hotels?
It depends on what you collect and what you do with it. Here is what the API does, and what stays with you once the data is yours.
Public pages only
The API reads what Google Hotels shows anyone who opens the page without signing in. It uses no account and opens nothing behind a paywall.
Facts are not the same as content
A price on a date, a rating or a count is a fact, and copyright does not protect facts. Review text, photos, descriptions and transcripts belong to their authors or the site. Counting, scoring or summarising them is a different use from republishing them, and republishing usually needs permission.
Databases have their own right in the EU and UK
Whoever invested in building a database there can stop others taking a substantial part of it, and repeated extraction of small parts can add up to a substantial part. Collect the fields and dates you need, not a copy of Google Hotels.
Personal data is yours to handle
Reviews and place listings can carry reviewer names and profile photos. If you keep it, the GDPR and UK GDPR apply to people in Europe and the UK, and other places have their own privacy laws: you need a lawful basis, must tell people you hold their data unless an exemption applies, should collect no more than you need, and should delete it on a schedule. The simplest route is not to keep it: drop names and handles before you store anything. A hashed name is still personal data.
The site’s terms, and ours
The terms of use of Google Hotels may limit automated access to it or reuse of its data. Our Terms make you responsible for how you use the data you collect, for following the terms of the sites it comes from, for data protection law, and for having the rights you need.
This is general information, not legal advice. For a specific use, ask a lawyer where you operate. Google Hotels is a trademark of its owner. ScraperCompany is independent: not affiliated with or endorsed by Google Hotels, and this is not an official Google Hotels API.
Frequently asked questions
Read next
- Price the next 90 nights
- Search a destination
- Hotel reviews guide
- Competitor rate shopping
- Hotel price API for rate shopping and parity
- Google Hotels API alternatives compared
Guides
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 APIsEvery 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.
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.
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.
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.
7,500 credits, one-time. No subscription. Or try it free: 50 calls, no card.
- See pricingPlans, packs and every price
- Talk to salesVolume, custom terms, invoices
- Read the quickstartFirst call in five minutes