Google Hotels & Vacation Rentals Scraper

Collect public Google Hotels and Vacation Rentals search results, property details, prices, reviews, and photos. Run location searches in batches or look up specific Google Hotels entity URLs.

Why use this scraper?

• Search hotels, vacation rentals, or both
• Run several destinations or stay dates in one Actor run
• Apply hotel price, class, guest-rating, and amenity filters
• Add property details and reviews to search results
• Look up specific hotel entity URLs with details and available gallery photos
• Receive strict dataset records with explicit partial-result status

Use cases

• Monitor hotel prices across locations and dates
• Compare vacation rental prices across booking platforms
• Build accommodation databases for travel analytics
• Track pricing trends for specific properties or areas
• Feed hotel data into alerting or recommendation pipelines

How to use

Basic hotel search

{
  "searches": [
    { "location": "Hue", "checkInDate": "2026-10-15", "checkOutDate": "2026-10-18" }
  ],
  "type": "hotels"
}

Vacation rentals only

{
  "type": "vacation_rentals",
  "searches": [
    { "location": "Paris", "checkInDate": "2026-10-15", "checkOutDate": "2026-10-22" }
  ]
}

Batch searches

{
  "searches": [
    { "location": "Paris", "checkInDate": "2026-10-15", "checkOutDate": "2026-10-18" },
    { "location": "Paris", "checkInDate": "2026-11-12", "checkOutDate": "2026-11-15" },
    { "location": "Tokyo", "checkInDate": "2026-12-03", "checkOutDate": "2026-12-06" }
  ]
}

With filters

{
  "searches": [
    { "location": "Hue", "checkInDate": "2026-10-15", "checkOutDate": "2026-10-18" }
  ],
  "type": "hotels",
  "maxPrice": 100,
  "currency": "USD",
  "hotelClass": [4, 5],
  "guestRating": "4.0",
  "amenities": ["Pool", "Free Wi-Fi"],
  "sortBy": "price_low",
  "adults": 2,
  "rooms": 1
}

With details and reviews

{
  "searches": [
    { "location": "Hue", "checkInDate": "2026-10-15", "checkOutDate": "2026-10-18" }
  ],
  "type": "hotels",
  "includeDetails": true,
  "includeReviews": true,
  "maxResults": 10
}

Lookup specific hotels by URL

{
  "hotelUrls": [
    "https://www.google.com/travel/hotels/entity/ChkIq_atzbv20-8ZGg0vZy8xMXFoMzRoa3pfEAE"
  ],
  "searches": [
    { "location": "Tokyo", "checkInDate": "2026-10-15", "checkOutDate": "2026-10-18" }
  ],
  "currency": "VND",
  "includeReviews": true,
  "maxReviewsPerHotel": 100,
  "reviewSort": "highest_score",
  "maxPhotosPerHotel": 0
}

Reviews with sorting and search

{
  "hotelUrls": [
    "https://www.google.com/travel/hotels/entity/ChkIq_atzbv20-8ZGg0vZy8xMXFoMzRoa3pfEAE"
  ],
  "searches": [
    { "location": "Tokyo", "checkInDate": "2026-10-15", "checkOutDate": "2026-10-18" }
  ],
  "includeReviews": true,
  "maxReviewsPerHotel": 50,
  "reviewSort": "highest_score",
  "reviewSearch": "breakfast"
}

Multiple guests

{
  "searches": [
    { "location": "Bali", "checkInDate": "2026-10-15", "checkOutDate": "2026-10-22" }
  ],
  "type": "vacation_rentals",
  "adults": 4,
  "children": 2,
  "rooms": 2
}

Input

Field	Type	Default	Description
hotelUrls	string[]		HTTPS Google Hotels entity URLs. Starts lookup mode, deduplicated by entity token
searches	array		{ location, checkInDate, checkOutDate } entries. Required for search mode; lookup uses the first entry's dates
type	enum	both	hotels, vacation_rentals, both
adults	integer	2	Adult guests (1-9)
children	integer	0	Child guests (0-9)
rooms	integer	1	Number of rooms (1-9)
currency	string	USD	Three-letter price currency code, normalized to uppercase
minPrice	integer		Minimum price per night in the selected currency
maxPrice	integer		Maximum price per night in the selected currency
hotelClass	integer[]		Star levels: [2, 3, 4, 5]
guestRating	enum		3.5, 4.0, 4.5
amenities	string[]		Free Wi-Fi, Free breakfast, Restaurant, Bar, Kid-friendly, Pet-friendly, Free parking, Parking, EV charger, Room service, Fitness center, Spa, Pool, Indoor pool, Outdoor pool, Air-conditioned, Wheelchair accessible, Beach access, All-inclusive available
sortBy	enum	relevance	relevance, price_low, price_high, rating
maxResults	integer	50	Maximum results per location and property type
includeDetails	boolean	false	Add booking links, amenities, descriptions, and related detail data to search results
includeReviews	boolean	false	Add available reviews to each property
maxReviewsPerHotel	integer	40	Maximum reviews per property. 0 continues until no page remains
reviewSort	enum	most_helpful	most_helpful, most_recent, highest_score, lowest_score
reviewSearch	string		Free-text search within reviews (e.g. "breakfast", "clean rooms")
maxPhotosPerHotel	integer	0	Lookup mode only. 0 continues until no gallery page remains
proxyConfiguration	object	{"useApifyProxy":true}	Optional connection settings managed by Apify

Hotel-only filters and non-relevance sorting require type: "hotels". Vacation-rental and both searches reject those settings instead of ignoring them.

Exact duplicate location-and-date searches are rejected. Non-default guest or room counts are supported for base searches, but cannot be combined with includeDetails: true because property-detail prices use the default two-adult occupancy.

When hotelUrls is present, lookup mode takes precedence. Property details are required to return a lookup record. After details load, the Actor attempts web results, photo categories, gallery photos, and optional reviews; failures in those optional sections produce a partial record. Search-only filters, sorting, multiple stay entries, occupancy changes, and maxResults are rejected in this mode. If searches is omitted, lookup uses tomorrow and the following day. Duplicate entity tokens produce one canonical property record.

An empty input is rejected. Provide at least one search or hotel URL.

Real output

This is the complete, unchanged dataset record from a one-result New York hotel run on July 30, 2026. Property availability and values can change between runs.

{
  "searchType": "hotel",
  "url": "https://www.google.com/travel/hotels/entity/ChYIjrDskJ36j9gtGgovbS8wamtfbnZwEAE",
  "location": "New York",
  "checkInDate": "2026-09-28",
  "checkOutDate": "2026-10-01",
  "name": "Hotel Edison",
  "propertyId": null,
  "placeId": null,
  "starRating": 4,
  "propertyType": null,
  "latitude": 40.7597355,
  "longitude": -73.9861511,
  "distance": null,
  "pricePerNight": 257,
  "totalPrice": 772,
  "currency": "USD",
  "priceLabel": "$257",
  "reviewScore": 3.8,
  "reviewCount": 8462,
  "reviewSource": null,
  "thumbnailUrl": null,
  "photos": [],
  "amenities": [],
  "ecoBadge": false,
  "sleeps": null,
  "bedrooms": null,
  "bathrooms": null,
  "hashId": null,
  "highlights": [],
  "capacity": [],
  "featured": false,
  "phone": null,
  "website": null,
  "countryCode": null,
  "address": null,
  "neighborhood": null,
  "neighborhoodDescription": null,
  "neighborhoodScores": [],
  "ratingDistribution": [],
  "aspectSentiments": [],
  "externalReviewSources": [],
  "bookingLinks": [],
  "description": null,
  "roomTypes": [],
  "checkInTime": null,
  "checkOutTime": null,
  "reviews": [],
  "nearbyHotels": [],
  "sponsoredHotels": [],
  "nearbyVacationRentals": [],
  "nearbyPlaces": [],
  "nearbyBusinesses": [],
  "priceHistory": null,
  "priceBreakdown": null,
  "originalPricePerNight": null,
  "originalTotalPrice": null,
  "reviewSummaryPositive": null,
  "reviewSummaryNegative": null,
  "featuredReviewSnippets": [],
  "locationHierarchy": [],
  "googleCategory": null,
  "inclusivityLabels": [],
  "featuredIn": [],
  "webResults": [],
  "photoCategories": [],
  "dataStatus": "complete",
  "failedSections": []
}

Output

Each property is written to the default dataset as a consistent record. Every top-level field is present. Unavailable values are represented by null or an empty array rather than invented values.

dataStatus is complete when all requested sections finished. It is partial when a requested enrichment failed, and failedSections names those sections. A complete record can still contain nullable fields when the source has no value.

Search records follow input order. For type: "both", hotels are processed before vacation rentals for each stay. Results within each search use the requested ordering. URL lookups follow the first occurrence of each unique entity token.

Core fields

The table summarizes the identity, context, price, and status fields. The Actor dataset schema is the complete machine-readable contract.

Field	Type	Description
searchType	string	"hotel" or "vacation_rental"
url	string	Public Google Hotels property URL
location	string or null	Search location or resolved lookup location
checkInDate	string	Check-in date
checkOutDate	string	Check-out date
name	string	Property name
propertyId	string or null	Google property ID when available
placeId	string or null	Google Place ID when available
starRating	number or null	Hotel class when available
propertyType	string or null	Property category
latitude	number	GPS latitude
longitude	number	GPS longitude
distance	string or null	Source-provided distance label
pricePerNight	number or null	Price per night
totalPrice	number or null	Total price for the stay
currency	string	Currency code
priceLabel	string or null	Source-provided price label
reviewScore	number or null	Aggregate review score
reviewCount	integer or null	Aggregate review count
reviewSource	string or null	Aggregate rating source
thumbnailUrl	string or null	Property thumbnail
photos	array	Deduplicated { url, label, categoryIds } entries
amenities	string[]	Available amenity names
hashId	string or null	Source identifier when available
highlights	string[]	Source-provided property highlights
capacity	string[]	Vacation-rental capacity labels
sleeps	integer or null	Vacation-rental guest capacity
bedrooms	integer or null	Vacation-rental bedroom count
bathrooms	number or null	Vacation-rental bathroom count
featured	boolean	Featured flag
ecoBadge	boolean	Eco marker when returned in property details
dataStatus	string	"complete" or "partial"
failedSections	string[]	Any failed details, reviews, webResults, photoCategories, or photos sections

Detail and lookup fields

Search mode populates these fields when includeDetails is true. Lookup mode always attempts property details. webResults, photoCategories, and full gallery pagination are lookup-only sections.

Field	Type	Description
address	string or null	Full street address
phone	string or null	Phone number
website	string or null	Hotel website URL
countryCode	string or null	Country code when available
description	string or null	Property description
checkInTime	string or null	Check-in time
checkOutTime	string or null	Check-out time
amenities	string[]	Available amenities with human-readable names
neighborhood	string or null	Neighborhood name
neighborhoodDescription	string or null	Short neighborhood description
neighborhoodScores	array	{ category, rating } - 5 neighborhood category scores
ratingDistribution	array	{ stars, count } - star breakdown (5★ through 1★)
aspectSentiments	array	{ aspect, score, positive, negative, total } - e.g. Breakfast, Service, Location
externalReviewSources	array	{ source, rating, maxRating, count } entries
bookingLinks	array	{ provider, price, url, logoUrl, isOfficialSite, freeCancellation, freeCancellationDeadline }
roomTypes	array	{ name, price } - room types with pricing
priceHistory	object or null	Current and typical price values when available
priceBreakdown	object or null	Base price, taxes, fees, and total with taxes when available
originalPricePerNight	number or null	Original nightly price before a displayed discount
originalTotalPrice	number or null	Original stay total before a displayed discount
reviewSummaryPositive	string or null	Positive review summary
reviewSummaryNegative	string or null	Negative review summary
featuredReviewSnippets	string[]	Source-provided review snippets
locationHierarchy	array	Resolved location names and identifiers
googleCategory	string or null	Source-provided Google category
inclusivityLabels	string[]	Source-provided inclusivity labels
featuredIn	string[]	Editorial mentions (e.g. "Featured in Best Hotels in Tokyo with a View")
webResults	array	Related { title, url, snippet, domain, favicon } results
photoCategories	array	{ categoryId, name, count, thumbnailUrl } - photo gallery category summary
nearbyPlaces	array	{ name, photoUrl, rating, reviewCount, description, latitude, longitude, category, travelTimes } - POIs with travel times
nearbyBusinesses	array	{ placeId, name, category, rating, reviewCount, phone, website, reservationUrl, photoUrl, priceRange, hours }
nearbyHotels	array	Similar hotels (NearbyHotel type)
sponsoredHotels	array	Sponsored/popular hotels (NearbyHotel type)
nearbyVacationRentals	array	Nearby vacation rentals (NearbyHotel type)

Review fields

Reviews are populated only when includeReviews is true. maxReviewsPerHotel applies per property after deduplication.

Field	Type	Description
reviews	array	Review entries (see below)

Each review:

Field	Type	Description
source	string	Review provider
author	string	Reviewer name
authorUrl	string or null	Profile URL
avatarUrl	string or null	Profile photo URL
rating	number	Rating (1-5)
maxRating	number	Provider rating scale
text	string	Full review text
date	string	Relative date ("3 months ago")
reviewId	string or null	Provider review ID used for deduplication
reviewUrl	string or null	Direct review URL when available
subRatings	array	{ category, score, maxScore } entries
photos	string[]	Review photo URLs
highlights	string[]	Hotel tags ("Luxury", "Romantic", "Great value")
replyText	string or null	Owner reply text

Run outcomes

A valid search with no matches succeeds with an empty dataset. In a batch, one failed search or lookup does not discard successful work; the run logs a warning. The Actor fails when every requested work item fails or when it cannot persist dataset records.

Optional enrichment failures preserve the base property record with dataStatus: "partial". A URL lookup cannot return a record when its required property details are unavailable. Use failedSections to decide whether to retry or accept a partial record.

Responsible use

The Actor collects public accommodation data. Review records can contain names, profile links, photos, and free text. Store only what you need, limit access and retention, and follow the source terms and laws that apply to your use.