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

- **URL**: https://apify.com/kestrel/agoda-reviews-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/kestrel/agoda-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-26

First release.

- Every guest review of any Agoda property: rating on Agoda's 0-10 scale and the familiar 5-star scale, rating word, title, comment, separate positives and negatives, the language it was written in, stay dates and length, room type, reviewer name and country, the hotel's public reply and which source the review came from.
- Three ways in: a plain property name (resolved through Agoda's own autocomplete — no id hunting), Agoda hotel URLs (the numeric id is read from the page for you), or the numeric ids directly. A name, its URL and its id all count as the same property and are harvested once.
- Order by most recent, highest rated, lowest rated or most relevant.
- Two cost controls that filter **before** billing: `maxRating` keeps only reviews at or below a score, and `requireText` drops the score-only reviews that have no words. Filtered reviews are never charged.
- Billing: pay per delivered review row. Hotel rows, status rows, filtered reviews, properties with no reviews and failed properties are all free, and a property is harvested once per run whether you give its URL, its id, or both.
- Reliability: a throttled call from Agoda answers 200 with no reviews at all — that is detected and retried on a fresh IP instead of reporting the property as having none.