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

Canonical page: https://scrapercompany.com/google-hotels-api. Endpoints and prices checked against the API on 2026-11-11.

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.

Price: $4.00 per 1,000 calls with a credit pack, down to $1.33 on the Business plan. Failed requests cost 0 credits.

## 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

## Endpoints and price per call

| Endpoint | Method and path | What it returns | Credits per successful call | Price per call |
| --- | --- | --- | --- | --- |
| [Destination search](https://scrapercompany.com/docs/reference/serp-google-hotels) | `POST /v1/serp/google_hotels` | Hotels for a place and dates, about 20 per page, with filters and sorting | 4 credits | $0.0049 on Starter, $0.0040 on Growth, $0.0032 on Scale, $0.0027 on Business |
| [Property page](https://scrapercompany.com/docs/reference/serp-google-hotels-property) | `POST /v1/serp/google_hotels_property` | Every seller’s price for one stay, rooms and hotel details | 5 credits | $0.0061 on Starter, $0.0050 on Growth, $0.0040 on Scale, $0.0033 on Business |
| [Price calendar](https://scrapercompany.com/docs/reference/serp-google-hotels-calendar) | `POST /v1/serp/google_hotels_calendar` | Nightly prices for one hotel, 90 nights by default and up to 330 | 8 credits | $0.0098 on Starter, $0.0079 on Growth, $0.0064 on Scale, $0.0053 on Business |
| [Reviews](https://scrapercompany.com/docs/reference/google-hotels-reviews) | `POST /v1/hotels/reviews` | Guest reviews from Google and the sites it syndicates, up to 10 pages per call | from 2 credits | from $0.0024 on Starter, from $0.0020 on Growth, from $0.0016 on Scale, from $0.0013 on Business |

Pricing: free trial of 50 calls or 14 days, whichever ends first, no card needed; Starter $49/month for 40,000 credits; Growth $149/month for 150,000 credits; Scale $399/month for 500,000 credits; Business $999/month for 1,500,000 credits; credit packs $15 for 7,500, $60 for 35,000, $200 for 125,000 (valid 12 months). Failed requests (4xx or 5xx) and empty results cost 0 credits. https://scrapercompany.com/pricing

## Example

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

```bash
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):

```json
{
  "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="
  }
}
```

## Fields in the response

Arrays show their first item; every item has the same fields.

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

## Inputs

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

## Your first call in three steps

1. **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. **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. **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 it legal to scrape Google Hotels?

**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.
Our Terms: https://scrapercompany.com/terms#data-use

## FAQ

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

## Read next

- [Price the next 90 nights](https://scrapercompany.com/docs/guides/price-next-90-nights)
- [Search a destination](https://scrapercompany.com/docs/guides/search-a-destination)
- [Hotel reviews guide](https://scrapercompany.com/docs/guides/hotel-reviews)
- [Competitor rate shopping](https://scrapercompany.com/use-cases/competitor-rate-shopping)
- [Hotel price API for rate shopping and parity](https://scrapercompany.com/hotel-price-api)
- [Google Hotels API alternatives compared](https://scrapercompany.com/compare/apify-google-hotels-actors)
- [Search a destination, then price a hotel](https://scrapercompany.com/docs/guides/search-a-destination)
- [Price the next 90 nights](https://scrapercompany.com/docs/guides/price-next-90-nights)
- [Find a property token](https://scrapercompany.com/docs/guides/find-property-token)
- [Identify a property by name and address](https://scrapercompany.com/docs/guides/identify-a-property)
- [Monitor a comp set with jobs and webhooks](https://scrapercompany.com/docs/guides/monitor-comp-set)
- [Is booking a hotel direct cheaper? We priced 8 hotels across 20+ booking sites](https://scrapercompany.com/research/is-booking-direct-cheaper)
- [All APIs](https://scrapercompany.com/apis.md)
