Google Hotels has no API for reading prices. Google's hotel APIs take prices and content from hotels and booking sites and show them in search, and the docs describe no way to read them back. To compare what each seller charges for the same stay, you read Google Hotels' public results. Our API does that and returns JSON.
What Google's hotel APIs are for
Google's hotel developer docs cover two things: Hotel Prices, for sending rates to Google, and Hotel Content, for sending property details such as the Google Lodging Format. They are for hotel chains, channel managers and travel sites that want to appear in Google's results. If you are one of those, start there. If you want the prices other sellers show, there is no official route.
Hotel prices with ToolzerHub
We make ToolzerHub. Our Google Hotels API has three routes, each 1 credit a call with the x-api-key header:
/v1/google-hotels/search: hotels and rentals for a place and dates/v1/google-hotels/property: class, address, phone, website, check-in times, rating breakdown/v1/google-hotels/prices: every seller's price for a stay, with a booking link
export TOOLZERHUB_API_KEY=your_key
curl -H "x-api-key: $TOOLZERHUB_API_KEY" \
"https://api.toolzerhub.com/v1/google-hotels/search?query=Lisbon&check_in_date=2026-12-10&check_out_date=2026-12-13"
A three-night search for Lisbon returned 306 properties, 300 of them hotels. The first hotel in data.properties:
{
"property_token": "ChoI4cjBy-KGurGyARoNL2cvMTFtdnFfdncydhAB",
"name": "Hyatt Regency Lisbon",
"type": "hotel",
"rating": 4.4,
"reviews": 1098,
"price_per_night": 225,
"price_per_night_with_taxes": 235,
"total_price": 674,
"total_price_with_taxes": 704
}
Pass property_token to prices with the same dates. Each offer there has the seller, is_official for the hotel's own site, the four prices and a booking_url. Prices are in USD unless you pass currency.
Compare sellers for a city's hotels
The script searches a city for your dates, takes the first 10 hotels in the results, pulls every seller's price for each and writes one row per offer with how far it sits above the cheapest. It prints the cheapest seller, the dearest and the hotel's own price. Install requests (pip install requests) and save it as hotel_prices.py.
import csv
import os
import sys
import time
import requests
API = "https://api.toolzerhub.com/v1/google-hotels"
HEADERS = {"x-api-key": os.environ.get("TOOLZERHUB_API_KEY", "")}
FIELDS = ["hotel", "rating", "reviews", "seller", "is_official", "price_per_night",
"total_price_with_taxes", "pct_above_cheapest"]
def get(op, params, tries=3):
# Retry rate limits, server errors and dropped connections.
for attempt in range(tries):
last = attempt == tries - 1
try:
r = requests.get(f"{API}/{op}", headers=HEADERS, params=params, timeout=90)
except requests.RequestException:
if last:
raise
time.sleep(5 * (attempt + 1))
continue
if r.status_code in (429, 500, 502, 503, 504) and not last:
time.sleep(5 * (attempt + 1))
continue
r.raise_for_status()
return r.json()["data"]
def main(city, check_in, check_out, top="10", out="hotel_prices.csv"):
stay = {"check_in_date": check_in, "check_out_date": check_out}
search = get("search", {"query": city, **stay})
hotels = [p for p in search["properties"] if p["type"] == "hotel"][: int(top)]
with open(out, "w", newline="", encoding="utf-8-sig") as f:
writer = csv.DictWriter(f, fieldnames=FIELDS)
writer.writeheader()
for h in hotels:
prices = get("prices", {"property_token_or_url": h["property_token"], **stay})
offers = [o for o in (prices or {}).get("offers", []) if o.get("total_price_with_taxes")]
if not offers:
print(f"{h['name']}: no prices")
continue
offers.sort(key=lambda o: o["total_price_with_taxes"])
low = offers[0]["total_price_with_taxes"]
for o in offers:
writer.writerow({
"hotel": h["name"], "rating": h["rating"], "reviews": h["reviews"],
"seller": o["seller"], "is_official": o["is_official"],
"price_per_night": o["price_per_night"],
"total_price_with_taxes": o["total_price_with_taxes"],
"pct_above_cheapest": round((o["total_price_with_taxes"] / low - 1) * 100, 1),
})
official = next((o for o in offers if o["is_official"]), None)
print(f"{h['name']}: {len(offers)} sellers, cheapest {offers[0]['seller']} {low}, "
f"dearest {offers[-1]['seller']} {offers[-1]['total_price_with_taxes']}, "
f"official {official['total_price_with_taxes'] if official else '-'} {search['currency']}")
if __name__ == "__main__":
if len(sys.argv) < 4:
sys.exit("usage: python hotel_prices.py Lisbon 2026-12-10 2026-12-13 [top hotels] [out.csv]")
if not HEADERS["x-api-key"]:
sys.exit("set TOOLZERHUB_API_KEY first")
main(*sys.argv[1:])
What 20 hotels showed
python hotel_prices.py Lisbon 2026-12-10 2026-12-13 and the same for Tokyo made 22 calls in 56 seconds and wrote 371 offers, a median of 19.5 sellers per hotel.
| Lisbon | Tokyo | |
|---|---|---|
| Offers | 202 | 169 |
| Cheapest to dearest seller, median | 35.1% | 34.9% |
| Hotel's own site above the cheapest, median | 18.3% | 19.3% |
| Hotels where the own site was cheapest | 1 of 9 | 0 of 7 |
| Booking.com above the cheapest, median | 24.2% | 16.3% |
The hotel's own site was the cheapest seller once in 16 hotels that listed one: The One Palácio da Anunciada in Lisbon. At KOKO HOTEL Asakusa Komagata in Tokyo it was the dearest of 20 sellers. Super.com had the lowest price at 8 of the 10 Lisbon hotels; in Tokyo seven different sellers did. The script ranks offers on Google's displayed total with taxes. Offers can differ in room type and cancellation terms, so check the booking link before you count a spread as a saving.
What it costs
A city with 10 hotels is 11 credits, so a weekly check of two cities is about 95 credits a month. The 100 free credits a month cover that; $19 buys 10,000 credits that never expire, and plans for higher volume cover more cities and dates. Set your key and your first city is a CSV in under a minute.
For flights on the same trip, see does Google Flights have an API. For rentals, see does Airbnb have a public API. For ratings by city, see the Tripadvisor API.
We are not affiliated with Google.