# Hostelworld Reviews Scraper (`shahidirfan/hostelworld-reviews-scraper`) Actor Harvest Hostelworld reviews at scale. Extract guest ratings, feedback, hostel details & location data instantly. Perfect for travel market research, reputation management, sentiment analysis & competitor benchmarking. Production-ready JSON datasets. - **URL**: https://apify.com/shahidirfan/hostelworld-reviews-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Categories:** Travel, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Hostelworld Reviews Scraper Extract comprehensive, structured reviews from any Hostelworld property — in seconds. Get detailed guest feedback, full rating breakdowns, reviewer demographics, and property pricing data at scale. No setup or technical knowledge required. ### Features - **Direct URL scraping** — Paste any Hostelworld property URL and get reviews instantly - **Rich rating breakdown** — Safety, location, staff, atmosphere, cleanliness, facilities, and value-for-money scores - **Full reviewer profiles** — Nationality, age group, traveler type, trip purpose, and review history - **Property pricing included** — Starting price per night in USD alongside every review - **Duplicate-free output** — Each review is returned only once, even across large paginated runs - **All languages supported** — Collects reviews in every language with machine-translation flag - **Owner responses included** — See how management replied to each review - **Fast and lightweight** — Collects 20 reviews in under 5 seconds ### Use Cases #### Hospitality Market Research Analyze guest sentiment across top hostels in any city. Compare safety, staff, and cleanliness scores, identify what travelers value most, and benchmark your property against competitors. #### Travel & Tourism Intelligence Build datasets of traveler reviews for booking trend analysis, seasonal preference mapping, and demographic targeting. Ideal for travel apps, guides, and tourism boards. #### Review Aggregation & Monitoring Continuously monitor reviews for specific properties. Track rating changes over time, spot service issues early, and measure the impact of improvements on guest satisfaction scores. #### Pricing & Competitor Intelligence Collect nightly price data alongside reviews to correlate guest satisfaction scores with pricing. Understand how value-for-money ratings shift across price tiers. #### Academic & Business Research Compile large-scale hostel review datasets for NLP research, sentiment analysis, and hospitality management studies. Structured JSON output integrates directly into data pipelines and ML models. --- ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `startUrl` | String | No | — | Full Hostelworld property URL (e.g. `https://www.hostelworld.com/hostels/p/1279/itaca-hostel/`) | | `results_wanted` | Integer | No | `20` | Maximum number of reviews to collect | | `max_pages` | Integer | No | `10` | Safety cap on review pages per property | | `sortBy` | String | No | `-date` | Sort order: `-date` (newest), `date` (oldest), `-rating` (highest), `rating` (lowest) | | `proxyConfiguration` | Object | No | — | Proxy settings for reliable access | > **Tip:** If no URL is provided, the actor uses a built-in example property (Itaca Hostel, Barcelona) — perfect for testing without any configuration. --- ### Output Data Each item in the dataset contains **31 fields**: #### Review Fields | Field | Type | Description | |-------|------|-------------| | `review_id` | String | Unique review identifier | | `review_date` | String | Date review was submitted (YYYY-MM-DD) | | `review_text` | String | Reviewer's written comment | | `language_code` | String | Original review language (e.g. `en`, `de`, `fr`) | | `is_machine_translated` | Boolean | Whether the review was machine-translated | | `owner_comment` | String | Property owner's response (if any) | #### Rating Fields | Field | Type | Description | |-------|------|-------------| | `rating_overall` | Number | Overall score (0–100) | | `rating_safety` | Number | Safety score (0–100) | | `rating_location` | Number | Location score (0–100) | | `rating_staff` | Number | Staff score (0–100) | | `rating_atmosphere` | Number | Atmosphere score (0–100) | | `rating_cleanliness` | Number | Cleanliness score (0–100) | | `rating_facilities` | Number | Facilities score (0–100) | #### Reviewer Fields | Field | Type | Description | |-------|------|-------------| | `reviewer_id` | Number | Reviewer's unique user ID | | `reviewer_nickname` | String | Reviewer's display name | | `reviewer_nationality` | String | Reviewer's country of origin | | `reviewer_nationality_code` | String | ISO country code (e.g. `US`, `DE`) | | `reviewer_total_reviews` | Number | Total reviews this user has written | | `reviewer_gender` | String | Reviewer gender (when provided) | #### Trip Context Fields | Field | Type | Description | |-------|------|-------------| | `traveler_type` | String | Group type (MALE, FEMALE, MIXED) | | `traveler_age_group` | String | Age bracket (e.g. `18-24`, `31-40`) | | `trip_type` | String | Trip purpose (REGULARVACATION, WEEKENDAWAY, etc.) | #### Property Fields | Field | Type | Description | |-------|------|-------------| | `property_id` | String | Hostelworld property ID | | `property_name` | String | Hostel name | | `property_url` | String | Property page URL | | `property_city` | String | City | | `property_country` | String | Country | | `property_overall_rating` | Number | Property's aggregate rating (0–100) | | `property_value_for_money` | Number | Value-for-money rating (0–100) | | `property_security_rating` | Number | Security rating (0–100) | | `property_total_reviews` | String | Total review count for the property | | `property_price_from_usd` | String | Lowest nightly price in USD | --- ### Usage Examples #### Scrape the 50 Most Recent Reviews ```json { "startUrl": "https://www.hostelworld.com/hostels/p/1279/itaca-hostel/", "results_wanted": 50, "sortBy": "-date" } ```` #### Collect the Highest-Rated Reviews ```json { "startUrl": "https://www.hostelworld.com/hostels/p/1279/itaca-hostel/", "results_wanted": 30, "sortBy": "-rating", "max_pages": 5 } ``` #### Large-Scale Collection with Proxy ```json { "startUrl": "https://www.hostelworld.com/hostels/p/6764/generator-hostel-berlin/", "results_wanted": 200, "max_pages": 25, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["DATACENTER"] } } ``` *** ### Sample Output ```json { "review_id": "16428596", "review_date": "2026-04-04", "review_text": "L'hostel était vraiment excellent, superbe accueil, superbe personnel, emplacement au top.", "language_code": "fr", "is_machine_translated": true, "owner_comment": "Salut, merci beaucoup pour ton avis ! Si tu décides de revenir à Barcelone, n'hésite pas !", "rating_overall": 100, "rating_safety": 100, "rating_location": 100, "rating_staff": 100, "rating_atmosphere": 100, "rating_cleanliness": 100, "rating_facilities": 100, "reviewer_id": 41926893, "reviewer_nickname": "aXgrxkQ2S4eK18Kh", "reviewer_nationality": "French Polynesia", "reviewer_nationality_code": "PF", "reviewer_total_reviews": 1, "reviewer_gender": "Female", "traveler_type": "MALE", "traveler_age_group": "18-24", "trip_type": "WEEKENDAWAY", "property_id": "1279", "property_name": "Itaca Hostel", "property_url": "https://www.hostelworld.com/hostels/p/1279/itaca-hostel/", "property_city": "Barcelona", "property_country": "Spain", "property_overall_rating": 95, "property_value_for_money": 94, "property_security_rating": 96, "property_total_reviews": "4703", "property_price_from_usd": "29.15" } ``` *** ### Supported URL Formats The actor works with any Hostelworld property URL format: | Format | Example | |--------|---------| | Standard | `https://www.hostelworld.com/hostels/p/1279/itaca-hostel/` | | Legacy slug | `https://www.hostelworld.com/hostels/City/Name--1279/` | | PWA path | `https://www.hostelworld.com/pwa/hostelworld/properties/1279/` | *** ### Tips for Best Results #### Use Direct Property URLs Copy the URL directly from your browser's address bar when viewing a Hostelworld property page. This is the fastest and most reliable approach. #### Optimize Collection Size Start with `results_wanted: 20` for testing, then scale up for production. Review counts per property are shown in `property_total_reviews`. #### Proxy for High-Volume Runs For collecting hundreds of reviews, enable Apify Proxy: ```json { "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": ["DATACENTER"] } } ``` *** ### Integrations Connect your review data directly to: - **Google Sheets** — Share and analyze in spreadsheets - **Airtable** — Build searchable review databases - **Make (Integromat)** — Automate review monitoring workflows - **Zapier** — Trigger actions when new reviews are collected - **Webhooks** — Stream data to custom endpoints - **Slack** — Receive review alerts in real time #### Export Formats Download collected data as: - **JSON** — For developers and data pipelines - **CSV** — For spreadsheet and BI tools - **Excel** — For business reporting - **XML** — For system integrations *** ### Frequently Asked Questions #### How many reviews can I collect? You can collect all available reviews for any property. Set `results_wanted` to the property's total review count (visible in `property_total_reviews` in the output). #### What Hostelworld URL formats are supported? All standard Hostelworld property URLs are supported. See the Supported URL Formats table above. #### What does `is_machine_translated` mean? Hostelworld auto-translates reviews from other languages into English. This field indicates when a review has been translated, letting you filter to original-language reviews if needed. #### Why is `owner_comment` null on some reviews? Property owners can choose to respond to reviews — many don't. A `null` value accurately reflects that no response was posted. #### Why does `reviewer_gender` not appear on all reviews? Gender is an optional field that reviewers may not have set in their profile. The field is only included in the output when the API provides it. #### Can I collect all reviews for a property? Yes. Set `results_wanted` to a large number (e.g. 10000) and `max_pages` to a high value. The actor automatically stops when all reviews have been collected. *** ### Support For issues or feature requests, contact support through the Apify Console. #### Resources - [Apify Documentation](https://docs.apify.com/) - [API Reference](https://docs.apify.com/api/v2) - [Scheduling Runs](https://docs.apify.com/schedules) *** ### Legal Notice This actor is designed for legitimate data collection and analysis purposes. Users are responsible for ensuring compliance with Hostelworld's terms of service and applicable privacy laws. Collected data should be used responsibly and not for unauthorized commercial exploitation of Hostelworld's content. # Actor input Schema ## `startUrl` (type: `string`): URL of a specific Hostelworld property page. Example: https://www.hostelworld.com/hostels/p/1279/itaca-hostel/ ## `results_wanted` (type: `integer`): Maximum number of reviews to collect per run. ## `max_pages` (type: `integer`): Safety cap on the number of review pages to fetch per property. ## `sortBy` (type: `string`): Sort order for reviews. Use '-date' for newest first, 'date' for oldest first, '-rating' for highest rated first. ## `proxyConfiguration` (type: `object`): Use Apify Proxy for reliable scraping. Datacenter proxies are sufficient for this actor. ## Actor input object example ```json { "startUrl": "https://www.hostelworld.com/hostels/p/1279/itaca-hostel/", "results_wanted": 20, "max_pages": 10, "sortBy": "-date", "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrl": "https://www.hostelworld.com/hostels/p/1279/itaca-hostel/", "results_wanted": 20, "max_pages": 10, "sortBy": "-date" }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/hostelworld-reviews-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrl": "https://www.hostelworld.com/hostels/p/1279/itaca-hostel/", "results_wanted": 20, "max_pages": 10, "sortBy": "-date", } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/hostelworld-reviews-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrl": "https://www.hostelworld.com/hostels/p/1279/itaca-hostel/", "results_wanted": 20, "max_pages": 10, "sortBy": "-date" }' | apify call shahidirfan/hostelworld-reviews-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shahidirfan/hostelworld-reviews-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Hostelworld Reviews Scraper", "description": "Harvest Hostelworld reviews at scale. Extract guest ratings, feedback, hostel details & location data instantly. Perfect for travel market research, reputation management, sentiment analysis & competitor benchmarking. Production-ready JSON datasets.", "version": "0.0", "x-build-id": "P5JdiFjHWhFct1E8Z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~hostelworld-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-hostelworld-reviews-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/shahidirfan~hostelworld-reviews-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-hostelworld-reviews-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/shahidirfan~hostelworld-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-hostelworld-reviews-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "startUrl": { "title": "Property URL", "type": "string", "description": "URL of a specific Hostelworld property page. Example: https://www.hostelworld.com/hostels/p/1279/itaca-hostel/" }, "results_wanted": { "title": "Maximum reviews to collect", "minimum": 1, "type": "integer", "description": "Maximum number of reviews to collect per run.", "default": 20 }, "max_pages": { "title": "Maximum pages", "minimum": 1, "type": "integer", "description": "Safety cap on the number of review pages to fetch per property.", "default": 10 }, "sortBy": { "title": "Sort reviews by", "enum": [ "-date", "date", "-rating", "rating" ], "type": "string", "description": "Sort order for reviews. Use '-date' for newest first, 'date' for oldest first, '-rating' for highest rated first.", "default": "-date" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use Apify Proxy for reliable scraping. Datacenter proxies are sufficient for this actor.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```