Response Fields

This page describes the structure and meaning of fields returned by the Google Hotels API. The response contains metadata about the request and a list of hotel results extracted from Google Hotels.

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

"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

"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

"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

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

---

Hotel Object Fields

name

Name of the hotel.

"name": "CC Palace Hotel Roma"

---

tags

Special labels applied to the hotel by Google Hotels.

"tags": ["Excellent location"]

---

link

Direct Google Hotels link to the property listing.

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

---

propertyToken

Unique Google identifier representing the hotel entity.

"propertyToken": "ChoItMjNnKqkq7aGARoNL2cvMTF0NWxndDc3NxAB"

---

hotelClass

Text representation of the hotel's class rating.

"hotelClass": "4-star hotel"

---

extractedHotelClass

Numeric version of the hotel class.

"extractedHotelClass": 4

---

overallRating

Average user rating for the hotel.

"overallRating": 4.7

---

ratePerNight

Lowest nightly rate for the hotel.

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

---

totalRate

Total price for the stay based on selected dates.

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

---

reviews

Number of reviews for the hotel.

"reviews": "362"

---

amenities

List of amenities provided by the hotel.

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

---

images

List of image objects associated with the hotel.

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

---

reviewsLink

Direct link to the hotel's reviews page.

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

---

rank

Position of the hotel in the returned search results.

"rank": 1

---

Example Hotel Object

{
  "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
}