Google hotel results schema - cloro
Google hotel results schema
Schema for Google’s hotel blocks from the Google Search endpoint: the hotel pack, More hotels, Hotels in popular areas, and the EU hotel unit and websites.
The
Google Search endpoint
returns Google’s hotel blocks, shown on hotel queries (“hotels in chicago”, “hotel berlin mitte”), as
result.hotelResults
, on desktop and mobile, with no flag and at no extra cost.
hotelResults
is a list of blocks in page order, and is omitted when the SERP has no hotel block.
Values are text as Google shows them, in the language of the SERP (
4-star hotel
,
Great deal
,
1.7K
). Hotels in a sponsored carousel (“Sponsored hotels”) are ads and come in
result.ads
.
Navigate to header: Layouts Layouts
Google shows hotels in six layouts, and each returns the fields it shows. Each example below is the result for the page in its screenshot, shortened with
// …
.
Navigate to header: Hotel pack Hotel pack
The block at the top of the results: a
title
, the hotels and a map. Each hotel has its coordinates on the map (
latitude
,
longitude
), and its
link
is its page on Google Travel.
Hotel pack in Google Search
A response to
hotels in chicago
in the United States, on desktop:
{
"success"
:
true
,
"result"
: {
"hotelResults"
: [
{
"title"
:
"Hotels | Chicago, IL"
,
"hotels"
: [
{
"position"
:
1
,
"name"
:
"The Chicago Hotel Collection Magnificent Mile Hotel & Suites"
,
"price"
: {
"value"
:
111
,
"currency"
:
"$"
,
"raw"
:
"$111"
},
"rating"
:
3
,
"reviews"
:
"1.7K"
,
"starClass"
:
"4-star hotel"
,
"deal"
:
"Great deal"
,
"latitude"
:
41.8959303
,
"longitude"
:
-87.6227186
,
"link"
:
"https://www.google.com/travel/search?q=hotels\+in\+chicago&…"
},
{
"position"
:
2
,
"name"
:
"Ambassador Gold Coast - The Chicago Hotel Collection"
,
"price"
: {
"value"
:
36
,
"currency"
:
"$"
,
"raw"
:
"$36"
},
"rating"
:
3.2
,
"reviews"
:
"1.1K"
,
"starClass"
:
"4-star hotel"
,
"deal"
:
"Great price"
,
"latitude"
:
41.9060542
,
"longitude"
:
-87.6284696
,
"link"
:
"https://www.google.com/travel/search?q=hotels\+in\+chicago&…"
}
// …
]
}
// …
]
}
}
Navigate to header: Hotel pack on mobile Hotel pack on mobile
On mobile the pack shows the map above the hotels, with the same fields. A hotel takes its coordinates from its pin on the map.
Hotel pack in Google Search on mobile
hotels in new york
in the United States, on mobile:
{
"title"
:
"Hotels | New York, NY"
,
"hotels"
: [
{
"position"
:
1
,
"name"
:
"Hotel Executive Suites"
,
"price"
: {
"value"
:
78
,
"currency"
:
"$"
,
"raw"
:
"$78"
},
"rating"
:
3.4
,
"reviews"
:
"1.4K"
,
"latitude"
:
40.5906
,
"longitude"
:
-74.23889
,
"link"
:
},
{
"position"
:
2
,
"name"
:
"The Baltic Hotel"
,
"price"
: {
"value"
:
95
,
"currency"
:
"$"
,
"raw"
:
"$95"
},
"rating"
:
2.9
,
"reviews"
:
"327"
,
"deal"
:
"Deal"
,
"latitude"
:
40.68252
,
"longitude"
:
-73.98558
,
"link"
:
}
// …
]
}
Navigate to header: More hotels More hotels
Carousels of more hotels between the organic results, each its own block, with the same fields as the pack. A hotel has coordinates when it is on the pack’s map. On mobile the carousel has no
title
.
More hotels in Google Search
The second block of the same response:
{
"title"
:
"More Hotels"
,
"hotels"
: [
{
"position"
:
1
,
"name"
:
"Holiday Inn Chicago North-Evanston by IHG"
,
"price"
: {
"value"
:
80
,
"currency"
:
"$"
,
"raw"
:
"$80"
},
"rating"
:
3.9
,
"reviews"
:
"1.1K"
,
"starClass"
:
"3-star hotel"
,
"deal"
:
"Great deal"
,
"latitude"
:
42.0444287
,
"longitude"
:
-87.6814744
,
"link"
:
"https://www.google.com/travel/search?q=hotels\+in\+chicago&…"
}
// …
]
}
Navigate to header: Hotels in popular areas Hotels in popular areas
On mobile in the United States: a list of areas, each with its average price, a description and its hotels. Google opens the first area; the hotels of the others come too, with
expanded: false
on their area. The block’s
hotels
is empty: its hotels are in
areas
.
Hotels in popular areas in Google Search on mobile
hotels in new york
in the United States, on mobile:
{
"title"
:
"Hotels in popular areas | New York, NY"
,
"hotels"
: [],
"areas"
: [
{
"name"
:
"Sunnyside"
,
"averagePrice"
: {
"value"
:
264
,
"currency"
:
"$"
,
"raw"
:
"Avg $264"
},
"description"
:
"Neighborhood"
,
"expanded"
:
true
,
"hotels"
: [
{
"position"
:
1
,
"name"
:
"DoubleTree by Hilton Hotel Newark Airport"
,
"price"
: {
"value"
:
102
,
"currency"
:
"$"
,
"raw"
:
"$102"
},
"rating"
:
3.6
,
"reviews"
:
"6K"
,
"starClass"
:
"4-star hotel"
,
"link"
:
"https://www.google.com/search?q=DoubleTree\+by\+Hilton\+Hotel\+Newark\+Airport&…"
}
// …
]
},
{
"name"
:
"Concourse Village"
,
"averagePrice"
: {
"value"
:
136
,
"currency"
:
"$"
,
"raw"
:
"Avg $136"
},
"description"
:
"Neighborhood"
,
"expanded"
:
false
,
"hotels"
: [
{
"position"
:
1
,
"name"
:
"Highbridge Hotel"
,
"price"
: {
"value"
:
81
,
"currency"
:
"$"
,
"raw"
:
"$81"
},
"rating"
:
4.5
,
"reviews"
:
"518"
,
"starClass"
:
"3-star hotel"
,
"link"
:
"https://www.google.com/search?q=Highbridge\+Hotel&…"
}
// …
]
}
// …
]
}
Navigate to header: EU hotel unit EU hotel unit
In the EU, the hotel pack is a list of booking sites (Expedia, Booking.com, Google, …), each with its hotels. The hotels of every site come in one list, each with its
supplier
, as in the
EU places unit
. Google opens one site; the hotels of the others come too, with
expanded: false
on their supplier. A site’s rating can be out of 10 (
ratingScale
), and some sites show the hotel class (
starClass
). No coordinates.
EU hotel unit in Google Search: Expedia open, the other booking sites collapsed
hotels dublin
in Ireland, on desktop: Expedia’s 3 hotels, open on the page, then those of the 7 other booking sites, 24 in all.
{
"title"
:
"Hotels | Dublin"
,
"hotels"
: [
{
"position"
:
1
,
"name"
:
"The Gibson Hotel Dublin City"
,
"price"
: {
"value"
:
140
,
"currency"
:
"€"
,
"raw"
:
"€140"
},
"rating"
:
9
,
"ratingScale"
:
10
,
"reviews"
:
"1.2K"
,
"link"
:
"https://www.google.com/travel/lodging/clk?pcurl=https://www.expedia.ie/Hotel-Search…"
,
"supplier"
: {
"name"
:
"Expedia"
,
"expanded"
:
true
,
"domain"
:
,
"link"
:
"https://www.expedia.ie/Dublin-Hotels.d178256.Travel-Guide-Hotels"
,
"redirectLink"
:
"https://www.google.com/goto?url=CAESfQHEIkXXXopRhpN1…"
}
},
// …
{
"position"
:
10
,
"name"
:
"Maldron Hotel Parnell Square Dublin City"
,
"price"
: {
"value"
:
102
,
"currency"
:
"€"
,
"raw"
:
"€102"
},
"rating"
:
8.4
,
"ratingScale"
:
10
,
"reviews"
:
"8.6K"
,
"starClass"
:
"4-star hotel"
,
"link"
:
"https://www.google.com/travel/lodging/clk?pc=AJ0xEyiwGOFsI6dplf7nCF…"
,
"supplier"
: {
"name"
:
"Booking.com"
,
"expanded"
:
false
,
"domain"
:
,
"link"
:
"https://www.booking.com/city/ie/dublin.html"
,
"redirectLink"
:
"https://www.google.com/goto?url=CAESaAHEIkXXkpuR9…"
}
}
// …
]
}
Navigate to header: EU hotel websites EU hotel websites
In the EU, next to the hotel unit: the hotels’ own websites.
source
is the website as Google shows it, and
link
goes to it.
EU hotel websites in Google Search
The second block of the same response:
{
"title"
:
"Hotel websites"
,
"hotels"
: [
{
"position"
:
1
,
"name"
:
"easyHotel Dublin City Centre"
,
"link"
:
"https://www.easyhotel.com/hotels/republic-of-ireland/dublin/dublin-city-centre?utm\_source=google&…"
,
"source"
:
,
"redirectLink"
:
"https://www.google.com/goto?url=CAES2wEBxCJF1ylsE…"
},
{
"position"
:
2
,
"name"
:
"Hilton Garden Inn Dublin City Centre"
,
"price"
: {
"value"
:
113
,
"currency"
:
"€"
,
"raw"
:
"from €113"
},
"link"
:
"https://www.google.com/travel/lodging/clk?pcurl=https://linkcenterus.derbysoftca.com/…"
,
"source"
:
}
// …
]
}
Navigate to header: Hotel block structure Hotel block structure
hotels
is always present.
title
and
areas
are included only when Google shows them.
| Field | Type | Description |
|---|---|---|
| title | string | Heading of the block (“Hotels | Chicago, IL”, “Hotel websites”), when shown |
| hotels | array | The hotels, in page order. See below. Empty in Hotels in popular areas |
| areas | array | Hotels in popular areas: the areas. See below |
Navigate to header: Hotel Hotel
position
and
name
are always present; the other fields are included only when Google shows them.
| Field | Type | Description |
|---|---|---|
| position | number | Position in the block (1-indexed), across the booking sites of the EU hotel unit |
| name | string | Hotel name |
| price | object | Price for the stay shown. See Price |
| rating | number | Rating |
| ratingScale | number | Maximum of the rating when Google shows it ( 10 for “9/10”); without it the rating is out of 5 |
| reviews | string | Review count as shown (“1.7K”, “1,2 k”) |
| starClass | string | Hotel class as shown (“4-star hotel”) |
| deal | string | Deal label as shown (“Great deal”, “Great price”) |
| latitude | number | Latitude of the hotel on the pack’s map |
| longitude | number | Longitude of the hotel on the pack’s map |
| link | string | The hotel’s page: Google Travel, the booking site, a Google search for the hotel, or its website |
| source | string | EU hotel websites: the website as shown (“ www.hilton.com ”) |
| supplier | object | EU hotel unit: the booking site of the hotel. See below |
| redirectLink | string | Google’s redirect that link was resolved from, when Google served one |
Navigate to header: Supplier Supplier
The booking site of a hotel in the EU hotel unit, the same object as in the
EU places unit
.
name
and
expanded
are always present.
| Field | Type | Description |
|---|---|---|
| name | string | Booking site ( "Booking.com" ) |
| expanded | boolean | true if this booking site is open on the page |
| domain | string | Booking site’s domain ( "www.booking.com" ) |
| link | string | The booking site’s “See more on …” page |
| redirectLink | string | Google’s redirect that link was resolved from, when Google served one |
Navigate to header: Area Area
name
,
expanded
and
hotels
are always present. An area always has at least one hotel.
| Field | Type | Description |
|---|---|---|
| name | string | Area (“Sunnyside”) |
| averagePrice | object | Average price in the area. See Price |
| description | string | Line beside the average price (“Neighborhood”, “Park and garden”) |
| expanded | boolean | true if the area is open on the page |
| hotels | array | The area’s hotels. See Hotel |
Navigate to header: Price Price
raw
is always present.
| Field | Type | Description |
|---|---|---|
| value | number | Numeric price. Omitted when the number doesn’t parse |
| currency | string | Currency symbol ( $ , € , kr ). Omitted when the text has no currency |
| raw | string | Price text as shown ( "$111" , "from €113" ) |
Was this page helpful?
Ask a question...
Navigate to header: Hotel pack
Navigate to header: Hotel pack on mobile
Navigate to header: More hotels
Navigate to header: Hotels in popular areas
Navigate to header: EU hotel unit
Navigate to header: EU hotel websites