Google Hotels Scraper
Give it a city or a list of hotels plus dates and guests, and it returns Google Hotels data as JSON: one row per hotel and stay with the lowest price, total, taxes, deal note, rating, review count, star class, amenities and coordinates, and, for hotels you name, one row per booking site with its price and free-cancellation deadline. $4.49 per 1,000 hotels and $0.90 per 1,000 offers on the free plan; you pay only for rows you get.
$4.49 per 1,000 hotel rows on the Free plan, down to $2.69 on higher plans
Why this actor
- Many dates and stay lengths per run, about 20 hotels per request from Google's own data endpoint, no browser.
- Per-site offers (Booking.com, Expedia, the official site and others) with free-cancellation deadlines and a tax flag.
- Real data or a clear error. 23.0% of zerobreak's runs failed (Apify Store, 30 days to 2026-10-31). 334 of our 334 runs since 2026-10-21 succeeded (our own scheduled and test runs, counted from the Apify run history). A failed input or date is a free
errorrow with acode.
Drop-in input
Drop-in input. Input written for zerobreak/google-hotels-scraper (locations, checkInDate, checkOutDate, maxResults, includeBookingSources...) or vittuhy/google-travel-hotel-prices works as it is.
As stated in the actor’s README. The full list of accepted input names is on the Store page.
What you get
Hotel row (rowType: "hotel"): one hotel for one stay.
| Field | What it holds |
|---|---|
entityId, name, googleUrl | Google's id for the property (reuse it in hotels), its name and Google Hotels link. |
propertyType | hotel or vacation_rental. |
hotelClass, hotelClassLabel | Star class (1-5) and Google's wording, e.g. "4-star tourist hotel". |
rating, reviewCount | Google guest rating out of 5 and the number of reviews behind it. |
latitude, longitude, countryCode, address | Where it is. address comes with hotel lookups and includeOffers (never for vacation rentals). |
description, thumbnailUrl, website, checkInTime, checkOutTime | Google's summary line, a photo, the hotel's own site, check-in and check-out times. |
amenities, amenityCodes | Amenities from the result card ("Free Wi-Fi", "Pool", "Spa", ...) and Google's codes behind them. |
checkIn, checkOut, nights, adults, children, childrenAges, currency | The stay this row is about. |
available | false when Google shows no price for these dates and guests. |
pricePerNight, pricePerNightText, totalPrice | Lowest price per night (as a number and as displayed) and for the whole stay. |
pricesIncludeTaxes, totalPriceWithTaxes, priceBeforeTaxes, taxesAndFees | Whether the shown prices include taxes (Google decides per market and currency), plus Google's own split. |
deal, dealPercent | Google's deal note, e.g. "30% less than usual" or "GREAT PRICE for a 4-star hotel". |
offerCount, lowestOfferProvider | Booking sites with a price, and the cheapest one (when offers were read). |
searchLocation, searchRank, totalResults | Location searches: what you typed, the position in Google's list and Google's total. |
input | Hotel lookups: the link, token or name you gave. |
Offer row (rowType: "offer"): one booking site's price for one hotel and stay, cheapest first.
| Field | What it holds |
|---|---|
entityId, hotelName, googleUrl | The hotel the offer belongs to. |
offerRank, provider, providerId | 1 = cheapest; the booking site and Google's id for it (stable across hotels). |
isOfficialSite, featured | The hotel's own website; shown in Google's highlighted block. |
pricePerNight, pricePerNightText, totalPrice, pricesIncludeTaxes | The site's price per night and for the stay. |
freeCancellation, freeCancellationUntil, freeCancellationUntilTime | Whether the site's lowest rate can be cancelled for free, and until when. null when Google does not say. |
roomName, rateCount, cheapestFreeCancellationPrice | For sites where Google lists rooms: the cheapest room, how many rates, the cheapest refundable one. |
Sample row (from the README example; long text shortened, lists cut to two items):
{
"rowType": "hotel",
"platform": "google-hotels",
"entityId": "ChoI_uTZsvz1i6-bARoNL2cvMTFmZHB6eDEwMxAB",
"name": "The Originals Boutique, Hôtel Maison Montmartre, Paris",
"googleUrl": "https://www.google.com/travel/hotels/entity/ChoI_uTZsvz1i6-bARoNL2cvMTFmZHB6eDEwMxAB",
"propertyType": "hotel",
"hotelClass": 4,
"rating": 4,
"reviewCount": 2133,
"latitude": 48.900537,
"longitude": 2.336269,
"amenities": [
"Free Wi-Fi",
"Air conditioning"
],
"checkIn": "2026-11-10",
"checkOut": "2026-11-12",
"nights": 2,
"adults": 2,
"currency": "USD",
"available": true,
"pricePerNight": 81.75,
"totalPrice": 163.5,
"pricesIncludeTaxes": true,
"priceBeforeTaxes": 136.25,
"taxesAndFees": 27.25,
"deal": "30% less than usual",
"dealPercent": 30,
"searchLocation": "Paris",
"searchRank": 1,
"totalResults": 15000
}
Price
Live Apify price on 2026-10-31, per 1,000 rows, by Apify plan. You pay only for rows delivered; error and summary rows marked free in the README cost nothing. Plus $0.001 per GB of memory when a run starts.
| Per 1,000 | Free | Bronze | Silver | Gold | Platinum | Diamond |
|---|---|---|---|---|---|---|
| Hotel row (main) | $4.49 | $3.89 | $3.29 | $2.69 | $2.69 | $2.69 |
| Booking-site offer row | $0.90 | $0.90 | $0.90 | $0.90 | $0.90 | $0.90 |
Use cases
- Rate shopping: the lowest Google price of your hotel and its competitive set for the next 60 nights, every morning.
- Rate parity: compare the official site with Booking.com, Expedia and the rest for the same stay (
isOfficialSite,offerRank). - Destination research: what a city costs on a given weekend, by stars, rating and amenities, with Google's deal notes.
- Travel and comparison sites: fill price calendars and hotel lists with coordinates and ratings.
Run it from code or an AI agent
Actor ID arcadium/google-hotels. Set APIFY_TOKEN to your Apify API token. The input below is the actor’s prefilled example; see the guide for every field.
curl
curl -X POST "https://api.apify.com/v2/acts/arcadium~google-hotels/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"locations":["Paris"],"maxHotels":20,"checkInDates":["+30d"],"nights":[2],"language":"en","country":"us"}'JavaScript
// npm install apify-client
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('arcadium/google-hotels').call({
"locations": [
"Paris"
],
"maxHotels": 20,
"checkInDates": [
"+30d"
],
"nights": [
2
],
"language": "en",
"country": "us"
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);Python
# pip install apify-client
import os
from apify_client import ApifyClient
client = ApifyClient(os.environ["APIFY_TOKEN"])
run = client.actor("arcadium/google-hotels").call(run_input={
"locations": ["Paris"],
"maxHotels": 20,
"checkInDates": ["+30d"],
"nights": [2],
"language": "en",
"country": "us",
})
items = client.dataset(run["defaultDatasetId"]).list_items().items
print(items)MCP
{
"mcpServers": {
"apify": {
"url": "https://mcp.apify.com/?tools=arcadium/google-hotels",
"headers": {
"Authorization": "Bearer <APIFY_TOKEN>"
}
}
}
}LangChain
# pip install langchain-apify (reads APIFY_API_TOKEN from the environment)
from langchain_apify import ApifyActorsTool
tool = ApifyActorsTool("arcadium/google-hotels")
rows = tool.invoke({"run_input": {
"locations": ["Paris"],
"maxHotels": 20,
"checkInDates": ["+30d"],
"nights": [2],
"language": "en",
"country": "us",
}})
# or give `tool` to an agent: create_react_agent(llm, [tool])LlamaIndex
# pip install llama-index-readers-apify
import os
from llama_index.core import Document, VectorStoreIndex
from llama_index.readers.apify import ApifyActor
reader = ApifyActor(os.environ["APIFY_TOKEN"])
documents = reader.load_data(
actor_id="arcadium/google-hotels",
run_input={
"locations": ["Paris"],
"maxHotels": 20,
"checkInDates": ["+30d"],
"nights": [2],
"language": "en",
"country": "us",
},
dataset_mapping_function=lambda item: Document(text=str(item.get("description") or ""), metadata={"url": item.get("url")}),
)
index = VectorStoreIndex.from_documents(documents)CrewAI
# pip install crewai crewai-tools langchain-apify (reads APIFY_API_TOKEN from the environment)
from crewai import Agent
from crewai_tools import ApifyActorsTool
tool = ApifyActorsTool(actor_name="arcadium/google-hotels")
researcher = Agent(
role="Research analyst",
goal="Answer with data collected by the tool",
backstory="Uses public web data.",
tools=[tool],
)n8n
{
"nodes": [
{
"name": "Run arcadium/google-hotels",
"type": "n8n-nodes-base.httpRequest",
"typeVersion": 4,
"position": [
0,
0
],
"parameters": {
"method": "POST",
"url": "https://api.apify.com/v2/acts/arcadium~google-hotels/run-sync-get-dataset-items",
"authentication": "genericCredentialType",
"genericAuthType": "httpHeaderAuth",
"sendBody": true,
"specifyBody": "json",
"jsonBody": "{\"locations\":[\"Paris\"],\"maxHotels\":20,\"checkInDates\":[\"+30d\"],\"nights\":[2],\"language\":\"en\",\"country\":\"us\"}",
"options": {
"timeout": 300000
}
}
}
],
"connections": {}
}Google Sheets
// Extensions > Apps Script. Store your token once: Project Settings > Script properties > APIFY_TOKEN.
function importLastRun() {
const token = PropertiesService.getScriptProperties().getProperty('APIFY_TOKEN');
const url = 'https://api.apify.com/v2/acts/arcadium~google-hotels/runs/last/dataset/items?status=SUCCEEDED&clean=true&format=json';
const res = UrlFetchApp.fetch(url, { headers: { Authorization: 'Bearer ' + token } });
const rows = JSON.parse(res.getContentText());
if (!rows.length) return;
const keys = Object.keys(rows[0]);
const values = rows.map((r) => keys.map((k) => (typeof r[k] === 'object' ? JSON.stringify(r[k]) : r[k])));
const sheet = SpreadsheetApp.getActiveSheet();
sheet.clearContents();
sheet.getRange(1, 1, 1, keys.length).setValues([keys]);
sheet.getRange(2, 1, values.length, keys.length).setValues(values);
}Limitations
- Public prices as an anonymous visitor sees them from the US market by default (
country). No login, no member or app-only rates. - Google prices one room for the whole party; there is no rooms input.
- Whether the shown prices include taxes depends on Google's market and currency; read
pricesIncludeTaxesandtotalPriceWithTaxesinstead of assuming. - Relevance order changes a little between requests; use
sortBywhen you need stable ranks. amenitiescome from the search result card; hotel lookups leave them empty. A few amenity codes have no label yet and appear only inamenityCodes.- Booking links are Google ad-click links that expire within minutes, so they are not included; use
googleUrl. - The actor reads Google over Apify's shared datacenter proxy. When Google rate-limits that pool, the run retries with short pauses and, if the limit persists, stops and reports the remaining inputs as free
blockederror rows instead of burning time. Run again later.
FAQ
How do I find a hotel's entity token? It is the entityId of any row, and it is the Ch... part of a Google Hotels link (/travel/hotels/entity/<token>). A hotel name with the city works too.
Why is available false for a hotel? Google showed no price for those dates and guests (sold out, closed, or the party is too large for one room). The row is delivered because the availability is the information.
Why do the offer prices differ from the hotel row price? The hotel row has Google's headline price; offers are each site's own price for the same stay. They usually match the cheapest offer, but Google may highlight a different rate.
Something looks wrong in the output. Who do I tell? Open an issue on the actor page with the run link. We read them all.
Related actors
Agoda and Trip.com Reviews Scraper
Agoda and Trip.com hotel reviews for hotel links or IDs: score, original text, English translation, traveler type, hotel reply; $5.40 per 1,000 Agoda reviews.
$5.40 per 1,000 Agoda reviews on the Free plan, down to $2.70 on higher plans
Booking.com Reviews Scraper
Booking.com hotel reviews for hotel URLs: score, liked and disliked text, hotel reply, reviewer country, traveler type, stay details; $1.80 per 1,000 reviews.
$1.80 per 1,000 reviews on the Free plan, down to $0.81 on higher plans
Google Hotel Reviews Scraper
Google hotel reviews for hotel links or names: rating, text, translation, date, trip type, room/service/location scores, owner reply; $0.54 per 1,000 reviews.
$0.54 per 1,000 reviews on the Free plan, down to $0.27 on higher plans
Hotel Reviews Scraper
Hotel reviews from Tripadvisor, Booking.com, Google Hotels, Agoda and Trip.com in one dataset, ratings on one 1-5 scale; $4.50 per 1,000 reviews.
$4.50 per 1,000 reviews on the Free plan, down to $0.80 on higher plans
Tripadvisor Reviews Scraper
Tripadvisor reviews for hotel, restaurant and attraction URLs or place names: rating, text, date, owner reply, sub-ratings; $4.50 per 1,000 reviews.
$4.50 per 1,000 reviews on the Free plan, down to $0.80 on higher plans