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
| Parameters | Required | Description |
|---|---|---|
hotel_id | Required | Hotel ID taken from the id field of Google Hotels API results. |
check_in | Optional | Check-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_out | Optional | Check-out date in YYYY-MM-DD format, after check_in and at most 30 nights later. |
currency | Optional | Three-letter currency code for offer prices, such as USD or EUR. |
location_code | Optional | Search market location code. Defaults to 2840 (United States). |
language_code | Optional | Language 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.
- POST {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} to /v1/google-hotels/hotel-details.
- Poll GET /v1/tasks/{task_id} until status is succeeded.
- 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.
Related APIs
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.