MCP + API · kestrel/hrs-reviews-scraper
HRS Reviews Scraper - Hotel Reviews, Guest Reviews, Ratings
Get HRS hotel reviews by URL or hotel ID. Each guest review includes 0-10 rating, 12 category scores, positives, negatives, hotel reply, traveller type, stay dates, language and text. Free hotel row: stars, address. Filters: complaints, negative reviews, business travel, German. Hotelbewertungen.
Open Actor Download MCP config
Connect this tool
Add this URL as a remote MCP server in your client, then sign in to Apify. For a client-specific setup, use Apify's configurator.
https://mcp.apify.com?tools=call-actor,fetch-actor-details,kestrel/hrs-reviews-scraper
Generic MCP client configuration
{
"mcpServers": {
"kestrel-hrs-reviews-scraper": {
"url": "https://mcp.apify.com?tools=call-actor,fetch-actor-details,kestrel/hrs-reviews-scraper"
}
}
}
Understand the output before you run
One row per guest review (charged), plus a free hotel context row and a free status row per property.
Declared dataset fields and row types · Output locations and dataset links
Use the declared dataset schema for item fields; the output schema describes where results are stored. Optional fields may be null or absent. If an integration shows a sampled schema without an optional field, check this declaration, the Actor instructions and actual returned rows before concluding that the field is unsupported.
Inspect 43 declared output fields
| Field | Type | Meaning |
|---|---|---|
type | string | review | hotel | status |
hotel_id | string | HRS hotel id (the number in the hotel URL) |
hotel_name | string / null | Hotel name from the hotel page (empty when includeHotelRow is off) |
url | string | Hotel page URL |
review_id | string | Stable id of the rating (HRS booking id) |
rating | number / null | Guest score 0-10 |
rating_5 | number / null | Same score on the 5-star scale |
recommends | boolean / null | Guest recommends the hotel |
comfort | string / null | HRS comfort word, e.g. NICE |
positives | string / null | What the guest liked |
negatives | string / null | What the guest disliked |
text | string / null | Positives and negatives joined |
hotel_reply | string / null | The hotel's replies |
traveller_type | string / null | BUSINESS, PRIVATE, YOUNG_COUPLE, MATURE_COUPLE, FAMILY_SMALL_CHILDREN, FAMILY_OLDER_CHILDREN, GROUP, CONFERENCE |
age_group | string / null | UP_TO_59 or OVER_59 |
language | string / null | ISO 639-2 code of the comment (deu, eng, …) |
locale | string / null | Two-letter site locale the guest used |
reviewer_name | string / null | Guest display name as HRS shows it |
arrival_date | string / null | Check-in date |
departure_date | string / null | Check-out date |
nights | integer / null | Length of stay |
review_date | string / null | When the rating was written (ISO 8601) |
votes | object / null | Twelve category votes 0-10: FRIENDLINESS_OF_RECEPTION, SERVICE_OF_HOTEL_EMPLOYEES, HOTEL_AMBIANCE, ROOM_CONFIGURATION, HOTEL_TIDINESS, SANITARY_FACILITIES, ROOM_SIZE, BREAKFAST_SERVICE, RESTAURANT_SERVICE, PRICE_PERFORMANCE_RATIO, WELLNESS_RANKING, QUALITY_OF_BEDS |
stars | integer / null | HRS star category |
address | string / null | Street address |
postal_code | string / null | Postal code |
city | string / null | City |
rating_count | integer / null | All ratings HRS counts for the property, commented or not |
comment_count | integer / null | Ratings with a written comment (what can be delivered) |
recommendation_pct | number / null | Share of guests who recommend the hotel |
ratings_by_traveller_type | object / null | Per traveller type: count, rating, recommendation_pct |
avg_by_category | object / null | Average 0-10 per category |
avg_by_super_category | object / null | Average per super category (HOTEL_GENERAL_ASPECTS, ROOM, STAFF_AND_GASTRONOMY) |
reviews_fetched | integer / null | Commented ratings read for this hotel |
target | string / null | The input this status row is for |
status | string / null | ok | no_reviews | not_found | duplicate | error |
reviews | integer / null | Review rows delivered |
filtered | integer / null | Reviews dropped by a filter (never billed) |
total | integer / null | HRS's rating count for the hotel |
comments | integer / null | Commented ratings available |
duplicates | integer / null | 1 when this input repeats a hotel already harvested |
error | string / null | Why the hotel failed |
fetched_at | string | UTC timestamp of the row |
Start with a small sample
Use call-actor with the JSON below. The $0.25 run ceiling is separate from the Actor input and may stop the sample early. Change the target to match your request. This input validates against build 1.0.8; it is not a promise that the source has matching rows today.
{
"actor": "kestrel/hrs-reviews-scraper",
"input": {
"startUrls": [
"https://www.hrs.com/en/hotel/10520"
],
"maxReviewsPerHotel": 3,
"reviewsSort": "most_recent",
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
},
"callOptions": {
"maxTotalChargeUsd": 0.25,
"timeout": 300
},
"waitSecs": 30
}
After completion, use get-dataset-items with storages.datasets.default.id. If still running, poll get-actor-run using the returned runId. Check status rows and errors before treating an empty dataset as no matches.
Call from Python, JavaScript or REST
Python SDK 3 example · JavaScript SDK 2 example · curl + jq example. Each uses this same small input, reads APIFY_TOKEN from your environment, sets a five-minute run timeout and exports all dataset row types as JSON Lines. The $0.25 run ceiling is separate from the Actor input and may stop the sample early. Inspect the run and source status before treating results as complete. Installation and usage.
Pricing and limits
Current listed event prices in USD. Some Actors charge for successful source checks even when no output rows match. The event descriptions below define those differences.
| Event | USD each | What is charged |
|---|---|---|
review | $0.004 | One commented guest rating of an HRS hotel: 0-10 score, 12 category scores, positives, negatives, the hotel's replies, traveller type, age group, stay dates, language and text (row keys review_id, rating, votes, positives, negatives, hotel_reply, traveller_type, age_group, arrival_date, departure_date, language, text, review_date): $4 per 1,000 reviews. Not charged: reviews removed by maxRating, travellerTypes, languages or requireText, duplicates, hotels with no commented ratings, unknown ids, hotel rows, status rows. No start fee; proxy and compute are included in the event price. A busy hotel has 50-150 commented ratings; maxReviewsPerHotel caps the rows per hotel. The run stops at the maximum cost per run you set when starting it (Apify run option maxTotalChargeUsd), never above it. |
Contracts for agents
- Input schema and sample input
- Prepared MCP call and pricing events
- Full Actor instructions and limits
- REST API
Public contract checked 2026-11-11. Active build: 1.0.8. Refresh live details before a large or recurring run.