kestrel actors › Guest & customer reviews

HRS Reviews Scraper — Hotel Guest Reviews & Ratings

Every commented guest rating of any hotel on HRS (hrs.com), Europe's business-travel booking platform — hrs hotel reviews and hrs ratings as clean rows: the 0-10 score with twelve category votes, what the guest liked and disliked, the hotel's replies, traveller type and age group, stay dates, nights and the language of the comment — plus one free row per property with its averages by traveller type and by category. Give the HRS reviews scraper hotel URLs or hotel ids and it returns the hotel guest reviews as a dataset you can export to CSV, Excel or JSON, feed to n8n or Make, or hand to an AI agent over MCP. No login, no browser, no HRS API key.

Run HRS Reviews Scraper on Apify →

HRS reviews scraper pricing: what one row costs

$0.003 per review row delivered, and nothing else: hotel rows, status rows, unknown hotels and filtered reviews are free, and an empty run costs $0. A busy city hotel has 50-150 commented ratings, so the full corpus of one property is $0.15-$0.45; a daily complaints feed over 20 properties that surfaces a handful of new low ratings costs a few cents a day. Proxy traffic is small (about 100 KB of JSON per hotel, plus the page for the hotel row) and is paid through your Apify plan. Set maxReviewsPerHotel and the filters to keep bulk work predictable — the status row tells you how much a hotel would have delivered.

HRS reviews scraper input reference

Every field of HRS Reviews, straight from the actor's input schema.

Example input

{
  "hotelIds": ["10520", "162"],
  "reviewsSort": "lowest_rated",
  "maxRating": 7,
  "maxReviewsPerHotel": 50,
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}

{
  "startUrls": ["https://www.hrs.com/de/hotel/162"],
  "travellerTypes": ["BUSINESS"],
  "languages": ["de"],
  "language": "de",
  "maxReviewsPerHotel": 0,
  "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"] }
}

HRS reviews scraper output fields

One row per guest review (charged), plus a free hotel context row and a free status row per property.

Dataset views in the Apify Console: Overview, Reviews, Complaints, Hotels, Status.

Example row from a real run

Taken from the actor's README — this is the shape your dataset holds.

{
  "type": "review",
  "review_id": "315653282",
  "hotel_id": "10520",
  "hotel_name": "Bilderberg Bellevue Hotel Dresden",
  "url": "https://www.hrs.com/en/hotel/10520",
  "rating": 9.36,
  "rating_5": 4.68,
  "recommends": true,
  "comfort": "NICE",
  "positives": "Tolle Lage direkt an der Elbe und fußnah zu Altstadt",
  "negatives": null,
  "text": "Tolle Lage direkt an der Elbe und fußnah zu Altstadt",
  "hotel_reply": "Das klingt nach einer schönen Zeit in Dresden! Wir freuen uns, dass Sie bei der Gelegenheit mit uns als Ihren Gastgeber geplant haben.",
  "traveller_type": "PRIVATE",
  "age_group": "OVER_59",
  "language": "deu",
  "locale": "de",
  "reviewer_name": "Müller K.",
  "arrival_date": "2025-12-08",
  "departure_date": "2025-12-11",
  "nights": 3,
  "review_date": "2025-12-11T14:28:35Z",
  "votes": { "FRIENDLINESS_OF_RECEPTION": 10, "SERVICE_OF_HOTEL_EMPLOYEES": 10, "HOTEL_AMBIANCE": 9, "ROOM_CONFIGURATION": 10, "HOTEL_TIDINESS": 10, "SANITARY_FACILITIES": 8, "ROOM_SIZE": 10, "BREAKFAST_SERVICE": 9, "RESTAURANT_SERVICE": 0, "PRICE_PERFORMANCE_RATIO": 9, "WELLNESS_RANKING": 8, "QUALITY_OF_BEDS": 10 },
  "fetched_at": "2026-08-29T10:20:11+00:00"
}

HRS reviews scraper in Python, JavaScript and curl

Python

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("kestrel/hrs-reviews-scraper").call(run_input={
    "hotelIds": ["10520", "162"],
    "reviewsSort": "lowest_rated",
    "maxRating": 7,
    "maxReviewsPerHotel": 50,
    "proxyConfiguration": {"useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"]},
})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    if row["type"] == "review":
        print(row["hotel_name"], row["rating"], row["traveller_type"], (row["negatives"] or "")[:80])

JavaScript (Node)

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('kestrel/hrs-reviews-scraper').call({
    startUrls: ['https://www.hrs.com/en/hotel/10520'],
    maxReviewsPerHotel: 100,
    proxyConfiguration: { useApifyProxy: true, apifyProxyGroups: ['RESIDENTIAL'] },
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
const reviews = items.filter(r => r.type === 'review');
console.log(reviews.length, 'reviews;', reviews.filter(r => r.hotel_reply).length, 'answered by the hotel');

curl

curl -X POST "https://api.apify.com/v2/acts/kestrel~hrs-reviews-scraper/run-sync-get-dataset-items?token=<YOUR_APIFY_TOKEN>&timeout=300" \
  -H "Content-Type: application/json" \
  -d '{"hotelIds": ["10520"], "maxReviewsPerHotel": 30, "reviewsSort": "most_recent", "proxyConfiguration": {"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"]}}'

The same three calls are runnable files in the examples repository: examples/hrs-reviews-scraper.py|.js|.sh.

Limits and honest notes

FAQ

Does it need an HRS API key or login?

No. The ratings endpoint the hotel page calls is public; the scraper sends the same client identifier the site's own JavaScript sends. Nothing is logged in and no session is reused.

Can I download HRS reviews as CSV or Excel?

Yes — download HRS reviews from any run, and get HRS reviews CSV files straight from the dataset. Every Apify dataset exports as CSV, Excel, JSON, XML or RSS from the Console or the API. The votes object flattens to twelve columns in the Excel export; in CSV it is a JSON string.

How do I get only HRS negative reviews?

maxRating: 7 keeps ratings at or below 7; reviewsSort: "lowest_rated" puts the worst first; maxReviewsPerHotel caps the count. Everything above 7 is filtered before billing.

What is the difference between rating_count and comment_count?

rating_count is every rating HRS has for the property, with or without a comment. comment_count is how many carry a written positive or negative — the rows this scraper can deliver. Both are on the hotel row and the status row.

Do I need the hotel id, or can I use the URL?

Either. The id is the number after /hotel/ in any hrs.com URL; the scraper reads it from the URL without loading the page. Ids are handier for long lists — twenty go into one request.

How many reviews can one hotel return?

All of its commented HRS hotel ratings — HRS returns the full list in one answer. City business hotels typically have 30-150; the status row's comments tells you the count before the cap.

Are reviews translated, and which languages come back?

They are not translated. Most comments are German or English, with French, Italian, Spanish, Dutch and others; language carries the ISO 639-2 code and languages filters on it before billing.

Does it include the hotel's replies?

Yes. HRS lets a hotel answer the positive and the negative separately; both go into hotel_reply. Counting rows with a reply is a quick measure of how attentive a property is.

Can I filter by traveller type?

Yes. travellerTypes accepts one or more of HRS's eight types. One type is asked of HRS directly (nothing else is downloaded); several are kept from the full list. The hotel row carries each type's average and recommendation rate.

Can I scrape HRS reviews without an API?

HRS reviews without API access is exactly what this does: no HRS API, no key, no browser — a scheduled Apify run and a dataset. Call it from the Apify API, n8n, Make, MCP or the Console.

What does bulk work cost?

$0.003 per review delivered. 100 hotels at 60 comments each is 6,000 rows and $18; the same 100 hotels with maxRating: 6 deliver only the bad stays and cost a fraction of that. Runs that deliver nothing cost $0.

How to use HRS Reviews Scraper

• How to Monitor Hotel Reputation Across OTAs — A daily feed of new guest reviews from every OTA a hotel sells on, normalised to one scale, at a cost measured in cents per property per month.

Ready-made runs you can open and start

Each one is a saved input on the Apify Store — open it, press Start, and it runs with the fields already filled in. All 163 across the suite.

Related scrapers

• Agoda Reviews Scraper — Agoda hotel reviews with separate positives and negatives and the hotel's reply.
• Trip.com Reviews Scraper — Trip.com and Ctrip hotel reviews with four sub-scores and the Chinese-language corpus.
• Airbnb Reviews Scraper — every guest review of an Airbnb listing, minRating billed only for the rows you keep.
• Hotel Rate Parity Checker — every booking site's rate for a stay side by side, with the parity math.
• Google Hotels Prices Scraper — hotel prices and every booking site's rate for exact dates.

Run HRS Reviews Scraper

The actor lives on the Apify Store, where the pricing tab carries the live per-row price and the input form has every field above: apify.com/kestrel/hrs-reviews-scraper