MCP + API · kestrel/hostelworld-reviews-scraper
Hostelworld Reviews Scraper - Hostel Guest Reviews, Ratings
Get Hostelworld hostel and backpacker reviews by property URL or ID. Each review includes score, safety, location, staff and cleanliness ratings, text, owner reply, group type, age, nationality and date. Free hostel row: address, lowest price. Filters: negative reviews, dates and group type.
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/hostelworld-reviews-scraper
Generic MCP client configuration
{
"mcpServers": {
"kestrel-hostelworld-reviews-scraper": {
"url": "https://mcp.apify.com?tools=call-actor,fetch-actor-details,kestrel/hostelworld-reviews-scraper"
}
}
}
Understand the output before you run
One row per hostel guest review (charged), plus a free hostel context row and a free status row per target.
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 56 declared output fields
| Field | Type | Meaning |
|---|---|---|
type | string | review | property | status |
target | string / null | The input value (URL or property id) this row came from |
property_id | string / null | Hostelworld's numeric property id (the number in /hostels/p/<id>/) |
property_name | string / null | Hostel name as Hostelworld lists it |
property_url | string / null | The hostel's page on hostelworld.com |
review_id | string / null | Hostelworld's numeric review id |
review_date | string / null | Publication date, YYYY-MM-DD |
text | string / null | The review text (Hostelworld's notes field); null when the guest scored without writing |
language | string / null | Language code of the text Hostelworld serves (always en today) |
machine_translated | boolean / null | true when Hostelworld machine-translated the review into the served language |
rating | integer / null | Overall score on Hostelworld's 0-100 scale (100 = perfect); on property rows, the hostel's aggregate score |
rating_5 | number / null | The same score converted to the 0-5 star scale, e.g. 94 -> 4.7 |
sub_ratings | object / null | The seven 0-100 sub-scores: value, safety, location, staff, atmosphere, cleanliness, facilities |
liked | string / null | What the guest liked, when Hostelworld splits the review that way (legacy field, usually null) |
disliked | string / null | What the guest disliked, when Hostelworld splits the review that way (legacy field, usually null) |
recommended | boolean / null | Whether the guest recommends the hostel (legacy field, usually null) |
owner_comment | string / null | The hostel's public reply to the review, if any |
group_type | string / null | MALE | FEMALE (solo travellers) | COUPLE | ALLFEMALEGROUP | ALLMALEGROUP | MIXEDGROUP | FAMILY |
age_group | string / null | Reviewer age band: 18-24, 25-30, 31-40 or 41+ |
trip_types | array / null | Why they were travelling: REGULARVACATION, WEEKENDAWAY, GAPYEAR, RTWTRIP, COLLEGEBREAK, OTHER |
reviewer_id | string / null | Hostelworld's numeric user id |
reviewer_nickname | string / null | Reviewer display name ("Anonymous" when they hid it) |
reviewer_gender | string / null | Male | Female when the reviewer published it |
reviewer_country | string / null | Reviewer nationality, e.g. "Ireland" |
reviewer_country_code | string / null | Hostelworld's nationality code, e.g. IE |
reviewer_reviews | integer / null | How many reviews this guest has written on Hostelworld |
reviewer_image | string / null | Reviewer avatar URL, when there is one |
property_type | string / null | HOSTEL | GUESTHOUSE | HOTEL | APARTMENT | CAMPSITE (property rows) |
star_rating | integer / null | Star rating where the property has one, else 0 (property rows) |
city | string / null | City (property rows) |
country | string / null | Country (property rows) |
region | string / null | Region or district Hostelworld files the property under (property rows) |
address | string / null | Street address (property rows) |
latitude | number / null | Latitude (property rows) |
longitude | number / null | Longitude (property rows) |
total_ratings | integer / null | How many guests have rated the hostel in total, scores without text included (property rows) |
currency | string / null | Currency the hostel prices in (property rows) |
lowest_price_per_night | number / null | Hostelworld's lowest advertised nightly price (property rows) |
best_for | array / null | What Hostelworld says the hostel is best for, e.g. ["Home Cooking", "Meeting People"] (property rows) |
facilities | array / null | Every facility Hostelworld lists for the hostel (property rows) |
description | string / null | Hostelworld's own write-up of the hostel, else the hostel's description (property rows) |
positive_count | integer / null | Reviews Hostelworld counts as positive (property rows) |
negative_count | integer / null | Reviews Hostelworld counts as negative (property rows) |
solo_percentage | number / null | Share of reviewers travelling solo (property rows) |
couples_percentage | number / null | Share of reviewers travelling as a couple (property rows) |
groups_percentage | number / null | Share of reviewers travelling in a group (property rows) |
reviews_listed | integer / null | Reviews Hostelworld lists for the hostel (property rows) |
reviews_fetched | integer / null | Reviews read in this run for the hostel before filters (property rows) |
status | string / null | ok | no_reviews | not_found | duplicate | error (status rows) |
reviews | integer / null | Reviews delivered and charged for this target (status rows) |
filtered | integer / null | Reviews dropped by the filters, never charged (status rows) |
pages | integer / null | Review pages read (status rows) |
total | integer / null | Reviews Hostelworld lists for the hostel (status rows) |
duplicates | integer / null | 1 when this target resolved to a hostel another target already covers (status rows) |
error | string / null | Why a target failed (status rows) |
fetched_at | string / null | UTC timestamp of the request |
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.9; it is not a promise that the source has matching rows today.
{
"actor": "kestrel/hostelworld-reviews-scraper",
"input": {
"startUrls": [
"https://www.hostelworld.com/hostels/p/15529/home-lisbon-hostel/"
],
"maxReviewsPerProperty": 3,
"reviewsSort": "-date"
},
"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 Hostelworld guest review: 0-100 score with seven sub-ratings, the text, the hostel's reply, group type, age band, trip types, nickname and nationality (row keys review_id, rating, sub_ratings, text, owner_comment, group_type, age_group, trip_types, reviewer_nickname, reviewer_country, review_date): $4 per 1,000 reviews. Not charged: reviews removed by minRating, maxRating, groupTypes, sinceDate or requireText, duplicate targets, hostels with no reviews, unknown ids, hostel rows, status rows. No start fee; proxy and compute are included in the event price. Hostelworld pages 50 reviews at a time and a busy hostel has a few thousand: maxReviewsPerProperty caps the rows per hostel. The run stops at the maximum cost per run you set (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.9. Refresh live details before a large or recurring run.