> Parel documentation. Index of every page: https://parel.si/docs/llms.txt. This page in HTML: https://parel.si/docs/tools/search_hotels

# 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`](https://parel.si/docs/tools/search_maps.md), for reviews [`get_maps_reviews`](https://parel.si/docs/tools/get_maps_reviews.md). 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.

| Field | Type | Required | Description |
|---|---|---|---|
| `depth` | integer | no | How many hotels, up to 18.; max 18 |
| `stars` | array of values | no | Star ratings to keep ([4, 5]). |
| `adults` | integer | no | Number of adults. Default 2. |
| `keyword` | string | no | What and where, as you would type into Google Hotels: "hotels in Goa", "boutique hotel Jaipur", "hotel near Dubai Mall". |
| `sort_by` | string | no | highest_rating, lowest_price or relevance. |
| `check_in` | string | no | YYYY-MM-DD. Default tomorrow. |
| `children` | array of values | no | Ages of children, as strings (["8"]). |
| `currency` | string | no | "INR", "USD". |
| `check_out` | string | no | YYYY-MM-DD. Default two nights from check-in. |
| `max_price` | integer | no | Highest price per night in the currency. |
| `min_price` | integer | no | Lowest price per night in the currency. |
| `min_rating` | number | no | Minimum guest rating (4.2). |
| `language_code` | string | no | Two-letter language code ("en"). |
| `free_cancellation` | boolean | no | Only 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 when | it fails, or the provider answers but there is nothing in it (an empty list, no email, no page): `class: "ok_free"`, ₹0 |
| Timeout | 31 s, then `upstream_timeout` (₹0, retryable) |
| Over MCP | `run_tool` with `tool: "search_hotels"` |
| Over REST | `POST https://api.parel.si/v1/run` with `"tool": "search_hotels"` |
| Confirmation | not needed (the estimate is under the ₹200 threshold) |

## Request

```bash
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:

```json
{
  "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

- [`search_maps`](https://parel.si/docs/tools/search_maps.md)
- [`get_maps_reviews`](https://parel.si/docs/tools/get_maps_reviews.md)
