# Changelog of Google Hotels Scraper & API — Hotel Prices & Rates (`aaronoptimus/google-hotels-scraper`) Actor

- **URL**: https://apify.com/aaronoptimus/google-hotels-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/aaronoptimus/google-hotels-scraper.md

## Changelog

### 1.1 — October 2026

- **Rate parity** with *Full details*: each hotel says whether its own website matches (`parity`), beats (`direct cheaper`) or loses to (`OTA cheaper`) the cheapest other booking site, with both prices, that site's name, the difference and how far all booking sites' prices spread. The fields are also in the *Rows* format and the *Prices* view, and are `null` without full details.
- **Prices by Apify plan**: a hotel costs $0.003 on the Free plan, $0.0025 on Starter, $0.0022 on Scale and $0.002 on Business; a hotel with all booking sites (*Full details*) $0.006, $0.005, $0.0045 and $0.004. The start fee stays $0.005 per run, with no platform fees.
- The price list names the events "Hotel" and "Hotel with all booking sites".
- *Maximum cost per run* is respected with plan prices too: the run stops cleanly at your limit.
- Every output field is described in the dataset schema, for the API, MCP clients and AI agents.
- README: cost table per Apify plan, rate-shopping and rate-parity examples, and how to track one hotel over many dates.

### 1.0 — October 2026

First public release.

- Hotel lists for any destination (city, area, landmark or Google Hotels search link), with price per night, taxes and fees, total for the stay, deals, rating, review breakdown, hotel class, location with Google's location scores, amenities and photos.
- **Full details** option: every booking site's price with taxes, free-cancellation deadline and direct booking link, room-by-room rates, address, phone, nearby places with travel times, and ratings on other sites.
- **Specific hotels** by name (the best-matching Google Hotels result; unknown names return an error, not a random hotel), Google Hotels link or hotel ID.
- **Price calendars**: repeat any search or hotel for up to 60 consecutive check-in dates.
- Google Hotels filters: price range, hotel class, guest rating, amenities, brands, free cancellation, special offers, eco-certified; sort by price, rating or reviews.
- Vacation rentals, with sleeps, bedrooms, bathrooms and provider links.
- Any currency, country and language; adults and children's ages.
- **Rows** output format for CSV / Excel / Google Sheets; every result links to the same view on Google Hotels and Google Maps.
- Reliability: per-session cookies and consistent browser fingerprint, session/IP rotation through proxy IPs in your chosen country (an answer Google priced for another country is asked for again from another IP), capped backoff, time limit per page and hotel, residential fallback, parallel sessions, resume after restarts.
- Pay per hotel returned, plus a small start fee per run; failed searches and searches without hotels are free; *Maximum cost per run* is respected across event types and parallel sessions.
- Crash- and migration-safe billing: progress is saved before every charge, so a restarted or migrated run never charges the same hotel twice.
- No personal data: individual reviews, reviewer names and profile photos are never collected.