Google Hotels

Google Hotels search by place and dates, and a property's details and every booking site's offers.

Call these actions with your String API key; see Authentication. Every call answers with the envelope described in Responses & errors, whose data holds the rows below.

Site: googlehotels
Version: 2.0.0
Reads from: www.google.com

Action	Description	Listed price
`search`	Search Google Hotels for places to stay at a location for given dates and guests, with price, guest rating and star class filters. Rows carry each property's lowest nightly and total price, rating, review count, star class, coordinates, amenities and thumbnail, and the propertyToken the hotel action takes for every booking site's offer and the street address, which search results do not carry. Vacation rentals appear among the hotels, marked by kind.	Billed per request at your plan's rates
`hotel`	Read Google Hotels properties by property token or URL for given dates and guests: address, phone, star class, rating with review counts by stars, amenities, check-in times, the lowest price, and every booking site's offer (site name, nightly and total price with and without taxes, free cancellation, link).	Billed per request at your plan's rates

`search`

Search Google Hotels for places to stay at a location for given dates and guests, with price, guest rating and star class filters. Rows carry each property's lowest nightly and total price, rating, review count, star class, coordinates, amenities and thumbnail, and the propertyToken the hotel action takes for every booking site's offer and the street address, which search results do not carry. Vacation rentals appear among the hotels, marked by kind.

POST https://request.usestring.ai/v1/integrations/googlehotels/search

Input

Unknown fields are rejected.

Field	Type	Description
`query`	string	Required. Where to stay: a place Google Hotels can resolve, such as a city, neighbourhood or landmark (Boston, Shibuya, Times Square). A phrase such as hotels near Times Square resolves to no place and fails the search. At least 1 character.
`checkIn`	string	Required. Check-in date, YYYY-MM-DD. Matches `^\d{4}-\d{2}-\d{2}$`.
`checkOut`	string	Required. Check-out date, YYYY-MM-DD, after checkIn. Matches `^\d{4}-\d{2}-\d{2}$`.
`adults`	integer	Adult guests. Defaults to 2. At least 1.
`children`	integer[] \| null	Each child guest's age, 0 to 17.
`currency`	string	The currency prices are quoted in, ISO 4217 such as USD, EUR or GBP. Defaults to USD. Matches `^[A-Za-z]{3}$`.
`minPrice`	integer \| null	Only properties whose nightly price before taxes is at least this, in currency. At least 0.
`maxPrice`	integer \| null	Only properties whose nightly price before taxes is at most this, in currency. At least 0.
`minRating`	`3.5` `4` `4.5`	Only properties with a guest rating of at least 3.5, 4 or 4.5.
`hotelClass`	integer[] \| null	Only hotels of these star classes, 2 to 5.
`limit`	integer	The most properties to return, 1 to 200. Defaults to 20. From 1 to 200.

Output

data is an array of rows, one per result. Each row has:

Field	Type	Description
`position`	integer	Position in the results, from 1, in Google Hotels' order.
`name`	string	—
`propertyToken`	string	Google Hotels' id for the property, as in google.com/travel/hotels/entity/<propertyToken>; the hotel action takes it.
`kind`	`hotel` `vacationRental` `null`	hotel or vacationRental.
`category`	string \| null	The property's Google category, such as hotel, hostel, inn or bed_and_breakfast; null for a vacation rental.
`url`	string	The property's Google Hotels page.
`hotelClass`	integer \| null	Star class, 1 to 5; null when Google Hotels gives none.
`rating`	number \| null	Average guest rating out of 5.
`reviewCount`	integer \| null	—
`latitude`	number \| null	—
`longitude`	number \| null	—
`description`	string \| null	Google's one-line summary of the property.
`amenities`	string[]	The amenities Google Hotels lists the property as having, as its search card labels them.
`thumbnail`	string \| null	—
`checkInTime`	string \| null	Earliest check-in, such as 4:00 PM.
`checkOutTime`	string \| null	Latest check-out, such as 11:00 AM.
`website`	string \| null	The property's own site.
`currency`	string \| null	—
`pricePerNight`	number \| null	The lowest nightly price before taxes, as Google Hotels shows it: the room rate plus the property's fees, per night.
`roomRate`	number \| null	The room rate for the whole stay, before fees and taxes.
`fees`	number \| null	The property's own fees for the stay, such as a resort or cleaning fee.
`taxes`	number \| null	Taxes on the stay.
`totalPriceWithTaxes`	number \| null	roomRate plus fees plus taxes.

Example

curl https://request.usestring.ai/v1/integrations/googlehotels/search \
  -H "Authorization: Bearer $STRING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "Boston",
    "checkIn": "2026-11-10",
    "checkOut": "2026-11-12",
    "limit": 3
  }'

data starts with these rows:

[
  {
    "position": 1,
    "name": "Hyatt Place Boston / Seaport District",
    "propertyToken": "ChoI0pulr-XwydiOARoNL2cvMTFqOGh5ZzYxdxAB",
    "kind": "hotel",
    "category": "hotel",
    "url": "https://www.google.com/travel/hotels/entity/ChoI0pulr-XwydiOARoNL2cvMTFqOGh5ZzYxdxAB",
    "hotelClass": 3,
    "rating": 4.5,
    "reviewCount": 992,
    "latitude": 42.3475646,
    "longitude": -71.0368804,
    "description": "Polished hotel featuring a bar with a lounge, a terrace & harbor views, plus a gym & breakfast.",
    "amenities": ["Free breakfast", "Free Wi-Fi", "Paid parking", "Air conditioning", "Pet-friendly", "Fitness center", "Bar", "Restaurant", "Wheelchair accessible", "Business center", "Smoke-free property"],
    "thumbnail": "https://lh3.googleusercontent.com/grass-cs/AABkmLcAJaNCrKaNA2y9jNUZ7vqmPhlz7SL0DXBvCV6oARyrp3wVW4Z6AIREiVlOEvB8e1rV-vRSUcM0yItgEcifClT0EqksTBRMBa2ArxrNdku8H4FrZHtfBnOXAIJGcyMzO87nxk6sLq6TsDXd=s150-w92-h150-n-k-no",
    "checkInTime": "3:00 PM",
    "checkOutTime": "12:00 PM",
    "website": "https://www.hyatt.com/hyatt-place/en-US/boszs-hyatt-place-boston-seaport-district?src=corp_lclb_google_seo_boszs&utm_source=google&utm_medium=organic&utm_campaign=lmr",
    "currency": "USD",
    "pricePerNight": 163.34,
    "roomRate": 326.69,
    "fees": 0,
    "taxes": 53.89,
    "totalPriceWithTaxes": 380.58
  },
  {
    "position": 2,
    "name": "The Revolution Hotel",
    "propertyToken": "ChkI0sm138C0tN1tGg0vZy8xMWduMGxzMWs4EAE",
    "kind": "hotel",
    "category": "hotel",
    "url": "https://www.google.com/travel/hotels/entity/ChkI0sm138C0tN1tGg0vZy8xMWduMGxzMWs4EAE",
    "hotelClass": 3,
    "rating": 4.4,
    "reviewCount": 596,
    "latitude": 42.3459092,
    "longitude": -71.0709013,
    "description": "Minimalist rooms in a trendy, industrial hotel offering free loaner bikes and a bright lobby bar.",
    "amenities": ["Free Wi-Fi", "Paid parking", "Air conditioning", "Pet-friendly", "Fitness center", "Bar", "Restaurant", "Kitchen in some rooms", "Wheelchair accessible", "Business center", "Kid-friendly", "Smoke-free property"],
    "thumbnail": "https://lh3.googleusercontent.com/grass-cs/ACvplmNO9GUiTZRYRGT9FWLvFYQwRXtSlixeLVNUKFm0icvocQVrBLqFitW1bEf1jhLN1da6824o0xISeLT90RaQG7aeJxre-2WdFck7N1E_DSZO40baCqL91-lZujcdd0XuD0_rdqbnNg=s150-w92-h150-n-k-no",
    "checkInTime": "4:00 PM",
    "checkOutTime": "12:00 PM",
    "website": "https://therevolutionhotel.com/?utm_source=gmblisting&utm_medium=organic",
    "currency": "USD",
    "pricePerNight": 111,
    "roomRate": 222.01,
    "fees": 0,
    "taxes": 36.51,
    "totalPriceWithTaxes": 258.52
  }
]

Requests and billing

Requests: 1 Web Access request per result page, plus up to 1 setup request per call.
Billing: passthrough. Each request the action makes bills at its own rate on your plan; there is no separate charge for the action. See Pricing.

`hotel`

Read Google Hotels properties by property token or URL for given dates and guests: address, phone, star class, rating with review counts by stars, amenities, check-in times, the lowest price, and every booking site's offer (site name, nightly and total price with and without taxes, free cancellation, link).

POST https://request.usestring.ai/v1/integrations/googlehotels/hotel