Google Hotels Scraper

Pulls hotel listings from Google Hotels into a structured dataset. Useful for price monitoring, travel research, competitor analysis, and building accommodation comparison tools.

What it does

Search hotels by destination and date range. Returns property details with prices, ratings, amenities, nearby places, and review breakdowns. Optionally fetches per-vendor booking prices (Booking.com, Expedia, Hotels.com, etc.) for each property.

Example use cases

• Monitor hotel prices for a destination over time
• Compare prices across vendors for the same hotel
• Research hotel availability and ratings in a city
• Find 5-star hotels with free cancellation under a budget
• Build a travel price tracker or accommodation comparison tool

Input

Field	Description	Default
searchQuery	Destination or hotel query (e.g., "hotels in Paris")	required
checkInDate	Check-in date in YYYY-MM-DD format	required
checkOutDate	Check-out date in YYYY-MM-DD format	required
sortBy	3=Lowest price, 8=Highest rating, 13=Most reviewed	3
minPrice	Minimum price per night filter	—
maxPrice	Maximum price per night filter	—
minRating	7=3.5+, 8=4.0+, 9=4.5+ guest rating	—
hotelClass	Minimum star class (2–5)	—
amenities	Comma-separated amenity codes (e.g., "27,22" for WiFi + pool)	—
freeCancellation	Return only free-cancellation properties	false
ecoCertified	Return only eco-certified properties	false
includeBookingSources	Fetch per-vendor prices for each hotel	false
currency	Price currency code (e.g., "USD", "EUR", "GBP")	USD
language	Language code (e.g., "en", "fr", "de")	en
country	Country code for geo-targeting	us
maxItems	Max hotels to return	20
requestTimeoutSecs	Per-request timeout	30

Common amenity codes

Code	Amenity
1	Fitness centre
2	Bar
4	Restaurant
6	Free breakfast
22	Pool
27	Free WiFi
31	Airport shuttle

Example input

{
  "searchQuery": "hotels in Paris",
  "checkInDate": "2025-09-20",
  "checkOutDate": "2025-09-25",
  "sortBy": 3,
  "minRating": 8,
  "hotelClass": 4,
  "amenities": "27,22",
  "freeCancellation": true,
  "currency": "EUR",
  "maxItems": 30
}

Output

Each hotel is one dataset record:

Field	Description
hotelName	Property name
propertyType	"hotel" or "vacation rental"
hotelDescription	Short property description
gpsLatitude / gpsLongitude	GPS coordinates
hotelClass	Star label (e.g., "4-star hotel")
starRating	Numeric star rating (2–5)
overallRating	Guest overall rating (0–5)
reviewCount	Total guest reviews
checkInTime	Check-in time (e.g., "3:00 PM")
checkOutTime	Check-out time (e.g., "12:00 PM")
pricePerNight	Nightly rate (numeric)
pricePerNightDisplay	Nightly rate (formatted, e.g., "$381")
totalRate	Total stay cost (numeric)
totalRateDisplay	Total stay cost (formatted)
currency	Currency code
amenityCodes	List of amenity codes
images	Thumbnail image URLs
ratingsBreakdown	Star distribution (1–5 star percentages)
reviewsBreakdown	Sentiment by category (service, location, etc.)
nearbyPlaces	Points of interest with transit times
detailToken	Token for booking sources lookup
bookingSources	Per-vendor prices (if includeBookingSources: true)
checkInDate / checkOutDate	Searched dates
scrapedAt	ISO 8601 timestamp

Booking source object fields

Field	Description
vendorName	Booking platform name (e.g., "Booking.com")
vendorIcon	Vendor logo URL
isSponsored	True if this is a paid listing
numGuests	Number of guests the price covers
ratePerNight	Nightly rate (numeric)
ratePerNightDisplay	Nightly rate (formatted)
totalRate	Total rate (numeric)
totalRateDisplay	Total rate (formatted)
bookingUrl	Redirect URL to complete booking

Example output

{
  "hotelName": "Four Seasons Hotel George V, Paris",
  "propertyType": "hotel",
  "hotelDescription": "Iconic luxury hotel near the Champs-Elysees with Michelin-starred dining.",
  "gpsLatitude": 48.8731,
  "gpsLongitude": 2.3024,
  "hotelClass": "5-star hotel",
  "starRating": 5,
  "overallRating": 4.8,
  "reviewCount": 6392,
  "checkInTime": "3:00 PM",
  "checkOutTime": "12:00 PM",
  "pricePerNight": 2253.24,
  "pricePerNightDisplay": "$2,253",
  "totalRate": null,
  "totalRateDisplay": null,
  "currency": "USD",
  "amenityCodes": [1, 2, 4, 22, 27],
  "ratingsBreakdown": [
    { "stars": 5, "percent": 90, "count": 6392 },
    { "stars": 4, "percent": 7, "count": 447 }
  ],
  "reviewsBreakdown": [
    { "name": "Service", "sentiment": 0.79, "total_mentioned": 2926, "positive": 1, "negative": 2772 },
    { "name": "Wellness", "sentiment": 0.63, "total_mentioned": 46 }
  ],
  "nearbyPlaces": [
    { "name": "Arc de Triomphe", "transportations": [{ "type": 3, "duration": "7 min" }] }
  ],
  "bookingSources": [
    {
      "vendorName": "Booking.com",
      "isSponsored": false,
      "numGuests": 2,
      "ratePerNight": 2253.24,
      "ratePerNightDisplay": "$2,253",
      "bookingUrl": "https://..."
    }
  ],
  "checkInDate": "2025-09-20",
  "checkOutDate": "2025-09-25",
  "scrapedAt": "2025-06-01T14:32:00+00:00"
}

Notes

• Results paginate automatically up to your maxItems limit
• includeBookingSources: true makes one extra request per hotel
• sortBy options: 3=lowest price, 8=highest rating, 13=most reviewed
• Transportation types in nearbyPlaces: 0=walk, 2=transit, 3=taxi/rideshare
• reviewsBreakdown sentiment is a 0–1 score (higher = more positive mentions)
• totalRate covers the full stay cost and may not always be present depending on the property