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

- **URL**: https://apify.com/ksvan/google-hotels-scraper.md
- **Developed by:** [K.S. Van](https://apify.com/ksvan) (community)
- **Categories:** Travel, E-commerce, AI
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$3.00 / 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.

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

Get **hotel prices from Google Hotels** for any city, neighbourhood or landmark and your exact dates. Each hotel comes with price per night, **total price with taxes and fees**, Google's **"great deal" flag and % below the usual price**, star class, guest rating, number of reviews, amenities and photos. Google shows about 20 hotels per search; this Actor runs extra searches automatically and returns **up to 150+ hotels per city** without duplicates. Fast HTTP requests, no browser.

### What you get

| Field | Details |
|---|---|
| Price | Lowest price per night and total for your stay, with taxes and fees |
| Deals | `GREAT DEAL` flag and how much cheaper than usual (%) |
| Quality | Star class, hotel type, guest rating (1-5), number of reviews |
| Amenities | Free Wi-Fi, breakfast, pool, parking, pet-friendly... |
| Photos | Up to 5 photo URLs |
| Link | Google Hotels page of the hotel |

### Use cases

- **Price monitoring** for hotels, revenue managers and travel agencies: run daily for your city and dates.
- **Travel deal finders and newsletters**: filter by `percentBelowUsual`.
- **Market research**: compare prices, ratings and amenities across a whole city.
- **Travel apps and AI trip planners**: live hotel data for an itinerary via the Apify MCP server.

### Input example

```json
{
  "locations": ["Paris", "Times Square New York"],
  "checkIn": "2026-11-20",
  "checkOut": "2026-11-22",
  "adults": 2,
  "maxHotelsPerLocation": 100,
  "minRating": 4
}
```

### Output example

```json
{
  "location": "Paris",
  "name": "Hôtel Villa Sorel",
  "pricePerNight": 72,
  "pricePerNightText": "$72",
  "totalPrice": 169,
  "totalPriceText": "$169",
  "nights": 2,
  "currency": "USD",
  "deal": "GREAT DEAL",
  "percentBelowUsual": 39,
  "rating": 4.3,
  "reviews": 274,
  "hotelClass": 3,
  "hotelType": "tourist hotel",
  "amenities": ["Breakfast", "Free Wi-Fi", "Parking ($)", "Air conditioning", "Pet-friendly"],
  "photos": ["https://lh3.googleusercontent.com/..."],
  "isSponsored": false,
  "checkIn": "2026-11-20",
  "checkOut": "2026-11-22",
  "adults": 2,
  "position": 1,
  "url": "https://www.google.com/travel/hotels/entity/ChcI4YCy5LKSu5J-GgsvZy8xdnYycmtsXxAB?q=Paris"
}
```

### Pricing

**$0.003 per hotel** ($3 per 1,000 hotels), no start fee. Searches that return nothing are free.

### Tips

- Prices depend on dates: always set check-in and check-out for real prices. Every result is checked against your number of nights, so you never get prices for the wrong stay.
- `totalPrice` includes taxes and fees for the whole stay; `pricePerNight` is the headline nightly price Google shows.
- For a full city, set **Max hotels** to 100-150. For a quick price check of the top results, keep 20.

### FAQ

**Which currency are prices in?** US dollars, as shown on Google Hotels in the US. The `currency` field always states the currency of each price.

**Which booking sites are the prices from?** Google Hotels shows the lowest price among its partners (Booking.com, Expedia, Hotels.com, the hotel's own site and others).

**Something broke or you need a feature?** Open an issue on the Actor page.

# Actor input Schema

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

Cities, neighbourhoods, landmarks or addresses, one per line.

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

YYYY-MM-DD. Empty = 14 days from today.

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

YYYY-MM-DD. Empty = 2 nights after check-in.

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

Number of adult guests.

## `maxHotelsPerLocation` (type: `integer`):

Google shows about 20 hotels per search. Above 20, the Actor runs extra searches (cheap, 4-star, luxury, boutique...) and removes duplicates, which usually reaches 100-150 hotels for a big city.

## `minRating` (type: `number`):

Skip hotels rated below this (0 = keep all).

## `skipSponsored` (type: `boolean`):

Leave out paid placements.

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

Language of hotel types and amenities. English gives the most complete data.

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

Parallel searches.

## `maxRetries` (type: `integer`):

Attempts per search, each on a new proxy IP.

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

Apify Proxy is used by default; the Actor switches to residential IPs automatically if Google starts blocking.

## Actor input object example

```json
{
  "locations": [
    "Paris",
    "Times Square New York"
  ],
  "checkIn": "",
  "checkOut": "",
  "adults": 2,
  "maxHotelsPerLocation": 20,
  "minRating": 0,
  "skipSponsored": false,
  "language": "en",
  "maxConcurrency": 4,
  "maxRetries": 4,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

One record per hotel.

# 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": [
        "Paris",
        "Times Square New York"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("ksvan/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": [
        "Paris",
        "Times Square New York",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("ksvan/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": [
    "Paris",
    "Times Square New York"
  ]
}' |
apify call ksvan/google-hotels-scraper --silent --output-dataset

```

## MCP server setup

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