Google Hotels Scraper

Export public Google Hotels search results for destinations, stay dates, and guest counts. This Google Hotels API-ready hotel price scraper returns one hotel per dataset row with prices, ratings, review counts, amenities, images, and Google Travel links for spreadsheets, databases, and travel workflows.

Who is it for?

Hotel revenue managers, travel agencies, travel-tech builders, destination analysts, and accommodation pricing teams can use this Actor for repeatable destination/date price monitoring.

Why use this Actor?

• Compare hotel inventory for cities, neighborhoods, landmarks, or named properties.
• Track publicly displayed nightly rates for specific stay dates.
• Export structured hotel rows instead of manually copying Google Hotels cards.
• Preserve the requested currency and the currency Google actually displays.
• Process several destination queries in one run while keeping partial results if one query fails.

Input example

{
  "queries": ["hotels in New York", "hotels near Eiffel Tower"],
  "checkInDate": "2026-09-15",
  "checkOutDate": "2026-09-17",
  "adults": 2,
  "currency": "USD",
  "language": "en",
  "country": "US",
  "maxResultsPerQuery": 20,
  "includeDetails": false
}

Dates must be in the future and use YYYY-MM-DD. Checkout must be after check-in.

Output example

{
  "query": "hotels in New York",
  "checkInDate": "2026-09-15",
  "checkOutDate": "2026-09-17",
  "adults": 2,
  "childrenAges": [],
  "requestedCurrency": "USD",
  "currency": "USD",
  "language": "en",
  "country": "US",
  "hotelName": "Example Hotel",
  "propertyToken": "example-token",
  "googleTravelUrl": "https://www.google.com/travel/hotels/entity/example-token",
  "propertyType": "hotel",
  "description": null,
  "address": null,
  "latitude": null,
  "longitude": null,
  "hotelClass": 4,
  "rating": 4.4,
  "reviewCount": 1280,
  "locationRating": null,
  "pricePerNight": 219,
  "pricePerNightDisplay": "$219",
  "totalPrice": null,
  "totalPriceDisplay": null,
  "priceAvailable": true,
  "amenities": ["Pool", "Free Wi-Fi"],
  "images": ["https://example.com/hotel.jpg"],
  "checkInTime": null,
  "checkOutTime": null,
  "ecoCertified": false,
  "offers": [],
  "detailStatus": "not_requested",
  "status": "succeeded",
  "diagnostics": [],
  "scrapedAt": "2026-08-13T12:00:00.000Z"
}

Fields unavailable on a particular public result remain null or an empty array, so exports keep a stable shape.

Input settings

Field	Type	Description
queries	string[]	Destinations, landmarks, neighborhoods, or hotel names; 1–20 queries.
checkInDate	string	Future check-in date in YYYY-MM-DD format.
checkOutDate	string	Checkout date after check-in.
adults	integer	Adult guests, from 1 to 20.
childrenAges	integer[]	Ages of child guests, from 0 to 17.
currency	string	Requested three-letter currency code, such as USD or EUR.
language	string	Two-letter Google interface language code.
country	string	Two-letter Google search region code.
maxResultsPerQuery	integer	Maximum unique hotels saved for each query.
includeDetails	boolean	Request public property-detail enrichment when available. Search rows are preserved if enrichment is unavailable.
includeOffers	boolean	Include the public booking-offer ladder when Google displays it.
minPrice, maxPrice	number	Optional nightly-price filters.
minRating	number	Optional minimum guest rating from 0 to 5.
hotelClasses	integer[]	Optional hotel star classes to keep.
proxyConfiguration	object	Optional Apify Proxy configuration.

Output fields

Each row includes:

• Request context: query, checkInDate, checkOutDate, adults, childrenAges, requestedCurrency, language, country.
• Hotel identity: hotelName, propertyToken, googleTravelUrl, propertyType, description, address, latitude, longitude.
• Quality signals: hotelClass, rating, reviewCount, locationRating, ecoCertified.
• Rates: currency, pricePerNight, pricePerNightDisplay, totalPrice, totalPriceDisplay, priceAvailable.
• Property information: amenities, images, checkInTime, checkOutTime.
• Booking offers: offers with vendor name/icon, sponsorship status, nightly and total prices, and booking URL when displayed publicly.
• Run status: detailStatus, status, diagnostics, scrapedAt.

Input recipes

Destination rate comparison

Use one city query, exact stay dates, and maxResultsPerQuery: 50 to create a market snapshot.

Compare several destinations

Add several entries to queries. Results retain their originating query, making grouping straightforward after export.

Find highly rated hotels in a budget range

Set minRating, minPrice, and maxPrice. Price filters apply only when Google displays a parseable public rate.

Pricing

This Actor uses pay-per-event pricing: a small run-start charge plus a charge for each hotel row successfully stored. Failed or filtered rows are not charged as results. See the live Pricing tab for the current tier-specific rates before starting a run.

API usage

curl -X POST "https://api.apify.com/v2/acts/fetch_cat~google-hotels-scraper/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries":["hotels in Paris"],"checkInDate":"2026-10-20","checkOutDate":"2026-10-22","maxResultsPerQuery":10}'

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/google-hotels-scraper').call({ queries: ['hotels in Paris'], checkInDate: '2026-10-20', checkOutDate: '2026-10-22', maxResultsPerQuery: 10 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();

from apify_client import ApifyClient
client = ApifyClient(token='YOUR_APIFY_TOKEN')
run = client.actor('fetch_cat/google-hotels-scraper').call(run_input={'queries': ['hotels in Paris'], 'checkInDate': '2026-10-20', 'checkOutDate': '2026-10-22', 'maxResultsPerQuery': 10})
items = client.dataset(run['defaultDatasetId']).list_items().items

Use the run's default dataset after it succeeds.

MCP and AI agents

Connect through Apify MCP to let compatible AI clients run hotel searches and consume structured results. Always supply explicit future dates and a bounded result limit.

$claude mcp add apify -- npx -y @apify/mcp-server

{"mcpServers":{"apify":{"command":"npx","args":["-y","@apify/mcp-server"],"env":{"APIFY_TOKEN":"YOUR_APIFY_TOKEN"}}}}

Example prompt: “Run fetch_cat/google-hotels-scraper for hotels in Paris for my stay dates and return rows with price, rating, and booking offers.”

Tips and limitations

• Hotel prices and availability change frequently; store scrapedAt with every comparison.
• Google may resolve a different display currency based on availability. Compare requestedCurrency with currency.
• Some cards do not display prices, addresses, coordinates, or offers. Such fields remain empty rather than being guessed.
• Search presentation varies by language, country, dates, and consent region.
• This Actor exports public hotel search data. It does not complete bookings, access private accounts, or scrape full review histories.
• Keep query batches and result limits reasonable. One blocked query does not invalidate rows already saved from other queries.

FAQ

Can I search by hotel name instead of a city?

Yes. queries accepts destinations, landmarks, neighborhoods, and named hotels.

What data can I export with Google Hotels Scraper?

You can scrape Google Hotels prices alongside hotel identity, stay dates, guest context, ratings, amenities, images, and public booking offers when displayed.

Does it return live prices?

It returns the public rates displayed by Google Hotels for the supplied dates and guests. A property may have no displayed price.

Can I run Google Hotels Scraper through an API, schedule, or MCP client?

Yes. Use the API request above, schedule saved Actor inputs in Apify, or connect the MCP tool for bounded date-specific hotel searches.

How much does it cost to use Google Hotels Scraper?

It charges a small start event plus one event for each hotel row successfully saved. Review the current rate on the Actor Pricing tab before starting a run.

Can I use the output in Excel, Google Sheets, or a database?

Yes. Apify datasets export to JSON, CSV, Excel, XML, and other formats and can be accessed through the API.

Does it support API and MCP automation?

Yes. Use the Apify API, client libraries, webhooks, integrations, or the MCP endpoint above.

Is this an official Google product?

No. This independent Actor reads publicly displayed search information and is not affiliated with Google. Follow applicable laws, website terms, and data-use requirements.

What happens when Google returns no usable results?

The run reports the failed query rather than fabricating rows. Results already saved for other queries remain in the dataset.

Related Actors

• Google Maps Lead Finder
• Google Search Scraper
• Booking Scraper
• Google Flights Scraper
• Tripadvisor Scraper

Support

For reproducible help, open an issue from the Actor page and include the input, run URL, expected behavior, and observed behavior. Do not include passwords, cookies, or private booking information.