search_hotels

Google Hotels results for a place and dates: hotel, price per night, rating, reviews, amenities and link. ₹0.48 per call; a result that finds nothing is ₹0.

What it does

The hotels Google Hotels lists for a place and dates: data with up to eighteen hotels, each with name, price per night in your currency, guest rating and review count, stars, amenities and the link; filter by stars, min_rating, min_price, max_price, free_cancellation and sort by rating or price.

Use it to compare stays for a trip or to see where a hotel sits against its neighbours; for the places themselves use search_maps, for reviews get_maps_reviews. Flat price per call. Five to fifteen seconds.

India: location_name "Goa, India" with currency "INR".

Inputs

Generated from the contract captured from staging on 2026-11-05.

FieldTypeRequiredDescription
depthintegernoHow many hotels, up to 18.; max 18
starsarray of valuesnoStar ratings to keep ([4, 5]).
adultsintegernoNumber of adults. Default 2.
keywordstringnoWhat and where, as you would type into Google Hotels: "hotels in Goa", "boutique hotel Jaipur", "hotel near Dubai Mall".
sort_bystringnohighest_rating, lowest_price or relevance.
check_instringnoYYYY-MM-DD. Default tomorrow.
childrenarray of valuesnoAges of children, as strings (["8"]).
currencystringno"INR", "USD".
check_outstringnoYYYY-MM-DD. Default two nights from check-in.
max_priceintegernoHighest price per night in the currency.
min_priceintegernoLowest price per night in the currency.
min_ratingnumbernoMinimum guest rating (4.2).
language_codestringnoTwo-letter language code ("en").
free_cancellationbooleannoOnly hotels with free cancellation.

What drives the cost

Flat per call for up to eighteen hotels. A result that finds nothing is class: "ok_free", ₹0. The timeout is 31 seconds.

Price today

Price today₹0.48 per call (cost_paise: 48) at ₹93.93 per US dollar on 17 November 2026
Hold before the call₹0.72 (hold_paise: 72); when the call settles the real price is charged and the unused part is released
₹0 whenit fails, or the provider answers but there is nothing in it (an empty list, no email, no page): class: "ok_free", ₹0
Timeout31 s, then upstream_timeout (₹0, retryable)
Over MCPrun_tool with tool: "search_hotels"
Over RESTPOST https://api.parel.si/v1/run with "tool": "search_hotels"
Confirmationnot needed (the estimate is under the ₹200 threshold)

Request

curl https://api.parel.si/v1/run \
  -H "Authorization: Bearer $PAREL_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"search_hotels","input":{"depth":10,"adults":2,"keyword":"boutique hotel Goa","sort_by":"highest_rating","currency":"INR","language_code":"en"}}'

What comes back

data, as the live check of 2026-11-05 recorded it, trimmed:

{
  "keyword": "boutique hotel Goa, India",
  "location_code": 2356,
  "language_code": "en",
  "check_url": "https://www.google.co.in/travel/search?q=boutique+hotel+Goa%2c+India&hl=en&gl=IN&ap=KigKEgmkd1Ix555AwBEYK9nRiuVHQBISCRtQA29xm1JAEe5m8j16iFtAMAA&ts=CAESCAoCCAMKAggDGmUKRxIbOhlib3V0aXF1ZSBob3RlbCBHb2EsIEluZGlhGigKEgmkd1Ix555AwBEYK9nRiuVHQBISC…",
  "datetime": "2026-11-05 15:15:24 +00:00",
  "items_count": 18,
  "items": [
    {
      "type": "hotel_search_item",
      "hotel_identifier": "ChoI28n04o7x1a7LARoNL2cvMTF5OG1obXhfahAB",
      "title": "Arambol Bliss Hotel Apartments",
      "stars": 0,
      "is_paid": false,
      "location": {
        "latitude": 15.6926584,
        "longitude": 73.7034699
      },
      "reviews": {
        "value": 5,
        "votes_count": 546,
        "mentions": null,
        "rating_distribution": null,
        "other_sites_reviews": null
      },
      "overview_images": [
        "https://lh3.googleusercontent.com/grass-cs/AABkmLe-Mtgqo_LSeH9FdHWRkVnmCgZCuRSHkONvkNMwnh3NA7ky5xOL1NQ4BeFZKoSFVI8l9LvQlQX2VVzZjolabd9M4nFGnfEEEFPQDVVN2d3gunJtAjlt-pHROhPgH-NYK64sQhpPJ8R4RMsR=s287-w287-h192-n-k-no-v1",
        "https://lh3.googleusercontent.com/grass-cs/AABkmLc_4jZYa3faGmGJ5U9oDacT5T-0kSJ8dMdTh41TdOn5k3x_oSXHcIQjIqYfRdbRSw2g-bc7zSb9-V0vT5OylUjAr49jIYrxurR-j_fqvRJ1HpEnDVG70quiNl_wSOp1U5JKttXYh3o9Kayw=s287-w287-h192-n-k-no-v1",
        "https://lh3.googleusercontent.com/grass-cs/AABkmLc2EJGnpTnEYPqmKrLVpyRXET2QWfCTJz_Cid7SMdUf4uk-czvdOzVxd0KJe1wXnALHKavW7kv_zZzdczU-42Vird1o2HD6MkWSwMLPrtGWlor1k1C0dZBeMEBLhQAUwk8z8dsDWejr4YMP=s287-w287-h192-n-k-no-v1"
      ],
      "prices": {
        "price": 2302,
        "price_without_discount": null,
        "currency": "INR",
        "discount_text": null,
        "check_in": "2026-11-06 00:00:00 +00:00",
        "check_out": "2026-11-07 00:00:00 +00:00",
        "visitors": 2,
        "items": null,
        "prices_by_dates": null
      }
    },
    {
      "type": "hotel_search_item",
      "hotel_identifier": "ChoIie2RtLnbvubQARoNL2cvMTFyYnl5Y3lkeBAB",
      "title": "Radisson Resort Goa Baga",
      "stars": 5,
      "is_paid": false,
      "location": {
        "latitude": 15.5704321,
        "longitude": 73.7566563
      },
      "reviews": {
        "value": 4.9,
        "votes_count": 6596,
        "mentions": null,
        "rating_distribution": null,
        "other_sites_reviews": null
      },
      "overview_images": [
        "https://lh3.googleusercontent.com/grass-cs/AABkmLfc7H-3eiz41xL9JzKC3SGMesy6VQLEK8iiy1S6VJwTQ1fGTq8iQmw4RAhyblXdBOcJGXSRjb112xzXehHY4tgf04xRudwAZ4q7XTpRCY-IGNbLgR_sJBGk0s8QgUUzuQNZkWEtiQ=s287-w287-h192-n-k-no-v1",
        "https://lh3.googleusercontent.com/grass-cs/AABkmLeceDs3nANKi8APNO3JXLG2aoLnR3OUCn9XRzPv6w_OnPU_l2Scr2TaJ3NgYIol9XatDJiBQiGJO8AYmb0CDoCmK3KE-MmsSjJ_rM4AnJLALfDrVvCqYpNLGr6UPdS1_0pFht3WRpFDMeE7=s287-w287-h192-n-k-no-v1",
        "https://lh3.googleusercontent.com/grass-proxy/AIM7gW34Cr9pQS-xPveJn6ulSv6fyNjefnPXMcNCxr2eFQMhu2R6Pf2zhbMyOHcn5Ks1e7X_Ya7wQBN4Uc3K-qnzsQawMEU8Tz2V7h6mSt0IG4xMq8O2tGTQ2pb_4ViVXSZZn1o0RLksVaEsHGUkq5N829ZUxp9SR7dYZ0aAdeVzpdZpAAWOhddq4n0=s287-w…"
      ],
      "prices": {
        "price": 5264,
        "price_without_discount": null,
        "currency": "INR",
        "discount_text": "54% less than usual",
        "check_in": "2026-11-06 00:00:00 +00:00",
        "check_out": "2026-11-07 00:00:00 +00:00",
        "visitors": 2,
        "items": null,
        "prices_by_dates": null
      }
    },
    {
      "type": "hotel_search_item",
      "hotel_identifier": "ChkIlpGV6r7-2MItGg0vZy8xMXZxdDkya3hjEAE",
      "title": "Golden Landmark Green Valley Beach Resort",
      "stars": 0,
      "is_paid": false,
      "location": {
        "latitude": 15.456079700000002,
        "longitude": 73.8157844
      },
      "reviews": {
        "value": 4.9,
        "votes_count": 1500,
        "mentions": null,
        "rating_distribution": null,
        "other_sites_reviews": null
      },
      "overview_images": [
        "https://lh3.googleusercontent.com/grass-cs/AABkmLdzmgp4vWwJR_2wPi0b6KKoVigVArXJGXl5DJ3BQETYthe_qcPKeZAN2XO0h723M4bmsBiVA3o7Oi4flDtZZw-mG6DQnKDH-hxaU25W9iZCvFTBTUanC03b3gDm6lYL4zVieVohV7ynkznN=s287-w287-h192-n-k-no-v1",
        "https://lh3.googleusercontent.com/grass-cs/AABkmLeejnS0AxizPqTOS3w_f2qIcVawXiMtrJQCRwx9iZye71ozArSd2kggz300rBZpQLRSa8K-_5HMtuPCR9AvtmCv-2KVsj1aQAMsTIf1XwvpbjxVqUz0c_fh5WNrXd50de9RFDWk=s287-w287-h192-n-k-no-v1",
        "https://lh3.googleusercontent.com/grass-cs/AABkmLcxzkMgRRhYtVRADhwgmd5v7shFTlNYumZQZ0oDM5f_Mw4825LpduhkD_Q7zbsqU2vfhx4DyfBtcZXokuWU9THtCUpPxSXXeOCAARPokfMfNbH7MIZ5CtXTh2bxB4IAKLAt0Z8qJg=s287-w287-h192-n-k-no-v1"
      ],
      "prices": {
        "price": 4400,
        "price_without_discount": null,
        "currency": "INR",
        "discount_text": null,
        "check_in": "2026-11-06 00:00:00 +00:00",
        "check_out": "2026-11-07 00:00:00 +00:00",
        "visitors": 2,
        "items": null,
        "prices_by_dates": null
      }
    }
  ]
}

Notes

  • Flat per call for up to eighteen hotels.
  • Prices are Google's quoted rate per night for the dates you give; without dates it is tomorrow for two nights.
  • Name the place as Google does: city, state, country.
  • The place goes in the keyword; results come from Google Hotels as seen from India, in the currency you ask for.

Siblings

This page as Markdown: /docs/tools/search_hotels.md. Something wrong or missing: hello@parel.si.