# Google Hotels API

You have to send a GET request to **`http://api.scrapingdog.com/google_hotels`** with the below-given parameters.

### Parameters

#### Scrapingdog Parameters

| Parameter                                                          | Description                                                                                                                                                   |
| ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>api\_key<br></p><p><mark style="color:red;">required</mark></p> | This is your API key.                                                                                                                                         |
| html                                                               | <p>This will return the full HTML of the Google page. <br><br>Default Value - <strong><code>false</code></strong> <br><br>Type - <strong>Boolean</strong></p> |

#### Search Query

| Parameter                                                       | Description                                                                                                                                                               |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>query<br></p><p><mark style="color:red;">required</mark></p> | <p>This parameter specifies the search query. You can enter anything you would normally use in a standard Google Hotels search.<br><br>Type - <strong>String</strong></p> |

#### Geographic Location and Localization

| Parameter | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| country   | <p>This parameter specifies the country for the Google search using a two-letter country code (e.g., US for the United States, UK for the United Kingdom, or FR for France). For a complete list of supported countries, visit the <a href="https://docs.scrapingdog.com/google-search-scraper-api/google-country-parameter-supported-google-countries">Google countries page</a>. <br><br>Default Value - <strong><code>us</code></strong> <br><br>Type - <strong>String</strong></p> |
| language  | <p>Language of the results. Possible Values - <strong><code>en</code></strong>, <strong><code>es</code></strong>, <strong><code>fr</code></strong>, <strong><code>de</code></strong>, etc. Visit <a href="https://docs.scrapingdog.com/google-search-scraper-api/google-language-page">Google's languages page</a> for a complete list of supported countries. <br><br>Default Value - en <br><br>Type - <strong>String</strong></p>                                                   |
| currency  | <p>This parameter sets the currency for the returned prices. The default is USD. Refer to the <a href="/pages/Ccbu4dzI38YLLjDbIhrI">Google Travel Currencies</a> page for the complete list of supported currency codes.<br><br>Type - <strong>String</strong></p>                                                                                                                                                                                                                     |

#### Advanced Google Parameters

| Parameter                                                               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ----------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>check\_in\_date<br><br><mark style="color:red;">required</mark></p>  | <p>This parameter specifies the check-in date in the format <strong>YYYY-MM-DD</strong> (e.g., 2025-08-15).<br><br>Type - <strong>String</strong></p>                                                                                                                                                                                                                                                                                                      |
| <p>check\_out\_date<br><br><mark style="color:red;">required</mark></p> | <p>This parameter specifies the check-out date, using the format <strong>YYYY-MM-DD</strong> (e.g., 2025-08-16).<br><br>Type - <strong>String</strong></p>                                                                                                                                                                                                                                                                                                 |
| adults                                                                  | <p>This parameter specifies the number of adults, with a default value of <strong>2</strong>.<br><br>Type - <strong>String</strong></p>                                                                                                                                                                                                                                                                                                                    |
| children                                                                | <p>This parameter specifies the number of adults, with a default value of <strong>0</strong>.<br><br>Type - <strong>String</strong></p>                                                                                                                                                                                                                                                                                                                    |
| children\_ages                                                          | <p>This parameter specifies the ages of children. The valid range is <strong>1 to 17</strong>, where children under 1 year old are considered as <strong>1</strong>.</p><p><br><strong>Examples:</strong></p><ul><li>For a single child: <code>5</code></li><li>For multiple children (comma-separated): <code>5,8,10</code></li></ul><p>⚠️ The number of ages provided must match the total number of children.<br><br>Type - <strong>String</strong></p> |

#### Advanced Filters

| Parameter       | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| sort\_by        | <p><strong>Parameter specifies how the results should be sorted.</strong> By default, results are sorted by <strong>Relevance</strong>.</p><p><strong>Available options:</strong></p><ul><li><strong>3</strong> – Sort by lowest price</li><li><strong>8</strong> – Sort by highest rating</li><li><strong>13</strong> – Sort by most reviews<br></li></ul><p>Type - <strong>String</strong></p>                                                                                                                                                                                                                |
| min\_price      | <p>Parameter sets the minimum price in the range.<br><br>Type - <strong>String</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| max\_price      | <p>Specifies the maximum price in the range.<br><br>Type - <strong>String</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| property\_types | <p>Specifies the property type(s) to include in the results.<br>For a complete list of supported hotel property types, refer to the <a href="/pages/T9Ieoef4WwszP3QpttBH"><strong>Google Hotels Property Types</strong></a> page.<br>For vacation rentals, see the <a href="/pages/SUjEyiZSiaVI8r9PqiHS"><strong>Google Vacation Rentals Property Types</strong></a> page.</p><p><strong>Examples:</strong></p><ul><li>Single property type: <code>17</code></li><li>Multiple property types (separated by commas): <code>17,12,18</code> <br></li></ul><p>Type - <strong>String</strong></p>                   |
| amenities       | <p>This parameter allows you to filter results so that only listings with the selected amenities are included.</p><p>For the full list of available amenities, see:</p><ul><li><a href="/pages/fAlmbEza8DfNhDz6Ea1L"><strong>Google Hotels Amenities</strong></a> (for Hotels)</li><li><a href="/pages/toNcqCbrlkL6tAEMKwsp"><strong>Google Vacation Rentals Amenities</strong></a> (for Vacation Rentals)</li></ul><p><strong>Examples:</strong></p><ul><li>Single amenity: <code>35</code></li><li>Multiple amenities (comma-separated): <code>35,9,19</code> </li></ul><p>Type - <strong>String</strong></p> |
| rating          | <p>Parameter is used for filtering the results to certain rating.<br><br>Available options:<br><code>7</code> - 3.5+<br><code>8</code> - 4.0+<br><code>9</code> - 4.5+<br><br>Type - <strong>String</strong></p>                                                                                                                                                                                                                                                                                                                                                                                                |

#### Hotel Filters

| Parameter          | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| brands             | <p>This parameter specifies the brands you want to focus your search on. Brand IDs can be found in the <code>brands</code> array within our JSON response (e.g., <code>brands\[0].id</code>).</p><p><strong>Examples:</strong></p><ul><li>Single brand: <code>33</code></li><li>Multiple brands (comma-separated): <code>33,67,101</code></li></ul><p><strong>Note: This parameter is not supported for Vacation Rentals.</strong></p>                                                     |
| hotel\_class       | <p>This parameter filters results to include only hotels of specific star ratings.</p><p><strong>Available options:</strong></p><ul><li>2 → 2-star</li><li>3 → 3-star</li><li>4 → 4-star</li><li>5 → 5-star</li></ul><p><strong>Example (single hotel class):</strong><br><code>2</code></p><p><strong>Example (multiple hotel classes, separated by commas):</strong><br><code>2,3,4</code></p><p></p><p><strong>Note: This parameter is not supported for Vacation Rentals.</strong></p> |
| free\_cancellation | <p>This parameter filters results to include only listings that offer <strong>free cancellation</strong>.</p><p><br><strong>Note: This option is not available for Vacation Rentals.</strong></p>                                                                                                                                                                                                                                                                                          |
| special\_offers    | <p>This parameter limits results to listings that include <strong>special offers</strong>.</p><p><br><strong>Note: This option is not available for Vacation Rentals.</strong></p>                                                                                                                                                                                                                                                                                                         |
| eco\_certified     | <p>This parameter filters results to include only listings that are <strong>eco-certified</strong>.</p><p><br><strong>Note: This option is not supported for Vacation Rentals.</strong></p>                                                                                                                                                                                                                                                                                                |

#### Vacation Rentals Filters

| Parameter         | Description                                                                                                                                                                                                                                                                       |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| vacation\_rentals | <p>This parameter specifies whether to search for <strong>Vacation Rentals</strong>.<br><br>By default, the search is set to <strong>Hotels</strong>.<br><br>Default Value - <strong><code>false</code></strong> </p><p></p><p>Type - <strong>String</strong></p>                 |
| bedrooms          | <p>This parameter sets the <strong>minimum number of bedrooms</strong>.</p><p></p><p>Default Value - <strong><code>false</code></strong> </p><p></p><p>Type - <strong>String</strong></p><p></p><p>Note: This option is available only for <strong>Vacation Rentals</strong>.</p> |
| bathrooms         | <p>This parameter specifies the <strong>minimum number of bathrooms</strong>.</p><p></p><p>Default Value - <strong><code>false</code></strong> </p><p></p><p>Type - <strong>String</strong><br><br>Note: This option is only available for <strong>Vacation Rentals</strong>.</p> |

#### Pagination

| Parameter         | Description                                                                                              |
| ----------------- | -------------------------------------------------------------------------------------------------------- |
| next\_page\_token | <p>The next\_page\_token is used to get the next page results. <br><br>Type: <strong>String</strong></p> |

#### Property Details

| Parameter       | Description                                                                                                                                                                                                                                                                                                |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| property\_token | <p>This parameter retrieves detailed property information, including <strong>name, address, phone number, prices, nearby places</strong>, and more.</p><p>You can obtain the <code>property\_token</code> from the <strong>Google Hotels Properties API</strong>.<br><br>Type: <strong>String</strong></p> |

### API Example

{% tabs %}
{% tab title="cURL" %}

```bash
cURL "https://api.scrapingdog.com/google_hotels?api_key=APIKEY&query=Hotels in New York&check_in_date=2025-08-19&check_out_date=2025-08-20"
```

{% endtab %}

{% tab title="Python" %}

```python
import requests

api_key = "5eaa61a6e562fc52fe763tr516e4653"
url = "https://api.scrapingdog.com/google_hotels"

params = {
    "api_key": api_key,
    "query": "Hotels in New York",
    "check_in_date": "2025-08-19",
    "check_out_date": "2025-08-20"
}

response = requests.get(url, params=params)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Request failed with status code: {response.status_code}")

```

{% endtab %}

{% tab title="Node JS" %}

```javascript
const axios = require('axios');

const api_key = '5eaa61a6e562fc52fe763tr516e4653';
const url = 'https://api.scrapingdog.com/google_hotels/';

const params = {
  api_key: api_key,
  query: "Hotels in New York",
  check_in_date: "2025-08-19",
  check_out_date: "2025-08-20"
};

axios
  .get(url, { params: params })
  .then(function (response) {
    if (response.status === 200) {
      const data = response.data;
      console.log(data)
    } else {
      console.log('Request failed with status code: ' + response.status);
    }
  })
  .catch(function (error) {
    console.error('Error making the request: ' + error.message);
  });

```

{% endtab %}

{% tab title="PHP" %}

```php
<?php

// Set the API key and request parameters
$api_key = '5eaa61a6e562fc52fe763tr516e4653';
$query = 'Hotels in New York';
$check_in_date = '2025-08-19';
$check_out_date = '2025-08-20';

// Set the API endpoint
$url = 'https://api.scrapingdog.com/google_hotels/?api_key=' . $api_key . '&query=' . $query . '&check_in_date =' . $check_in_date . '&check_out_date=' . $check_out_date;

// Initialize cURL session
$ch = curl_init($url);

// Set cURL options
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Execute the cURL request
$response = curl_exec($ch);

// Check if the request was successful
if ($response === false) {
    echo 'cURL error: ' . curl_error($ch);
} else {
    // Process the response data as needed
    echo $response;
}

// Close the cURL session
curl_close($ch);

```

{% endtab %}

{% tab title="Ruby" %}

```ruby
require 'net/http'
require 'uri'

# Set the API key and request parameters
api_key = '5eaa61a6e562fc52fe763tr516e4653'
query = 'Hotels in New York'
check_in_date = '2025-08-19'
check_out_date= '2025-08-20'

# Construct the API endpoint URL
url = URI.parse("https://api.scrapingdog.com/google_hotels/?api_key=#{api_key}&query=#{query}&check_in_date=#{check_in_date}&check_out_date=#{check_out_date}")

# Create an HTTP GET request
request = Net::HTTP::Get.new(url)

# Create an HTTP client
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true # Enable SSL (https)

# Send the request and get the response
response = http.request(request)

# Check if the request was successful
if response.is_a?(Net::HTTPSuccess)
  puts response.body # Process the response data as needed
else
  puts "HTTP request failed with code: #{response.code}, message: #{response.message}"
end

```

{% endtab %}

{% tab title="Java" %}

```java
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.IOException;

public class Main {
    public static void main(String[] args) {
        try {
            // Set the API key and request parameters
            String apiKey = "5eaa61a6e562fc52fe763tr516e4653";
            String query = "Hotels in New York";
            String check_in_date = "2025-08-19";
            String check_out_date = "2025-08-20";

            // Construct the API endpoint URL
            String apiUrl = "https://api.scrapingdog.com/google_hotels/?api_key=" + apiKey
                    + "&query=" + query
                    + "&check_in_date=" + check_in_date
                    + "&check_out_date=" + check_out_date

            // Create a URL object from the API URL string
            URL url = new URL(apiUrl);

            // Open a connection to the URL
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();

            // Set the request method to GET
            connection.setRequestMethod("GET");

            // Get the response code
            int responseCode = connection.getResponseCode();

            if (responseCode == 200) {
                // Read the response from the connection
                BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String inputLine;
                StringBuilder response = new StringBuilder();

                while ((inputLine = reader.readLine()) != null) {
                    response.append(inputLine);
                }
                reader.close();

                // Process the response data as needed
                System.out.println(response.toString());
            } else {
                System.out.println("HTTP request failed with response code: " + responseCode);
            }

            // Close the connection
            connection.disconnect();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

```

{% endtab %}
{% endtabs %}

### API Response

```json
{
    "ads": [
        {
            "title": "Howard Johnson by Wyndham Newark Airport",
            "source": "Booking.com",
            "source_icon": "https://www.gstatic.com/travel-hotels/branding/icon_184.png",
            "link": "https://www.google.com/aclk?sa=l&ai=DChcSEwiVnaa6zpSPAxXuSf8BHdbXPM4YABACGgJtZA&co=1&ase=2&gclid=EAIaIQobChMIlZ2mus6UjwMV7kn_AR3W1zzOEA0YASACEgK-f_D_BwE&category=acrcp_v1_48&sig=AOD64_0HWTqV9nJiUDO6hQGUfVq5loZDyQ&adurl=",
            "property_token": "CgsIlsrqgKWto5OmARAB",
            "gps_coordinates": {
                "latitude": 40.71048400000001,
                "longitude": -74.15697800000001
            },
            "thumbnail": "https://www.google.com//lh5.googleusercontent.com/proxy/7YlKszkZI-z08MVhEvJwI9MKOBZRmqWQh1SMy4umGSoSr7G74R_VFyQfdpDgU7PjWQoyNCEBLQLTkSEhJgR42imtYUBRef9KGxHFTeFM2j7kylbXnGVFW-8m2O0kWEShX5jbMXKP5kMlKarM6gh82-56NZAt2Fo=w225-h150-k-no",
            "price": "$98",
            "reviews": 1812,
            "overall_rating": 3,
            "amenities": [
                "Beach access",
                "Restaurant",
                "Hot Tub"
            ],
            "hotel_class": 2,
            "free_cancellation": false
        },
         ......
     ],
       "brands": [
        {
            "id": 33,
            "name": "Accor Live Limitless",
            "children": [
                {
                    "id": 8,
                    "name": "Fairmont Hotels and Resorts"
                },
                {
                    "id": 84,
                    "name": "Sofitel"
                }
            ]
        },
       .....
       ],
       "properties": [
        {
            "type": "hotel",
            "title": "YOTEL New York Times Square",
            "description": "Snug rooms & suites in a hip, stylish hotel featuring a rooftop restaurant & a fitness center.",
            "link": "https://www.yotel.com/en/hotels/yotel-new-york?utm_source=Google&utm_medium=Yext_YONYC",
            "property_token": "ChcIiv7qloTyutUJGgsvZy8xdG5zc3Y3NRAB",
            "gps_coordinates": {
                "latitude": 40.7591608,
                "longitude": -73.9954657
            },
            "check_in_time": "3:00 PM",
            "check_out_time": "11:00 AM",
            "rate_per_night": {
                "lowest": "$151",
                "before_taxes_fees": "$177"
            },
            "total_rate": {
                "lowest": "$151",
                "before_taxes_fees": "$177"
            },
            "nearby_places": [
                {
                    "name": "Times Square",
                    "transportations": [
                        {
                            "type": "Public transport",
                            "duration": "8 min"
                        }
                    ]
                },
                {
                    "name": "42 St-Port Authority Bus Terminal",
                    "transportations": [
                        {
                            "type": "Walking",
                            "duration": "9 min"
                        }
                    ]
                },
                {
                    "name": "John F. Kennedy International Airport",
                    "transportations": [
                        {
                            "type": "Taxi",
                            "duration": "43 min"
                        },
                        {
                            "type": "Public transport",
                            "duration": "57 min"
                        }
                    ]
                },
                {
                    "name": "Bea",
                    "transportations": [
                        {
                            "type": "Walking",
                            "duration": "5 min"
                        }
                    ]
                }
            ],
            "hotel_class": "4-star hotel",
            "extracted_hotel_class": 4,
            "images": [
                {
                    "thumbnail": "https://lh5.googleusercontent.com/proxy/YDPcobfVgUBfUaXjVIo5kNT6HFZVlez8yu8VJy1eBvXRXcQ8QH4xKaKhKcqqmQHX1CJACn8DhXuMccLFe5CkhFDCldIAbxSaWYjXCjb9V1HLvVgB6iNpJNbOdhOfE6e6tBQ-Gv1iiSfbtR3Owom7_AM72VAH9I4=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/proxy/YDPcobfVgUBfUaXjVIo5kNT6HFZVlez8yu8VJy1eBvXRXcQ8QH4xKaKhKcqqmQHX1CJACn8DhXuMccLFe5CkhFDCldIAbxSaWYjXCjb9V1HLvVgB6iNpJNbOdhOfE6e6tBQ-Gv1iiSfbtR3Owom7_AM72VAH9I4=s10000-"
                },
                {
                    "thumbnail": "https://lh3.googleusercontent.com/p/AF1QipOkSPFFRhooA7oXNuO7KhhnOaYKZ6yat--utemK=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/p/AF1QipOkSPFFRhooA7oXNuO7KhhnOaYKZ6yat--utemK=s10000-"
                },
                {
                    "thumbnail": "https://lh6.googleusercontent.com/proxy/2LCtifX5-emMos3ppPK5eXsC4QVZRVA1hcudeiNevleEj0akfGWsgFkOkx_sjbcHaVab86nupecyyHdvEsiFsRQ8JII8-q2_l2jIhQ5zBlpkg37QXSvBGM93IozOPdzD17-kf5K905jg8YE93JN9ENGy8byTy9Y=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/proxy/2LCtifX5-emMos3ppPK5eXsC4QVZRVA1hcudeiNevleEj0akfGWsgFkOkx_sjbcHaVab86nupecyyHdvEsiFsRQ8JII8-q2_l2jIhQ5zBlpkg37QXSvBGM93IozOPdzD17-kf5K905jg8YE93JN9ENGy8byTy9Y=s10000-"
                },
                {
                    "thumbnail": "https://lh5.googleusercontent.com/proxy/NAM4yJorz4JTcSC-L-XZymVL6OlMnBrcCGFWV3rMUZDuCfi4HPS61aM0_KJ2FWNzUKSs5FXReEknrXwzA3OjyumioD5WF7yA27slGIjVTQL4ptTkbSHd80LfSTLr7uvh1eCJD80ZZqUQT2_GGSC2v7-ulJfjVlU=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/proxy/NAM4yJorz4JTcSC-L-XZymVL6OlMnBrcCGFWV3rMUZDuCfi4HPS61aM0_KJ2FWNzUKSs5FXReEknrXwzA3OjyumioD5WF7yA27slGIjVTQL4ptTkbSHd80LfSTLr7uvh1eCJD80ZZqUQT2_GGSC2v7-ulJfjVlU=s10000-"
                },
                {
                    "thumbnail": "https://lh3.googleusercontent.com/p/AF1QipPAZvwlK4FpBueIiEqlyEfONjt9tmQt7VIEC62C=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/p/AF1QipPAZvwlK4FpBueIiEqlyEfONjt9tmQt7VIEC62C=s10000-"
                },
                {
                    "thumbnail": "https://lh3.googleusercontent.com/p/AF1QipO4Yceq_66uWJmvsRylRCb70VQGZBLAKRvuZz3O=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/p/AF1QipO4Yceq_66uWJmvsRylRCb70VQGZBLAKRvuZz3O=s10000-"
                },
                {
                    "thumbnail": "https://lh3.googleusercontent.com/p/AF1QipMHWAZXDyvCvryI9oucYLl8YKGET4Rm2aKos9mo=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/p/AF1QipMHWAZXDyvCvryI9oucYLl8YKGET4Rm2aKos9mo=s10000-"
                },
                {
                    "thumbnail": "https://lh4.googleusercontent.com/proxy/d4rdOMM8qPZS-3ZGn2GgSo1dVdDRyE2l_qWDeuvj2GH9LILLOFrAB4Umt8g-DFGg55aMrnyY0LNj15Vls6fowDEgBpJ59qMhlqhoPo-RJXAEVqTqdf9T6DNmNjzN6LzIGWGOo8_RJAIS3IM9-aFqUgGanmR9zQQ=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/proxy/d4rdOMM8qPZS-3ZGn2GgSo1dVdDRyE2l_qWDeuvj2GH9LILLOFrAB4Umt8g-DFGg55aMrnyY0LNj15Vls6fowDEgBpJ59qMhlqhoPo-RJXAEVqTqdf9T6DNmNjzN6LzIGWGOo8_RJAIS3IM9-aFqUgGanmR9zQQ=s10000-"
                },
                {
                    "thumbnail": "https://lh3.googleusercontent.com/proxy/fNsMZTakmnIIKicuWKoEymka9KjJNBZGt7Aw0WT5tGW0BFZ9jdvX7llS-eenLhVJIkJtsBf-2EoHs-jfQb1Cj_E5fMeCN5eT5ueiopDd4CKKqpy77YVxXxX2M_02mQlYboZ-AEVxp5kSrPpMF5a83lb6kTPqoZs=s287-w287-h192-n-k-no-v1",
                    "original_image": "https://lh5.googleusercontent.com/proxy/fNsMZTakmnIIKicuWKoEymka9KjJNBZGt7Aw0WT5tGW0BFZ9jdvX7llS-eenLhVJIkJtsBf-2EoHs-jfQb1Cj_E5fMeCN5eT5ueiopDd4CKKqpy77YVxXxX2M_02mQlYboZ-AEVxp5kSrPpMF5a83lb6kTPqoZs=s10000-"
                }
            ],
            "reviews": 3.9,
            "overall_rating": 9040,
            "ratings": [
                {
                    "stars": 5,
                    "count": 4051
                },
                {
                    "stars": 4,
                    "count": 2587
                },
                {
                    "stars": 3,
                    "count": 1067
                },
                {
                    "stars": 2,
                    "count": 513
                },
                {
                    "stars": 1,
                    "count": 922
                }
            ],
            "location_rating": 3.9,
            "reviews_breakdown": [
                {
                    "name": "Property",
                    "description": "Property",
                    "total_mentioned": 0,
                    "positive": 2765,
                    "negative": 0,
                    "neutral": -2765
                },
                {
                    "name": "Location",
                    "description": "Location",
                    "total_mentioned": 0,
                    "positive": 1,
                    "negative": 1217,
                    "neutral": -1218
                },
                {
                    "name": "Bathroom",
                    "description": "Bathroom and toiletries",
                    "total_mentioned": 0,
                    "positive": 2,
                    "negative": 191,
                    "neutral": -193
                },
                {
                    "name": "Room",
                    "description": "Room amenities",
                    "total_mentioned": 0,
                    "positive": 938,
                    "negative": 0,
                    "neutral": -938
                },
                {
                    "name": "Bar",
                    "description": "Bar or lounge",
                    "total_mentioned": 0,
                    "positive": 1,
                    "negative": 305,
                    "neutral": -306
                },
                {
                    "name": "Service",
                    "description": "Service",
                    "total_mentioned": 0,
                    "positive": 1624,
                    "negative": 0,
                    "neutral": -1624
                }
            ],
            "amenities": [],
            "eco_certified": true
            }
             ......
            ]
```

### With Property Token

{% tabs %}
{% tab title="cURL" %}

```bash
http://api.scrapingdog.com/google_hotels?api_key=APIKEY&query=Hotels in New York&property_token=CgoIjrCvh-j2tN5-EAE&check_in_date=2025-10-21&check_out_date=2025-10-22
```

{% endtab %}

{% tab title="Python" %}

<pre class="language-python"><code class="lang-python">import requests

api_key = "APIKEY"
url = "https://api.scrapingdog.com/google_hotels"

params = {
    "api_key": api_key,
    "query": "Hotels in New York",
    "check_in_date": "2025-10-21",
    "check_out_date": "2025-10-22"
    "property_token": "CgoIjrCvh-j2tN5-EAE" 
<strong>}
</strong>
response = requests.get(url, params=params)

if response.status_code == 200:
    data = response.json()
    print(data)
else:
    print(f"Request failed with status code: {response.status_code}")

</code></pre>

{% endtab %}

{% tab title="Node JS" %}

```
const axios = require('axios');

const api_key = 'APIKEY';
const url = 'https://api.scrapingdog.com/google_hotels/';

const params = {
  api_key: api_key,
  query: "Hotels in New York",
  check_in_date: "2025-08-21",
  check_out_date: "2025-08-22",
  property_token: "CgoIjrCvh-j2tN5-EAE"
};

axios
  .get(url, { params: params })
  .then(function (response) {
    if (response.status === 200) {
      const data = response.data;
      console.log(data)
    } else {
      console.log('Request failed with status code: ' + response.status);
    }
  })
  .catch(function (error) {
    console.error('Error making the request: ' + error.message);
  });

```

{% endtab %}

{% tab title="PHP" %}

```php
<?php

// Set the API key and request parameters
$api_key = 'APIKEY';
$query = 'Hotels in New York';
$check_in_date = '2025-08-21';
$check_out_date = '2025-08-22';
$property_token = 'CgoIjrCvh-j2tN5-EAE'

// Set the API endpoint
$url = 'https://api.scrapingdog.com/google/?api_key=' . $api_key . '&query=' . $query . '&check_in_date =' . $check_in_date . '&check_out_date=' . $check_out_date . '&property_token=' . $property_token;

// Initialize cURL session
$ch = curl_init($url);

// Set cURL options
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// Execute the cURL request
$response = curl_exec($ch);

// Check if the request was successful
if ($response === false) {
    echo 'cURL error: ' . curl_error($ch);
} else {
    // Process the response data as needed
    echo $response;
}

// Close the cURL session
curl_close($ch);

```

{% endtab %}

{% tab title="Ruby" %}

```ruby
require 'net/http'
require 'uri'

# Set the API key and request parameters
api_key = 'APIKEY'
query = 'Hotels in New York'
check_in_date = '2025-08-21'
check_out_date= '2025-08-22'
property_token= 'CgoIjrCvh-j2tN5-EAE'

# Construct the API endpoint URL
url = URI.parse("https://api.scrapingdog.com/google_hotels/?api_key=#{api_key}&query=#{query}&check_in_date=#{check_in_date}&check_out_date=#{check_out_date}&property_token=#{property_token}")

# Create an HTTP GET request
request = Net::HTTP::Get.new(url)

# Create an HTTP client
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true # Enable SSL (https)

# Send the request and get the response
response = http.request(request)

# Check if the request was successful
if response.is_a?(Net::HTTPSuccess)
  puts response.body # Process the response data as needed
else
  puts "HTTP request failed with code: #{response.code}, message: #{response.message}"
end

```

{% endtab %}

{% tab title="Java" %}

```java
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.IOException;

public class Main {
    public static void main(String[] args) {
        try {
            // Set the API key and request parameters
            String apiKey = "APIKEY";
            String query = "Hotels in New York";
            String check_in_date = "2025-08-21";
            String check_out_date = "2025-08-22";
            String property_token = "CgoIjrCvh-j2tN5-EAE";

            // Construct the API endpoint URL
            String apiUrl = "https://api.scrapingdog.com/google_hotels/?api_key=" + apiKey
                    + "&query=" + query
                    + "&check_in_date=" + check_in_date
                    + "&check_out_date=" + check_out_date
                    + "&proerty_token=" + property_token

            // Create a URL object from the API URL string
            URL url = new URL(apiUrl);

            // Open a connection to the URL
            HttpURLConnection connection = (HttpURLConnection) url.openConnection();

            // Set the request method to GET
            connection.setRequestMethod("GET");

            // Get the response code
            int responseCode = connection.getResponseCode();

            if (responseCode == 200) {
                // Read the response from the connection
                BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
                String inputLine;
                StringBuilder response = new StringBuilder();

                while ((inputLine = reader.readLine()) != null) {
                    response.append(inputLine);
                }
                reader.close();

                // Process the response data as needed
                System.out.println(response.toString());
            } else {
                System.out.println("HTTP request failed with response code: " + responseCode);
            }

            // Close the connection
            connection.disconnect();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }
}

```

{% endtab %}
{% endtabs %}

### Response With Property Token

```json
{
    "property": {
        "title": "Waldorf Astoria New York",
        "gps_coordinates": {
            "latitude": 40.7564821,
            "longitude": -73.9734562
        },
        "link":"https://www.waldorfastorianewyork.com/?SEO_id\=GMB-AMER-WA-NYCWAWA\&y_source\=1_MjA4MzU3MC03MTUtbG9jYXRpb24ud2Vic2l0ZQ%3D%3D",
        "address": "301 Park Ave, New York, NY 10022",
        "directions": "https://maps.google.com/maps?hl=en-US&gl=US&um=1&ie=UTF-8&fb=1&sa=X&geocode=KU84ulX8WMKJMQ7Y64C207x-&daddr=Waldorf+Astoria+New+York,+301+Park+Ave,+New+York,+NY+10022",
        "phone": "(212) 355-3000",
        "phone_link": "tel:+12123553000",
        "check_in_time": "4:00 PM",
        "check_out_time": "12:00 PM",
        "rate_per_night": {
            "lowest": "$1,611",
            "extracted_lowest": 1611,
            "before_taxes_fees": "$1,852",
            "extracted_before_taxes_fees": 1852
        },
        "total_rate": {
            "lowest": "$1,611",
            "extracted_lowest": 1611,
            "before_taxes_fees": "$1,852",
            "extracted_before_taxes_fees": 1852
        },
        "featured_prices": [
          {
            "source": "Waldorf Astoria New York",
            "link": "https://www.google.com/aclk?sa=l&ai=DChsSEwiKtLyA3oiQAxUsaUcBHU22HVoYACICCAEQLRoCcXU&co=1&gclid=EAIaIQobChMIirS8gN6IkAMVLGlHAR1Nth1aEAoYASABEgK78vD_BwE&cid=CAASN-RoZtwRP4mpkeEjLrgD_3FeqcFQ5PAd3codv_-kf4QuZVzDHnN8n8ALwfH3PtkhGCaGh0RnUJs&sig=AOD64_3y-xe-vI6qU3OnCFee9YT1Wdn2Cw&adurl",
            "logo": "https://www.gstatic.com/travel-hotels/branding/6df97707-4a79-4cf7-931b-54f7f622f081.png",
            "remarks": [],
            "num_guests": 2,
            "rate_per_night": {
                "lowest": "$1,611",
                "extracted_lowest": 1611,
                "before_taxes_fees": "$1,852",
                "extracted_before_taxes_fees": 1852
            },
            "total_rate": {
                "lowest": "$1,611",
                "extracted_lowest": 1611,
                "before_taxes_fees": "$1,852",
                "extracted_before_taxes_fees": 1852
                }
            },
            ......
          }
         ],
        "prices": [
         {
            "source": "Waldorf Astoria New York",
            "link": "https://www.google.com/travel/clk?pc=AA80OswOix0QXeNXKVb3zStHPV703wNsssv23vGTSvWoKSJm_WprXhn3riFxx5gK4Htt_UZwOIW0Rs854UMZY2lYeqdlpwye_j5cvpH3EzOahnD_sGV20TKQa7gk1sw-uHRKiJOdk0lssAs_wo90J4n7JH7nZshYbEWxVPtTT-QLJAky&pcurl=https://linkcenterus.derbysoftca.com/dplatform-linkcenter/booking.htm?hotelCode%3DHILTON-NYCWA%26providerHotelCode%3DNYCWA%26checkInDate%3D2025-10-21%26checkOutDate%3D2025-10-22%26identifier%3Dgoogle-hilton%26price%3D1852.00%26roomTypeCode%3DK1DRV%26ratePlanCode%3DQO%26currency%3DUSD%26language%3Den%26userCountry%3DUS%26dateType%3Dselected%26testClick%3Dfalse%26sitetype%3Dlocaluniversal%26occupancy%3D2%26partnerId%3Dhilton%26campaignid%3D%26rateRuleId%3D%26userlistid%3D%26ifDefaultDate%3Dselected%26isPromoted%3Dfalse%26isRuleIdsClosed%3Dfalse%26s_is_ad%3Dfalse%26adType%3D0%26adults%3D2%26children%3D0%26clk_src%3D%26is_ds_account%3Dtrue&s=AD1XQnnifHpO8BOX5gzrHm5nINu3&ap=1",
            "logo": "https://www.gstatic.com/travel-hotels/branding/6df97707-4a79-4cf7-931b-54f7f622f081.png",
            "remarks": [],
            "num_guests": 2,
            "rate_per_night": {
                "lowest": "$1,611",
                "extracted_lowest": 1611,
                "before_taxes_fees": "$1,852",
                "extracted_before_taxes_fees": 1852
            },
            "total_rate": {
                "lowest": "$1,611",
                "extracted_lowest": 1611,
                "before_taxes_fees": "$1,852",
                "extracted_before_taxes_fees": 1852
                }
            },
            ...
           ]
}         
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.scrapingdog.com/google-hotels-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.