# Changelog of Kurzurlaub Reviews Scraper — Hotel- & Gästebewertungen (`kestrel/kurzurlaub-reviews-scraper`) Actor

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

## Changelog

### 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 guest rating of any Kurzurlaub.de hotel: the overall score on Kurzurlaub's 1-6 scale (6 is the best), the per-area scores the guest gave (hotel, room, service, food, leisure, location, value), the title, the comment when the guest wrote one, the reviewer's first name or "Gast", and the date.
- Two ways in: Kurzurlaub hotel URLs (read once for the hotel's id, name, stars, address and price range) or the numeric ids directly. A URL and its id count as the same hotel and are harvested once.
- Ratings arrive newest first. Three cost controls filter **before** billing: `maxScore` keeps only ratings at or below a score (the complaints feed), `minScore` keeps only ratings at or above one (the praise feed), and `sinceDate` keeps only ratings from a date on — and stops paging as soon as the date is passed, so older ratings are never fetched.
- Free hotel row per property: name, stars, address, overall score and word, rating count, per-area averages and the offer price range.
- Billing: pay per delivered rating row. Hotel rows, status rows, filtered ratings, hotels with no ratings and failed hotels are all free.
- Reliability: a body that is not a ratings fragment (an error page, an empty answer) rotates the IP and retries instead of being read as "no ratings"; the shell Kurzurlaub returns for an id it does not have is reported as an error on the status row, free, without retrying.