# Hostelworld Hostel & Budget Accommodation Scraper (`parseforge/hostelworld-scraper`) Actor

Scrape hostel and budget accommodation listings from Hostelworld by city and country. Exports name, type, rating, reviews, price, location, and more.

- **URL**: https://apify.com/parseforge/hostelworld-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Travel, Developer tools, Automation
- **Stats:** 2 total users, 1 monthly users, 97.6% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $19.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true)

## 🏨 Hostelworld Scraper

> 🚀 **Export hostel and budget accommodation listings from Hostelworld in seconds.** Get names, ratings, reviews, prices, addresses, and images - no account needed.

The Hostelworld Scraper extracts hostel and budget accommodation listings from Hostelworld.com - the world's largest hostel booking platform with over 36,000 properties across 180+ countries. Data is scraped in real-time from live property pages so you always get current ratings, reviews, and prices.

Each record includes the property image, name, type, rating, review count, minimum nightly price, currency, city, country, full address, and direct listing URL.

**Coverage:** 180+ countries, 36,000+ hostels, guesthouses, and budget hotels. For any city supported by Hostelworld - Bangkok, Paris, Amsterdam, Tokyo, New York, Sydney, and thousands more.

| Who uses this | What they build |
|---|---|
| Travel platforms | Hostel comparison tools and budget travel apps |
| Data analysts | Price tracking and destination popularity studies |
| Researchers | Accommodation market analysis and tourism research |
| Marketers | Competitive intelligence for hospitality businesses |

### 📋 What the Hostelworld Scraper does

- Searches any city and country available on Hostelworld
- Scrapes all listed hostels, hotels, guesthouses, and budget accommodations
- Exports names, types, ratings, review counts, minimum prices, and addresses
- Paginates through all results automatically (30 per page, up to hundreds per city)
- Returns clean image URLs, direct listing links, and structured location data

> 💡 **Why it matters:** Hostelworld is the definitive source for budget travel accommodations worldwide. There is no public API - this scraper gives you programmatic access to a dataset that would take weeks to collect manually.

### 📊 Data fields

Each record includes: `address`, `city`, `country`, `currency`, `imageUrl`, `name`, `pricePerNight`, `rating`, `results`, `reviewCount`, `scrapedAt`, `type`, `url`. These field names come straight from the actor's dataset schema, so what you see here is what lands in your dataset.

### 🚀 How to use

1. [Create a free Apify account](https://console.apify.com/sign-up?fpr=vmoqkp)
2. Find the Hostelworld Scraper in the Apify Store
3. Set your city (e.g. "Amsterdam") and country (e.g. "Netherlands")
4. Set maxItems to control how many results you want
5. Click "Run" and download your dataset as JSON, CSV, Excel, or XML

### 🔗 Recommended Actors

| Actor | Description |
|---|---|
| [Booking.com Scraper](https://apify.com/parseforge) | Scrape hotel listings from Booking.com |
| [TripAdvisor Hotel Scraper](https://apify.com/parseforge) | Extract hotel reviews and ratings from TripAdvisor |
| [Airbnb Scraper](https://apify.com/parseforge) | Scrape short-term rental listings from Airbnb |

> 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more travel, hospitality, and data scrapers built by the same team.

**Disclaimer:** This Actor is not affiliated with, endorsed by, or sponsored by Hostelworld Group Limited. All trademarks belong to their respective owners. Use responsibly and in accordance with Hostelworld's Terms of Service.

### 🆘 Need Help?

If you hit a bug, have questions about setup, or need a scraper we haven't built yet, open our [contact form](https://tally.so/r/BzdKgA) or write to parseforge@protonmail.com. We also take on paid custom data projects.

For faster answers, join our [Discord](https://parseforge.co/discord). It's the best place to get support and suggest new actors.

# Actor input Schema

## `maxItems` (type: `integer`):

How many hostels to collect per run.

## `city` (type: `string`):

City to search for hostels and budget accommodations (e.g. Bangkok, Paris, Amsterdam, Tokyo).

## `country` (type: `string`):

Country where the city is located (e.g. Thailand, France, Netherlands, Japan).

## `checkIn` (type: `string`):

Optional check-in date in YYYY-MM-DD format. Leave blank for availability-independent results.

## `checkOut` (type: `string`):

Optional check-out date in YYYY-MM-DD format.

## Actor input object example

```json
{
  "maxItems": 10,
  "city": "Bangkok",
  "country": "Thailand"
}
```

# Actor output Schema

## `results` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "maxItems": 10,
    "city": "Bangkok",
    "country": "Thailand"
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/hostelworld-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "maxItems": 10,
    "city": "Bangkok",
    "country": "Thailand",
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/hostelworld-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 '{
  "maxItems": 10,
  "city": "Bangkok",
  "country": "Thailand"
}' |
apify call parseforge/hostelworld-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=parseforge/hostelworld-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/bWhttnO9mdzWl7xJp/builds/3ZHuhf0r3HHiKYDBD/openapi.json