google-hotels/
hotel-details

The Google Hotel Details API reads one hotel's full Google Hotels profile by hotel ID: contact details, amenities, location scores, guest rating breakdown, review topics and each booking site's offer.

Google Hotel Details API

Booking-site offers
Review topics
Rating breakdown
Location scores
2 credits / request
Ready
Ready

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

README

By SocQ · Updated

Google Hotel Details

A hotel's Google Hotels page combines its address, phone, check-in times and amenity list with what guests report: a rating split by star level, topics such as location or breakfast counted as positive and negative mentions, and scores carried over from other review sites. Set next to the price each booking site and the hotel's own website asks for the same stay, those details support rate-parity checks, competitive-set reviews and richer hotel listings.

Google Hotel Details API Features

  • An offer from every booking siteoffers lists each seller with its nightly price and booking link, and is_official, is_sponsored and free_cancellation_until tell the hotel's own rate, paid placements and flexible offers apart.
  • What guests talk aboutreview_topics names themes such as Wellness or Breakfast with positive_count, negative_count and mentions_count, so you can see which parts of a stay draw praise or complaints.
  • Rating breakdown and other review sitesrating_distribution gives the share of reviews at each star level, and other_reviews carries the rating, review count and an excerpt from sites such as Tripadvisor.
  • Neighborhood scoreslocation_scores rates the area from 1 to 5 overall and for things to do, restaurants, transit and airport access, next to the neighborhood name and coordinates.
  • Property facts in one rowaddress, phone, website, check_in_time, check_out_time, the available amenities, the description and photos arrive together in each Google Hotel Details API row.
  • Offers for your datescheck_in, check_out and currency set the stay the offers are quoted for; without dates they cover one night from tomorrow.

Google Hotel Details API Parameters

ParametersRequiredDescription
hotel_idRequiredHotel ID taken from the id field of Google Hotels API results.
check_inOptionalCheck-in date in YYYY-MM-DD format, today or later. Give check_out with it; without both, offers 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 offer prices, such as USD or EUR.
location_codeOptionalSearch market location code. Defaults to 2840 (United States).
language_codeOptionalLanguage code of the hotel details. Defaults to en.

How to Use the Google Hotel Details API

Send a hotel ID from a hotel search to the Google Hotel Details API and read the hotel as a single row.

  1. POST {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} to /v1/google-hotels/hotel-details.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read the hotel from results.items; has_more and results.next_cursor follow the usual paging rules and stay empty for this single row.
curl -X POST "https://api.socq.ai/v1/google-hotels/hotel-details" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'

Google Hotel Details API Use Cases

  • Rate-parity monitoring: Compare the offer marked is_official with the prices from online travel agencies for the same dates to spot sellers undercutting the hotel's own rate.
  • Competitive-set reviews: Put rating_distribution, review_topics and location_scores of nearby hotels side by side to see where a property leads or trails its rivals.
  • Enriching hotel listings: Fill a travel product's hotel pages with address, amenities, check-in times, photos and neighborhood scores from one Google Hotel Details API lookup.
  • Guest feedback research: Rank review_topics by negative_count to find the parts of a stay, such as noise or breakfast, that guests mention unfavorably most often.

Google Hotel Details API Pro Tips

  • Take hotel IDs from a recent Google Hotels API search, so each 2-credit request returns the hotel you expect.
  • Send the Google Hotel Details API the same check_in, check_out and currency you searched with, so offer prices line up with the search price.
  • Filter offers by is_sponsored before comparing sellers, so paid placements do not skew a parity check.
  • Read rating_distribution.share as a fraction from 0 to 1 when charting how reviews spread across star levels.

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

  • Google Hotels API — Search Google Hotels by destination and get each hotel's nightly price for your dates, star class, guest rating, review count, coordinates and hotel ID.
  • 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 Hotel Details API — FAQ

Google Hotel Details API is a programmatic interface for reading one hotel's Google Hotels profile by hotel ID, returning its contact details, amenities, location scores, rating breakdown, review topics, other-site ratings and the offer from each booking site.

Every row returned by Google Hotels API carries the hotel's ID in its id field; pass that value as hotel_id.

offers lists the booking sites Google Hotels shows for the stay, including the hotel's own website when it takes part, which is flagged with is_official.

rating_distribution shows how reviews spread across star levels, review_topics counts positive and negative mentions per theme, and other_reviews adds each outside site's rating with a short review excerpt.

Each request costs 2 credits and returns the hotel that matches the hotel_id you send.