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
FieldTypeMeaning
typestringreview | property | status
targetstring / nullThe input value (URL or property id) this row came from
property_idstring / nullHostelworld's numeric property id (the number in /hostels/p/<id>/)
property_namestring / nullHostel name as Hostelworld lists it
property_urlstring / nullThe hostel's page on hostelworld.com
review_idstring / nullHostelworld's numeric review id
review_datestring / nullPublication date, YYYY-MM-DD
textstring / nullThe review text (Hostelworld's notes field); null when the guest scored without writing
languagestring / nullLanguage code of the text Hostelworld serves (always en today)
machine_translatedboolean / nulltrue when Hostelworld machine-translated the review into the served language
ratinginteger / nullOverall score on Hostelworld's 0-100 scale (100 = perfect); on property rows, the hostel's aggregate score
rating_5number / nullThe same score converted to the 0-5 star scale, e.g. 94 -> 4.7
sub_ratingsobject / nullThe seven 0-100 sub-scores: value, safety, location, staff, atmosphere, cleanliness, facilities
likedstring / nullWhat the guest liked, when Hostelworld splits the review that way (legacy field, usually null)
dislikedstring / nullWhat the guest disliked, when Hostelworld splits the review that way (legacy field, usually null)
recommendedboolean / nullWhether the guest recommends the hostel (legacy field, usually null)
owner_commentstring / nullThe hostel's public reply to the review, if any
group_typestring / nullMALE | FEMALE (solo travellers) | COUPLE | ALLFEMALEGROUP | ALLMALEGROUP | MIXEDGROUP | FAMILY
age_groupstring / nullReviewer age band: 18-24, 25-30, 31-40 or 41+
trip_typesarray / nullWhy they were travelling: REGULARVACATION, WEEKENDAWAY, GAPYEAR, RTWTRIP, COLLEGEBREAK, OTHER
reviewer_idstring / nullHostelworld's numeric user id
reviewer_nicknamestring / nullReviewer display name ("Anonymous" when they hid it)
reviewer_genderstring / nullMale | Female when the reviewer published it
reviewer_countrystring / nullReviewer nationality, e.g. "Ireland"
reviewer_country_codestring / nullHostelworld's nationality code, e.g. IE
reviewer_reviewsinteger / nullHow many reviews this guest has written on Hostelworld
reviewer_imagestring / nullReviewer avatar URL, when there is one
property_typestring / nullHOSTEL | GUESTHOUSE | HOTEL | APARTMENT | CAMPSITE (property rows)
star_ratinginteger / nullStar rating where the property has one, else 0 (property rows)
citystring / nullCity (property rows)
countrystring / nullCountry (property rows)
regionstring / nullRegion or district Hostelworld files the property under (property rows)
addressstring / nullStreet address (property rows)
latitudenumber / nullLatitude (property rows)
longitudenumber / nullLongitude (property rows)
total_ratingsinteger / nullHow many guests have rated the hostel in total, scores without text included (property rows)
currencystring / nullCurrency the hostel prices in (property rows)
lowest_price_per_nightnumber / nullHostelworld's lowest advertised nightly price (property rows)
best_forarray / nullWhat Hostelworld says the hostel is best for, e.g. ["Home Cooking", "Meeting People"] (property rows)
facilitiesarray / nullEvery facility Hostelworld lists for the hostel (property rows)
descriptionstring / nullHostelworld's own write-up of the hostel, else the hostel's description (property rows)
positive_countinteger / nullReviews Hostelworld counts as positive (property rows)
negative_countinteger / nullReviews Hostelworld counts as negative (property rows)
solo_percentagenumber / nullShare of reviewers travelling solo (property rows)
couples_percentagenumber / nullShare of reviewers travelling as a couple (property rows)
groups_percentagenumber / nullShare of reviewers travelling in a group (property rows)
reviews_listedinteger / nullReviews Hostelworld lists for the hostel (property rows)
reviews_fetchedinteger / nullReviews read in this run for the hostel before filters (property rows)
statusstring / nullok | no_reviews | not_found | duplicate | error (status rows)
reviewsinteger / nullReviews delivered and charged for this target (status rows)
filteredinteger / nullReviews dropped by the filters, never charged (status rows)
pagesinteger / nullReview pages read (status rows)
totalinteger / nullReviews Hostelworld lists for the hostel (status rows)
duplicatesinteger / null1 when this target resolved to a hostel another target already covers (status rows)
errorstring / nullWhy a target failed (status rows)
fetched_atstring / nullUTC 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.

EventUSD eachWhat is charged
review$0.004One 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

Public contract checked 2026-11-11. Active build: 1.0.9. Refresh live details before a large or recurring run.