ToolzerHubAnswer

Google Hotels API: compare every seller's price

Google's hotel APIs send prices to Google. Ours reads them back: across 20 hotels, the cheapest and dearest seller differed by a median 35%.

5 min read

Short answer

  • Google's hotel APIs are for hotels and booking sites sending prices and content into Google, not for reading them back.
  • ToolzerHub's Google Hotels API returns search results for a city and dates, property details, and every seller's price for a stay, with and without taxes.
  • On 20 hotels in Lisbon and Tokyo, the cheapest and dearest seller differed by a median 35%; of 16 hotels selling direct, the own site was cheapest once. Each call costs 1 credit.
On this page

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
bash
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:

json
{
  "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.

python
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.

Get this data from your own code

The Google Hotels API returns it as JSON with one x-api-key header. 100 free credits monthly.