# 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%.

- URL: https://toolzerhub.com/blog/google-hotels-api
- Published: 2026-11-03
- Publisher: ToolzerHub (we sell the API this post describes)

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

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](https://developers.google.com/hotels) 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](https://toolzerhub.com/apis/google-hotels) 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](https://toolzerhub.com/pricing) 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](https://toolzerhub.com/blog/does-google-flights-have-an-api). For rentals, see [does Airbnb have a public API](https://toolzerhub.com/blog/airbnb-api). For ratings by city, see the [Tripadvisor API](https://toolzerhub.com/blog/tripadvisor-api).

We are not affiliated with Google.
