# Google Hotels Scraper: Prices, Ratings & Booking Sites (`tablewise/google-hotels-scraper`) Actor

Scrape Google Hotels for any destination: hotels and vacation rentals with prices for your dates and adults, price per night, total with taxes, star class, rating, reviews, deals and coordinates. Optional address and prices by booking site. Export to CSV or Excel, or use the API.

- **URL**: https://apify.com/tablewise/google-hotels-scraper.md
- **Developed by:** [table wise](https://apify.com/tablewise) (community)
- **Categories:** Travel
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 properties

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

### What is Google Hotels Scraper?

Google Hotels Scraper gets hotels and vacation rentals from Google Hotels for
any destination, with the prices for your dates and number of adults: price
per night, total for the stay with taxes and fees, star class, guest rating
and reviews, deals, coordinates and photos. Optionally, it opens each property
to add its full address and the price on every booking site Google lists
(Booking.com, Expedia, Hotels.com, the hotel's own site...). No API key needed.

### What you can do with it

- **Compare hotel prices** in a city for specific dates, before and after
  taxes, in one table.
- **Track prices over time:** run it every day on a schedule for the same
  destination and dates, and see when rates drop.
- **Rate shopping:** see what each booking site charges for the same room
  (turn on **Add address and prices by booking site**).
- **Market research:** star class, guest rating, number of reviews and price
  level of every property in a destination.
- Feed hotel data to an AI agent through Apify's MCP server.

### Use cases

Ready-to-run examples, with the input already filled in:

- [Compare hotel prices in Lisbon for your dates](https://apify.com/tablewise/google-hotels-scraper/examples/compare-hotel-prices-in-lisbon):
  price per night, total with taxes, rating and hotel class for 20 Lisbon hotels, 30 days ahead unless you set a check-in date.
- [Compare New York hotel prices across booking sites](https://apify.com/tablewise/google-hotels-scraper/examples/new-york-hotel-prices-by-booking-site):
  the price each booking site offers for 10 New York hotels, to find the cheapest place to book.

### Example output

A real row from a test run on 2026-11-14 (photos and booking sites shortened
here; this hotel had 13 booking sites):

```json
{
  "search_query": "Paris",
  "search_location": "Paris",
  "position": 9,
  "name": "Mercure Paris 17 Batignolles",
  "property_type": "hotel",
  "is_vacation_rental": false,
  "hotel_class": 4,
  "hotel_class_text": "4-star tourist hotel",
  "rating": 4.4,
  "reviews_count": 876,
  "rating_breakdown": {"1": 35, "2": 23, "3": 61, "4": 229, "5": 528},
  "check_in_date": "2027-03-05",
  "check_out_date": "2027-03-07",
  "nights": 2,
  "adults": 2,
  "currency": "USD",
  "price_per_night": 104.46,
  "price_per_night_text": "$104",
  "total_before_taxes": 208.93,
  "taxes": 58.14,
  "fees": 0,
  "total_with_taxes": 267.07,
  "deal": "GREAT DEAL: 26% less than usual",
  "latitude": 48.8882008,
  "longitude": 2.3069289,
  "address": "118 Rue de Tocqueville, 75017 Paris, France",
  "country_code": "FR",
  "website": "https://all.accor.com/lien_externe.svlt?goto=fiche_hotel&code_hotel=A6S7&...",
  "check_in_time": "2:00 PM",
  "check_out_time": "12:00 PM",
  "description": "Warm rooms, some with balconies, in a stylish hotel offering a bar & a terrace, plus free Wi-Fi.",
  "images": [
    "https://lh3.googleusercontent.com/grass-cs/AABkmLeUZ6er8r79aGnzFP9LSc562fygueJt2mgMsg0xCp7a8Lb7pJdSmi-06C3lQNH_d1PATbna8Erzc_qixvO88qwRJFOTJvqXUKjmw9Ue2JEy-4kp23dKY7si_0N6ZuznEQIvjU8R=s287-w287-h192-n-k-no-v1",
    "..."
  ],
  "google_hotels_url": "https://www.google.com/travel/hotels/entity/ChkI59_fsrWz1dMqGg0vZy8xMWcwNzJjbWpiEAE",
  "google_maps_url": "https://www.google.com/maps/search/?api=1&query=48.8882008,2.3069289",
  "entity_id": "ChkI59_fsrWz1dMqGg0vZy8xMWcwNzJjbWpiEAE",
  "prices_by_provider": [
    {"provider": "Mercure Paris 17 Batignolles", "price_per_night": 104.46, "price_per_night_with_taxes": 133.54, "total_before_taxes": 208.93, "total_with_taxes": 267.07},
    {"provider": "Expedia.com", "price_per_night": 109.69, "price_per_night_with_taxes": 139.27, "total_before_taxes": 219.38, "total_with_taxes": 278.55},
    {"provider": "Hotels.com", "price_per_night": 109.69, "price_per_night_with_taxes": 139.27, "total_before_taxes": 219.38, "total_with_taxes": 278.55}
  ],
  "scraped_at": "2026-11-14T19:41:31Z"
}
```

| Field | What it is |
| --- | --- |
| `search_query`, `search_location`, `position` | Your search, the place Google understood and the position in Google's results |
| `name`, `property_type`, `is_vacation_rental` | Name and type: `hotel`, `hostel`, `guest_house`, `bed_and_breakfast`... or `vacation_rental` |
| `hotel_class`, `hotel_class_text` | Star class (1–5); empty for vacation rentals and unrated places |
| `rating`, `reviews_count`, `rating_breakdown` | Guest rating (1–5), number of reviews and how many gave 5, 4, 3, 2 and 1 stars |
| `check_in_date`, `check_out_date`, `nights`, `adults` | The stay the prices are for |
| `currency`, `price_per_night`, `price_per_night_text` | Lowest price per night Google shows, before taxes |
| `total_before_taxes`, `taxes`, `fees`, `total_with_taxes` | The whole stay. `fees` are extra charges such as cleaning fees (0 when there are none) |
| `deal` | Google's deal label, for example "GREAT DEAL: 26% less than usual" |
| `latitude`, `longitude`, `country_code`, `google_maps_url` | Location |
| `address` | Full address. Only with **Add address and prices by booking site** |
| `website`, `check_in_time`, `check_out_time`, `description`, `images` | Property details as Google shows them |
| `google_hotels_url`, `entity_id` | The property's Google Hotels page and id |
| `prices_by_provider` | Only with **Add address and prices by booking site**: each site's price per night and total, before and with taxes |

### What it costs

| Event | Price |
| --- | --- |
| Actor start | USD 0.0005 per run |
| Property | USD 0.004 per hotel or vacation rental |

**Example:** the 20 properties of one destination = USD 0.08; 1,000
properties = USD 4.00, plus USD 0.0005 per run. Booking-site prices and the
address cost nothing extra.

You only pay for properties delivered. Searches where Google did not
recognize the place, returned other dates than the ones you asked for, or
showed no properties are not charged. Use **Maximum properties** to cap the
spend.

#### How many properties can I get with the free plan?

Apify's free plan includes USD 5 of credit every month. Used only for
this Actor, that is about 1,245 properties: for example, 5 runs of 249
properties = 5 × (0.0005 + 249 × 0.004) = USD 4.98.

### How to use it

1. Type your destinations into **Destinations or searches**, one per line: a
   city (`Lisbon`), a neighborhood (`Shibuya Tokyo`) or a landmark
   (`hotels near Eiffel Tower`).
2. Set the **Check-in date** (YYYY-MM-DD), the **Nights** and the **Adults**.
   Leave the date empty to search 30 days ahead of each run: useful for
   scheduled runs, which then never search a past date.
3. Optional: turn on **Add address and prices by booking site**.
4. Set **Maximum properties** and click **Start**. Download the results as
   JSON, CSV or Excel.

You can also run it from the API, on a schedule, or let an AI agent call it
through Apify's MCP server.

#### Input

| Field | Type | Default | What it does |
| --- | --- | --- | --- |
| `searches` | array | — | Destinations or searches, one per line |
| `checkInDate` | string | 30 days from today | Check-in date, YYYY-MM-DD |
| `nights` | integer | 2 | Nights, 1 to 30 |
| `adults` | integer | 2 | Adults, 1 to 6 |
| `includeBookingSitePrices` | boolean | `false` | Opens each property's page to add the address and the price on each booking site |
| `maxProperties` | integer | 100 | Stops after this many properties across all searches |
| `delayBetweenRequests` | integer | 3 | Seconds between requests to Google |
| `proxyConfiguration` | object | `{"useApifyProxy": true}` | Apify Proxy settings |

### Speed and reliability

One request per destination. In our tests on Apify: 20 properties in 10
seconds; 15 destinations (300 properties) in 103 seconds; 10 destinations in
65 seconds, with every request answered on the first try. With **Add address
and prices by booking site**, each property needs one more page: 5 to 7
seconds per property (25 properties took 125 seconds and 20 took 148).

Before delivering a search, the Actor checks that Google kept your dates (it
silently replaces dates it cannot use) and recognized the place (if it does
not, it shows hotels near the server's location instead). If either check
fails, the search is skipped and not charged.

### Limits and known issues

- **Up to 20 properties per destination**: the first page of Google's
  results. For more, add more specific searches (neighborhoods or landmarks).
- **Prices are in US dollars.** Google picks the currency from the location
  of the server, not from a setting.
- Prices are what Google shows for those dates and adults. The booking site
  can show a different final price.
- Some properties show no price (no availability for those dates or that
  number of adults; 3 of 300 in our 1-adult test). The row is still
  delivered with the rest of the data.
- The address only comes with **Add address and prices by booking site**:
  Google leaves it out of searches with dates.
- Children and number of rooms cannot be set. Amenities and review texts are
  not included.
- Some searches return nothing. In our tests, "Naples" (an ambiguous name)
  showed no properties, while "Naples Italy" showed 20 in Italy and "hotels
  in Naples" showed 20 in Naples, Florida; "hotels near Times Square" showed
  none while "Times Square" showed 20. Add the country to ambiguous names and
  check `search_location` and `country_code`. Empty searches are not charged,
  and the run log says which ones came back empty.
- If Google shows a captcha, the run stops instead of insisting. The Actor
  does not solve captchas.
- Data comes from the public Google Hotels website. Phone numbers and
  personal data are not collected.

### FAQ

#### Can I get prices for several dates?

Yes: run it once per date, or schedule it. Each run uses one check-in date
and one number of nights for all its searches.

#### Why do vacation rentals appear?

Google Hotels mixes some vacation rentals into its hotel results. They are
marked with `is_vacation_rental` and `property_type` = `vacation_rental`, so
you can filter them out.

#### Do I need a Google account or an API key?

No. It reads the same public pages the Google Hotels website shows to any
visitor.

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

This Actor only reads pages that anyone can open without logging in, and it
does not collect personal data. Whether scraping is allowed depends on your
country and on how you use the data, and Google's terms of use may
restrict automated access. If you are not sure, ask a lawyer.

#### Can I run it from the API or from Python?

Yes: with the Apify API or the official Apify clients for Python and
JavaScript. This call runs the Actor and returns the rows when it finishes
(it waits up to 5 minutes; for longer runs, start the run and read its
dataset when it ends):

```bash
curl -X POST "https://api.apify.com/v2/acts/tablewise~google-hotels-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer <YOUR_APIFY_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searches": ["Lisbon"], "checkInDate": "2027-03-05", "nights": 2, "maxProperties": 20}'
```

#### Can I schedule it or send the results to other tools?

Yes. You can run it on a schedule, export each run as JSON, CSV or Excel, get
a webhook when it finishes, and connect it to Make, Zapier, n8n, Google
Drive, Slack and other tools through Apify integrations.

#### Can AI agents use it?

Yes. AI agents can find and run it through Apify's MCP server
(`https://mcp.apify.com`). Every output field has a description, so an agent
knows what each value means.

### Support

Found a problem? Open an issue on the Actor's **Issues** tab with the run ID
and we'll look into it.

### More Actors from the same developer

- [Google Trends Scraper](https://apify.com/tablewise/google-trends-scraper): interest over time, interest by region and related queries for any keyword.
- [Tennis Results & Odds Scraper](https://apify.com/tablewise/tennis-results-scraper): ATP, WTA, Challenger and ITF results and fixtures with set scores and betting odds.
- [Semrush Domain Metrics Scraper](https://apify.com/tablewise/semrush-domain-metrics-scraper): Authority Score, backlinks, referring domains and traffic for any list of domains.
- [YouTube Transcript & Subtitles Scraper](https://apify.com/tablewise/youtube-transcript-scraper): the transcript of any YouTube video, Short or channel as text or SRT, with the video details.
- [Website Email & Contact Scraper](https://apify.com/tablewise/website-email-contact-scraper): emails, phones and social profiles from any list of websites.
- [LinkedIn Company Scraper](https://apify.com/tablewise/linkedin-company-scraper): size, industry, employees, website and offices of any LinkedIn company page.
- [LinkedIn Jobs Scraper](https://apify.com/tablewise/linkedin-jobs-scraper): LinkedIn job postings with full description, salary, seniority and applicants, without login.
- [Company Jobs Scraper: Workday, Greenhouse, Lever & Ashby](https://apify.com/tablewise/workday-greenhouse-lever-jobs-scraper): every open job from company careers sites on those four platforms.
- [AliExpress Search Scraper](https://apify.com/tablewise/aliexpress-search-scraper): prices, discounts, ratings and units sold from any AliExpress search.
- [Amazon Best Sellers Scraper](https://apify.com/tablewise/amazon-bestsellers-scraper): the top 100 of any Amazon.com Best Sellers or Hot New Releases list.
- [Amazon Product Details Scraper](https://apify.com/tablewise/amazon-product-details-scraper): price, Best Sellers Rank, specs and images for any list of ASINs.

# Actor input Schema

## `searches` (type: `array`):

One per line: a city, neighborhood or landmark, as you would type it on Google Hotels (Lisbon, Shibuya Tokyo, hotels near Times Square). Each line returns up to 20 properties.

## `checkInDate` (type: `string`):

YYYY-MM-DD. Leave it empty to use 30 days from the day of the run, so a scheduled run never searches a past date.

## `nights` (type: `integer`):

Length of the stay, from 1 to 30 nights.

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

Number of adult guests, from 1 to 6. Prices are for this number of adults.

## `includeBookingSitePrices` (type: `boolean`):

Opens each property's Google Hotels page to add its full address and the price on each booking site Google lists (Booking.com, Expedia, Hotels.com, the hotel's own site...). One more page per property, so the run is slower.

## `maxProperties` (type: `integer`):

Stops after this many properties across all searches, so you never pay for more than this.

## `delayBetweenRequests` (type: `integer`):

Pause between requests to Google.

## `proxyConfiguration` (type: `object`):

Apify Proxy settings. On by default (datacenter proxy).

## Actor input object example

```json
{
  "searches": [
    "Lisbon"
  ],
  "nights": 2,
  "adults": 2,
  "includeBookingSitePrices": false,
  "maxProperties": 20,
  "delayBetweenRequests": 3,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

One row per hotel or vacation rental: prices for the chosen dates and adults, rating, reviews, class, deal, location and, if requested, prices by booking site.

# 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 = {
    "searches": [
        "Lisbon"
    ],
    "maxProperties": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tablewise/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 = {
    "searches": ["Lisbon"],
    "maxProperties": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("tablewise/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 '{
  "searches": [
    "Lisbon"
  ],
  "maxProperties": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call tablewise/google-hotels-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,tablewise/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/8VH7WZnV8og5FT7XE/builds/pCsGnojAS0I78Gyns/openapi.json
