# HousingAnywhere Scraper — Mid-Term Rentals in Europe (`hipersoft/housinganywhere-scraper`) Actor

Scrape HousingAnywhere rental listings for any city: rooms, studios and apartments with rent, utilities, size, furnished flag, availability, minimum stay, address, coordinates, landlord type and rating, photos. Ideal for student and expat rentals. Export CSV/JSON.

- **URL**: https://apify.com/hipersoft/housinganywhere-scraper.md
- **Developed by:** [hiper soft](https://apify.com/hipersoft) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.0015 / rental listing

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## HousingAnywhere Scraper: Mid-Term Rentals for Students and Expats in Europe

**HousingAnywhere Scraper** extracts rental listings from **HousingAnywhere**, Europe's largest platform for **mid-term rentals** used by students, interns and expats. Scrape **rooms, studios and apartments** in **Berlin, Amsterdam, Rotterdam, Madrid, Barcelona, Milan, Rome, Paris, Lisbon, Vienna, Brussels** and hundreds of other cities. Every listing includes the **monthly rent (and rent in EUR), monthly price variations, utilities included flag, deposit policy, size in m², bedrooms, furnished flag, city registration possible, student-housing and co-living flags, availability date, minimum and maximum stay, cancellation policy, street, city, country, coordinates, landlord type, landlord rating and review count, successful move-ins, top-landlord flag, favourites count, photo/floor plan/video counts, cover photo and photo gallery**. Export to **CSV, Excel or JSON**.

### What does HousingAnywhere Scraper do?

- 🌍 **Any city** on HousingAnywhere: use "City, Country".
- 🏠 **Property types**: studios, apartments, private rooms and shared rooms.
- 💶 **Rent** in local currency and EUR, with monthly price variations and utilities flag.
- 📐 **Size (m²), bedrooms and furnished** flag.
- 🗓️ **Availability date**, minimum and maximum stay, cancellation policy.
- 📍 **Street, city, country and coordinates**.
- ⭐ **Landlord type, rating, reviews and successful move-ins**; top-landlord flag.
- 🎓 **Student housing, co-living and city registration** flags.
- 🖼️ **Photos**, floor plans, videos and 3D tours.
- 🧹 **Filters**: property type, maximum rent, furnished only.
- 🔗 **Paste search links** with your own filters (dates, price, type).

### What data can you scrape from HousingAnywhere?

| Field | Description |
|---|---|
| Listing | ID, link, property type, new flag |
| Location | Street, city, country, latitude, longitude |
| Price | Rent, rent in EUR, currency, price type, monthly prices, utilities included, deposit policy |
| Space | Size m², bedrooms, furnished |
| Stay | Available from, minimum stay, maximum stay, cancellation policy |
| Flags | Registration possible, student housing, co-living |
| Landlord | Type, rating, review count, successful move-ins, top landlord |
| Popularity | Favourites |
| Media | Cover photo, photos, photo/floor plan/video counts, 3D tour |

### Use cases for rental data

- **Students and expats**: compare rooms and studios across cities and neighbourhoods.
- **Relocation agencies and universities**: monitor supply and prices for incoming students and staff.
- **Rental market research**: track mid-term rental prices across Europe.
- **Property managers**: benchmark rents and amenities.
- **Proptech**: feed geocoded rental listings into apps and models.

### How to scrape HousingAnywhere

1. Click **Try for free** to open HousingAnywhere Scraper in Apify Console.
2. Enter **cities** as "City, Country" or paste **search links**.
3. Optionally pick **property types**, a **maximum rent** and **furnished only**.
4. Set **Max listings** and click **Start**.
5. Download the listings as **CSV, Excel or JSON**.

### Input

#### Example input

```json
{
  "cities": ["Amsterdam, Netherlands", "Rotterdam, Netherlands"],
  "propertyTypes": ["STUDIO", "APARTMENT"],
  "maxRent": 1500,
  "furnishedOnly": false,
  "maxItems": 500
}
```

| Field | Description |
|---|---|
| **Cities** | "City, Country", one search each. |
| **HousingAnywhere search links** | Search links with your own filters. |
| **Property types** | Studio, apartment, private room, shared room. |
| **Maximum rent** | Monthly rent limit in EUR. |
| **Only furnished** | Furnished listings only. |
| **Max listings** | Stop after this many (0 = no limit). |

### Output

#### Listing example

```json
{
  "listingId": 2426799,
  "url": "https://housinganywhere.com/room/ut1731063/nl/Amsterdam/rooseveltlaan",
  "propertyType": "studio",
  "street": "Rooseveltlaan",
  "city": "Amsterdam",
  "country": "Netherlands",
  "latitude": 52.343744,
  "longitude": 4.8985287,
  "rent": 1250,
  "rentEUR": 1250,
  "currency": "EUR",
  "priceType": "flat",
  "utilitiesIncluded": true,
  "depositPolicy": "classical deposit",
  "sizeM2": 27,
  "bedrooms": 0,
  "furnished": false,
  "registrationPossible": false,
  "minimumStay": 1,
  "availableFrom": "2027-04-04",
  "cancellationPolicy": "strict",
  "landlordType": "private-landlord",
  "landlordReviews": 0,
  "topLandlord": false,
  "favorites": 29,
  "photoCount": 12,
  "imageUrl": "https://housinganywhere.imgix.net/unit_type/1731063/e6042e50-9127-4c24-95c3-10e297ea4afa.jpg?auto=format%2Ccompress&cs=srgb&fit=clip&h=881&w=1920",
  "search": "Amsterdam--Netherlands"
}
```

#### Output schema

| Field | Type | Description |
|---|---|---|
| `listingId`, `url`, `propertyType`, `isNew` | mixed | Listing. |
| `street`, `city`, `country`, `latitude`, `longitude` | mixed | Location. |
| `rent`, `rentEUR`, `currency`, `priceType`, `monthlyPricesEUR`, `utilitiesIncluded`, `depositPolicy` | mixed | Price. |
| `sizeM2`, `bedrooms`, `furnished` | mixed | Space. |
| `availableFrom`, `minimumStay`, `maximumStay`, `cancellationPolicy` | mixed | Stay. |
| `registrationPossible`, `studentHousing`, `coLiving` | boolean | Flags. |
| `landlordType`, `landlordRating`, `landlordReviews`, `successfulMoveIns`, `topLandlord` | mixed | Landlord. |
| `favorites`, `photoCount`, `floorPlanCount`, `videoCount`, `has3DTour` | mixed | Popularity and media. |
| `imageUrl`, `photos` | mixed | Photos. |
| `search`, `scrapedAt` | string | Source info. |

### How much does it cost?

HousingAnywhere Scraper uses **pay-per-listing** pricing: a small fixed price per listing, with automatic discounts on higher Apify plans. See the **Pricing** tab for the exact price.

### More rental data

- [SpareRoom Scraper](https://apify.com/hipersoft/spareroom-scraper): UK and US flatshares.
- [OnTheMarket Scraper](https://apify.com/hipersoft/onthemarket-scraper): UK property for sale and rent.
- [Bazos Scraper](https://apify.com/hipersoft/bazos-scraper): Central European classifieds including rentals.

### FAQ

**How do I enter a city?**
As "City, Country", e.g. "Berlin, Germany" or "Madrid, Spain".

**Are prices monthly?**
Yes. `rent` is the monthly rent; `monthlyPricesEUR` shows month-by-month prices when they vary.

**Can I filter by move-in date?**
Set dates on HousingAnywhere, copy the search link and paste it into **HousingAnywhere search links**.

**What formats can I export?**
CSV, Excel, JSON, XML, HTML and RSS, or read the results through the Apify API.

**Can I integrate this scraper with other apps?**
HousingAnywhere Scraper can be connected with almost any cloud service or web app thanks to [integrations on the Apify platform](https://apify.com/integrations). It works with [Make](https://apify.com/integrations/make), [Zapier](https://apify.com/integrations/zapier), [Slack](https://docs.apify.com/platform/integrations/slack), [Airbyte](https://docs.apify.com/platform/integrations/airbyte), [GitHub](https://docs.apify.com/platform/integrations/github), [Google Drive](https://docs.apify.com/platform/integrations/drive) and [many more](https://apify.com/integrations), plus the [Apify API](https://docs.apify.com/api/v2), JS/Python clients and MCP. Or use [webhooks](https://docs.apify.com/platform/integrations/webhooks) to trigger an action whenever a run finishes.

**Is it legal to scrape HousingAnywhere?**
The scraper only collects publicly listed rental offers. You are responsible for using the data in line with HousingAnywhere's terms and GDPR.

### Related Actors

- [SpareRoom Scraper](https://apify.com/hipersoft/spareroom-scraper)
- [OnTheMarket Scraper](https://apify.com/hipersoft/onthemarket-scraper)

### Notes

Original clean-room implementation. Returns only public data. Not affiliated with HousingAnywhere.

# Actor input Schema

## `cities` (type: `array`):

Cities as "City, Country", e.g. Berlin, Germany; Amsterdam, Netherlands; Madrid, Spain; Milan, Italy; Paris, France.

## `startUrls` (type: `array`):

Optional. Paste HousingAnywhere search links with your own filters (dates, price, type).

## `propertyTypes` (type: `array`):

Only these property types.

## `maxRent` (type: `integer`):

Only listings at or below this monthly rent in EUR.

## `furnishedOnly` (type: `boolean`):

Only furnished listings.

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

Stop after this many listings. 0 means no limit.

## `proxyConfiguration` (type: `object`):

Not required for normal use.

## Actor input object example

```json
{
  "cities": [
    "Berlin, Germany"
  ],
  "furnishedOnly": false,
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

The results as dataset items.

# 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 = {
    "cities": [
        "Berlin, Germany"
    ],
    "maxItems": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("hipersoft/housinganywhere-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 = {
    "cities": ["Berlin, Germany"],
    "maxItems": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("hipersoft/housinganywhere-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "cities": [
    "Berlin, Germany"
  ],
  "maxItems": 50
}' |
apify call hipersoft/housinganywhere-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hipersoft/housinganywhere-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/G85lnhtFPlyoOEpG6/builds/RxqpR0ukrGEtSNn3S/openapi.json
