logo
Google Scraper API

Google Hotels API

Scrape Google Hotels listings with ratings, amenities, classes, and images as structured JSON

Google Hotels API

The Google Hotels API is a specialized plugin that searches Google Hotels and returns property listings with names, descriptions, ratings, star classes, amenities, GPS coordinates, and images, all as structured JSON. It's designed for the listing-scope view: 18–20 properties per page with filters for price, rating, hotel class, brand, eco-certification, and free cancellation.

Credit Usage: Each successful request costs 10 credits. For bulk processing, use the Async API with plugins.

Key Features

  • Structured JSON Output: Each property returns name, description, GPS coordinates, hotel class (numeric + label), guest rating, review count, amenities, and images.
  • Currency Localization: Per-request currency (USD, EUR, GBP, TRY, …) for region-specific pricing. Combine with hl and gl for full regional search.
  • Sort Modes: Lowest price, highest rating, or most reviewed (sort_by=3 / 8 / 13).
  • Filters: min_price / max_price, minimum rating (3.5+ / 4.0+ / 4.5+), hotel_class (2–5 stars), brands, amenities, property_types, free_cancellation, eco_certified, special_offers.
  • Vacation Rentals Mode: property_types=12 switches the listing to vacation rentals when available.
  • Pagination: Token-based. Fetch the next page by passing the previous response's next_page_token.
  • No Blocks or CAPTCHAs: All anti-bot measures are handled automatically by Scrape.do.

Endpoint

GET https://api.scrape.do/plugin/google/hotels

Occupancy parameters are not supported. Results always reflect the default occupancy of 2 adults, 0 children. Adults / children / children-ages cannot be customized.

Query Guidelines

For best results, use simple location-based queries:

RecommendedAvoid
Paris hotelsParis luxury hotels near Eiffel Tower
Tokyo hotelsTokyo traditional ryokan hotels
Edinburgh hotelsEdinburgh Royal Mile hotels

Overly specific queries may return empty results because Google resolves the query text to a location internally. Simple "<City> hotels" queries have the highest success rate.

Request Parameters

Required

ParameterTypeDescription
tokenstringYour Scrape.do API authentication token
qstringHotel search query. Use simple "<City> hotels" form for best results
check_in_datestringCheck-in date in YYYY-MM-DD
check_out_datestringCheck-out date in YYYY-MM-DD. Should be after check_in_date (not validated server-side)

Localization

ParameterTypeDefaultDescription
hlstringenLanguage code
glstringusCountry code
currencystringUSDCurrency code (EUR, GBP, TRY, …)

Sorting

ParameterTypeDefaultDescription
sort_byinteger0 (relevance)3 = lowest price, 8 = highest rating, 13 = most reviewed

Filters

ParameterTypeDefaultDescription
min_priceinteger—Minimum price filter (≥ 0)
max_priceinteger—Maximum price filter (≥ 0 and ≥ min_price)
ratinginteger—Minimum rating: 7 (3.5+), 8 (4.0+), 9 (4.5+)
hotel_classstring—Comma-separated star ratings (4,5 for 4★ and 5★). Each value 2–5
brandsstring—Comma-separated brand IDs (e.g. 33 for Accor). Parent brand IDs expand to children automatically
amenitiesstring—Comma-separated amenity codes (see Amenity Codes below)
property_typesstring—Comma-separated property type codes. 12 = vacation rentals (switches mode)
free_cancellationbooleanfalseOnly properties with free cancellation. Accepts true or 1
eco_certifiedbooleanfalseOnly eco-certified properties
special_offersbooleanfalseOnly properties with special offers

Pagination

ParameterTypeDefaultDescription
next_page_tokenstring—From the previous response's pagination.next_page_token. Pass back unchanged

Example Usage

curl --location --request GET 'https://api.scrape.do/plugin/google/hotels?token=<SDO-token>&q=Bali+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03'
import requests
import json

token = "<SDO-token>"

url = f"https://api.scrape.do/plugin/google/hotels?token={token}&q=Bali+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03"

response = requests.request("GET", url)

print(json.dumps(response.json(), indent=2))
const axios = require('axios');

const token = "<SDO-token>";

const url = `https://api.scrape.do/plugin/google/hotels?token=${token}&q=Bali+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03`;

axios.get(url)
  .then(response => {
    console.log(JSON.stringify(response.data, null, 2));
  })
  .catch(error => {
    console.error(error);
  });
package main

import (
	"fmt"
	"io/ioutil"
	"net/http"
)

func main() {
	token := "<SDO-token>"

	url := fmt.Sprintf(
		"https://api.scrape.do/plugin/google/hotels?token=%s&q=Bali+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03",
		token,
	)

	resp, err := http.Get(url)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := ioutil.ReadAll(resp.Body)
	fmt.Println(string(body))
}
require 'net/http'
require 'json'

token = "<SDO-token>"

url = URI("https://api.scrape.do/plugin/google/hotels?token=#{token}&q=Bali+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03")

response = Net::HTTP.get(url)

puts JSON.pretty_generate(JSON.parse(response))
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public class GoogleHotels {
    public static void main(String[] args) throws Exception {
        String token = "<SDO-token>";

        String url = String.format(
            "https://api.scrape.do/plugin/google/hotels?token=%s&q=Bali+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03",
            token
        );

        HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
        conn.setRequestMethod("GET");

        BufferedReader reader = new BufferedReader(
            new InputStreamReader(conn.getInputStream())
        );
        String line;
        StringBuilder response = new StringBuilder();
        while ((line = reader.readLine()) != null) {
            response.append(line);
        }
        reader.close();

        System.out.println(response.toString());
    }
}
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        string token = "<SDO-token>";

        string url = $"https://api.scrape.do/plugin/google/hotels?token={token}&q=Bali+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03";

        using HttpClient client = new HttpClient();
        string response = await client.GetStringAsync(url);

        Console.WriteLine(response);
    }
}
<?php
$token = "<SDO-token>";

$url = "https://api.scrape.do/plugin/google/hotels?token={$token}&q=Bali+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
?>
curl "https://api.scrape.do/plugin/google/hotels?q=Bali+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03&token=$TOKEN"

Turkish Locale + TRY Currency

curl "https://api.scrape.do/plugin/google/hotels?q=Istanbul+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03&hl=tr&gl=tr&currency=TRY&token=$TOKEN"

Sort by Lowest Price + Range

curl "https://api.scrape.do/plugin/google/hotels?q=London+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03&sort_by=3&min_price=100&max_price=300&currency=GBP&token=$TOKEN"

4–5 Star with Free Cancellation

curl "https://api.scrape.do/plugin/google/hotels?q=Dubai+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03&hotel_class=4,5&free_cancellation=true&token=$TOKEN"

Eco-Certified, High Rating, Pool

curl "https://api.scrape.do/plugin/google/hotels?q=Maldives+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03&rating=9&eco_certified=true&amenities=22&token=$TOKEN"

Vacation Rentals

curl "https://api.scrape.do/plugin/google/hotels?q=Santorini+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03&property_types=12&token=$TOKEN"

Pagination

# Page 1
curl "https://api.scrape.do/plugin/google/hotels?q=Paris+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03&token=$TOKEN"
# → response includes pagination.next_page_token

# Page 2
curl "https://api.scrape.do/plugin/google/hotels?q=Paris+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03&next_page_token=CgsI...&token=$TOKEN"

Response

Top-Level Structure

{
  "search_parameters": { ... },
  "search_information": { ... },
  "properties": [ ... ],
  "pagination": { ... }
}

search_parameters

{
  "engine": "google_hotels",
  "q": "Bali hotels",
  "check_in_date": "2026-05-01",
  "check_out_date": "2026-05-03",
  "currency": "USD",
  "gl": "us",
  "hl": "en"
}

Optional fields appear when set: sort_by, min_price, max_price, rating, hotel_class, brands, amenities, property_types, free_cancellation, eco_certified, special_offers, next_page_token.

search_information

{ "total_results": 18 }

properties[]

{
  "type": "hotel",
  "name": "The Anvaya Beach Resort Bali",
  "description": "Sophisticated resort offering 8 pools, 2 restaurants & a spa, plus a private beach & a kids' club.",
  "gps_coordinates": { "latitude": -8.7322535, "longitude": 115.1659877 },
  "hotel_class": "5-star hotel",
  "extracted_hotel_class": 5,
  "overall_rating": 4.7,
  "reviews": 14342,
  "amenities": [6, 29, 16, 22, 2, 8, 26, 5, 4, 23, 24, 14, 1, 31, 27, 7, 11],
  "images": [
    {
      "thumbnail": "https://lh3.googleusercontent.com/...",
      "original_image": "https://lh3.googleusercontent.com/..."
    }
  ],
  "property_token": "ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE",
  "property_details_link": "https://api.scrape.do/plugin/google/hotels/detail?property_token=ChkI0Nqb_63cnPoTGg0vZy8xMWJ4ZjNoMXloEAE&token=TOKEN&gl=us&hl=en&currency=USD"
}

Field Reference

FieldTypeAlways presentDescription
typestringyes"hotel" or "vacation rental"
namestringyesProperty name
descriptionstringShort description
gps_coordinatesobjectyes{ latitude, longitude }
hotel_classstringStar rating label (e.g. "5-star hotel")
extracted_hotel_classintNumeric star rating
overall_ratingfloatGuest rating out of 5
reviewsintNumber of guest reviews
amenitiesint[]yesAmenity codes (see Amenity Codes). Empty array when none
imagesobject[]yes[{ thumbnail, original_image }]. Empty array when none
property_tokenstringyesOpaque token identifying the property. Use with the detail endpoint
property_details_linkstringyesReady-to-call URL for the detail endpoint with property_token and localization pre-filled. Replace TOKEN with your API token

pagination

Included when more pages exist. Omitted on the last page.

{
  "current_from": 1,
  "current_to": 20,
  "next_page_token": "CgsI..."
}
FieldTypeDescription
current_fromint1-based index of the first property on this page
current_toint1-based index of the last property on this page
next_page_tokenstringPass back as next_page_token for the next page

Property Types

ValueWhen returned
"hotel"Traditional hotel, resort, inn, or hostel
"vacation rental"Vacation rental, apartment, or villa. Returned when property_types=12 is set

The mode-switching behavior of property_types=12 depends on inventory at the destination. Some queries continue to return type: "hotel" even when vacation rentals are requested.

Filter Reference

The Hotels API provides three filter layers: scalar filters (price range, rating threshold), comma-separated category filters (hotel_class, brands, amenities, property_types), and boolean toggles (free_cancellation, eco_certified, special_offers).

Price Filters

# Hotels between $100 and $300 per night
curl "https://api.scrape.do/plugin/google/hotels?q=London+hotels&check_in_date=2026-05-01&check_out_date=2026-05-03&min_price=100&max_price=300&token=$TOKEN"
ParameterTypeDescription
min_priceintMinimum nightly price (≥ 0)
max_priceintMaximum nightly price (≥ 0, ≥ min_price)

Either bound can be omitted. Currency follows the currency parameter.

Rating Threshold

ValueMeaning
73.5+ stars
84.0+ stars
94.5+ stars
# Only 4.5+ rated hotels
curl "...&rating=9&..."

Hotel Class

Comma-separated star ratings. Each value must be 2–5.

ValueMeaning
22-star
33-star
44-star
55-star
# 4-star and 5-star only
curl "...&hotel_class=4,5&..."

Sort Modes

sort_byMeaning
0 (default)Relevance
3Lowest price
8Highest rating
13Most reviewed
curl "...&sort_by=3&..."     # cheapest first
curl "...&sort_by=8&..."     # highest rated first
curl "...&sort_by=13&..."    # most reviewed first

Boolean Filters

ParameterEffect
free_cancellation=trueOnly properties with free cancellation
eco_certified=trueOnly eco-certified properties
special_offers=trueOnly properties with active special offers

All accept true or 1. They combine freely.

# Eco-certified, free-cancellation, special offers
curl "...&eco_certified=true&free_cancellation=true&special_offers=true&..."

Brands

brands accepts comma-separated brand IDs. Parent brand IDs (e.g. 33 for Accor) automatically expand to their child brands.

# Accor properties
curl "...&brands=33&..."

Brand IDs are integers; pass each as it appears in Google's classification.

Property Types

property_types accepts comma-separated property type codes.

ValueMeaning
12Vacation rentals (switches mode)
OtherRemain in hotels mode (filter to specific property kinds)
# Vacation rentals only
curl "...&property_types=12&..."

Mode switching depends on inventory. Some destinations continue to return type: "hotel" even when property_types=12 is set if no vacation rentals are listed.

Amenities

amenities accepts comma-separated amenity codes: raw integers from Google's classification.

Amenity Codes

CodeAmenity
1Fitness center
2Bar
4Restaurant
5Room service
6Free breakfast
7Kids' club
8Spa
9Business center
10Child-friendly
11Accessible
14Beach access
15Parking
16Outdoor pool
17Pet-friendly
20Indoor pool
22Pool
23Air-conditioned
24Kitchen / kitchenette
25Smoke-free
26Full-service laundry
27Free Wi-Fi
29Wi-Fi
31Airport shuttle
# Pool + Free Wi-Fi
curl "...&amenities=22,27&..."

Codes may change without notice. Raw integer values are forwarded as-is from Google. The same codes are returned in properties[].amenities[] on the response, so they round-trip safely.

Combining Filters

All filters compose freely. The most restrictive query wins; if no properties match, properties: [] is returned along with total_results: 0.

# 4-5 star, eco-certified, $200-500/night, with pool, sorted by rating
curl "https://api.scrape.do/plugin/google/hotels?\
q=Maldives+hotels&\
check_in_date=2026-05-01&\
check_out_date=2026-05-03&\
hotel_class=4,5&\
eco_certified=true&\
min_price=200&\
max_price=500&\
amenities=22&\
sort_by=8&\
token=$TOKEN"

Scope

This endpoint returns listing-scope data only. Per-property pricing (rate_per_night, total_rate, price breakdowns), check-in/check-out times, nearby places, and review breakdowns are available from the detail endpoint (/plugin/google/hotels/detail). Use the property_details_link returned on each property to fetch them.

Error Handling

{ "error": "error_code", "message": "Human readable error message" }

Common Error Codes

StatusErrorDescription
400token is requiredMissing token
400q (hotel search query) is requiredMissing q
400check_in_date is required (format: YYYY-MM-DD)Missing or malformed check_in_date
400check_out_date is required (format: YYYY-MM-DD)Missing or malformed check_out_date
400sort_by must be 3, 8, or 13Invalid sort_by
400min_price must be a non-negative integerInvalid min_price
400max_price must be a non-negative integerInvalid max_price
400min_price must be <= max_priceRange inverted
400rating must be 7, 8, or 9Invalid rating
400hotel_class values must be 2-5Invalid hotel_class
400hotel_class: invalid int "..."Non-integer in hotel_class
400brands: invalid int "..."Non-integer in brands
400amenities: invalid int "..."Non-integer in amenities
400property_types: invalid int "..."Non-integer in property_types
400failed to construct RPC body: ...Invalid date format
502request failedTransient. Retry
502unexpected responseNon-200 from Google
500decompression failed / parse failedTransient. Retry

check_out_date is not validated against check_in_date. Sending a check-out date before the check-in date currently returns 200 with results (likely Google falls back to a default). Don't rely on the API as a guardrail; validate dates client-side.

Localization

Currency

Google Flights API GET

Scrape Google Flights for fares, durations, layovers, airlines, and carbon emissions as structured JSON

Google News API GET

Scrape Google News articles, topic streams, story clusters, and publisher pages as structured JSON

On this page

Key Features
Endpoint
Query Guidelines
Request Parameters
Required
Localization
Sorting
Filters
Pagination
Example Usage
Basic Search
Turkish Locale + TRY Currency
Sort by Lowest Price + Range
4–5 Star with Free Cancellation
Eco-Certified, High Rating, Pool
Vacation Rentals
Pagination
Response
Top-Level Structure
search_parameters
search_information
properties[]
Field Reference
pagination
Property Types
Filter Reference
Price Filters
Rating Threshold
Hotel Class
Sort Modes
Boolean Filters
Brands
Property Types
Amenities
Amenity Codes
Combining Filters
Scope
Error Handling
Common Error Codes