# Changelog of Trip.com Reviews Scraper — Hotel Guest Reviews & Ratings (`kestrel/trip-com-reviews-scraper`) Actor

- **URL**: https://apify.com/kestrel/trip-com-reviews-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/kestrel/trip-com-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 review of any Trip.com (Ctrip) hotel: rating on Trip.com's 0-10 scale and the familiar 5-star scale, the rating word, the four sub-scores (location, cleanliness, service, amenities), review text in the language it was written in, posting and check-in dates, room type, traveler type, reviewer name, country, review count and level, helpful votes, photos, the hotel's public reply and which source the review came from (Trip.com, Ctrip, Expedia, Hotels.com).
- Two ways in: Trip.com hotel URLs (the id is in the URL, so no page read is needed) or the numeric ids directly. A URL and its id count as the same hotel and are harvested once.
- Order by most recent, highest rated, lowest rated or most relevant; keep only chosen languages, filtered by Trip.com itself so skipped reviews are never fetched or charged.
- Two cost controls that filter **before** billing: `maxRating` keeps only reviews at or below a score, and `requireText` drops reviews with no words. Filtered reviews are never charged.
- Free hotel row per property: name, stars, address, overall and sub-scores, review count, and the languages and traveler types its reviews come in.
- Billing: pay per delivered review row. Hotel rows, status rows, filtered reviews, hotels with no reviews and failed hotels are all free.
- Reliability: a refused call from Trip.com answers 200/Success with no review block — the same shape a missing request head produces — and is detected and retried on a fresh IP instead of being reported as "no reviews". An unknown hotel id is reported as such, not retried forever.