---
description: >-
  Google Hotel Search. Given a search query, return the searched hotel
  information.
---

# Google Hotel Search

## Try it in the Widget Center

Click this [url](https://app.myshell.ai/robot-workshop/widget/1781994096558313472) to try this widget and copy the Pro Config template.

## Usage

Search the hotels using google hotel search. The `check_out_date` must be later than `check_in_date` and both the two dates must be later than today.&#x20;

**Input Parameters**

<table><thead><tr><th>Name</th><th>Type</th><th>Description</th><th>Default</th><th data-type="checkbox">Required</th></tr></thead><tbody><tr><td>query</td><td><code>string</code></td><td>The search query string that specifies what the search should be about.</td><td></td><td>true</td></tr><tr><td>country</td><td><code>string</code></td><td>The country where you want to search the hotel.</td><td>United States</td><td>true</td></tr><tr><td>num_results</td><td><code>integer</code></td><td>The number of search results to return.</td><td>10</td><td>false</td></tr><tr><td>check_in_date</td><td><code>string</code></td><td>The check-in date, should be YYYY-MM-DD. e.g. 2024-04-20</td><td></td><td>true</td></tr><tr><td>check_out_date</td><td><code>string</code></td><td>The check-in date, should be YYYY-MM-DD. e.g. 2024-04-21</td><td></td><td>true</td></tr><tr><td>currency</td><td><code>string</code></td><td>Defines the currency of the returned prices. Default is USD</td><td>USD</td><td>false</td></tr></tbody></table>

**Output Parameters**

| Name            | Type    | Description                       | File Type |
| --------------- | ------- | --------------------------------- | --------- |
| search\_results | `array` | The result of google hotel search |           |

**Output Example**

{% tabs %}
{% tab title="success" %}
{% code fullWidth="false" %}
```json
{
  "search_results": [
    {
      "amenities": [
        "Air conditioning",
        "Balcony",
        "Crib",
        "Heating",
        "Ironing board",
        "Kitchen",
        "Patio",
        "Pet-friendly",
        "Smoke-free",
        "Cable TV",
        "Free parking",
        "Free Wi-Fi"
      ],
      "check_in_time": "3:00 PM",
      "check_out_time": "11:00 AM",
      "essential_info": [
        "Entire house",
        "Sleeps 7",
        "3 bedrooms",
        "2 bathrooms",
        "4 beds"
      ],
      "excluded_amenities": [
        "No airport shuttle",
        "No beach access",
        "Not kid-friendly",
        "No elevator",
        "No fireplace",
        "No fitness center",
        "No hot tub",
        "No indoor pool",
        "No microwave",
        "No outdoor grill",
        "No outdoor pool",
        "No oven stove",
        "No washer",
        "Not wheelchair accessible"
      ],
      "gps_coordinates": {
        "latitude": 29.964040756225586,
        "longitude": -90.06597137451172
      },
      "images": [
        {
          "original_image": "https://p.fih.io/v2/nSr0o-3gbZN8o1xMecXCcG-BkDeQVo3k-wOeVogkTe7ajuFOX7O-WA8aRWhXz1jsToZif_TsA_xCWfhWRa0Zjp2vkzwvqntlGAnUH59nxQiduWT9P6GUmzv9DtP7_KqwHRd-1o7IBwy_fjF4en3ketkYyx1j1dLbUfhlOgkNcIcn9PwNtk_AU2csbUk6dd9sGqAEVmr2qjQMPI095Pdv3pEtFPIxOxxOPC-YWoFEg4yUvBhQ3nG9m-EPX9TU2Voda_hO30Az3JWuq4tHLkiogsy54aSfY1hA9f4xqquae344FS17ESLRWvkRUepgJA968jti7cMPqWLdOXGcidq2XQp_",
          "thumbnail": "https://lh5.googleusercontent.com/proxy/Mj6OWUJ-M3P7L330ny0RfacMHyFKivelesG8Oz1le2FbfO9vN_1CDKE2KRIb172T6wISzHPmg-A6NZ4HWvNDz9h0-Q3oWx03_ogwwJm8RWORWZItaPZrjqJ-ODYlgduMSvXl9-VDu8yVxP7mEBpZBBpiraybgQ=s287-w287-h192-n-k-no-v1"
        },
        {
          "original_image": "https://q-xx.bstatic.com/xdata/images/hotel/max1440x1080/116626512.jpg?k=e72976257fbefd4a522311edb686ab14df144181c3ab4b65170f1ae923e63790\u0026o=",
          "thumbnail": "https://lh4.googleusercontent.com/proxy/yc_S5_vfONvTPltc20zEaLlrTYP3Fl2f-sjbs-LSBhLuQCmZEi8qBTVMkf6TE37nTDR7K6pKokOTCXUEZpix1wOfoOE0jTsZrIxRsMl6cFpVT2Kc59I3nH7gxefxXWT5MGRe2EyYkADjdls7x5DZ1p61o9y8yQ=s287-w287-h192-n-k-no-v1"
        },
        {
          "original_image": "https://p.fih.io/v2/nSr0o-3gbZN8o1xMecXCcG-BkDeQVo3k-wOeVogkTe7ajuFOX7O-WA8aRWhXz1jsToZif_TsA_xCWfhWRa0Z3LuIgioI1W4ZbwapfqlSzTjMoyPJFJX7pBCZNaL-pam6Lw0Rpqu3GVzUBzF4en3ketkYyx1j1dLbUfhlOgkNcIcn9PwNtk_AU2csbUk6dd9sGqAEVmr2qjQMPI095Pdv3pEtFPIxOxxOPC-YWoFEg4yUvBhQ3nG9m-EPX9TU2Voda_hO30Az3JWuq4tHLkiogsy54aSfY1hA9f55pquae3J_Fz1aBiLRWvkRUepgJA968ju74Ejzfp8RnT62dOwxyCuQ",
          "thumbnail": "https://lh3.googleusercontent.com/proxy/G2MHQxcSs6JIFBSZagD19KTnKtzzAisQ2HxUf7oqQhrdiT3ItQSA38VGL9AntlbY1wtsQgxFRih4atyPlnJavNQyYEX7yoIafHqrG65DQnf_pZbCH7ha0m5hhGtaFbOK7935DnDmVFFukSgNJC1m0ejWrjrbTos=s287-w287-h192-n-k-no-v1"
        },
        {
          "original_image": "https://p.fih.io/v2/nSr0o-3gbZN8o1xMecXCcG-BkDeQVo3k-wOeVogkTe7ajuFOX7O-WA8aRWhXz1jsToZif_TsA_xCWfhWRa0Z34u6vjguzUcAbx7XSZl6wm7dlnvKHomRoROQAJOirKaKAlcc1JT9UX3EDzF4en3ketkYyx1j1dLbUfhlOgkNcIcn9PwNtk_AU2csbUk6dd9sGqAEVmr2qjQMPI095Pdv3pEtFPIxOxxOPC-YWoFEg4yUvBhQ3nG9m-EPX9TU2Voda_hO30Az3JWuq4tHLkiogsy54aSfY1hA9f4xpuKMRXFjAC57XyLRWvkRUepgJA968jvmThqO7VWuhAG0vPgATTkX",
          "thumbnail": "https://lh6.googleusercontent.com/proxy/qKg2u9MvZszdiRC2s3xalPZookq8Qjv0CGiAQEFoVL1mueu_LKedNSmznQuNQVLzhYUWx8nffqc2oHfiWlUqhjBWxC3etIeijYMHLoiFxSoe43xnGU_3Pjc62inv9uQPwLkrfBAsu-jST5cBMx7uokY47HG82qQ=s287-w287-h192-n-k-no-v1"
        },
        {
          "original_image": "https://q-xx.bstatic.com/xdata/images/hotel/max1440x1080/116626730.jpg?k=babe5edf29be1433301b7788078caa61eb6998d642cdb54243765a794abd71ee\u0026o=",
          "thumbnail": "https://lh6.googleusercontent.com/proxy/yXGgz1DOqRbs7WnbzHdzjnwo6myDiMd9lEe2NtYV8ojNNiwTB0QI4uY7OOy8G2BVmjSaqMijkaRLjORz8hYq7U4hkkDhKKf82PJ7u4bAsNvNM3uXl_9y3BYopFyfXb7i2u2uqVyM3fxzUYirctj9EkXMiunMhCU=s287-w287-h192-n-k-no-v1"
        },
        {
          "original_image": "https://p.fih.io/v2/nSr0o-3gbZN8o1xMecXCcG-BkDeQVo3k-wOeVogkTe7ajuFOX7O-WA8aRWhXz1jsToZif_TsA_xCWfhWRa0ZraCLsH430F5qDjKPH7hvxxP7jifaFp2iqjDbC7b697i4SzN13bXLMHH2ejF4en3ketkYyx1j1dLbUfhlOgkNcIcn9PwNtk_AU2csbUk6dd9sGqAEVmr2qjQMPI095Pdv3pEtFPIxOxxOPC-YWoFEg4yUvBhQ3nG9m-EPX9TU2Voda_hO30Az3JWuq4tHLkiogsy54aSfY1hA9f55quyYeHlhFxR_WiLRWvkRUepgJA968jtibr0SVyR0NMkurmsRgq_m",
          "thumbnail": "https://lh4.googleusercontent.com/proxy/BGCS2tJkUdGNTqchvZ3dHq4-tCl_Va6g1iaJRPwX7L6BLnm4J0uG9Tdy453edu-58YGLVkM_FG7zgmBgWHl13sbfb-9DYixkRizM_DR_zLs6I08LcBkaCftOCBWH9LyXhl_6XT4HPjs2tOEtT78l2XLsomLtIPs=s287-w287-h192-n-k-no-v1"
        },
        {
          "original_image": "https://q-xx.bstatic.com/xdata/images/hotel/max1440x1080/116626727.jpg?k=15c7801a3d6795cd5ad4d1ddee1ac1a98bf673611faae2a62c654871c8ff9b2a\u0026o=",
          "thumbnail": "https://lh6.googleusercontent.com/proxy/eWM25XMwH4iZopp1o1AnTR-cYR64Zd_gFAckO5rh9uuZWGV0xACdEyjiysSZ1skyQSOWS_y9fNe51PxDzNZ7cULpmjaY5uIGZoOSk6eOjZXjeHvl87uS0cSkULTU-Dvl29R4PSEl4JaFSQb23FMu2FW6RiGEEGs=s287-w287-h192-n-k-no-v1"
        },
        {
          "original_image": "https://p.fih.io/v2/nSr0o-3gbZN8o1xMecXCcG-BkDeQVo3k-wOeVogkTe7ajuFOX7O-WA8aRWhXz1jsToZif_TsA_xCWfhWRa0ZrrOHvxkO7i9hLSikf7Nq7hv-pybeHu-oijuYN4ep-pqCFSkQsor4Omr0FzF4en3ketkYyx1j1dLbUfhlOgkNcIcn9PwNtk_AU2csbUk6dd9sGqAEVmr2qjQMPI095Pdv3pEtFPIxOxxOPC-YWoFEg4yUvBhQ3nG9m-EPX9TU2Voda_hO30Az3JWuq4tHLkiogsy54aSfY1hA9f55tuKPVX1jFD1VWiLRWvkRUepgJA968jvSUXubFuLA44o9F9gcWDIZ",
          "thumbnail": "https://lh5.googleusercontent.com/proxy/3jIVs921svpee-IbNhjr3sFHBUL6xE8gMIDQx50C054Y2lnwjLT66aWH6lQAdiMwiKj5TmftP-BOXvz9tFi9fZEI78AR2mMUmhU-ro9oHrsbc8tHNeqs34Tens9EmER9pzUbF1Lr0ZHD6PMQ5rjl4jDCZ3c9zA=s287-w287-h192-n-k-no-v1"
        },
        {
          "original_image": "https://q-xx.bstatic.com/xdata/images/hotel/max1440x1080/116626718.jpg?k=d8b60e19eaafdd9e35095dcbc857d9e0ddc20cd806aeb5b4136f53a5edeb3c84\u0026o=",
          "thumbnail": "https://lh6.googleusercontent.com/proxy/ZOyTvBmA0DQr_4Gm4do0qCt_BJyr369izYaTcCAltSMBeZNu3Sr77uKEbO_0ptqFyS0kYiEJ5OB3KUa5XkLXyURGYHsmKQRtQHWEQuZnWDLNJZJmxwjHqsGcZjeHZFE7dquHafGOVUX-0jfWfR6RpQqshMoXxg=s287-w287-h192-n-k-no-v1"
        }
      ],
      "location_rating": 4.3,
      "name": "New Orleans Guest House",
      "nearby_places": [
        {
          "name": "N. Rampart at Ursuline",
          "transportations": [
            {
              "duration": "1 min",
              "type": "Walking"
            }
          ]
        },
        {
          "name": "Louis Armstrong New Orleans International Airport",
          "transportations": [
            {
              "duration": "19 min",
              "type": "Taxi"
            },
            {
              "duration": "41 min",
              "type": "Public transport"
            }
          ]
        },
        {
          "name": "Effervescence",
          "transportations": [
            {
              "duration": "1 min",
              "type": "Walking"
            }
          ]
        }
      ],
      "overall_rating": 4.0164237,
      "prices": [
        {
          "logo": "https://www.gstatic.com/travel-hotels/branding/7287187d-2586-494f-92ff-726979e94c2a.png",
          "num_guests": 2,
          "rate_per_night": {
            "before_taxes_fees": "$89",
            "extracted_before_taxes_fees": 89,
            "extracted_lowest": 103,
            "lowest": "$103"
          },
          "source": "Vio.com"
        }
      ],
      "property_token": "ChkQ2aOjyZeD1udFGg0vZy8xMXZ0NmJxa2R6EAI",
      "rate_per_night": {
        "before_taxes_fees": "$89",
        "extracted_before_taxes_fees": 89,
        "extracted_lowest": 103,
        "lowest": "$103"
      },
      "reviews": 1577,
      "serpapi_property_details_link": "https://serpapi.com/search.json?adults=2\u0026check_in_date=2024-04-24\u0026check_out_date=2024-04-25\u0026children=0\u0026currency=USD\u0026engine=google_hotels\u0026gl=us\u0026hl=en\u0026property_token=ChkQ2aOjyZeD1udFGg0vZy8xMXZ0NmJxa2R6EAI\u0026q=New+Orleans",
      "total_rate": {
        "before_taxes_fees": "$89",
        "extracted_before_taxes_fees": 89,
        "extracted_lowest": 103,
        "lowest": "$103"
      },
      "type": "vacation rental"
    },
    {
      "amenities": [
        "Air conditioning",
        "Kid-friendly",
        "Elevator",
        "Heating",
        "Kitchen",
        "Microwave",
        "Oven stove",
        "Smoke-free",
        "Cable TV",
        "Free Wi-Fi"
      ],
      "check_in_time": "4:00 PM",
      "check_out_time": "11:00 AM",
      "essential_info": [
        "Entire apartment",
        "Sleeps 2",
        "1 bedroom",
        "1 bathroom",
        "1 bed"
      ],
      "excluded_amenities": [
        "No airport shuttle",
        "No balcony",
        "No beach access",
        "No crib",
        "No fireplace",
        "No free breakfast",
        "No fitness center",
        "No hot tub",
        "No indoor pool",
        "No ironing board",
        "No outdoor grill",
        "No outdoor pool",
        "No patio",
        "Not pet-friendly",
        "No washer",
        "Not wheelchair accessible",
        "No parking"
      ],
      "gps_coordinates": {
        "latitude": 29.95509147644043,
        "longitude": -90.0724105834961
      },
      "images": [
        {
          "original_image": "https://images.trvl-media.com/lodging/103000000/102640000/102636000/102635952/667e3e15_z.jpg",
          "thumbnail": "https://lh5.googleusercontent.com/proxy/pdqy6OW6fqbxBfU6jK2ARioz3PMyLBzmOWTN0-AZE7HzV55l8HKt_yeFrLIlE4sxub1IGrxKwIbAVmTBNH0jm4bbJVvoPoebGO5dpdFmLLz2qNDt1T-twNrdGhpJvWMRRjLb6c7feGKp78UojJgz-uZRbQygie4=s287-w287-h192-n-k-no-v1"
        },
        {
          "original_image": "https://images.trvl-media.com/lodging/103000000/102640000/102636000/102635952/165f4ec2_z.jpg",
          "thumbnail": "https://lh6.googleusercontent.com/proxy/PT5SzwGUyl1GbM-cf1Gh8Qe_WgDr3Uc8ANof9m5c7LEwTaPF5TwULLdJq4tNsZApvD9m0w8l-34fZU25nVkptvanBWLZ54udibIK0u5DyzE3LGtjKmlx8KoYJNaaCGJYHGX1xjLQ70Lg_R2yZlpPLveoBMQVAQ=s287-w287-h192-n-k-no-v1"
        },
        {
          "original_image": "https://assets.whimstay.com/564526/3792778/eb6dca5dcd5b6e0eb2551571c8437687-10",
          "thumbnail": "https://lh3.googleusercontent.com/proxy/pWtUSNneZPH-aAqd0TuUJey29mFHKohY05uGbUt-lZWYApHnPBOCPt5lQNwQl_8-fYS75ad2-OEAL3xLkrAASQM7UOgSP7iHS26D6Gc_GCmnVp-mJTYEKu8eZikeAq44nE_ewYsHOMlp6DB36eoCDdnDNAc1ucU=s287-w287-h192-n-k-no-v1"
        },
        {
          "original_image": "https://images.trvl-media.com/lodging/103000000/102640000/102636000/102635952/306f171e_z.jpg",
          "thumbnail": "https://lh4.googleusercontent.com/proxy/sl_6Oq-5LrFt9l7JHF63YTXwzRzYU-rm2l-BDkOnxeKi82dvCkH96exOphvqIIQa1y1fjKZ7a0EBu23tyWWhyfxCweaaZjEpQqc5s3CNvekmCZE3POs7uepBYoc7OQNKpI4gncA_QrvB8u8M43Xx4a0tobg33XU=s287-w287-h192-n-k-no-v1"
        },
        {
          "original_image": "https://images.trvl-media.com/lodging/103000000/102640000/102636000/102635952/8a36f8fb_z.jpg",
          "thumbnail": "https://lh4.googleusercontent.com/proxy/8PNswSlqWvzjTBAYwXw6h4h0hZAFM7kj9hlCue5uSOldmDlMNyy4h48uNLXns4ev5eImNVz2onhQ0AXcNW8mp4u9KFU23URqaaxxKHZu890TzdPqnk40u-RmMdMp74VEj5YRGSBbuFngHQu95dPOPcSwc85pAQ=s287-w287-h192-n-k-no-v1"
        },
        {
          "original_image": "https://images.trvl-media.com/lodging/103000000/102640000/102636000/102635952/30a35e17_z.jpg",
          "thumbnail": "https://lh4.googleusercontent.com/proxy/Gb9hY4QzY4SFzNWzWF3c1p_l7i8Pe7h9aRD9vUe2-1XsJZSIlzdT91yHRQVqVwUz3nvcZr1cmZptbU0WKmmRZa8wjzn2QXxnIjg_Ub_tOAy9iE9bevPuSysdPMZ9Uu39Nzn-aJLNabDb8WRuJuy_rVk6wlCyFw=s287-w287-h192-n-k-no-v1"
        },
        {
          "original_image": "https://images.trvl-media.com/lodging/103000000/102640000/102636000/102635952/7812d3cd_z.jpg",
          "thumbnail": "https://lh3.googleusercontent.com/proxy/JQhZcLoyl186N9efi8z-a6p3cfxyIk0QHklVoeKFUzk75uEIoFwMxv38GgBu0WyUTS9kPTaBk0dABVLhhpLyAHHhheOsQhjEo2vDcBGIrwaxJlrd72emIY8GiBmVzD_OvWeSfyfOnyT2By_3lQJ2pjV0hGWPRzc=s287-w287-h192-n-k-no-v1"
        },
        {
          "original_image": "https://assets.whimstay.com/564526/3792778/f0e4111a136e9e1d123b998913608926-3",
          "thumbnail": "https://lh3.googleusercontent.com/proxy/nCosuTq2YyJS0lP69CrLxyT7pXbV3o510VIYZW8aoDdlWHyjgIqpOne78nh76M_Keq5r7Guluph8JOUlym-6kYjs9QEudfC37wwRcgKJnQm-oNGWcgL8ZaBhna6AN4uKXK2_RikwdzbOKB6lHFcIGGiHs8U1Kg=s287-w287-h192-n-k-no-v1"
        },
        {
          "original_image": "https://images.trvl-media.com/lodging/103000000/102640000/102636000/102635952/112f1c4b_z.jpg",
          "thumbnail": "https://lh4.googleusercontent.com/proxy/VXhpSd6EUdqUu60GaZlDyO4RVy8h2DB3y5xiqcrtO9H1GhsirMlL1_4oRcb-L421uGDBfS9j97BzD3uCrpXMgQJWJRd_JOmQ_2CINzHjbFtkpUoDYGsW0PxqLGuvhntuk5PAxzqxQZslKW1ge_ynyTWwBW_rhg=s287-w287-h192-n-k-no-v1"
        }
      ],
      "location_rating": 4.7,
      "name": "Roami at Canal Quarters",
      "nearby_places": [
        {
          "name": "Canal + S. Rampart (In)",
          "transportations": [
            {
              "duration": "5 min",
              "type": "Walking"
            }
          ]
        },
        {
          "name": "Louis Armstrong New Orleans International Airport",
          "transportations": [
            {
              "duration": "25 min",
              "type": "Taxi"
            },
            {
              "duration": "40 min",
              "type": "Public transport"
            }
          ]
        }
      ],
      "overall_rating": 3.9,
      "prices": [
        {
          "logo": "https://www.gstatic.com/travel-hotels/branding/7725599522425217147.png",
          "num_guests": 2,
          "rate_per_night": {
            "before_taxes_fees": "$95",
            "extracted_before_taxes_fees": 95,
            "extracted_lowest": 226,
            "lowest": "$226"
          },
          "source": "Hotels.com"
        }
      ],
      "property_token": "ChkQyvyh6_HY1N5SGg0vZy8xMXkzaGg5bnZtEAI",
      "rate_per_night": {
        "before_taxes_fees": "$95",
        "extracted_before_taxes_fees": 95,
        "extracted_lowest": 226,
        "lowest": "$226"
      },
      "reviews": 26,
      "serpapi_property_details_link": "https://serpapi.com/search.json?adults=2\u0026check_in_date=2024-04-24\u0026check_out_date=2024-04-25\u0026children=0\u0026currency=USD\u0026engine=google_hotels\u0026gl=us\u0026hl=en\u0026property_token=ChkQyvyh6_HY1N5SGg0vZy8xMXkzaGg5bnZtEAI\u0026q=New+Orleans",
      "total_rate": {
        "before_taxes_fees": "$95",
        "extracted_before_taxes_fees": 95,
        "extracted_lowest": 226,
        "lowest": "$226"
      },
      "type": "vacation rental"
    }
  ]
}
```
{% endcode %}
{% endtab %}
{% endtabs %}

