# Response Fields

## Field Summary

The table below provides a quick overview of the main fields returned by the Google Hotels API response.

| Field   | Type   | Description                                                      |
| ------- | ------ | ---------------------------------------------------------------- |
| url     | string | Final Google Hotels search URL used to retrieve the results.     |
| general | object | Metadata about the search environment and request configuration. |
| input   | object | Information about the original request processed by the API.     |
| hotels  | array  | List of hotel result objects extracted from Google Hotels.       |

***

## Hotel Object Fields Summary

Each element inside the `hotels` array contains the following fields:

| Field               | Type    | Description                                                     |
| ------------------- | ------- | --------------------------------------------------------------- |
| name                | string  | Name of the hotel.                                              |
| tags                | array   | Labels assigned by Google Hotels such as location highlights.   |
| link                | string  | Direct Google Hotels link to the property listing.              |
| propertyToken       | string  | Unique Google identifier representing the hotel entity.         |
| hotelClass          | string  | Text representation of the hotel's star rating.                 |
| extractedHotelClass | integer | Numeric version of the hotel class.                             |
| overallRating       | float   | Average rating for the hotel.                                   |
| ratePerNight        | object  | Information about the lowest nightly rate.                      |
| totalRate           | object  | Information about the total stay price based on selected dates. |
| reviews             | string  | Total number of reviews displayed by Google Hotels.             |
| amenities           | array   | List of hotel amenities.                                        |
| images              | array   | List of hotel image objects.                                    |
| reviewsLink         | string  | Direct link to the hotel's reviews page.                        |
| rank                | integer | Position of the hotel in the search results.                    |

***

## Top-Level Fields

### url

The final Google Hotels URL used to retrieve the results.

This URL reflects the fully constructed search query including filters, location targeting, and encoded Google parameters.

**Example**

```json
"url": "https://www.google.com/travel/search?..."
```

***

### general

Metadata describing the request environment and search configuration.

#### Fields

| Field        | Description                               |
| ------------ | ----------------------------------------- |
| searchEngine | Search engine used for the request.       |
| language     | Language used in the request.             |
| device       | Device type used for the request.         |
| searchType   | Type of search performed.                 |
| pageTitle    | Title of the Google Hotels results page.  |
| timestamp    | Timestamp when the request was processed. |
| render       | Indicates whether rendering was enabled.  |

**Example**

```json
"general": {
  "searchEngine": "google_hotels",
  "language": "en",
  "device": "desktop",
  "searchType": "text",
  "pageTitle": "rome - Google Hotel Search",
  "timestamp": "2026-03-10T13:29:47.328468801Z",
  "render": false
}
```

***

### input

Information about the original request processed by the API.

#### Fields

| Field       | Description                                              |
| ----------- | -------------------------------------------------------- |
| originalUrl | Google search URL generated from the request parameters. |
| jobId       | Unique identifier assigned to the scraping job.          |

**Example**

```json
"input": {
  "originalUrl": "https://www.google.com/search?...",
  "jobId": "b40c5eab-2694-4aa8-9114-68096e05102e"
}
```

***

## Hotels Array

The `hotels` field contains a list of hotel objects extracted from Google Hotels.

Each object represents a single hotel listing.

**Example**

```json
"hotels": [
  { ...hotel object... }
]
```

***

## Hotel Object Fields

### name

Name of the hotel.

```json
"name": "CC Palace Hotel Roma"
```

***

### tags

Special labels applied to the hotel by Google Hotels.

```json
"tags": ["Excellent location"]
```

***

### link

Direct Google Hotels link to the property listing.

```json
"link": "https://www.google.com/travel/hotels/entity/..."
```

***

### propertyToken

Unique Google identifier representing the hotel entity.

```json
"propertyToken": "ChoItMjNnKqkq7aGARoNL2cvMTF0NWxndDc3NxAB"
```

***

### hotelClass

Text representation of the hotel's class rating.

```json
"hotelClass": "4-star hotel"
```

***

### extractedHotelClass

Numeric version of the hotel class.

```json
"extractedHotelClass": 4
```

***

### overallRating

Average user rating for the hotel.

```json
"overallRating": 4.7
```

***

### ratePerNight

Lowest nightly rate for the hotel.

```json
"ratePerNight": {
  "lowest": "$126",
  "extractedLowest": 126
}
```

***

### totalRate

Total price for the stay based on selected dates.

```json
"totalRate": {
  "lowest": "$156 total",
  "extractedLowest": 156
}
```

***

### reviews

Number of reviews for the hotel.

```json
"reviews": "362"
```

***

### amenities

List of amenities provided by the hotel.

```json
"amenities": [
  "Free Wi-Fi",
  "Restaurant",
  "Air conditioning"
]
```

***

### images

List of image objects associated with the hotel.

```json
"images": [
  {
    "thumbnail": "https://lh3.googleusercontent.com/..."
  }
]
```

***

### reviewsLink

Direct link to the hotel's reviews page.

```json
"reviewsLink": "https://www.google.com/travel/hotels/entity/.../reviews"
```

***

### rank

Position of the hotel in the returned search results.

```json
"rank": 1
```

***

### Example Hotel Object

```json
{
  "name": "CC Palace Hotel Roma",
  "tags": ["Excellent location"],
  "propertyToken": "ChoItMjNnKqkq7aGARoNL2cvMTF0NWxndDc3NxAB",
  "hotelClass": "4-star hotel",
  "extractedHotelClass": 4,
  "overallRating": 4.7,
  "ratePerNight": {
    "lowest": "$126",
    "extractedLowest": 126
  },
  "totalRate": {
    "lowest": "$156 total",
    "extractedLowest": 156
  },
  "reviews": "362",
  "amenities": [
    "Free Wi-Fi",
    "Restaurant"
  ],
  "images": [
    {
      "thumbnail": "https://lh3.googleusercontent.com/..."
    }
  ],
  "reviewsLink": "https://www.google.com/travel/hotels/entity/.../reviews",
  "rank": 1
}
```