Features

A detailed overview of the Google Hotels capabilities

The ts parameter is the main Google Hotels search state parameter.

It preserves and applies Google Hotels filters, stay details, and internal search context. This parameter is typically generated by Google and can represent advanced search configurations that are not fully exposed through simpler parameters.

Parameter

ts: string

Example

https://serp-api.netnut.io/search?engine=google_hotels&q=uk&hl=en&gl=us&ts=CAESBgoCCAMQARogCgIaABIaEhQKBwjqDxADGBoSBwjqDxADGBwYAjICCAEqDQoLOgNVU0RiAggBGgA

Use Cases

  • Preserve Google Hotels search context

  • Reproduce a specific Google Hotels results page

  • Apply advanced filters from an existing Google Hotels URL


Pricing

Minimum Price

Defines the minimum hotel price returned in the results.

Parameter

minPrice: integer

Example

Use Cases

  • Remove budget listings below a target threshold

  • Focus on mid-range or premium properties

  • Apply price floor filtering


Maximum Price

Defines the maximum hotel price returned in the results.

Parameter

maxPrice: integer

Example

Use Cases

  • Stay within a target budget

  • Exclude high-end properties

  • Narrow results to affordable hotel options


Price Range Filtering

You can combine minimum and maximum price filters to restrict results to a specific price range.

Parameters

minPrice: integer maxPrice: integer

Example

Use Cases

  • Budget window filtering

  • Mid-market hotel analysis

  • Price-based travel comparisons


Currency

Defines the currency used for hotel prices in the results.

Parameter

currency: string

Example

Use Cases

  • Normalize hotel pricing across regions

  • Compare prices in a specific currency

  • Localized travel pricing analysis


Dates

Check-in Date

Defines the hotel check-in date.

The value must be sent in YYYY-MM-DD format.

Parameter

checkInDate: string

Example

Use Cases

  • Time-specific hotel availability

  • Future stay searches

  • Travel planning workflows


Check-out Date

Defines the hotel check-out date.

The value must be sent in YYYY-MM-DD format.

Parameter

checkOutDate: string

Example

Use Cases

  • Multi-night stay searches

  • Date-based hotel comparisons

  • Travel itinerary planning


Stay Dates

Defines the full stay period by combining check-in and check-out dates.

Parameters

checkInDate: string checkOutDate: string

Example

Use Cases

  • Full stay pricing

  • Night-by-night booking comparisons

  • Accurate hotel availability retrieval


Occupancy

Adults

Defines the number of adults included in the stay.

Parameter

adults: integer

Example

Use Cases

  • Single traveler searches

  • Couple bookings

  • Group occupancy filtering


Children Ages

Allows you to include children in the hotel search.

Ages should be sent as comma-separated values.

Parameter

childrenAges: string

Format

Example

Use Cases

  • Family travel searches

  • Occupancy-aware hotel filtering

  • Child-friendly room availability checks


Occupancy

Defines the full guest configuration by combining adults and children.

Parameters

adults: integer childrenAges: string

Example

Use Cases

  • Family booking flows

  • Vacation package analysis

  • Accurate room capacity matching


Sorting

sortBy

Controls how hotel results are ordered in the response.

Parameter

sortBy: string

Example

Use Cases

  • Cheapest hotel discovery

  • Ranked hotel comparisons

  • Order results based on preferred travel criteria


Combined Example

You can combine multiple parameters to create a more precise Google Hotels search.

Example

This request will:

  • search Google Hotels for london

  • use English results for the US market

  • search for 2 adults and 2 children

  • set a stay from April 12 to April 16, 2026

  • filter prices between 100 and 350

  • return prices in USD

  • sort the results by price

Last updated