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

**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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.myshell.ai/ko/create/pro-config-mode/api-reference/widgets/16-google-hotel-search.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.