> ## Documentation Index > Fetch the complete documentation index at: https://cloro.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # Google hotel results schema > Schema for Google's hotel blocks returned by the Google Search endpoint: the hotel pack and its map coordinates, the More hotels carousels, Hotels in popular areas, and in the EU the hotel unit with every booking site and the hotel websites. The [Google Search endpoint](https://cloro.dev/docs/api-reference/endpoint/monitor-google.md) 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`](https://cloro.dev/docs/api-reference/endpoint/google/sponsored-ads). ## 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 `// …`. ### 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](https://mintcdn.com/cloro/DN2fq38dozWEeDHt/images/google/search-hotel-results-hotel-pack.webp?fit=max\&auto=format\&n=DN2fq38dozWEeDHt\&q=85\&s=1188d744f2d3ec7a3615e209eee413e2) Hotel pack in Google Search A response to `hotels in chicago` in the United States, on desktop: ```json theme={null} { "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&…" } // … ] } // … ] } } ``` ### 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](https://mintcdn.com/cloro/DN2fq38dozWEeDHt/images/google/search-hotel-results-hotel-pack-mobile.webp?fit=max\&auto=format\&n=DN2fq38dozWEeDHt\&q=85\&s=85eabc4ebe5a2398e85624c7f7be8f1e) Hotel pack in Google Search on mobile `hotels in new york` in the United States, on mobile: ```json theme={null} { "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&…" } // … ] } ``` ### 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](https://mintcdn.com/cloro/DN2fq38dozWEeDHt/images/google/search-hotel-results-more-hotels.webp?fit=max\&auto=format\&n=DN2fq38dozWEeDHt\&q=85\&s=4e260a7a02fda1eef3e1a94b5acc01f3) More hotels in Google Search The second block of the same response: ```json theme={null} { "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&…" } // … ] } ``` ### 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](https://mintcdn.com/cloro/DN2fq38dozWEeDHt/images/google/search-hotel-results-popular-areas.webp?fit=max\&auto=format\&n=DN2fq38dozWEeDHt\&q=85\&s=167d036a5ca0901b9512a377ec37b022) Hotels in popular areas in Google Search on mobile `hotels in new york` in the United States, on mobile: ```json theme={null} { "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&…" } // … ] } // … ] } ``` ### 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](https://cloro.dev/docs/api-reference/endpoint/google/local-pack.md#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](https://mintcdn.com/cloro/DN2fq38dozWEeDHt/images/google/search-hotel-results-eu-hotel-unit.webp?fit=max\&auto=format\&n=DN2fq38dozWEeDHt\&q=85\&s=884a45f5d16856b4262e4cdb7138ff5c) 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. ```json theme={null} { "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…" } } // … ] } ``` ### 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](https://mintcdn.com/cloro/DN2fq38dozWEeDHt/images/google/search-hotel-results-eu-hotel-websites.webp?fit=max\&auto=format\&n=DN2fq38dozWEeDHt\&q=85\&s=4a3a7cc1023ac397d3a64115fc958239) EU hotel websites in Google Search The second block of the same response: ```json theme={null} { "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" } // … ] } ``` ## Hotel block structure | 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 | ### 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](#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](http://www.hilton.com)") | | `supplier` | object | EU hotel unit: the booking site of the hotel. See below | | `redirectLink` | string | Google's [redirect](https://cloro.dev/docs/api-reference/endpoint/google/resolve-goto.md) that `link` was resolved from, when Google served one | ### Supplier The booking site of a hotel in the EU hotel unit, the same object as in the [EU places unit](https://cloro.dev/docs/api-reference/endpoint/google/local-pack.md#eu-places-unit). | 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 | ### Area | Field | Type | Description | | - | - | - | | `name` | string | Area ("Sunnyside") | | `averagePrice` | object | Average price in the area. See [Price](#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](#hotel) | ### Price | Field | Type | Description | | - | - | - | | `value` | number | Numeric price. Omitted when the number doesn't parse | | `currency` | string | Currency symbol (`$`, `€`, `kr`) | | `raw` | string | Price text as shown (`"$111"`, `"from €113"`) | This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.