Google Hotels Search Scraper

Google Hotels Search Scraper runs a Google Hotels search for a destination and stay and returns every hotel on the page with its price for your dates, rating and review count, star class, amenities, GPS coordinates, images and the property token used by the other Google Hotels scrapers. It supports Google's filters (price range, rating, star class, amenities, property type, free cancellation) and pages through results. Two lookup modes turn a hotel name into its property token, or into up to three candidates with address and phone.

Powered by the ScraperCompany API: requests, proxies, retries and anti-bot handling run on ScraperCompany's servers, so you don't need your own proxies or API key. Start a run, get structured JSON.

Prefer to call it from your own code? The same data is available as the Google Hotels API, with per-call pricing and a free tier.

What can this scraper do?

• Destination search exactly like Google Hotels: hotels in Montreal, Paris, hotels near JFK.
• Per hotel: nightly and total price, rating, reviews, star class, amenities, GPS, images, nearby places and property token.
• Google's filters: price range, minimum rating, star class, amenities, property types, free cancellation, special offers, eco-certified.
• Paging up to 20 pages per query, any currency, country and language, children ages.
• Find property token for a hotel name, or Resolve a name to candidates with address and phone.

Modes

Mode	What it returns	Price per request
search	Hotels for a destination and stay: price, rating, reviews, class, amenities, GPS, property token	$0.005
token	Google Hotels property token for a hotel name (fast, verified)	$0.002
resolve	Up to 3 candidates for a hotel name and place, with address, phone, rating and token	$0.018

What data can you extract?

Field	Description
properties[].name / type / hotel_class	Hotel identity and class
properties[].rate	Nightly and total price for the stay, before and after taxes
properties[].rating / reviews / reviews_breakdown	Guest rating, review count and breakdown
properties[].amenities / images / thumbnail	Amenities and photos
properties[].gps_coordinates / nearby_places	Location
properties[].property_token	Token for the Google Hotels Property and Calendar scrapers
search_information	Resolved location, total results, returned currency
pagination.next_page_token	Cursor for the next page
matches[].token / verified (Find property token)	Token per candidate, verified against Google
properties[].address / phone (Resolve)	Candidates with address and phone

Every dataset item also carries input (the exact request that was sent), request_id (quote it to support), billed and scraped_at.

How to use Google Hotels Search Scraper

1. Open Google Hotels Search Scraper in Apify Console and go to the Input tab.
2. Type destinations as you would on Google Hotels and set your dates (exact or relative such as 30 days). Use Find property token mode with hotel names to get tokens for the other Google Hotels scrapers.
3. Adjust the options if needed. Dates accept an exact date (2026-12-01) or a relative one (30 days from today), so saved tasks and schedules never go stale.
4. Click Start and wait for the run to finish.
5. Download the results from the Output tab as JSON, CSV, Excel or HTML, or fetch them with the Apify API.

Input example

This is the default input; running the Actor without changes uses it.

{
  "mode": "search",
  "queries": [
    "hotels in Montreal"
  ],
  "check_in": "30 days",
  "check_out": "32 days",
  "maxPages": 1,
  "includeErrors": true,
  "maxConcurrency": 3,
  "maxRetries": 2
}

Output example

One dataset item per request (trimmed here; real items contain every field the API returns):

{
  "mode": "search",
  "endpoint": "/v1/hotels/search",
  "input": {
    "q": "hotels in Montreal",
    "check_in": "2026-10-31",
    "check_out": "2026-11-02",
    "currency": "CAD",
    "gl": "ca"
  },
  "meta": {
    "egress": {
      "attempts": 1,
      "class": "direct",
      "mode": "direct",
      "path": [
        "direct/direct:ok"
      ],
      "pool": "direct"
    },
    "elapsed_s": 1.89,
    "skipped_records": 0,
    "wire_bytes": 214986
  },
  "pagination": {
    "next_page_token": "CBI=",
    "records_from": 1,
    "records_to": 20
  },
  "properties": [
    {
      "airport_access_rating": 4.6,
      "amenities": [
        "Breakfast ($)"
      ],
      "amenity_codes": [
        [
          1
        ]
      ],
      "check_in_time": "3:00 PM",
      "check_out_time": "11:00 AM",
      "country": "CA",
      "data_id": "0x4cc9178df6e67b8d:0x96904dcb5fd8281a",
      "deal": "27% less than usual",
      "deal_description": "Great Deal",
      "deal_kind": "below_usual_price",
      "description": "Modern lodging with a restaurant & an indoor pool, plus free WiFi & an airport shuttle.",
      "extracted_hotel_class": 4,
      "gps_coordinates": {
        "latitude": 45.4851544,
        "longitude": -73.6909316
      },
      "hotel_class": "4-star hotel",
      "images": [
        {
          "original": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWk0lycQOr7G_2oWSLSEpBlBBfN0wY5jwgISonycKD0xeg__AHXxCEpS3XqlR9IcD1alML-r6P2EvsCMBx_Lt3KN8sOYNRZU4Jouiz7gc8JcjO...",
          "thumbnail": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWk0lycQOr7G_2oWSLSEpBlBBfN0wY5jwgISonycKD0xeg__AHXxCEpS3XqlR9IcD1alML-r6P2EvsCMBx_Lt3KN8sOYNRZU4Jouiz7gc8JcjO..."
        }
      ],
      "link": "https://www.choicehotels.com/quebec/montreal/radisson-hotels/cnc37?mc=llgoxxpx",
      "location_rating": 3.1,
      "name": "Radisson Hotel Montreal Airport",
      "nearby_places": [
        {
          "category_code": 2,
          "name": "Côte-de-Liesse / No 6400"
        }
      ],
      "property_token": "ChgImtDg_rW5k8iWARoLL2cvMXRzamQ4NncQAQ",
      "provenance": {
        "collection_id": "ratecol_0123456789abcdef0123456789abcdef",
        "collector": "scrapingme.google_hotels_search",
        "derivation": "normalized_upstream",
        "egress_mode": "direct",
        "observation_id": "rateobs_0123456789abcdef0123456789abcdef",
        "observed_at": "2026-09-30T22:46:08.123Z",
        "price_basis": "stay_total_including_taxes_and_fees",
        "requested_currency": "CAD",
        "requested_market": "CA",
        "returned_currency": "CAD",
        "schema_version": 1,
        "source": "google_hotels_search",
        "source_kind": "search_listing",
        "source_property_id": "ChgImtDg_rW5k8iWARoLL2cvMXRzamQ4NncQAQ"
      },
      "proximity_to_restaurants_rating": 2.8,
      "proximity_to_things_to_do_rating": 3.2,
      "proximity_to_transit_rating": 2.5,
      "rate": {
        "base": 203.35938,
        "before_taxes": 203.36,
        "check_in": "2026-10-21",
        "check_out": "2026-10-23",
        "currency": "CAD",
        "extracted_price_per_night": 121,
        "extracted_price_per_night_before_taxes": 101.67969,
        "fees": 0,
        "from_display_text": false,
        "nights": 2,
        "price_per_night": "$121",
        "price_per_night_before_taxes": "$102",
        "taxes": 38.640625,
        "total": 242,
        "total_price": "$242",
        "total_price_before_taxes": "$203"
      },
      "rating": 3.5,
      "reviews": 2535,
      "reviews_breakdown": [
        {
          "description": "Fitness",
          "name": "Fitness",
          "negative": 67,
          "neutral": 13,
          "positive": 119,
          "total": 199
        }
      ],
      "reviews_histogram": {
        "1": 443,
        "2": 220,
        "3": 396,
        "4": 674,
        "5": 802
      },
      "thumbnail": "https://lh3.googleusercontent.com/gps-cs-s/AHRPTWk0lycQOr7G_2oWSLSEpBlBBfN0wY5jwgISonycKD0xeg__AHXxCEpS3XqlR9IcD1alML-r6P2EvsCMBx_Lt3KN8sOYNRZU4Jouiz7gc8JcjO...",
      "type": "hotel"
    }
  ],
  "search_information": {
    "available_property_types": [
      {
        "id": 19,
        "name": "Bed and breakfasts"
      }
    ],
    "currency_matches_request": true,
    "entity_match": false,
    "location": "Montreal",
    "location_data_id": "0x4cc91a541c64b70d:0x654e3138211fefef",
    "nights": 2,
    "priced": 7,
    "requested_currency": "CAD",
    "requested_market": "CA",
    "returned": 7,
    "returned_currency": "CAD",
    "total_results": 5778
  },
  "search_parameters": {
    "adults": 2,
    "check_in_date": "2026-10-21",
    "check_out_date": "2026-10-23",
    "currency": "CAD",
    "engine": "google_hotels_search",
    "gl": "ca",
    "hl": "en",
    "q": "hotels in Montreal",
    "sort_by": "relevance"
  },
  "warnings": [
    "prices reflect this server's egress, not a verified CA exit; configure a market proxy for market-matched results"
  ],
  "request_id": "req_3f9c0d6e2b8a4c1f9e7d5b3a1c0e8f6d",
  "billed": true,
  "scraped_at": "2026-10-01T14:03:27.512Z"
}

A request that fails is saved with an error message instead (turn off Include failed requests to skip those). Failed requests are never charged.

How much does it cost?

This Actor uses pay-per-event pricing: you pay for successful API requests, not for compute time.

Event	Charged when	Price	Per 1,000
search-page	One page of Google Hotels destination results (about 20 properties with prices). Empty pages are free.	$0.005	$5.00
token-lookup	One hotel name matched to its Google Hotels property token.	$0.002	$2.00
resolve-request	One hotel name and place resolved to up to 3 candidates with address, phone and rating.	$0.018	$18.00

For example, 1,000 requests in the default mode cost $5.00.

• Failed requests (errors, invalid input, blocked upstream after retries) are free.
• Requests where the source returns nothing at all (no results, nothing priced) are saved but not charged.
• Set Maximum cost per run when you start a run and the Actor stops cleanly before going over it.

FAQ

Do I need proxies or a ScraperCompany API key?

No. Proxy rotation, retries and anti-bot handling run on the ScraperCompany side, and the Actor is already connected to the API. You only pay the per-event prices above.

What is a property token for?

It identifies a hotel on Google Hotels. Pass it to the Google Hotels Property Scraper (OTA offers, rooms, details), the Price Calendar Scraper (330-night calendar) or the Hotel Reviews Scraper (source: Google).

Why do some hotels have no price?

Google only prices hotels with availability for your dates and party. Others are still listed with their details.

Is there an official Google Hotels API?

Google's hotel APIs are for partners who send prices to Google, not for reading them. This Actor returns the public Google Hotels results as structured data.

How many hotels does a page return?

About 20 properties per page. Turn on paging to go further; a page with no properties is not charged.

Can I price a hotel for many dates?

Yes, with the Google Hotels Price Calendar Scraper: up to 330 nights for one hotel in a single request, using the property token this Actor returns.

Is it legal to scrape this data?

The Actor collects publicly available information that anyone can see without logging in. You are responsible for how you use the results: respect the source site's terms, copyright and privacy law (such as GDPR) and do not collect personal data without a lawful basis. If in doubt, ask a lawyer.

What happens when a request is blocked or rate-limited?

Rate limits (HTTP 429) and temporary errors (5xx) are retried automatically with exponential backoff, respecting Retry-After. If a request still fails it is saved with the error message and not charged, and the rest of the batch keeps going. A run only fails when every request failed.

Why did a request return an error?

Read the error field: validation problems (for example a malformed date or an unknown id) are reported exactly as the API sees them. Fix the input and run again; failed requests cost nothing.

How many requests can I run at once?

Any number per run. The Actor sends up to 3 requests in parallel by default (change it under Run options); larger batches simply take longer.

Use it from your code

Call the Actor from any language through the Apify API. With the JavaScript client (npm install apify-client):

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('scrapercompany/google-hotels-search-scraper').call({
    "mode": "search",
    "queries": [
        "hotels in Montreal"
    ],
    "check_in": "30 days",
    "check_out": "32 days"
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

With Python (pip install apify-client):

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("scrapercompany/google-hotels-search-scraper").call(run_input={
    "mode": "search",
    "queries": ["hotels in Montreal"],
    "check_in": "30 days",
    "check_out": "32 days",
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

You can also schedule runs, chain them with webhooks, or connect them to Make, Zapier, n8n, Google Sheets and other integrations from the Integrations tab.

Related scrapers

• Google Hotels Property Scraper
• Google Hotels Price Calendar Scraper
• Hotel Reviews Scraper

Support

Questions, a field you need, or a site that stopped working? Open an issue on the Issues tab or contact us at scrapercompany.com. Include the request_id from the dataset item so we can trace the request.