google-hotels/
search

The Google Hotels API searches Google Hotels by destination and returns each hotel's nightly price for your dates, star class, guest rating, review count, coordinates and a reusable hotel ID.

Google Hotels API

Destination search
Prices for your dates
Stars and guest ratings
Hotel ID for follow-ups
0.15 credits / result
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Google Hotels

A Google Hotels listing pairs a property's name, star class and map position with its guest rating, review count, photos and the lowest nightly price Google shows for the chosen dates and currency. Read side by side, those signals let you compare the hotel supply of a destination, weigh price against rating and narrow a long list before studying any single property.

Google Hotels API Features

  • Search the way travelers typequery takes a destination or a hotel name, such as hotels in new york, and returns the hotels Google Hotels lists for it in their displayed order, with rank recording each position.
  • Prices for a specific staycheck_in, check_out and currency price the stay you care about, and every row repeats those dates next to price.amount, price.currency and a formatted price.
  • Sorting and nightly price boundssort_by switches between relevance, lowest_price, highest_rating and most_reviewed, while min_price and max_price keep only hotels within a nightly budget in your currency.
  • Quality signals on every hotelstars gives the hotel class, rating the average guest score from 1 to 5 and reviews_count how many reviews stand behind it.
  • Coordinates and photoslocation carries latitude and longitude for mapping, and images lists the photo URLs Google shows for the hotel.
  • Hotel ID for deeper lookupsEach row's id opens the same hotel in Google Hotel Details API and Hotel Price Tracker API, and url links to its Google Hotels page.
  • Up to 140 hotels per searchThe Google Hotels API returns 1 to 140 hotels through results_limit, and is_sponsored marks sponsored placements so they can be kept apart from the regular listing.

Google Hotels API Parameters

ParametersRequiredDescription
queryRequiredDestination or hotel search, such as hotels in new york or a hotel name.
check_inOptionalCheck-in date in YYYY-MM-DD format, today or later. Give check_out with it; without both, prices are for one night from tomorrow.
check_outOptionalCheck-out date in YYYY-MM-DD format, after check_in and at most 30 nights later.
currencyOptionalThree-letter currency code for prices and price bounds, such as USD or EUR.
sort_byOptionalResult order: relevance, lowest_price, highest_rating or most_reviewed.
min_priceOptionalLowest nightly price to include, in the chosen currency.
max_priceOptionalHighest nightly price to include, in the chosen currency; must not be below min_price.
location_codeOptionalSearch market location code. Defaults to 2840 (United States).
language_codeOptionalLanguage code of the results. Defaults to en.
results_limitOptionalNumber of hotels to return, from 1 to 140. Defaults to 18.

How to Use the Google Hotels API

Send a destination search to the Google Hotels API, then read one hotel per row.

  1. POST {"query": "hotels in new york", "currency": "USD", "results_limit": 18} to /v1/google-hotels/search.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read the hotels from results.items; when has_more is true, request the next page with results.next_cursor.
curl -X POST "https://api.socq.ai/v1/google-hotels/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"hotels in new york","currency":"USD","results_limit":18}'

Google Hotels API Use Cases

  • Benchmarking prices in a destination: Line up price.amount against stars and rating for the same dates to see what each class of hotel costs in a city.
  • Building a hotel shortlist: From the Google Hotels API results, keep hotels above a rating and reviews_count threshold inside your price bounds, then pass their id values on for details and offers.
  • Comparing travel dates: Repeat one Google Hotels API query with different check_in and check_out values and join the rows on id to see how each hotel's price moves between dates.
  • Mapping hotel supply: Plot location latitude and longitude with stars and price to see where budget and upscale hotels cluster in a neighborhood.

Google Hotels API Pro Tips

  • Set currency on every run you plan to compare, so price.amount values from different searches share one unit.
  • Send check_in and check_out together; a stay longer than 30 nights or a check-out before check-in is rejected before the task starts.
  • Join later lookups on id rather than the hotel name, since chain properties in one city often share most of their name.
  • Set results_limit to the number of hotels you will actually review, because the Google Hotels API charges 0.15 credits for each hotel returned.

Beyond the Google Hotels API, use these APIs when you need a different type of public Google Hotels data.

  • Google Hotel Details API — Open one hotel's Google Hotels profile by hotel ID, with contact details, amenities, location scores, rating distribution, review topics and booking-site offers.
  • Hotel Price Tracker API — Pull one hotel's Google Hotels price calendar by hotel ID, with the lowest nightly price for each check-in date over roughly the next 6–8 weeks.

Explore other platforms

Combine Google Hotels data with public data from other supported social platforms.

Google Hotels API — FAQ

Google Hotels API is a programmatic interface for searching Google Hotels by destination or hotel name and returning each hotel's nightly price for your dates, star class, guest rating, review count, coordinates, photos and hotel ID.

Prices follow the check_in and check_out you send, for stays of up to 30 nights. When both are left out, prices are for one night starting tomorrow, and each row shows the dates it was priced for.

Yes. min_price and max_price bound the nightly price in your currency, and sort_by orders hotels by relevance, lowest_price, highest_rating or most_reviewed.

Search rows hold listing-level fields. Pass a hotel's id to Google Hotel Details API for its address, amenities, review topics and the offer from each booking site, or to Hotel Price Tracker API for its price by check-in date.

Each hotel returned costs 0.15 credits, so 18 hotels cost 2.7 credits; a search that finds no hotels is not charged.