# Changelog of Google Hotels Scraper (`searchapi/google-hotels-scraper`) Actor

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

## Changelog

All notable changes to the Google Hotels Scraper are documented here.

### \[3.0.0] - 2026-08-29

#### Changed

- Rebuilt extraction around current public Google Travel hotel cards and canonical `/entity/` links.
- Added stable IDs, typed numeric values, source/engine provenance, ISO timestamps, and requested-versus-displayed currency reporting.
- Added single and fairly allocated batch modes with user-friendly location inputs and legacy `query` compatibility.
- Added date, guest, locale, filter, sorting, concurrency, retry, timeout, and proxy validation.
- Added Playwright session pooling, consistent fingerprints, bounded scrolling, safe resource blocking, and explicit challenge/layout classification.
- Added Residential/custom proxy support and explicit rejection of incompatible `GOOGLE_SERP` tunneling.
- Replaced placeholder-rich output with source-backed optional fields; empty values are omitted and records are deduplicated by stable ID.
- Added current input, dataset, and output schemas; dataset auditing; six unit tests; and a deterministic production install.

#### Removed

- Removed an unused helper that read proxy authentication from a local file.
- Removed unsupported output claims for addresses, coordinates, contact data, and booking-provider details.

### \[2.0.0] - 2026-06-12

#### Added

- **Schema expanded** from 30 to **54 fields**.
- **New fields**: `type`, `resultType`, `name`, `titleHtml`, `link`, `hotelId`, `city`, `state`, `zipCode`, `coordinates`, `latitude`, `longitude`, `reviewCount`, `reviewScore`, `reviewScoreWord`, `starRating`, `amenities`, `propertyType`, `checkIn`, `checkOut`, `priceNumeric`, `pricePerNight`, `pricePerNightNumeric`, `originalPrice`, `discount`, `freeCancellation`, `noPrepayment`, `reserveUrl`, `bookingProvider`, `imageUrl`, `images`, `neighborhood`, `landmarks`, `transit`, `phone`, `email`, `isAd`, `isSponsored`, `query`.
- **New view**: `fullDetails` — all 54 fields.
- **INPUT.json** added at project root for local validation.

### \[1.0.0] - 2025-05-20

#### Added

- Initial production release of the Google Hotels Scraper.
- `PlaywrightCrawler`-based architecture using Chrome.
- Modular project structure.
- `validate-datasets.js` for local dataset output validation.
- `Dockerfile` using `apify/actor-node-playwright-chrome` image.
- `README.md` with full Apify usage guide.