Google hotel results schema - cloro

Google

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"

:

"https://www.google.com/travel/hotels/New%20York,%20NY/entity/CgsIkPCX3P7fgYq2ARAB?q=hotels\+in\+new\+york&…"

},

{

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

:

"https://www.google.com/travel/hotels/New%20York,%20NY/entity/CgsI2ZLchtqEs7f-ARAB?q=hotels\+in\+new\+york&…"

}

// …

]

}

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"

:

"www.expedia.ie"

,

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

:

"www.booking.com"

,

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

:

"www.easyhotel.com"

,

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

:

"www.hilton.com"

}

// …

]

}

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

Google Search endpoint

result.ads

EU places unit

Navigate to header: Price

www.hilton.com

redirect

Hotel

Navigate to header: Layouts

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

Navigate to header: Hotel block structure

Navigate to header: Supplier

Navigate to header: Area