Skip to main content
POST
Google Hotels API

Google Hotels

Search hotels the way travelers do on Google, then work with the list as data. Each hotel comes with its name, star class, guest rating and review count, the lowest nightly price for your dates, map coordinates and photos, plus the id you pass to Hotel Details and Hotel Prices. Add check-in and check-out dates and a currency to price a real trip, sort by price or rating, and narrow the list with a price range.
Provide a destination or hotel search in query. check_in and check_out (YYYY-MM-DD, given together, up to 30 nights) price a specific stay; without them prices are for one night from tomorrow. sort_by accepts relevance, lowest_price, highest_rating or most_reviewed. results_limit defaults to 18 and accepts integers from 1 to 140. Each hotel costs 0.15 credits.

Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use fields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null. The following example shows the response format for a completed task. Actual data depends on your query.

Completed Task Response

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Provide a destination or hotel search in query. Add check_in and check_out to price a specific stay; without them prices are for one night from tomorrow. results_limit defaults to 18 and accepts integers from 1 to 140.

query
string
required

Destination or hotel search, such as hotels in new york.

Minimum string length: 1
callback_url
string<uri>
check_in
string

Check-in date in YYYY-MM-DD format. Defaults to tomorrow; give check_out with it.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
check_out
string

Check-out date in YYYY-MM-DD format, after check_in and at most 30 nights later.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$
currency
string

Three-letter currency code for prices, such as USD or EUR.

Pattern: ^[A-Za-z]{3}$
language_code
string
default:en

Language code of the results. Defaults to en.

Required string length: 2 - 10
location_code
integer
default:2840

Search market location code. Defaults to 2840 (United States).

Required range: x >= 1
max_price
number

Highest nightly price to include, in the chosen currency.

Required range: x >= 0
min_price
number

Lowest nightly price to include, in the chosen currency.

Required range: x >= 0
results_limit
integer
default:18
Required range: 1 <= x <= 140
sort_by
enum<string>
Available options:
highest_rating,
lowest_price,
most_reviewed,
relevance
Minimum string length: 1

Response

Task accepted

code
integer
data
object