# Google Hotels Scraper (`tacps126/google-hotels`) Actor

Scrape hotel prices from Google Hotels for any place and dates: nightly and total price with and without taxes, deals vs the usual price, hotel class, rating, reviews, check-in and check-out times, website and coordinates. From $2 per 1,000 hotels.

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

## Pricing

from $1.60 / 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

Get **hotel prices from Google Hotels** for any place and your travel dates as a clean dataset: **nightly and total price, with and without taxes and fees**, the **deal versus the usual price** ("32% less than usual"), hotel class, **rating and review count**, check-in and check-out times, the hotel's own website, coordinates and a Google Hotels link. Export to JSON, CSV or Excel, send to Google Sheets, or call it as an API.

**Built for** hotel revenue managers watching competitor rates, travel startups and agencies comparing prices, analysts tracking hotel pricing by city and date, and anyone planning trips at scale.

### Why this scraper

- **Plain-word places.** `Lisbon`, `Shibuya, Tokyo` or `Times Square, New York`.
- **Prices for your dates.** Set check-in and check-out: nightly rate, total for the stay, and both with taxes and fees.
- **Deals flagged.** Google's "less than usual" deal text when a price is below normal.
- **About 100 hotels per place.** *More hotels per place* also searches each hotel class and vacation rentals, then removes duplicates (they are free).
- **Filters.** Minimum hotel class and maximum nightly price; filtered hotels are not charged.
- **Rate tracking.** Schedule it daily with the same dates to follow prices over time.

### How to use it

1. Add **Locations** and **Check-in** / **Check-out** dates.
2. Optionally set filters.
3. Press **Start**. Download results from the **Output** tab, or connect an integration.

```json
{
  "locations": ["Lisbon", "Porto"],
  "checkIn": "2026-12-10",
  "checkOut": "2026-12-14",
  "minStars": 4,
  "maxNightlyPrice": 250
}
```

### What you get

| Field | Description |
|-------|-------------|
| `name`, `hotelClass`, `stars` | Hotel name and class ("4-star hotel", 4) |
| `price` | `{currency, nightly, nightlyWithTaxes, total, totalWithTaxes}` |
| `priceText`, `deal` | Nightly price as shown, deal text ("32% less than usual") |
| `rating`, `reviewsCount` | Google rating and number of reviews |
| `checkInTime`, `checkOutTime` | Check-in and check-out times |
| `website`, `googleUrl`, `photo` | Hotel website, Google Hotels page, photo |
| `latitude`, `longitude`, `countryCode` | Location |
| `description` | Short description |
| `checkIn`, `checkOut`, `search`, `scrapedAt` | The dates and place searched |

Example (shortened):

```json
{
  "name": "Blue Liberdade Hotel",
  "hotelClass": "3-star hotel",
  "price": { "currency": "USD", "nightly": 98, "nightlyWithTaxes": 104, "total": 393, "totalWithTaxes": 415 },
  "deal": "32% less than usual",
  "rating": 4.8,
  "reviewsCount": 735,
  "checkInTime": "4:00 PM",
  "checkOutTime": "12:00 PM",
  "countryCode": "PT"
}
```

### Pricing

Pay per result: about **$2 per 1,000 hotels** (lower on higher Apify plans) plus a small start fee. Duplicates and filtered hotels are free. See the **Pricing** tab for exact rates, and set a maximum charge per run to cap spend.

On Apify's **free plan** each run returns up to 100 hotels. Any paid Apify plan removes the limit.

### FAQ

**Which currency?** Prices are in US dollars.

**Can I get each booking site's price for a hotel?** Not yet. You get Google's lowest shown price per hotel. Open an issue if you need the per-site list.

**How many hotels per place?** About 100 with *More hotels per place* on. For more, search neighborhoods (`Alfama, Lisbon`).

**Is it legal?** The Actor collects publicly shown prices. You're responsible for how you use the data under the laws that apply to you.

### Support

Missing a field or a place that returns too little? Open an issue on the **Issues** tab with your input and what you expected.

# Actor input Schema

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

Places in plain words (for example `Lisbon`, `Shibuya, Tokyo`, `Times Square, New York`).

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

Arrival date. With check-out, prices are for your stay. Without dates Google picks its own.

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

Departure date.

## `moreResults` (type: `boolean`):

Also search each hotel class (2 to 5 stars) and vacation rentals, for about 100 hotels per place instead of about 18. Duplicates are free.

## `minStars` (type: `integer`):

Leave out hotels below this class (in stars). Places without a class are left out too.

## `maxNightlyPrice` (type: `integer`):

Leave out hotels above this nightly price.

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

Language for hotel classes and descriptions (two-letter code).

## `countryCode` (type: `string`):

Two-letter country code of the Google site to search.

## `maxItems` (type: `integer`):

Maximum number of hotels to return in total.

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

Keep the default setting for reliable results.

## `debug` (type: `boolean`):

More detail in the run log.

## Actor input object example

```json
{
  "locations": [
    "Lisbon"
  ],
  "moreResults": true,
  "language": "en",
  "countryCode": "us",
  "maxItems": 200,
  "proxyConfiguration": {
    "useApifyProxy": true
  },
  "debug": false
}
```

# Actor output Schema

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

The produced items (default dataset items).

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

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

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

```

## MCP server setup

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

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/KwlxzBT1CKzlyf28J/builds/dLte6ccai4eKqxjpX/openapi.json
