Hostelworld Scraper

Overview

This actor scrapes detailed hostel data from Hostelworld.com. It extracts property information, pricing, ratings, facilities, and availability from search result pages. The data is useful for monitoring prices, analyzing market trends, comparing hostels, or building travel platforms.

Key Features

• Comprehensive Data Extraction: Pulls detailed property info, current pricing, promotional offers, and precise location/address data.
• Ratings & Reviews: Captures overall star ratings, guest scores, and detailed breakdowns (security, location, staff, fun, cleanliness, facilities, value).
• Room & Facility Details: Lists all available room types (dorms and private) and provides a categorized list of facilities.
• Operational Efficiency: Supports scraping multiple search URLs in one run and includes proxy rotation and anti-blocking measures.
• Structured Output: Returns consistent, well-structured JSON data for easy integration.

How to Use

Configure the actor using input parameters, then run it. The scraped data will be available in the Apify dataset storage under the Storage tab, downloadable in multiple formats (JSON, JSONL, Excel, CSV, HTML, XML).

Input/Output

Input Parameters

Configure the actor run via these parameters:
* searchUrls (required): An array of one or more Hostelworld search URLs to scrape.
* maxItems (optional): Limit the total number of hostels to scrape.
* proxyConfiguration (optional): Settings for using proxy servers.

Input Example:

{
  "searchUrls": [
    "https://www.hostelworld.com/pwa/wds/s?q=Tokyo,%20Japan&country=Tokyo&city=Tokyo&type=city&id=452&from=2025-03-04&to=2025-03-07&guests=2&page=1"
  ],
  "maxItems": 50
}

Output Data

The actor outputs an array of objects, one per hostel. Each object contains fields like:

• id, name, starRating
• overallRating: Contains overall score and numberOfRatings.
• ratingBreakdown: Scores for security, location, staff, fun, cleanliness, facilities, and value.
• location: latitude, longitude, address1, address2, district.
• propertyInfo: type (e.g., "HOSTEL"), isNew, isPromoted, overview description.
• pricing: Current prices for different room types.
• facilities: Categorized list (e.g., "Services", "Food & Drink", "Entertainment").
• cancellationPolicy: Text description of the policy.

Output Sample (Excerpt):

[
  {
    "searchUrl": "https://www.hostelworld.com/...",
    "id": 265421,
    "name": "UNPLAN Kagurazaka",
    "starRating": 0,
    "overallRating": {
      "overall": 93,
      "numberOfRatings": "1294"
    },
    "ratingBreakdown": {
      "security": 96,
      "location": 92,
      "staff": 95,
      "fun": 84,
      "clean": 96,
      "facilities": 95,
      "value": 91,
      "average": 93
    },
    "location": {
      "latitude": 35.7050654,
      "longitude": 139.7313228,
      "address1": "23-1 Tenjin-cho",
      "district": "Shinjuku City"
    },
    "propertyInfo": {
      "type": "HOSTEL",
      "isNew": false,
      "isPromoted": true,
      "overview": "About UNPLAN Kagurazaka: Located in the heart of Kagurazaka..."
    }
    // ... additional fields for pricing, facilities, etc.
  }
]