# Spotahome Scraper - European Mid-Term Furnished Rentals (`studio-amba/spotahome-scraper`) Actor

Scrape mid-term furnished rental listings from Spotahome across ~100 European cities. Extract prices, currency, address, geo-coordinates, bedrooms, bathrooms, floor size, availability dates, amenities, and images for rooms, studios, apartments, and student residences.

- **URL**: https://apify.com/studio-amba/spotahome-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 result scrapeds

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?

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

## Spotahome Scraper

Extract mid-term furnished rental listings from [Spotahome](https://www.spotahome.com) -- a European platform for booking rooms, studios, apartments, and student residences for 1-11+ month stays -- into structured JSON with prices, currency, address, geo-coordinates, bedrooms, bathrooms, floor size, availability dates, amenities, and photos.

### What is Spotahome Scraper?

**Spotahome Scraper** lets you extract structured mid-term rental data from Spotahome's ~150,000 properties across roughly 100 European cities, without manual browsing, login, or booking.

- **Track furnished-rental prices across Europe:** extract listings with monthly prices in the market's own currency (EUR, GBP, and others) to build price comparisons across Madrid, Barcelona, Berlin, Paris, London, Lisbon, and dozens more cities
- **Monitor new listings in real time:** schedule daily runs and get alerted the moment a room or apartment matching your criteria goes live
- **Build datasets for relocation and corporate-housing research:** export thousands of listings with bedrooms, bathrooms, floor size, and amenities for market analysis, relocation tooling, or digital-nomad/corporate-housing sourcing
- **Compare rooms vs. studios vs. apartments:** filter by property type to analyse how the shared-flat market differs from whole-unit rentals in the same city
- **Feed your CRM or dashboard:** export structured data to Google Sheets, Airtable, or any BI tool via Apify integrations

Spotahome has **no public API and no bulk export feature** for its listing data. This scraper is the only way to get structured data out of this platform at scale -- the same kind of dataset a third-party vendor already resells as a paid service.

### What data does Spotahome Scraper extract?

Each listing returns the following fields:

- **Title** -- the listing headline
- **Property Type** -- Room, Apartment, Studio, or Residence
- **Price / Currency** -- monthly rent in the market's own currency (never assumed -- London quotes GBP, most other cities quote EUR)
- **Address / City / Postal Code / Country** -- with `fetchDetails` on
- **Latitude / Longitude** -- geo-coordinates, with `fetchDetails` on
- **Bedrooms / Bathrooms** -- total in the flat or house (not just the rented room, for shared-room listings), with `fetchDetails` on
- **Surface** -- floor size in m², with `fetchDetails` on
- **Occupancy Max** -- maximum occupants, with `fetchDetails` on
- **Available From** -- ISO 8601 move-in date (authoritative with `fetchDetails` on; a best-effort estimate from the search-card text otherwise)
- **Price Valid Until** -- ISO 8601 date the quoted price is valid until, with `fetchDetails` on
- **Min Stay Note** -- free-text minimum-stay note, e.g. "8+ month stay"
- **Rating / Review Count / Rating Scale** -- aggregate tenant rating
- **Instant Booking** -- whether the listing supports instant booking
- **Bills Included** -- nullable true/false, never coerced to false when unknown
- **Pets Allowed / Smoking Allowed** -- with `fetchDetails` on
- **Amenities** -- e.g. Furnished, Elevator, A/C, Equipped kitchen, Washing machine, with `fetchDetails` on
- **Description** -- full listing text, with `fetchDetails` on
- **Images** -- main photo by default, full gallery (60+ photos typical) with `fetchDetails` on
- **Date Posted** -- with `fetchDetails` on
- **URL** -- direct link to the listing on Spotahome
- **Scraped At** -- ISO 8601 timestamp

### How to scrape Spotahome data

The input is simple: choose a **city and property type** and hit run. You can configure the scraper through the Apify Console UI or programmatically via the API.

#### Input fields

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| **citySlug** | String | `"madrid"` | City slug from a Spotahome URL, e.g. `"madrid"`, `"barcelona"`, `"berlin"`, `"paris"`, `"london"`, `"lisbon"`, `"dublin"` |
| **propertyType** | String | `"any"` | `"any"`, `"rooms"`, `"apartments"`, `"studios"` |
| **startUrls** | Array | -- | Spotahome search-result or single-listing URLs (overrides city/type filters); max 100 |
| **maxResults** | Integer | `20` | Maximum number of listings to return (1--2,000) |
| **fetchDetails** | Boolean | `true` | ON by default -- fetches each listing's own detail page to add address, geo-coordinates, bedrooms, bathrooms, floor size, amenities, and the authoritative ISO availability date. Turn OFF only for a faster run with search-card data alone (price, title, property type, rating, raw availability text) -- most output fields are null without it |
| **proxyConfiguration** | Object | Automatic | No proxy group needed -- see "Do I need proxies?" below |

#### Tips for best results

- **Use `citySlug` for quick searches:** `"madrid"`, `"barcelona"`, `"valencia"`, `"rome"`, `"milan"`, `"lisbon"`, `"berlin"`, `"munich"`, `"brussels"`, `"dublin"`, `"london"`, `"paris"`, `"amsterdam"` and more are confirmed-working. Any valid Spotahome city slug works, even ones not listed here.
- **Use `startUrls` for advanced filtering:** apply price ranges, move-in dates, or other filters on Spotahome, copy the URL, and paste it as a start URL to preserve them. A single listing URL also works and returns full detail-page data for that one property.
- **Keep `fetchDetails` on** unless you only need price/title/rating for a quick scan -- address, geo, bedrooms, bathrooms, and surface all require the extra per-listing request.
- **Start with a small `maxResults`** (e.g. 20) to verify the output, then scale up.
- **Empty input works:** running with `{}` defaults to all property types in Madrid.

### Output

Results are stored in a **dataset** that you can download in JSON, CSV, Excel, XML, or HTML format directly from the Apify Console.

#### JSON example

```json
{
    "externalId": "272377",
    "title": "Room in a shared 7-bedroom apartment for rent in Goya, professionals and students only",
    "price": 695,
    "currency": "EUR",
    "url": "https://www.spotahome.com/madrid/for-rent:rooms/272377",
    "scrapedAt": "2026-08-29T14:55:34.524Z",
    "listingType": "rent",
    "propertyType": "Room",
    "address": "Calle Duque de Sesto, 28009 Madrid, Spain",
    "city": "Madrid",
    "postalCode": "28009",
    "country": "ES",
    "latitude": 40.42282904,
    "longitude": -3.67462951,
    "bedrooms": 7,
    "bathrooms": 2,
    "surface": 160,
    "surfaceUnit": "m²",
    "occupancyMax": 1,
    "availableFrom": "2026-08-31",
    "availableFromRaw": "From 31 Aug",
    "priceValidUntil": "2027-08-29",
    "minStayNote": "8+ month stay",
    "rating": 4,
    "reviewCount": 4743,
    "ratingScale": "1-5",
    "instantBooking": true,
    "billsIncluded": true,
    "petsAllowed": false,
    "smokingAllowed": false,
    "amenities": ["Furnished", "Elevator", "Equipped kitchen", "Washing machine", "Dishwasher"],
    "description": "Room in a shared 7-bedroom flat, fully furnished, with elevator and WiFi. Located in Goya near Dolmen de Dalí. Professionals and students only. (ref: 272377)",
    "imageUrl": "https://photos.spotahome.com/fsobscale_1600_900_nonverified_ur_15_50/f7cfbfb5a9e626ab080a053e3034e40b8f077fab9bd671c837788187.webp",
    "imageUrls": ["https://photos.spotahome.com/..."],
    "datePosted": null
}
```

### How much does it cost to scrape Spotahome?

Spotahome has no real bot protection to pay for -- the actor reads server-rendered HTML directly, no proxy or unblocking service required. That keeps runs fast and cheap.

| Scenario | Est. cost | Time |
|----------|-----------|------|
| 20 listings, `fetchDetails` on | ~$0.11 | ~15 sec |
| 200 listings, `fetchDetails` on | ~$1.01 | ~2 min |
| 500 listings, `fetchDetails` off | ~$2.51 | ~30 sec |
| 2,000 listings, `fetchDetails` on | ~$10.01 | ~15 min |

**Pricing breakdown:**

- Per result: $0.005
- Per run: $0.01

Usage cost only settles once a run reports **SUCCEEDED** -- reading a dataset mid-run will show a cost far below the final total.

### Can I integrate Spotahome Scraper with other apps?

Yes. Spotahome Scraper connects with any tool through [Apify integrations](https://apify.com/integrations):

- **Google Sheets** -- automatically export listing data to a spreadsheet
- **Slack / Email** -- get notified when new listings match your criteria
- **Zapier / Make** -- trigger workflows when data is ready
- **Airtable** -- build a searchable rental database
- **REST API** -- call the scraper programmatically from any language
- **Webhooks** -- get notified when a run finishes

### Can I use Spotahome Scraper as an API?

Yes. Use the [Apify API](https://docs.apify.com/api/v2) to run Spotahome Scraper programmatically.

**Python:**

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("studio-amba/spotahome-scraper").call(run_input={
    "citySlug": "madrid",
    "propertyType": "rooms",
    "maxResults": 200,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['title']} -- {item['currency']} {item['price']} -- {item['city']}")
```

**JavaScript:**

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });
const run = await client.actor('studio-amba/spotahome-scraper').call({
    citySlug: 'madrid',
    propertyType: 'rooms',
    maxResults: 200,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

Check the [API tab](https://apify.com/studio-amba/spotahome-scraper/api) for full documentation.

### FAQ

#### What is Spotahome?

Spotahome is a Spanish-founded, online mid-term rental platform (1 to 11+ months) covering furnished rooms, studios, apartments, and student residences across roughly 100 European cities, verified through professional photos, videos, and floor plans with 100% online booking. It's aimed at students, digital nomads, remote workers, and corporate relocations rather than the long-term-lease resale market.

#### How does Spotahome Scraper work?

It requests Spotahome's own server-rendered search and listing pages -- no login, no JavaScript execution required. Search pages give price, title, property type, and rating directly; the detail-page fetch (on by default) reads the page's own `schema.org` structured-data block for address, geo-coordinates, bedrooms, bathrooms, floor size, amenities, and the authoritative move-in date.

#### Can I filter by property type?

Yes. Set `propertyType` to `"rooms"`, `"apartments"`, or `"studios"`, or leave it `"any"` for a mixed search that also includes student residences.

#### Do I need proxies?

No. Spotahome has no anti-bot layer on the routes this actor uses -- confirmed with plain requests under concurrent load, no Cloudflare/Akamai/DataDome challenge. The default `proxyConfiguration` uses Apify's free automatic proxy pool. If you see blocks from your own account's specific IP reputation, escalate to `RESIDENTIAL` in the proxy settings.

#### Why does currency vary between listings?

Spotahome quotes prices in the local market's currency -- EUR in most of its European cities, GBP in London. The scraper reports the currency exactly as published per listing, never assuming or converting.

#### Is it legal to scrape Spotahome?

This scraper extracts publicly available listing data that Spotahome displays to all visitors. The data is factual (prices, addresses, property specifications) and does not contain private personal or tenant information. As with any scraping tool, use the data responsibly and in compliance with applicable laws. No login or cookies are required.

### Limitations

- **Detail-page fields require `fetchDetails: true` (the default).** With it off, output is limited to search-card data: price, title, property type, rating, and a raw (yearless) availability text.
- **Bedrooms/bathrooms describe the whole unit, not just the rented room** for shared-flat "Room" listings -- Spotahome doesn't expose a separate per-room count.
- **`datePosted` is frequently null.** Not every listing on the source site carries this field.
- **`surface` (floor size) is missing on some listings.** Spotahome's own structured data doesn't publish a floor size for every property (confirmed on the source page itself, not an extraction gap) -- most common on smaller room listings.
- **Availability text fallback assumes the next future occurrence** of the given month/day when `fetchDetails` is off and the authoritative ISO date isn't available -- turn `fetchDetails` on for the real date.

### Other European real estate and rental scrapers

Combine Spotahome Scraper with these actors for broader European housing market coverage:

- [Spareroom Scraper](https://apify.com/studio-amba/spareroom-scraper) -- UK room-rental listings
- [Flatfox Scraper](https://apify.com/studio-amba/flatfox-scraper) -- Swiss rental and property listings
- [Imoti.net Scraper](https://apify.com/studio-amba/imoti-net-scraper) -- Bulgarian real estate listings

### Your feedback

Found a bug or have a feature request? Please open an issue on the [Issues tab](https://apify.com/studio-amba/spotahome-scraper/issues). We actively maintain this scraper and respond to all reports.

# Actor input Schema

## `citySlug` (type: `string`):

Spotahome city slug from a spotahome.com URL, e.g. 'madrid', 'barcelona', 'berlin', 'paris', 'lisbon', 'dublin', 'london'. Defaults to 'madrid' if empty. Any valid Spotahome city slug works, not just the documented ones.

## `propertyType` (type: `string`):

Type of accommodation to search for. Leave as 'any' for all types (rooms, apartments, studios, and residences mixed).

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

Spotahome search-result or single-listing URLs. Overrides citySlug/propertyType if provided. Max 100 URLs per run.

## `maxResults` (type: `integer`):

Maximum number of property listings to scrape. Hard-capped at 2000 to keep runs bounded (search pages return up to 48 cards/page, verified live).

## `fetchDetails` (type: `boolean`):

ON by default. The actor visits each listing's own detail page (one extra request per result) to add address, geo-coordinates, bedrooms, bathrooms, floor size, amenities, and the authoritative ISO availability date — fields NOT available on the search-results cards. Turn OFF only for a faster run with just search-card data: price, title, property type, rating, and a raw availability text (no year). Most fields in the output are null without this on.

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

Spotahome has no anti-bot on the routes this actor uses — confirmed live with plain requests and no challenge under concurrent load. No proxy group is required; automatic/free proxy is the default. Only escalate to RESIDENTIAL if you see repeated blocks from your own account's IP reputation.

## Actor input object example

```json
{
  "citySlug": "madrid",
  "propertyType": "any",
  "maxResults": 20,
  "fetchDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# 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 = {
    "citySlug": "madrid",
    "propertyType": "any",
    "maxResults": 20,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/spotahome-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 = {
    "citySlug": "madrid",
    "propertyType": "any",
    "maxResults": 20,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/spotahome-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 '{
  "citySlug": "madrid",
  "propertyType": "any",
  "maxResults": 20,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call studio-amba/spotahome-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/spotahome-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/l9aecSmwbNFTmvg5T/builds/5v7iw6CLRVRg7aP6I/openapi.json