# Features

### Google Hotels Search

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**

```
https://serp-api.netnut.io/search?engine=google_hotels&q=london&minPrice=100
```

**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**

```
https://serp-api.netnut.io/search?engine=google_hotels&q=london&maxPrice=300
```

**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**

```
https://serp-api.netnut.io/search?engine=google_hotels&q=london&minPrice=100&maxPrice=300
```

**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**

```
https://serp-api.netnut.io/search?engine=google_hotels&q=paris&currency=EUR
```

**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**

```
https://serp-api.netnut.io/search?engine=google_hotels&q=rome&checkInDate=2026-04-10
```

**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**

```
https://serp-api.netnut.io/search?engine=google_hotels&q=rome&checkOutDate=2026-04-15
```

**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**

```
https://serp-api.netnut.io/search?engine=google_hotels&q=rome&checkInDate=2026-04-10&checkOutDate=2026-04-15
```

**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**

```http
https://serp-api.netnut.io/search?engine=google_hotels&q=barcelona&adults=2
```

**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**

```
2,6,10
```

**Example**

```
https://serp-api.netnut.io/search?engine=google_hotels&q=barcelona&adults=2&childrenAges=4,8
```

**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**

```
https://serp-api.netnut.io/search?engine=google_hotels&q=barcelona&adults=2&childrenAges=4,8
```

**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**

```
https://serp-api.netnut.io/search?engine=google_hotels&q=amsterdam&sortBy=price
```

**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**

```
https://serp-api.netnut.io/search?engine=google_hotels&q=london&hl=en&gl=us&adults=2&childrenAges=5,9&checkInDate=2026-04-12&checkOutDate=2026-04-16&minPrice=100&maxPrice=350&currency=USD&sortBy=price
```

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**