Back to APIs
Google Hotels data

Google Hotels Data APIs

Search hotels by destination, open any hotel's full Google Hotels profile and pull its nightly price calendar, all linked by one hotel ID.

Available Google Hotels APIs

Start with Google Hotels API to find hotels and their IDs, then use Google Hotel Details API for one hotel's profile and offers, or Hotel Price Tracker API for its price by check-in date.

What Google Hotels data can you retrieve?

Every row describes one hotel or one night, with prices in the currency you choose and a hotel ID that connects the three APIs.

Hotel listings with prices

Name, rank, the lowest nightly price for your dates, sponsored flag and a link to the hotel's Google Hotels page.

Ratings and guest reviews

Star class, average guest rating from 1 to 5, review count, share of each star rating and positive and negative mentions by review topic.

Booking-site offers

The nightly price and booking link from each seller, with flags for the hotel's own site, sponsored offers and free cancellation.

Location and neighborhood

Address, coordinates, neighborhood name and 1–5 scores for things to do, restaurants, transit and airport access.

Nightly price calendar

The lowest price for each check-in date, usually covering the next 6–8 weeks for one hotel.

Which Google Hotels API to use

All three APIs share the same hotel ID, so a search result can feed straight into a details or price-calendar request.

APIStart fromWhat you get
Google Hotels APIA destination or hotel name in queryUp to 140 hotels with nightly price, stars, rating, review count, coordinates and hotel ID
Google Hotel Details APIOne hotel_idOne row with contact details, amenities, location scores, rating distribution, review topics and booking-site offers
Hotel Price Tracker APIOne hotel_idOne row per check-in date with that night's lowest price, usually 6–8 weeks ahead

How the Google Hotels API works

All three APIs use the same asynchronous task flow.

  1. 1. Find hotels

    POST a destination to /v1/google-hotels/search and keep the id of the hotels you want to follow.

  2. 2. Go deeper

    POST a hotel_id to /v1/google-hotels/hotel-details for its profile and offers, or to /v1/google-hotels/hotel-prices for its price calendar.

  3. 3. Read the results

    Poll GET /v1/tasks/{task_id} until status is succeeded, then read the rows in results.items.

Search hotels in a destination

Authenticate with your SocQ API key and send a destination. Each hotel returned costs 0.15 credits.

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}'

# Poll GET /v1/tasks/{task_id}
# Read the hotels in results.items

Common Google Hotels API use cases

Destination price benchmarks

Compare nightly prices by star class and rating across cities for the same dates.

Rate parity checks

Compare a hotel's official rate with online travel agency offers for the same stay.

Competitor monitoring

Track neighboring hotels' price calendars, rating distribution and review topics side by side.

Travel content and listings

Fill hotel pages with addresses, amenities, check-in times, photos and neighborhood scores.

Trip planning

Find the cheapest check-in dates in the coming weeks before booking.

Request rules and pricing

These rules apply across the three Google Hotels APIs.

  • Send check_in and check_out together, in YYYY-MM-DD from today onward, for a stay of up to 30 nights; without them, prices are for one night from tomorrow.
  • Set currency with a three-letter code such as USD or EUR to keep prices comparable across requests.
  • Google Hotels API returns 1–140 hotels per request, 18 by default, and costs 0.15 credits per hotel returned.
  • Google Hotel Details API takes a hotel_id from a search result and costs 2 credits per request.
  • Hotel Price Tracker API takes a hotel_id and costs 4 credits per request for the whole calendar.

Google Hotels API frequently asked questions

What is the Google Hotels API?

The Google Hotels API searches Google Hotels by destination and returns hotels with nightly prices for your dates, star class, guest ratings, review counts, coordinates and a hotel ID for follow-up requests.

Which Google Hotels APIs are available?

Google Hotels API for search, Google Hotel Details API for one hotel's profile and booking-site offers, and Hotel Price Tracker API for its price by check-in date.

Where does the hotel_id come from?

Every row from Google Hotels API has the hotel ID in its id field. Pass that value as hotel_id to the details and price-calendar APIs.

Which dates do the prices cover?

Search and details use your check_in and check_out, up to 30 nights, or one night from tomorrow when both are left out. The price calendar lists one night per check-in date for about 6–8 weeks.

How are Google Hotels requests priced?

Search costs 0.15 credits per hotel returned, Hotel Details costs 2 credits per request and the price calendar costs 4 credits per request.

Bring public profiles, content, and engagement data from different platforms into one workflow to track brands, creators, and topics and run cross-platform monitoring and analysis more efficiently.