# Changelog of Tripadvisor Hotel Scraper — Hotels, Reviews · Travel Data API (`sian.agency/tripadvisor-hotel-scraper`) Actor

- **URL**: https://apify.com/sian.agency/tripadvisor-hotel-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/sian.agency/tripadvisor-hotel-scraper.md

## Changelog

### \[2026-07-03] Maintenance — hidden dead search modes

- Hidden `bygeoid`/`bylocation`/`bycoordinates`/`byboundingbox` from Search Mode: the upstream hotel-list service is temporarily down (provider outage). `byid` + `byurl` (single-hotel detail + reviews) work normally. Search modes return automatically once the provider restores the service. Code unchanged — see `.scratch/MAINTENANCE-hidden-paths.md`.

All notable changes to **Tripadvisor Hotel Scraper** will be documented in this file.

### \[2026-07-03]

#### 🔧 Reliability Fixes

- **Fixed location lookup** — free-text location resolution (`bylocation` mode) now works again after an upstream data-source update changed parameter and response formats
- **Clearer errors** — hotel searches that hit a temporary upstream outage now report a clear error message instead of silently returning zero results
- **Radius accuracy** — `bycoordinates` radius (km) is now converted correctly for the updated upstream API
- **Instant test runs** — default input now fetches a real example hotel (Hôtel Astra Opéra, Paris) so first runs return data immediately; switch Search Mode to `bylocation`/`bygeoid` for full city searches
- **Note:** area-wide hotel list searches (geo / location / coordinates / bounding box) may temporarily return an upstream service error while the data source completes maintenance — single-hotel lookups (`byid`/`byurl`) and reviews are unaffected

### \[2026-05-19]

#### 🎉 Tripadvisor Hotel Scraper — Launch!

- **5 Search Modes** — pull hotels by Tripadvisor geo ID, free-text location (city/region), lat/lng + radius, bounding box, single hotel ID, or hotel URL
- **Live Tripadvisor Hotel Data** — name, rating, review count, ranking position, accommodation type, style tags, address, coordinates, contact info
- **Live Nightly Price Quotes** — pass checkIn/checkOut/adults/rooms/currency to pull priced rates in any ISO currency
- **Reviews Enrichment (PAID)** — opt-in `fetchReviews` flag pulls up to 20 reviews per hotel in the same run — no two-actor pipeline, no manual locationId hand-off
- **Hospitality KPIs HTML Report** — auto-generated report with median price, rating distribution, rank distribution, top cities, top accommodation types, and style-tag tally
- **Bulk Detail Mode (PAID)** — pass multiple `locationIds` or `urls` to pull hotel details in one run
- **Direct-API Wrapper** — sub-2-second/hotel response time, no Cloudflare/captcha brittleness like browser-scrapers
- **Built-in Deduplication** — hotels deduped across overlapping queries automatically

#### 💎 User Benefits

- Hospitality analysts can build daily competitor dashboards across any city in under 5 minutes
- Reputation managers get up to 20 latest reviews per hotel ready for sentiment pipelines
- OTA pricing teams benchmark inventory + live price quotes across the top-50 cities in one workflow
- Travel researchers build geographic hotel comparables by lat/lng or bounding box for academic / consulting work
- M\&A teams snapshot a target hotel's Tripadvisor footprint (rank, reviews, price, address) in one API call

#### 🎯 Use Cases

- Hospitality analyst tracking competitor hotels' rank position drift over time
- Reputation manager piping latest 20 reviews per hotel into a sentiment-analysis stack
- OTA pricing analyst comparing nightly rates across cities for OTA-rate-parity audits
- Hospitality M\&A advisor building a one-page Tripadvisor footprint for each acquisition target
- Vacation-rental platform quantifying hotel competition in a neighborhood bounding box
- BI engineer powering a Looker / Power BI / Metabase board with daily Tripadvisor hotel snapshots

#### 💰 Pricing

- **FREE tier:** 25 hotels per run, all 5 search modes, no reviews enrichment
- **PAID tier:** unlimited hotels, bulk input arrays, reviews enrichment available
- **Tiered curve:** $0.008 FREE → $0.0029 BRONZE → $0.0025 SILVER → $0.002 GOLD → $0.0015 PLATINUM → $0.00125 DIAMOND per hotel; reviews charged separately