Google

Google Hotels

Search Google Hotels for a destination and date range — price, rating, class, amenities, and vendor rates — as JSON.

POST/api/v2/google/hotels

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

querystringrequired

Destination in '<City> hotels' form (-> q).

Example: hotels in Paris

check_in_datestringrequired

Check-in date, YYYY-MM-DD.

Example: 2026-08-01

check_out_datestringrequired

Check-out date, YYYY-MM-DD.

Example: 2026-08-05

hlstring

UI language.

Example: en

glstring

Country perspective.

Example: us

currencystring

Currency code.

Example: USD

sort_byenum<int>

3 lowest price, 8 highest rating, 13 most reviewed.

min_pricenumber

Minimum nightly price.

max_pricenumber

Maximum nightly price.

ratingenum<int>

7 (3.5+), 8 (4.0+), 9 (4.5+).

hotel_classstring

Comma-separated class 2-5 (e.g. 4,5).

amenitiesstring

Comma-separated amenity ids.

property_typesstring

Property type ids (12 = vacation rentals).

free_cancellationboolean

Only properties with free cancellation.

eco_certifiedboolean

Only eco-certified properties.

special_offersboolean

Only properties with special offers.

next_page_tokenstring

Pagination cursor from a prior response.

limitnumber

Max properties to return (1-20).

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.google.hotels("hotels in Paris", "2026-08-01", "2026-08-05")
print(results)

Response

"engine": "google_hotels",

"q": "hotels in Paris",

"check_in_date": "2026-08-01",

"check_out_date": "2026-08-05",

"currency": "USD",

"gl": "us",

"hl": "en"

"total_results": 20

"current_from": 1,

"current_to": 20,

"next_page_token": "eyJvZmZzZXQiOjE4fQ=="

"credits_used": 1,

"credits_remaining": 49

}