Arcadium Data Scrapers
Home / Actors / Google Hotels Scraper

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

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.

FieldWhat it holds
entityId, name, googleUrlGoogle's id for the property (reuse it in hotels), its name and Google Hotels link.
propertyTypehotel or vacation_rental.
hotelClass, hotelClassLabelStar class (1-5) and Google's wording, e.g. "4-star tourist hotel".
rating, reviewCountGoogle guest rating out of 5 and the number of reviews behind it.
latitude, longitude, countryCode, addressWhere it is. address comes with hotel lookups and includeOffers (never for vacation rentals).
description, thumbnailUrl, website, checkInTime, checkOutTimeGoogle's summary line, a photo, the hotel's own site, check-in and check-out times.
amenities, amenityCodesAmenities from the result card ("Free Wi-Fi", "Pool", "Spa", ...) and Google's codes behind them.
checkIn, checkOut, nights, adults, children, childrenAges, currencyThe stay this row is about.
availablefalse when Google shows no price for these dates and guests.
pricePerNight, pricePerNightText, totalPriceLowest price per night (as a number and as displayed) and for the whole stay.
pricesIncludeTaxes, totalPriceWithTaxes, priceBeforeTaxes, taxesAndFeesWhether the shown prices include taxes (Google decides per market and currency), plus Google's own split.
deal, dealPercentGoogle's deal note, e.g. "30% less than usual" or "GREAT PRICE for a 4-star hotel".
offerCount, lowestOfferProviderBooking sites with a price, and the cheapest one (when offers were read).
searchLocation, searchRank, totalResultsLocation searches: what you typed, the position in Google's list and Google's total.
inputHotel lookups: the link, token or name you gave.

Offer row (rowType: "offer"): one booking site's price for one hotel and stay, cheapest first.

FieldWhat it holds
entityId, hotelName, googleUrlThe hotel the offer belongs to.
offerRank, provider, providerId1 = cheapest; the booking site and Google's id for it (stable across hotels).
isOfficialSite, featuredThe hotel's own website; shown in Google's highlighted block.
pricePerNight, pricePerNightText, totalPrice, pricesIncludeTaxesThe site's price per night and for the stay.
freeCancellation, freeCancellationUntil, freeCancellationUntilTimeWhether the site's lowest rate can be cancelled for free, and until when. null when Google does not say.
roomName, rateCount, cheapestFreeCancellationPriceFor 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,000FreeBronzeSilverGoldPlatinumDiamond
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

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

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