SerpApi Official

Get live Google Search data and more from SerpApi's official node

Actions72

Search Actions

Overview

This node enables users to perform live searches on Google Hotels through the SerpApi service. It allows querying hotel listings based on various parameters such as location, check-in and check-out dates, number of guests, price range, amenities, and more. This is useful for travel agencies, booking platforms, or any application that needs to fetch up-to-date hotel availability and pricing information directly from Google Hotels.

Practical examples include:

Searching for hotels in Bali with specific check-in/out dates and filtering by price or rating.
Retrieving detailed property information using a property token.
Filtering results to show only eco-certified hotels or those offering free cancellation.
Paginating through search results using next page tokens.

Properties

Name	Meaning
Search Query (q)	Defines the search query, e.g., "Bali Resorts". Can be any valid Google Hotels search term.
Check-in Date (check_in_date)	The check-in date in YYYY-MM-DD format, e.g., "2025-08-05".
Check-out Date (check_out_date)	The check-out date in YYYY-MM-DD format, e.g., "2025-08-06".
Country (gl)	Country code to use for the search, e.g., "us" for United States. Many country options available.
Language (hl)	Language code for the search results, e.g., "en" for English. Multiple language options supported.
Currency (currency)	Currency code for returned prices, e.g., "USD" for US Dollar. Many currency options supported.
Number of Adults (adults)	Number of adults for the booking; defaults to 2.
Number of Children (children)	Number of children; defaults to 0.
Children's Ages (children_ages)	Comma-separated ages of children, must match the number of children, e.g., "5,8,10". Age range 1-17, under 1 considered as 1.
Sort By (sort_by)	Sorting criteria for results: "Lowest price", "Highest rating", or "Most reviewed".
Min. Price (min_price)	Lower bound of price range filter.
Max. Price (max_price)	Upper bound of price range filter.
Property Types (property_types)	Filter to include only certain property types, specified by comma-separated IDs, e.g., "10,12,20".
Amenities (amenities)	Filter to include only properties offering specified amenities, comma-separated IDs, e.g., "5,13,21".
Guest Rating (rating)	Filter results by minimum guest rating: 3.5+, 4.0+, or 4.5+.
Brands (brands)	Filter search to specific brands by their IDs, comma-separated, e.g., "33,67,101". Not available for Vacation Rentals.
Hotel Class (hotel_class)	Filter by hotel star class, e.g., "2,3,4" for 2-star to 4-star hotels. Not available for Vacation Rentals.
Free Cancellation (free_cancellation)	Boolean to show only results offering free cancellation. Not available for Vacation Rentals.
Special Offers (special_offers)	Boolean to show only results with special offers. Not available for Vacation Rentals.
Eco Certified (eco_certified)	Boolean to show only eco-certified properties. Not available for Vacation Rentals.
Vacation Rentals (vacation_rentals)	Boolean to search specifically for vacation rental properties.
Min. bedrooms (bedrooms)	Minimum number of bedrooms; applicable only for Vacation Rentals. Defaults to 0.
Min. bathrooms (bathrooms)	Minimum number of bathrooms; applicable only for Vacation Rentals. Defaults to 0.
Next Page Token (next_page_token)	Token used to retrieve the next page of results for pagination.
Property Token (property_token)	Token to get detailed property information including name, address, phone, prices, nearby places, etc. Obtained from Google Hotels Properties API.
JSON Restrictor (json_restrictor)	Restricts fields returned in the response, e.g., "organic_results[].{title,snippet}" to limit output fields.
Disable Caching (no_cache)	Boolean to force fetching new results instead of cached ones. Cache expires after 1 hour. Cannot be used with async.
Async (async)	Boolean to perform search asynchronously. If true, results must be retrieved later via Search Archive API. Cannot be used with no_cache or on accounts with Ludicrous Speed enabled.
ZeroTrace Mode (zero_trace)	Boolean to enable ZeroTrace mode (Enterprise only), which skips storing search parameters and metadata on servers for privacy.
Output (output)	Defines final output format: "json" (default) for structured JSON or "html" for raw HTML.

Output

The node outputs a JSON object containing the search results from Google Hotels according to the specified parameters. The structure includes hotel listings, property details, pricing, ratings, amenities, and other relevant data depending on the query.

If the output parameter is set to "html", the node returns the raw HTML content of the search results instead of JSON.

No binary data output is indicated.

Dependencies

Requires an active API key credential for SerpApi to authenticate requests.
Internet access to connect to SerpApi's endpoint at https://serpapi.com/search.json.
Proper configuration of the API key credential within n8n.

Troubleshooting

Missing or invalid API key: The node will fail if the API key credential is not provided or invalid. Ensure the API key is correctly configured.
Invalid date formats: Check-in and check-out dates must be in YYYY-MM-DD format. Incorrect formats may cause errors or empty results.
Mismatch in children count and ages: The number of children's ages provided must match the number of children specified.
Conflicting parameters: Using no_cache and async together is not allowed and will cause errors.
Pagination issues: When using next_page_token, ensure the token is valid and corresponds to the previous result set.
Unsupported filters for Vacation Rentals: Some filters like brands, hotel class, free cancellation, special offers, and eco certification are not applicable to vacation rentals and may be ignored or cause unexpected results.
Async mode limitations: Async mode requires retrieving results later via Search Archive API and is incompatible with some account features.