Google Hotel Details API
curl --request POST \
--url https://api.socq.ai/v1/google-hotels/hotel-details \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"hotel_id": "<string>",
"callback_url": "<string>",
"check_in": "<string>",
"check_out": "<string>",
"currency": "<string>",
"language_code": "en",
"location_code": 2840
}
'import requests
url = "https://api.socq.ai/v1/google-hotels/hotel-details"
payload = {
"hotel_id": "<string>",
"callback_url": "<string>",
"check_in": "<string>",
"check_out": "<string>",
"currency": "<string>",
"language_code": "en",
"location_code": 2840
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
hotel_id: '<string>',
callback_url: '<string>',
check_in: '<string>',
check_out: '<string>',
currency: '<string>',
language_code: 'en',
location_code: 2840
})
};
fetch('https://api.socq.ai/v1/google-hotels/hotel-details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/google-hotels/hotel-details",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'hotel_id' => '<string>',
'callback_url' => '<string>',
'check_in' => '<string>',
'check_out' => '<string>',
'currency' => '<string>',
'language_code' => 'en',
'location_code' => 2840
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/google-hotels/hotel-details"
payload := strings.NewReader("{\n \"hotel_id\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"check_in\": \"<string>\",\n \"check_out\": \"<string>\",\n \"currency\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/google-hotels/hotel-details")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"hotel_id\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"check_in\": \"<string>\",\n \"check_out\": \"<string>\",\n \"currency\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/google-hotels/hotel-details")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"hotel_id\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"check_in\": \"<string>\",\n \"check_out\": \"<string>\",\n \"currency\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}Google Hotels
Google Hotel Details
Get a hotel’s address, amenities, location scores, guest rating breakdown, review topics and offers from every booking site.
POST
/
v1
/
google-hotels
/
hotel-details
Google Hotel Details API
curl --request POST \
--url https://api.socq.ai/v1/google-hotels/hotel-details \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"hotel_id": "<string>",
"callback_url": "<string>",
"check_in": "<string>",
"check_out": "<string>",
"currency": "<string>",
"language_code": "en",
"location_code": 2840
}
'import requests
url = "https://api.socq.ai/v1/google-hotels/hotel-details"
payload = {
"hotel_id": "<string>",
"callback_url": "<string>",
"check_in": "<string>",
"check_out": "<string>",
"currency": "<string>",
"language_code": "en",
"location_code": 2840
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
hotel_id: '<string>',
callback_url: '<string>',
check_in: '<string>',
check_out: '<string>',
currency: '<string>',
language_code: 'en',
location_code: 2840
})
};
fetch('https://api.socq.ai/v1/google-hotels/hotel-details', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/google-hotels/hotel-details",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'hotel_id' => '<string>',
'callback_url' => '<string>',
'check_in' => '<string>',
'check_out' => '<string>',
'currency' => '<string>',
'language_code' => 'en',
'location_code' => 2840
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/google-hotels/hotel-details"
payload := strings.NewReader("{\n \"hotel_id\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"check_in\": \"<string>\",\n \"check_out\": \"<string>\",\n \"currency\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/google-hotels/hotel-details")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"hotel_id\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"check_in\": \"<string>\",\n \"check_out\": \"<string>\",\n \"currency\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/google-hotels/hotel-details")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"hotel_id\": \"<string>\",\n \"callback_url\": \"<string>\",\n \"check_in\": \"<string>\",\n \"check_out\": \"<string>\",\n \"currency\": \"<string>\",\n \"language_code\": \"en\",\n \"location_code\": 2840\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}Google Hotel Details
Everything Google Hotels knows about one property in a single row. You get the address, phone and website, check-in time, the amenity list, scores for the neighborhood’s transit, restaurants and attractions, the share of reviews at each star rating, the topics guests praise or complain about, ratings on other review sites, and the price each booking site charges for your stay. Ideal for rate-parity checks, competitive set analysis or a richer hotel page in your own product.{
"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB",
"currency": "USD"
}
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, usefields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | Yes | Hotel ID; pass it to Hotel Details or Hotel Prices. |
platform | string | No | Platform the result belongs to, such as instagram or linkedin. |
resource | string | No | SocQ resource represented by the result, such as videos or comments. |
type | string | No | Category of the result item, such as video, post, or comment. |
url | string | Yes | URL of the hotel on Google Hotels. |
published_at | string | Yes | Time the source item was published, in ISO 8601 format when available. |
collected_at | string | No | Time SocQ collected or processed this result, in ISO 8601 format. |
name | string | Yes | Name of the hotel. |
text | string | Yes | Description of the hotel (details only). |
stars | integer | Yes | Star class of the hotel, from 1 to 5. |
rating | number | Yes | Average guest rating from 1 to 5. |
reviews_count | integer | Yes | Number of guest reviews. |
price | object | Yes | Lowest nightly price for the stay. |
price.amount | number | Yes | Price as a number. |
price.currency | string | Yes | Three-letter currency code of the price. |
price.formatted | string | Yes | Price with its currency code, such as USD 176. |
check_in | string | Yes | Check-in date the price is for, in YYYY-MM-DD format. |
check_out | string | Yes | Check-out date the price is for, in YYYY-MM-DD format. |
is_sponsored | boolean | Yes | Whether the listing is a sponsored placement. |
address | string | Yes | Street address of the hotel (details only). |
phone | string | Yes | Phone number of the hotel (details only). |
website | string | Yes | Official website of the hotel (details only). |
location | object | Yes | Where the hotel is. |
location.name | string | Yes | Neighborhood of the hotel (details only). |
location.city | string | Yes | City name. |
location.region | string | Yes | Region, state, or province name. |
location.country | string | Yes | Country or territory name or code. |
location.latitude | number | Yes | Latitude in decimal degrees. |
location.longitude | number | Yes | Longitude in decimal degrees. |
location_scores | object | Yes | Location ratings from 1 to 5 (details only). |
location_scores.overall | number | Yes | Overall location score. |
location_scores.things_to_do | number | Yes | Score for nearby attractions and activities. |
location_scores.restaurants | number | Yes | Score for nearby restaurants. |
location_scores.transit | number | Yes | Score for public transport access. |
location_scores.airport_access | number | Yes | Score for access to the airport. |
check_in_time | string | Yes | Earliest check-in time, as HH:MM (details only). |
check_out_time | string | Yes | Latest check-out time, as HH:MM (details only). |
amenities | array<string> | Yes | Amenities the hotel offers, such as Free Wi-Fi or Pool (details only). |
rating_distribution | array<object> | Yes | Share of guest reviews at each star rating (details only). |
rating_distribution.stars | integer | Yes | Star rating, from 1 to 5. |
rating_distribution.share | number | Yes | Share of reviews with this rating, from 0 to 1. |
review_topics | array<object> | Yes | Topics guests mention in reviews, with how they feel about each (details only). |
review_topics.name | string | Yes | Topic, such as Location or Breakfast. |
review_topics.positive_count | integer | Yes | Reviews that speak well of the topic. |
review_topics.negative_count | integer | Yes | Reviews that speak badly of the topic. |
review_topics.mentions_count | integer | Yes | Reviews that mention the topic. |
other_reviews | array<object> | Yes | Ratings of the hotel on other review sites (details only). |
other_reviews.source | string | Yes | Name of the review site. |
other_reviews.url | string | Yes | URL of the hotel’s reviews on that site. |
other_reviews.rating | number | Yes | Rating on that site, out of 5. |
other_reviews.reviews_count | integer | Yes | Number of reviews on that site. |
other_reviews.text | string | Yes | Excerpt of a review from that site. |
offers | array<object> | Yes | Prices from each booking site for the stay (details only). |
offers.seller | string | Yes | Booking site or the hotel itself. |
offers.price | object | Yes | Nightly price on that site. |
offers.price.amount | number | Yes | Price as a number. |
offers.price.currency | string | Yes | Three-letter currency code of the price. |
offers.price.formatted | string | Yes | Price with its currency code, such as USD 176. |
offers.url | string | Yes | Booking link on Google Hotels for that site. |
offers.is_official | boolean | Yes | Whether the offer comes from the hotel’s own website. |
offers.is_sponsored | boolean | Yes | Whether the offer is a sponsored placement. |
offers.free_cancellation_until | string | Yes | Time until which the booking can be cancelled for free, when offered. |
images | array<string> | Yes | URLs of photos of the hotel. |
rank | integer | Yes | Position of the hotel in the search results, starting at 1 (search only). |
query | string | Yes | Search the results are for (search only). |
Completed Task Response
{
"code": 200,
"data": {
"task_id": "example-google-hotels-hotel-details",
"status": "succeeded",
"public_id": "google-hotels/hotel-details",
"result_count": 1,
"credits_amount": 2,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "hotel",
"schema_version": "1.0",
"items": [
{
"id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB",
"platform": "google-hotels",
"resource": "hotel-details",
"type": "hotel",
"url": "https://www.google.com/travel/hotels/entity/ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB",
"published_at": null,
"collected_at": "2026-11-17T23:54:22.651788Z",
"name": "The Rockaway Hotel",
"text": null,
"stars": 4,
"rating": 4.6,
"reviews_count": 1791,
"price": {
"amount": 206,
"currency": "USD",
"formatted": "USD 206"
},
"check_in": "2026-11-18",
"check_out": "2026-11-19",
"is_sponsored": null,
"address": "108-10 Rockaway Beach Dr, Rockaway Park, NY 11694",
"phone": "+17184741216",
"website": "https://www.therockawayhotel.com/",
"location": {
"name": "Queens",
"city": null,
"region": null,
"country": null,
"latitude": 40.5815002,
"longitude": -73.8300876
},
"location_scores": {
"overall": 3.2,
"things_to_do": 2.9,
"restaurants": 3.1,
"transit": 4.8,
"airport_access": 4.1
},
"check_in_time": "15:00",
"check_out_time": null,
"amenities": [
"Wi-Fi",
"Wi-Fi in public areas",
"Public internet workstation"
],
"rating_distribution": [
{
"stars": 5,
"share": 0.8
},
{
"stars": 4,
"share": 0.1
},
{
"stars": 3,
"share": 0.04
}
],
"review_topics": [
{
"name": "Wellness",
"positive_count": 135,
"negative_count": 17,
"mentions_count": 166
},
{
"name": "Spa",
"positive_count": 118,
"negative_count": 14,
"mentions_count": 146
},
{
"name": "Pool",
"positive_count": 110,
"negative_count": 9,
"mentions_count": 130
}
],
"other_reviews": [
{
"source": "Tripadvisor",
"url": "https://www.tripadvisor.com/ShowUserReviews-g48508-d20404929-r1075778183?m=68573&staydates=2026_11_29_2026_11_30&uguests=1_2_0&supdv=desktop&supuc=US&supul=en",
"rating": 4.300000190734863,
"reviews_count": 229,
"text": "Ritz Carlton level of service, if not higher, in every place around the hotel. We experienced 95% of what they have to offer and it was all A+"
},
{
"source": "Trip.com",
"url": "https://www.trip.com/hotels/detail?hotelid=58601219&Allianceid=810504&Sid=1394411&utm_medium=cpc&utm_campaign=HPA&utm_source=google#review",
"rating": 4.300000190734863,
"reviews_count": 104,
"text": "Probably better to book directly with Hotel. State of emergency and no one could help with adjusting our day. It is a nice place, the service is great. However during checkout I noticed added charges, that I am waiting getting fixed."
}
],
"offers": [
{
"seller": "Hotels.com",
"price": {
"amount": 206,
"currency": "USD",
"formatted": "USD 206"
},
"url": "https://google.com/aclk?sa=l&ai=DChsSEwjttMLnmZCYAxXitwMAHVzMBpsYACICCAEQARoCb2E&co=1&ase=2&gclid=EAIaIQobChMI7bTC55mQmAMV4rcDAB1czAabEAoYASABEgJifPD_BwE&cid=CAASuwHkaPZGjV1Mq-rp2nJFK8IwrwvExCeiQ-H7JdZScQOaNHYbOnPrxOrOshynrHx1nps2GLS3FcI8-U_6tm8S7rW0XgbU_KWDb4lANIgiwmAW1eLKd7PVl6ORhZmNF61LRbIilr48s28ExFa_PDulRDbqdoMj4y-HCwb_E8wCMBjxi09GWoGQAA4y0eYh-UZyjIF6dGPQ04aY2SrGkmi06OIbcBO__XBhpwwA4m7iUuINsL-Nal6VJL9af7gl&category=acrcp_v1_48&sig=AOD64_2mDalbcTS5poMt_i4t-CfoMuV9DQ&adurl",
"is_official": false,
"is_sponsored": true,
"free_cancellation_until": null
},
{
"seller": "Priceline",
"price": {
"amount": 240,
"currency": "USD",
"formatted": "USD 240"
},
"url": "https://google.com/aclk?sa=l&ai=DChsSEwjttMLnmZCYAxXitwMAHVzMBpsYACICCAEQDRoCb2E&co=1&ase=2&gclid=EAIaIQobChMI7bTC55mQmAMV4rcDAB1czAabEAoYAiABEgKBWfD_BwE&cid=CAASuwHkaPZGjV1Mq-rp2nJFK8IwrwvExCeiQ-H7JdZScQOaNHYbOnPrxOrOshynrHx1nps2GLS3FcI8-U_6tm8S7rW0XgbU_KWDb4lANIgiwmAW1eLKd7PVl6ORhZmNF61LRbIilr48s28ExFa_PDulRDbqdoMj4y-HCwb_E8wCMBjxi09GWoGQAA4y0eYh-UZyjIF6dGPQ04aY2SrGkmi06OIbcBO__XBhpwwA4m7iUuINsL-Nal6VJL9af7gl&category=acrcp_v1_48&sig=AOD64_3ChNPm9Bp1ahmfS6DbEfne0GmUWQ&adurl",
"is_official": false,
"is_sponsored": true,
"free_cancellation_until": null
},
{
"seller": "Expedia.com",
"price": {
"amount": 206,
"currency": "USD",
"formatted": "USD 206"
},
"url": "https://google.com/aclk?sa=l&ai=DChsSEwjttMLnmZCYAxXitwMAHVzMBpsYACICCAEQERoCb2E&co=1&ase=2&gclid=EAIaIQobChMI7bTC55mQmAMV4rcDAB1czAabEAoYAyABEgI9cvD_BwE&cid=CAASuwHkaPZGjV1Mq-rp2nJFK8IwrwvExCeiQ-H7JdZScQOaNHYbOnPrxOrOshynrHx1nps2GLS3FcI8-U_6tm8S7rW0XgbU_KWDb4lANIgiwmAW1eLKd7PVl6ORhZmNF61LRbIilr48s28ExFa_PDulRDbqdoMj4y-HCwb_E8wCMBjxi09GWoGQAA4y0eYh-UZyjIF6dGPQ04aY2SrGkmi06OIbcBO__XBhpwwA4m7iUuINsL-Nal6VJL9af7gl&category=acrcp_v1_48&sig=AOD64_0DwzYWyJs-1IEsz6XQB34gWzq9MA&adurl",
"is_official": false,
"is_sponsored": true,
"free_cancellation_until": null
}
],
"images": [
"https://lh3.googleusercontent.com/grass-cs/AABkmLfo__PIr6n9Zm8EP9Vl8usPu2VfsitYLenrvlQRE3y0W-kJNPC7LAVu6rqk2E6a1DqNEvUB9VVo0QvDeyoKDsJZf6FUtzDj-sKTGR2KmT9OYV6KQ1tm-PictQy9dHYUKEyqW5ZK=s287-w287-h192-n-k-no-v1",
"https://lh3.googleusercontent.com/grass-cs/AABkmLcPSuGEN38ayG11FEdE-3bkuUoo8cdJFyPlOb84MjOd53IDUnYC81kcSVr62wQEDVapW1rTfpghJ5ynGrnBzS6KcpbaCIarNm61FplOJmWxguIRpLseHioQqkVIRpRnsG4DV7Qx8g=s287-w287-h192-n-k-no-v1",
"https://lh3.googleusercontent.com/grass-cs/AABkmLfOoJ-il_uwZFzkQQdsFJkC5mvJA--sBQ3PW3A6wIaQ5DoS2a-1C225Lmxv3QEx8_UWaCsB-nXWfZ-ztn36i-_X0f-_8Shqz9R4T03KQmRQV6bT7mvSJIEhDypyJwmVOKAW7x7-UA=s287-w287-h192-n-k-no-v1"
],
"rank": null,
"query": null
}
]
}
}
}
Authorizations
bearerAuthapiKeyAuth
Body
application/json
Provide a hotel_id from Google Hotels Search. The result is one row with the hotel's address, contact details, amenities, location scores, guest ratings, review topics and the offers from each booking site for the chosen stay.

