# Changelog of TripAdvisor Reviews Scraper — Hotel Guest Reviews & Ratings (`kestrel/tripadvisor-reviews-scraper`) Actor

- **URL**: https://apify.com/kestrel/tripadvisor-reviews-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/kestrel/tripadvisor-reviews-scraper.md

## Changelog

### 1.1 — 2026-09-01

- Fix: TripAdvisor's DataDome gate stopped serving the Firefox 147 fingerprint (403 on every IP, residential included, from 2026-09-01), which failed every run. The client now impersonates Safari 26.0.1, the one profile the site still serves; paging, typeahead and the localized domains are unchanged.

### 2026-08-30

- Reliability: a run that cannot act on its input — a URL from the wrong site, a name nothing resolves to, an empty target list, a number outside the documented range — now ends cleanly with the reason on the run card instead of as a failed run. Nothing is charged in either case; a blocked or throttled source still fails loudly.
- Store listing: moved into the categories buyers actually browse (the old `Business` category has no Store page).

### 1.0 — 2026-08-29

First release.

- Every TripAdvisor review of a hotel as structured rows: 1-5 bubbles, title, full text, six sub-ratings, language and original language, machine-translation flag, publication and stay dates, trip type, reviewer profile (name, handle, verified flag, contribution counts, hometown), photos, helpful votes and the management response.
- Hotels by TripAdvisor URL, by location id (the `d<number>`) or by name through TripAdvisor's own typeahead, with a word-overlap guard so a nonsense name is an error row rather than a random hotel.
- Up to 30 site languages in one run — each TripAdvisor domain serves the reviews in its own language, machine-translated ones included; `includeTranslated: false` keeps only reviews written in that language.
- Filters that run **before billing**: `maxRating` (complaints feeds), `tripTypes`, `sinceDate` (relative dates for schedules; paging stops once a whole page predates it), `requireText`, `includeTranslated`.
- A free hotel row per hotel and language: bubble rating, review count, reviews per rating and per language, six sub-ratings, city ranking, address, coordinates, phone, website, amenities.
- Reads the server-rendered review pages through Apify's residential proxy with a Firefox-fingerprinted client — no browser, no GraphQL, no login. A DataDome refusal rotates the IP and retries; it is never reported as "no reviews".
- Pay per review row; hotels with no reviews, unknown ids, duplicate targets and filtered reviews are free.