# Google Hotels Scraper - Prices, Deals, Ratings for Any Dates (`optimistical_lectern/google-hotels-scraper`) Actor

Hotel prices from Google Hotels for any city and dates: nightly and total price with taxes, deal badges and how the price compares to usual, star class, rating, review count, amenities and photos. Many cities and searches in one run. Built for price monitoring and travel research.

- **URL**: https://apify.com/optimistical_lectern/google-hotels-scraper.md
- **Developed by:** [Ivan Honer](https://apify.com/optimistical_lectern) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.75 / 1,000 hotels

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 🏨 Google Hotels Scraper: Prices, Deals & Ratings for Any Dates

Hotel prices from **Google Hotels** for any city and **any dates**: nightly and total price including taxes, deal badges, how today's price compares to usual, star class, rating, reviews, amenities and photos. Google Hotels compares Booking.com, Expedia, Hotels.com, the hotels' own sites and more; this Actor turns that comparison into clean data, one row per hotel.

- ✅ **Prices for your exact stay**, with the check-in and check-out dates Google applied reported on every row
- ✅ **Nightly and total price with taxes and fees**, plus the number of nights
- ✅ **Deal signals**: `DEAL`, `GREAT DEAL`, and `29% less than usual`
- ✅ **Quality signals**: star class, rating, review count and the 5-to-1-star split
- ✅ **Amenities and up to six photos** per hotel
- ✅ **Many cities and search variations in one run**, with repeats removed and not charged

### What does Google Hotels Scraper do?

You give it locations ("Austin, TX", "Downtown Chicago", "near JFK airport"), and optionally dates, guests and search variations ("4 star hotels", "hotels with pool"). It then:

1. Runs each variation in each location on Google Hotels, for your dates and number of adults.
2. Checks which dates Google actually applied and records them on every result.
3. Reads each hotel card: price per night, total price, deal badges, star class, rating, reviews, amenities and photos.
4. Drops hotels already saved for the same place in the same run.

### Use cases

- 🏨 **Hotel revenue management.** Watch competitors' prices for the same dates every day.
- ✈️ **Travel deals and newsletters.** Find hotels priced well below their usual rate for a weekend or event.
- 📈 **Event and seasonality research.** Compare prices across dates: a festival weekend against the week after.
- 🧭 **Travel apps and research.** Price levels, ratings and amenities by city.
- 🤖 **AI agents.** "Find 4-star hotels in Denver under $150 a night for December 4 to 6."

### What data can you get?

| Field | What it is |
|---|---|
| `name`, `hotelId` | The hotel and Google's ID for it, stable across runs |
| `pricePerNight`, `totalPrice`, `currency` | Lowest advertised price for your stay. `totalPrice` includes taxes and fees |
| `nights`, `priceNote` | Number of nights, and Google's note, e.g. `2 nights with taxes + fees` |
| `deal`, `comparedToUsual` | `DEAL` or `GREAT DEAL`, and e.g. `16% less than usual` |
| `hotelClass` | Star class, 1 to 5. Empty for vacation rentals |
| `rating`, `reviews`, `ratingBreakdown` | Average rating out of 5, review count, and the percentage of 5- to 1-star reviews |
| `amenities` | Free breakfast, Wi-Fi, parking, pool, pet-friendly and more |
| `thumbnail`, `photos` | The main photo and up to six photo URLs |
| `googleHotelUrl`, `pricesUrl`, `reviewsUrl` | The hotel on Google Hotels, its full price comparison, and its reviews |
| `checkIn`, `checkOut`, `datesAsRequested` | The dates Google used, and whether they match what you asked for |
| `adults`, `country`, `searchLocation`, `searchQuery`, `position` | How it was searched, and where it ranked |

### How to use it

1. Click **Try for free** (or **Start**) at the top of this page.
2. Add cities, neighbourhoods or landmarks to **Locations**, one per line.
3. Pick **Check-in date** and **Check-out date**, or leave them empty for Google's default dates.
4. Optionally change **Adults**, and add variations to **What to search for**.
5. Press **Start**, then download the results from the **Output** tab as Excel, CSV or JSON.

### How to get many results

Google Hotels shows about **18 hotels per search**. Every entry in **What to search for** runs once in every location:

| Variations | Locations | Searches run | Unique hotels, at most |
|---|---|---|---|
| 1 (`hotels`) | 1 | 1 | about 18 |
| 3 | 2 | 6 | about 108 |
| 5 | 5 | 25 | about 450 |

Variations in the same place return some of the same hotels, which are saved once. In testing, 2 variations in 2 cities gave 64 unique hotels out of 72.

Good variations: `hotels`, `4 star hotels`, `5 star hotels`, `cheap hotels`, `hotels with pool`, `pet friendly hotels`, `boutique hotels`. Neighbourhoods work as locations too: `Downtown Austin`, `Austin airport`.

### Input examples

**Two cities, fixed dates.**

```json
{
  "locations": ["Austin, TX", "Denver, CO"],
  "checkIn": "2026-12-04",
  "checkOut": "2026-12-06",
  "hotelSearches": ["hotels", "4 star hotels"]
}
```

**A family of four, one neighbourhood, several variations.**

```json
{
  "locations": ["Orlando near Disney World"],
  "checkIn": "2027-03-14",
  "checkOut": "2027-03-19",
  "adults": 4,
  "hotelSearches": ["hotels", "hotels with pool", "family hotels", "resorts"]
}
```

**Prices in pounds for London.**

```json
{
  "locations": ["London Kings Cross", "London Soho"],
  "checkIn": "2027-01-15",
  "checkOut": "2027-01-17",
  "country": "GB"
}
```

**Free-form searches, exactly as written.**

```json
{
  "searchQueries": ["boutique hotels in Nashville from May 1 2027 to May 3 2027"]
}
```

### Output example

```json
{
  "hotelId": "ChcIxoO5itecjct-GgsvZy8xdGRwMHo2NBAB",
  "name": "DoubleTree by Hilton Hotel Denver Tech Center",
  "pricePerNight": 89,
  "totalPrice": 197,
  "currency": "$",
  "nights": 2,
  "priceNote": "2 nights with taxes + fees",
  "deal": "DEAL",
  "comparedToUsual": "16% less than usual",
  "hotelClass": 4,
  "rating": 4.1,
  "reviews": 2444,
  "ratingBreakdown": { "1": 7, "2": 5, "3": 10, "4": 27, "5": 51 },
  "amenities": ["Breakfast ($)", "Free Wi-Fi", "Parking ($)", "Pool", "Air conditioning", "Pet-friendly", "Fitness center", "Bar"],
  "thumbnail": "https://lh3.googleusercontent.com/grass-cs/...",
  "photos": ["https://lh3.googleusercontent.com/grass-cs/...", "..."],
  "googleHotelUrl": "https://www.google.com/travel/hotels/entity/ChcIxoO5itecjct-GgsvZy8xdGRwMHo2NBAB",
  "pricesUrl": "https://www.google.com/travel/hotels/entity/ChcIxoO5itecjct-GgsvZy8xdGRwMHo2NBAB/prices",
  "reviewsUrl": "https://www.google.com/travel/hotels/entity/ChcIxoO5itecjct-GgsvZy8xdGRwMHo2NBAB/reviews",
  "checkIn": "2026-12-04",
  "checkOut": "2026-12-06",
  "datesAsRequested": true,
  "adults": 2,
  "searchLocation": "Denver, CO",
  "searchQuery": "4 star hotels in Denver, CO from December 4 2026 to December 6 2026",
  "position": 1,
  "country": "US",
  "scrapedAt": "2026-10-14T19:48:32.951Z"
}
```

### Statuses and errors

The dataset contains only hotels. Anything that goes wrong is in the run log:

| Log line or field | Meaning | Charged? |
|---|---|---|
| `"hotels in Austin, TX ...": 18 hotel(s), 16 new.` | Normal. "New" excludes hotels already saved for the same place | Only the new ones |
| `datesAsRequested: false` | Google used different dates than you asked for; the dates it used are in `checkIn` and `checkOut` | Yes |
| `"...": Google did not return hotel results after 4 attempts` | Google refused that search four times. The rest of the run continues | No |
| Run fails with `Check-in ... is in the past` | Pick a date from today onwards | No |
| Run fails with `Every search failed` | Google refused every search. Try again in a few minutes | No |

### How much does it cost?

You pay per hotel saved. Repeats for the same place, empty searches and failed searches are free. Platform usage and proxies are included.

| Hotels | Price on the Free and Bronze tiers |
|---|---|
| 100 | $0.50 |
| 1,000 | $5.00 |
| 10,000 | $50.00 |

Larger Apify plans pay less per hotel: 15% less on Silver, and 25% less on Gold and above.

### FAQ

#### Can I use it through the API?

Yes. For a quick lookup, the synchronous endpoint returns the hotels in one request:

```bash
curl -X POST "https://api.apify.com/v2/acts/optimistical_lectern~google-hotels-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"locations": ["Austin, TX"], "checkIn": "2026-12-04", "checkOut": "2026-12-06"}'
```

JavaScript:

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('optimistical_lectern/google-hotels-scraper').call({ locations: ['Austin, TX'], checkIn: '2026-12-04', checkOut: '2026-12-06' });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

Python:

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("optimistical_lectern/google-hotels-scraper").call(run_input={"locations": ["Austin, TX"], "checkIn": "2026-12-04", "checkOut": "2026-12-06"})
items = client.dataset(run["defaultDatasetId"]).list_items().items
```

#### Can AI agents use it?

Yes. It runs with limited permissions, so it needs no approval step. Add it to Claude, Cursor or any other MCP client through Apify's MCP server at `mcp.apify.com`, using the Actor name `optimistical_lectern/google-hotels-scraper`.

#### How do I track prices every day?

Create a schedule in Apify Console with fixed dates, and send the results to Google Sheets, a database or a webhook. `hotelId` stays the same across runs, so each day's price lines up with the last.

#### Which currency are prices in?

The currency Google uses for the **Country** you choose: `US` for dollars, `GB` for pounds, `DE` or `FR` for euros, and so on.

#### Are the prices exact?

They are Google's lowest advertised price for the stay at the moment of the run. Hotel prices change by the minute, and the final price depends on the room and the site you book through. `pricesUrl` opens Google's full comparison.

#### Why do some results have no star class?

Vacation rentals sometimes appear among hotels. They have a rating but no official star class.

#### Is it legal to scrape Google Hotels?

The tool collects prices and hotel details that Google shows to any visitor. Using automated tools on Google may go against Google's terms of service, and whether that matters depends on how and where you use the data. If you are unsure, ask a lawyer.

#### Something looks wrong?

Open an issue on the **Issues** tab with the location and dates. Every report is read.

### Related tools

- [💼 Google Jobs Scraper](https://apify.com/optimistical_lectern/google-jobs-scraper): job listings with salaries and apply links
- [📇 Website Contact Extractor](https://apify.com/optimistical_lectern/website-contact-extractor): contact details from hotels' own websites
- [🌐 Domain WHOIS, DNS & Email Security](https://apify.com/optimistical_lectern/domain-whois-dns-lookup): registration and email-security data for domains

# Actor input Schema

## `locations` (type: `array`):

Cities, neighbourhoods or landmarks, one per line, e.g. 'Austin, TX', 'Downtown Chicago', 'near JFK airport'.

## `checkIn` (type: `string`):

Optional. Leave empty to get Google's default dates (usually a single night a couple of weeks ahead).

## `checkOut` (type: `string`):

Optional. Defaults to one night after check-in.

## `adults` (type: `integer`):

Number of adult guests.

## `hotelSearches` (type: `array`):

Each is searched in every location. Google shows about 18 hotels per search, so add variations for more: 'hotels', '4 star hotels', 'hotels with pool', 'pet friendly hotels'.

## `searchQueries` (type: `array`):

Free-form Google Hotels searches used exactly as written, e.g. 'boutique hotels in Nashville from May 1 2027 to May 3 2027'.

## `country` (type: `string`):

Two-letter country code. Prices come back in that country's currency, e.g. US for dollars, GB for pounds, DE for euros.

## `language` (type: `string`):

Language code for the results, e.g. en, de, fr.

## `maxConcurrency` (type: `integer`):

How many searches to run at the same time.

## Actor input object example

```json
{
  "locations": [
    "Austin, TX"
  ],
  "adults": 2,
  "hotelSearches": [
    "hotels"
  ],
  "country": "US",
  "language": "en",
  "maxConcurrency": 4
}
```

# Actor output Schema

## `results` (type: `string`):

One item per hotel per location searched.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "locations": [
        "Austin, TX"
    ],
    "hotelSearches": [
        "hotels"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("optimistical_lectern/google-hotels-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "locations": ["Austin, TX"],
    "hotelSearches": ["hotels"],
}

# Run the Actor and wait for it to finish
run = client.actor("optimistical_lectern/google-hotels-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locations": [
    "Austin, TX"
  ],
  "hotelSearches": [
    "hotels"
  ]
}' |
apify call optimistical_lectern/google-hotels-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,optimistical_lectern/google-hotels-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/c7WMaOsV9u4vuZvfA/builds/JZJ6fx2yqB78RPOEN/openapi.json