Google Hotels Scraper & Price Tracker
Pricing
from $1.69 / 1,000 hotels
Google Hotels scraper and hotel price tracker: Google Hotels prices for any destination and dates — lowest price per night and for the stay with taxes, every booking site's rate with direct links (rate parity), class, rating, reviews, amenities, location. One flat row per hotel, no personal data.
Schema version
schemaVersion
Required
Version of this output schema (travel-listing/.). travel-listing/1.7 = every travel-listing/1.5 column of the travel studio, then the booking-site rates and Google columns. Columns are only added within a major version, never renamed or removed.
Platform
platform
Required
Source platform. Always "google_hotels" for this Actor; the first columns are shared by the other scrapers of the travel studio (Booking.com, Expedia, Agoda, Airbnb) so that rows from several platforms can be compared.
Google Hotels entity id
platformListingId
Required
Google Hotels entity id of the hotel (ChkI…), the id of its /travel/hotels/entity/ page. Stable key to deduplicate rows, to join several runs and to pass the hotel back in hotelUrls.
Hotel URL
url
Required
Google Hotels page of the hotel for the searched stay: /travel/hotels/entity/ with the search text (q), the dates, travellers and currency (ts), the language (hl) and the market (gl). Built by the Actor, never requested by it.
Name
title
Required
Hotel name as displayed by Google (a business name, never a person); for a vacation rental, the title written by the lister.
Property type
propertyType
Required
Class label Google shows ("5-star hotel", "Hôtel 3 étoiles" in French), else the Google type (Hotel, Hostel, Guest house, Bed and breakfast, Motel…), "Vacation rental" for rentals; null when Google gives neither.
Room type
roomType
Required
hotel_room for hotels, hostels and guest houses; entire_place for vacation rentals (apartments, houses, houseboats).
City
city
Required
City of the search as Google resolved it (the same for every hotel of a search, in the language of the search: "Lisbon", "Lisbonne"); for a hotel given by URL, the city Google attaches to it.
Region
region
Required
Not provided by Google Hotels results: always null for this Actor.
Country
country
Required
Country name in English, from countryCode.
Country code
countryCode
Required
ISO 3166-1 alpha-2 code of the country of the hotel.
Latitude
latitude
Required
Latitude of the hotel as published by Google.
Longitude
longitude
Required
Longitude of the hotel as published by Google.
Check-in
checkIn
Required
Check-in date of the priced stay (YYYY-MM-DD), as Google echoes it.
Check-out
checkOut
Required
Check-out date of the priced stay (YYYY-MM-DD).
Nights
nights
Required
Number of nights of the stay.
Guests
guests
Required
Travellers of the search: adults plus children.
Currency
currency
Required
ISO 4217 code of every price of the row (offers included), the one Google answered in.
Price per night
pricePerNight
Required
Lowest price per night for the stay, before taxes (fees included): Google's nightly price. See pricePerNightWithTaxes for the price with taxes; null when no booking site has a price for the stay.
Total price
priceTotal
Required
Lowest price of the whole stay, taxes and fees included (the total of Google's base, taxes and fees); priceTotalAllIn repeats it. Null when no booking site has a price for the stay.
Price before discount
priceBeforeDiscount
Required
Not provided: Google shows a deal note ("20% less than usual", in badges) rather than a strike-through price. Always null for this Actor.
Cleaning fee
cleaningFee
Required
Not itemised by Google Hotels: always null (fees are counted in taxesAndFees).
Service fee
serviceFee
Required
Not itemised by Google Hotels: always null (fees are counted in taxesAndFees).
Taxes and fees
taxesAndFees
Required
Taxes and fees of the stay at the lowest price: priceTotal minus the base rate.
Taxes included
taxesIncluded
Required
Whether priceTotal includes the taxes and fees: always true when there is a priceTotal (Google gives the stay with taxes and fees), null without a price.
Total price, taxes included
priceTotalAllIn
Required
Lowest price of the whole stay with taxes and fees, equal to priceTotal; null without a price. The column to compare stays across the travel scrapers of the studio.
Guest rating
rating
Required
Average guest rating on Google, on a 5-point scale (ratingMax).
Rating scale
ratingMax
Required
Maximum of the rating scale: always 5 on Google Hotels.
Reviews
reviewCount
Required
Number of Google reviews behind the rating. Review texts and authors are never collected.
Hotel class
starRating
Required
Official hotel class in stars (1 to 5); null for hostels without a class and for vacation rentals.
Bedrooms
bedrooms
Required
Vacation rentals only: number of bedrooms; null for hotels.
Beds
beds
Required
Not provided reliably by Google Hotels results: always null for this Actor.
Bathrooms
bathrooms
Required
Vacation rentals only: number of bathrooms; null for hotels.
Max guests
maxGuests
Required
Vacation rentals only: number of guests the rental sleeps; null for hotels.
Amenities
amenities
Required
Hotels: the amenities Google lists as available, as English labels (Free Wi-Fi, Pool, Parking ($), Breakfast…); vacation rentals: the available amenities Google lists, in the language of the search. Empty for a hotel given by URL (hotelUrls).
[ "Breakfast", "Free Wi-Fi", "Parking ($)", "Outdoor pool", "Air conditioning", "Restaurant", "Airport shuttle", "Full-service laundry"]Badges
badges
Required
Deal note Google shows for the stay, e.g. "20% less than usual" (in the language of the search); empty when there is none.
[ "20% less than usual"]Superhost
isSuperhost
Required
Airbnb-only column of the shared schema: always null for this Actor.
Listed by
listedBy
Required
Legal status of the lister (other platforms of the studio): always null for this Actor.
Instant book
instantBook
Required
Not provided by Google Hotels: always null.
New listing
isNew
Required
Not provided by Google Hotels: always null.
Available
isAvailable
Required
True when at least one booking site has a price for the stay; false when Google shows the hotel without a price for these dates (prices are then null).
Cancellation policy
cancellationPolicy
Required
Free cancellation, read with the booking-site rates (includeOffers, hotelUrls or freeCancellationOnly): free_cancellation_until: when a booking site shown by Google sells a rate that can be cancelled for free (the earliest deadline of those rates), free_cancellation when no deadline is readable (labels in a language other than English), null when no rate shown is free to cancel or without the booking-site rates.
Photos
imageUrls
Required
Photo URLs of the hotel shown by Google (googleusercontent.com), the first one being the main photo.
[ "https://lh3.googleusercontent.com/grass-cs/AABkmLdujg01vZaFk7NCx76fXiCl8-YyLLBABMeFGEYiTmy2EIFv4gxnfT4Oadb7cK7v1yTZqjNju8jymLbuEZTLCkWkju_7Gav6tzkFj6EAPQNfI43oBw9fplVFSYMrRsRZxvbZ7DFf=s287-w287-h192-n-k-no-v1"]Photo count
imageCount
Required
Number of photo URLs in imageUrls.
Search
searchLocation
Required
Search text that found the hotel ("hotels in Lisbon"), from searchQueries or from the q parameter of a search URL; null for a hotel given in hotelUrls.
Rank
searchRank
Required
1-based position of the hotel in the Google Hotels results of its search (Google's order, which varies between runs); null for a hotel given in hotelUrls.
Page
searchPage
Required
Results page (20 hotels each) of the search where the hotel was found; null for a hotel given in hotelUrls.
Proxy country
viewCountryCode
Required
Country of the proxy used for the request (US for the default Apify datacenter proxies). Prices follow the currency and market of the input, not the proxy.
Scraped at
scrapedAt
Required
UTC time the row was produced (ISO 8601).
Change
changeType
Required
Price-monitoring runs (monitorPrices): new (first time this hotel is seen by the search), price_changed or unchanged compared with your previous run of the same search; null otherwise.
Previous total
previousPrice
Required
Price-monitoring runs: the priceTotal recorded by the previous run, same currency; null for new or unchanged hotels and outside monitoring.
Price change
priceDelta
Required
Price-monitoring runs: priceTotal − previousPrice (negative for a drop); null otherwise.
Price change %
priceDeltaPercent
Required
Price-monitoring runs: 100 × priceDelta / previousPrice, one decimal; null otherwise.
Price per night with taxes
pricePerNightWithTaxes
Required
Lowest price per night, taxes and fees included: priceTotal divided by the nights.
Total before taxes
priceTotalBeforeTaxes
Required
Lowest price of the stay before taxes (fees included), as Google shows it next to the total with taxes.
Description
description
Required
Short description of the hotel written by Google; null for vacation rentals.
Check-in time
checkInTime
Required
Check-in time of the hotel as Google displays it ("3:00 PM", "15:00" in French); null when not shown.
Check-out time
checkOutTime
Required
Check-out time of the hotel as Google displays it; null when not shown.
Hotel website
website
Required
The hotel's own website as listed by Google; null when there is none.
Rating breakdown
ratingBreakdown
Required
Share (percent) and number of Google reviews for each number of stars, 5 to 1. Aggregates only: no review text, no author.
[ { "stars": 5, "percent": 82, "count": 224 }, { "stars": 4, "percent": 10, "count": 30 }]Google hotel id
googleHotelId
Required
Numeric Google Hotels id of the hotel.
Google Maps id
googleMapsCid
Required
Google Maps feature id (0x…:0x…) of the hotel, to join with Google Maps data.
Google Place id
googlePlaceId
Required
Google Place id (ChIJ…) of the hotel, known when the booking-site rates were fetched (includeOffers or hotelUrls); null otherwise.
Booking sites included
offersIncluded
Required
True when the rates of every booking site were fetched for this row (includeOffers, or hotelUrls); false otherwise, also when that request failed.
Booking-site rates
offers
Required
One entry per booking site for the stay, cheapest first (price of the stay with taxes): site name, site id, official site or not, price per night and of the stay before and with taxes, and the direct link to the site. Empty when not requested; capped by maxOffersPerHotel.
[ { "site": "Vio.com", "siteId": "1587851245", "isOfficialSite": false, "currency": "USD", "pricePerNight": 169.26, "pricePerNightWithTaxes": 188.08, "priceTotal": 507.77, "priceTotalWithTaxes": 564.25, "bookingUrl": "https://deals.vio.com/?sig=73aca13c7f952d2641c156f3e69125e1eb497c325f122828ee5aa8797168b9a12d32303331333438363233&turl=https%3A%2F%2Fwww.vio.com%2FHotel%2FSearch%3FcheckIn%3D2026-11-20%26checkOut%3D2026-11-23%26currency%3DUSD%26forceCurrencyChange%3D1%26lang%3Den%26forceLanguageChange%3D1%26rooms%3D2%3A%26utm_source%3Dgha%26utm_medium%3Dcpc%26hotelId%3D22249821%26userCountry%3DUS%26profile%3Dr2d2m73kn8%26preferredRate%3D564.25%26deviceType%3Ddesktop%26label%3Dsrc%253Dgha%2526cltype%253Dhotel%2526datype%253Ddefault%2526gsite%253Dlocaluniversal%2526vf%253D0%2526ucountry%253DUS%2526udevice%253Ddesktop%2526hotel%253D22249821%2526day%253D20%2526month%253D11%2526year%253D2026%2526los%253D3%2526price%253D564.25%2526currency%253DUSD%2526cid%253D%2526listid%253D%2526rateid%253DUS_D%2526closerateid%253D%2526promo%253D0%2526isPrivateRate%253D0%2526isAudienceUser%253D0%2526isPaidClick%253D0%2526%26cp%3DiiEEQLM_XUnurHdAChoI2owDGJIsIgNVU0Q6AgIBQgXZugKTflIBMhIaFaSogEQaC0JyUDAtSndIcy1VKAIwy8Pm1gY" }]Booking sites
offerCount
Required
Number of booking sites with a rate for the stay, before the maxOffersPerHotel cap; null when the rates were not fetched.
Cheapest site
cheapestOfferSite
Required
Booking site with the lowest price for the stay, taxes included; null without rates.
Cheapest site price
cheapestOfferPriceTotal
Required
Lowest price of the stay among the booking sites, taxes included.
Official site price
officialSitePriceTotal
Required
Price of the stay on the hotel's own website, taxes included (rate parity check against cheapestOfferPriceTotal); null when the hotel has no official-site rate or the rates were not fetched.