Google Hotels Search API ​
API health status
Healthy Available Limited Mostly unavailable No data
Loading health status...
Get Google hotels Search data, including prices, ratings, and availability details, for travel comparison and hospitality market analysis.
Tags: Google Hotels
Parameters ​
| Name | Required | Type | Default | Description |
|---|---|---|---|---|
| query | Yes | string | The destination or specific hotel name you are searching for (e.g., 'Paris', 'Hilton New York'). | |
| check_in_date | Yes | string | The hotel check-in date in 'YYYY-MM-DD' format (e.g., '2026-05-20'). | |
| check_out_date | Yes | string | The hotel check-out date in 'YYYY-MM-DD' format (e.g., '2026-05-25'). | |
| next_page_token | No | string | The token used to retrieve the next page of hotel results. This token is found in the 'next_page_token' field of a previous response. | |
| adults | No | integer | 2 | The number of adults staying in the room. |
| children | No | integer | 0 | The number of children staying in the room. |
| children_ages | No | string | The ages of the children, separated by commas (e.g., '5,10'). The number of ages must match the 'children' parameter. | |
| html | No | boolean | false | Set to true to return the raw HTML of the Google search results page alongside the structured data. |
| language | No | string | en | Set the language for the results using its two-letter code (e.g., 'en' for English, 'fr' for French). See Google Language. |
| country | No | string | us | Set the target country code (e.g., 'us', 'uk') to localize results. See Google Countries. |
| currency | No | string | USD | The three-letter ISO currency code for displaying prices (e.g., 'USD', 'EUR'). See Google Hotels Currency. |
| sort_by | No | string | The criteria to sort hotel results. Supported values: '3' (Lowest price), '8' (Highest rating), '13' (Most reviews). | |
| min_price | No | string | Minimum price filter for the hotel stay. | |
| max_price | No | string | Maximum price filter for the hotel stay. | |
| property_types | No | string | Filter by hotel property types. See the Google Property Types for the full list of supported hotel property types. For vacation rentals, refer to the Google Hotels Vacation Rentals Property Types. | |
| amenities | No | string | Filter by specific amenities (e.g., '35' for free Wi-Fi). Google Hotels Amenities (hotel amenities). Google Hotels Vacation Rentals Amenities (vacation rental amenities) | |
| rating | No | string | Filter by minimum guest rating. Supported values: '7' (3.5+), '8' (4.0+), '9' (4.5+). | |
| brands | No | string | Filter by specific hotel brand IDs. IDs can be comma-separated. | |
| hotel_class | No | string | Filter by hotel star ratings. Supported values: '2', '3', '4', '5'. Can be comma-separated. | |
| free_cancellation | No | string | Filter for hotels that offer free cancellation. Set to '1' or 'true' to enable. | |
| special_offers | No | string | Filter for hotels currently offering special deals or discounts. Set to '1' or 'true' to enable. | |
| eco_certified | No | string | Filter for hotels that are eco-certified. Set to '1' or 'true' to enable. | |
| vacation_rentals | No | boolean | false | Set to true to search for vacation rentals instead of standard hotels. |
| bedrooms | No | string | Minimum number of bedrooms required (applies to vacation rentals). | |
| bathrooms | No | string | Minimum number of bathrooms required (applies to vacation rentals). | |
| property_token | No | string | The unique token for a specific hotel property to fetch detailed information. |
Copy Request ​
bash
curl -X GET "https://api.justserpapi.com/api/v1/google/hotels/search?query=coffee&check_in_date=YOUR_VALUE&check_out_date=YOUR_VALUE" \
-H "X-API-Key: YOUR_API_KEY"js
const res = await fetch("https://api.justserpapi.com/api/v1/google/hotels/search?query=coffee&check_in_date=YOUR_VALUE&check_out_date=YOUR_VALUE", {
headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);python
import requests
url = "https://api.justserpapi.com/api/v1/google/hotels/search"
headers = { "X-API-Key": "YOUR_API_KEY" }
params = {
"query": "coffee",
"check_in_date": "YOUR_VALUE",
"check_out_date": "YOUR_VALUE"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())php
<?php
$url = "https://api.justserpapi.com/api/v1/google/hotels/search?query=coffee&check_in_date=YOUR_VALUE&check_out_date=YOUR_VALUE";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"X-API-Key: YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;go
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://api.justserpapi.com/api/v1/google/hotels/search?query=coffee&check_in_date=YOUR_VALUE&check_out_date=YOUR_VALUE", nil)
req.Header.Set("X-API-Key", "YOUR_API_KEY")
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}Response ​
Loading the latest response example...
