# ImmoScout24 Scraper: Germany Property Listings & Rent Data (`automatic/immoscout24-de-scraper`) Actor

ImmoScout24 scraper for Germany: apartments, houses and plots for rent or sale in any city, district or postcode. Cold rent or price in EUR, m², rooms, address, map point, private or agency, photos; warm rent and deposit on request. Up to 10,000 listings per run.

- **URL**: https://apify.com/automatic/immoscout24-de-scraper.md
- **Developed by:** [Philip Kirkbride](https://apify.com/automatic) (community)
- **Categories:** Real estate, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 listings

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

## ImmoScout24 Scraper: Germany Property Listings & Rent Data

Get apartments and houses **for rent or for sale, and building plots, from
ImmoScout24**, Germany's largest property portal, in any German city,
district, state or postcode. Every listing arrives as a clean row: cold rent
or purchase price in EUR, living area, rooms, price per m², address,
postcode and district, map coordinates, private owner or agency, new-build
and project flags, energy class, how long it has been online, and photos.

- **Whole cities in one run:** up to 10,000 listings per run, newest first.
- **Scheduled monitoring:** run the same district every morning; the stable
  `listingKey` shows which listings are new since yesterday.
- **Map-ready:** latitude and longitude for every listing with a full address.
- **Private vs agency:** see who advertises, and spot new-build projects.
- **Your website searches, reused:** paste any ImmoScout24 search link with
  its filters (balcony, built-in kitchen, Altbau, price per month, and more).
- **Warm rent and deposit on request:** turn on listing details and every
  listing arrives with its full cost breakdown, description and photo
  gallery.

Leave the input empty for a quick sample: the 50 newest apartments for rent
in Berlin.

Built for property investors, landlords, agents, proptech and relocation
teams, and analysts tracking German rents and asking prices.

**Covering the whole German market?** Pair it with our Immowelt Germany and
Kleinanzeigen scrapers: many listings appear on only one of the three.

### Use cases

- **Rent tracking:** follow cold rents per m² for the same districts week by
  week (Mietspiegel-style comparisons in your own spreadsheet).
- **New-listing alerts:** schedule a district search with "newest first" and
  act on fresh listings the hour they go online.
- **Comparables:** pull every flat or house for sale in a postcode to price an
  offer or a valuation.
- **Lead lists for agents:** find private-owner listings (`publisherType:
  "private"`) in your area.
- **Market snapshots:** stock, asking prices and new-build share for a city,
  district or a whole state such as Bayern.

### Quick start

An empty input (`{}`) returns the 50 newest apartments for rent in Berlin.

Search by place, rent or buy, and property type, with filters:

```json
{
  "locations": ["Leipzig", "Dresden"],
  "operation": "rent",
  "propertyType": "apartment",
  "priceMax": 900,
  "roomsMin": 2,
  "maxResults": 500
}
```

Houses for sale in a district, most expensive first:

```json
{
  "locations": ["München Schwabing"],
  "operation": "buy",
  "propertyType": "house",
  "sortBy": "priceDesc",
  "maxResults": 200
}
```

Or paste search links straight from immobilienscout24.de; every filter in the
link is kept:

```json
{
  "startUrls": [
    "https://www.immobilienscout24.de/Suche/de/hamburg/hamburg/wohnung-mit-balkon-mieten?price=-1500.0&livingspace=60.0-"
  ],
  "maxResults": 1000
}
```

### Input

| Field | Default | What it does |
|---|---|---|
| `locations` | (Berlin sample) | Up to 10 German places, one search each: city, district or quarter, state, or five-digit postcode. |
| `operation` | `rent` | `rent` or `buy`. |
| `propertyType` | `apartment` | `apartment`, `house` or `plot` (plots for sale only). |
| `priceMin`, `priceMax` | none | Cold rent per month (rent; warm rent with `priceType` `warm`) or purchase price (buy), in EUR. |
| `priceType` | `cold` | `cold` (Kaltmiete) or `warm` (Gesamtmiete, cold rent plus service and heating costs) for the price range; warm rent works for apartments for rent. |
| `roomsMin`, `roomsMax` | none | Room count; half rooms allowed (2.5). |
| `areaMin`, `areaMax` | none | Living area (plot area for plots) in m². |
| `sortBy` | `newest` | `newest`, `relevance` (ImmoScout24 default order), `priceAsc`, `priceDesc`. |
| `includeNewHomeBuilderOffers` | `false` | Also deliver builders' catalogue houses ("Bauen mit ..."), which are not existing properties. |
| `includeDetails` | `false` | Add each delivered listing's own page: warm rent, service charges, heating costs, deposit, the full description, every attribute, the advertiser and the gallery. Slower (about one second per listing) and priced per detailed listing (see Pricing). |
| `startUrls` | none | Up to 10 immobilienscout24.de search links. When given, they replace the place, type and filter fields. |
| `maxResults` | `50` | Most listings saved per run, shared fairly across your searches (up to 10,000). |
| `maxPages` | `120` | Safety cap of result pages per search (100 listings per page). |

Several places in one run share `maxResults` fairly; when one place has fewer
listings, the others get the rest. A place ImmoScout24 does not know (for
example a typo) is skipped and named in the run summary, and the other places
still run. You only pay for listings delivered.

### What you get

One row per listing. A real row, collected on 2026-11-15:

```json
{
  "id": "172647217",
  "listingKey": "immobilienscout24.de:172647217",
  "url": "https://www.immobilienscout24.de/expose/172647217",
  "name": "Charmante 2-Raumwohnung im EG mit Balkon & Stellplatz in grüner Lage in Leipzig / Heiterblick",
  "operation": "rent",
  "propertyType": "apartment",
  "realEstateType": "apartmentrent",
  "price": 393,
  "currency": "EUR",
  "priceLabel": "393 €",
  "priceKind": "rent",
  "isStartingPrice": false,
  "prices": [{"amount": 393, "currency": "EUR", "label": "393 €"}],
  "areaM2": 48.58,
  "livingAreaM2": 48.58,
  "plotAreaM2": null,
  "areaLabel": "48,58 m²",
  "pricePerM2": 8.09,
  "rooms": 2,
  "roomsLabel": "2 Zi.",
  "otherCardValues": [],
  "address": "Weigelienstraße 13 WE01, 04329 Leipzig / Heiterblick, Paunsdorf",
  "streetAddress": "Weigelienstraße 13 WE01",
  "postcode": "04329",
  "city": "Leipzig / Heiterblick",
  "district": "Paunsdorf",
  "addressVisibility": "EXACT",
  "latitude": 51.35303,
  "longitude": 12.45163,
  "isPrivate": false,
  "publisherType": "agency",
  "logoUrl": "https://pictures.immobilienscout24.de/usercontent/5db18682-5b52-4064-8269-3a65d050870b.PNG/ORIG/resize/300x200%3E/format/webp/quality/80",
  "isProject": false,
  "isNewObject": false,
  "isNewHomeBuilderOffer": false,
  "groupHeading": null,
  "groupPublisher": null,
  "listingType": "M",
  "listOnlyOnImmoScout24": false,
  "hasLiveVideoTour": true,
  "energyEfficiencyClass": "B",
  "publishedAgo": "vor 2 Tagen",
  "plusEarlyAccess": false,
  "plusEarlyAccessUntil": null,
  "tags": [],
  "imageUrl": "https://pictures.immobilienscout24.de/listings/a0934d8d-e093-42c2-b05d-b76dbeda64ea-2130149854.jpg/ORIG/resize/800x600>/format/webp/quality/80",
  "photos": ["https://pictures.immobilienscout24.de/listings/a0934d8d-e093-42c2-b05d-b76dbeda64ea-2130149854.jpg/ORIG/legacy_thumbnail/1200x900/format/webp/quality/80"],
  "portal": "immobilienscout24",
  "country": "DE",
  "source": "www.immobilienscout24.de",
  "search": "Leipzig",
  "searchPlace": "Leipzig",
  "collectedAt": "2026-11-15T23:18:51.726606+00:00"
}
```

Key fields:

| Field | Meaning |
|---|---|
| `price`, `priceKind` | Monthly cold rent (Kaltmiete) for rentals, purchase price for sales, in EUR. |
| `warmRent`, `serviceCharges`, `deposit` | Full cost breakdown from the listing's own page, with `includeDetails` on. |
| `livingAreaM2`, `plotAreaM2`, `rooms` | As shown on the listing. |
| `pricePerM2` | Price divided by area, both as displayed. |
| `address`, `postcode`, `city`, `district` | As published; `addressVisibility` is `EXACT` (street shown) or `PARTIAL`. |
| `latitude`, `longitude` | The listing's own map point, only with a full address; never estimated. |
| `publisherType` | `private` or `agency`. |
| `isProject`, `isNewObject` | New-build project and "new" flags. |
| `publishedAgo` | How long the listing has been online, as ImmoScout24 shows it. |
| `plusEarlyAccess` | ImmoScout24 still reserves contacting this fresh listing for its paid Plus members. |
| `detailLevel`, `detailAttributes` | With details on: `full` rows carry every labelled attribute of the listing's own page (floor, year built, heating, energy certificate, ...). |
| `listingKey` | Stable key for spotting new listings and combining portals. |

### Listing details (optional)

**Add warm rent, service charges and deposit to every listing.** Turn on
**Include listing details** and each delivered listing's own page is opened
and merged into its row. On top of the search-result fields you get:

- the full cost breakdown: warm rent (Gesamtmiete), service charges
  (Nebenkosten), heating costs and deposit (Kaution) — and, for sales, the
  purchase price the listing itself shows;
- the whole published description, plus the furnishing (Ausstattung),
  location (Lage) and other notes (Sonstiges) texts;
- every labelled attribute of the listing: floor, year built, condition,
  heating type, energy certificate, available from, and the rest, as
  published;
- the advertiser's contact name and company, and the complete photo
  gallery.

Each row says what it carries: `detailLevel` is `full` when the listing's own
page was read, `listing` when the row keeps its search-result fields — a
listing whose page could not be opened, or one still reserved for
ImmoScout24 Plus members. Details cost **$0.75 per 1,000 detailed listings**
on top of the listing price (see Pricing); a listing that keeps its
search-result fields never pays the details price. Runs with details are
slower: allow about one extra second per listing.

The run summary (`OUTPUT` in the key-value store) lists each search with the
place it ran on and its total listing count, any skipped place or link with
the reason, and why the run stopped. With details on, it also says how many
listings were read with details and names any listing page that could not be
opened.

### FAQ

**What do I need `includeDetails` for?** Add warm rent, service charges and
deposit to every listing, plus its full description, floor, year built,
heating and the whole gallery — data that lives on each listing's own page,
not on the search results. Details are slower (about one second per listing)
and cost $0.75 per 1,000 detailed listings on top of the listing price; a
listing whose page could not be opened is delivered without them and never
pays the details price.

**How fresh is the data?** Every run reads ImmoScout24 live, at the time it
runs. Nothing is cached between runs.

**Why are some rows missing warm rent even with details on?** That listing's
own page does not state it, could not be opened, or the listing is still in
ImmoScout24's paid Plus members early-access window. A row whose page could
not be read keeps every search-result field and is never charged the details
price; the run summary names each such listing.

**Can I run it daily?** Yes. Schedule the run with the same input and read
the dataset through the Apify API, exported as JSON, CSV or Excel. Sorting
is newest-first, so each run's first rows are the freshest listings, and the
stable `listingKey` shows what is new since yesterday.

**Why did my run stop early?** The run stops at `maxResults`, at your
cost limit, at the time limit, or when a place runs dry; every listing
already found is saved and the run summary and status message say why it
stopped.

### Pricing

**$0.90 per 1,000 listings** ($0.0009 per listing) **plus $0.001 per run start.**
Higher Apify plans pay less per listing, down to $0.70 per 1,000.
The start fee is charged per GB of memory; the default 256 MB run is one start event.
Set **Maximum cost per run** in the run options to cap any run; listings found
before the cap are kept.

With **Include listing details** on, a listing whose own page was opened and
read costs **$0.00075 more** ($0.75 per 1,000 detailed listings, down to
$0.55 on higher Apify plans): $0.00165 per detailed listing in total on the
Free plan. A listing whose page could not be opened is
charged as a plain listing, and details are only fetched while your cost cap
covers the combined price.

| Run (Free plan prices) | Listings | Cost |
|---|---:|---|
| Sample `{}` | 50 | 50 × $0.0009 + $0.001 = $0.046 |
| One district, daily | 200 | 200 × $0.0009 + $0.001 = $0.181 |
| One district, daily, with details | 200 | 200 × ($0.0009 + $0.00075) + $0.001 = $0.331 |
| Whole city | 5,000 | 5,000 × $0.0009 + $0.001 = $4.501 |

### Limits

- Warm rent, service charges, heating costs, deposit and the full description
  live on each listing's own page: turn on **Include listing details** for
  them (a small extra charge per detailed listing; about one extra second per
  listing).
- Listings still in ImmoScout24's Plus early-access window keep their
  search-result fields only.
- The deposit is a number only when the listing states an amount; a deposit
  given as "3 Kaltmieten" stays as published in `detailAttributes`.
- Card prices are rounded to whole euros as ImmoScout24 shows them; with
  details on, `coldRent` carries the exact amount.
- No advertiser phone numbers or e-mail addresses in the search results;
  with details on, numbers published on the listing's own page are kept.
- Map coordinates only for listings whose advertiser shows the full address.
- `publishedAgo` is the portal's relative text ("vor 2 Tagen"), not a date.
- Investment property, commercial space, garages, shared-flat rooms, short
  stays and map-drawn search areas are not supported yet; such links are
  skipped and named in the run summary.
- A postcode search reads the postcode's quarters and keeps only listings in
  that postcode, so it takes a few more pages than a city search.
- Germany only (immobilienscout24.de).
- Allow about 30 seconds per 1,000 listings (about 5 minutes for 10,000);
  with details on, allow about one extra second per listing (about 17 minutes
  per 1,000 detailed listings). The default 30-minute timeout covers the
  largest plain run; raise it for large detail runs.

# Actor input Schema

## `locations` (type: `array`):

Up to 10 German places, one search each: a city (Berlin, München), a district or quarter (Leipzig Plagwitz, Hamburg Altona), a state (Bayern) or a five-digit postcode (10115). A place that ImmoScout24 does not know, for example a typo, is skipped and listed in the run summary; the other places still run. Leave empty and fill Search links instead to reuse searches from the website. An empty run input returns a sample of the newest Berlin rentals.

## `operation` (type: `string`):

Listings for rent or for sale. Applies to the places above.

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

Apartments, houses or building plots (plots are for sale only). Applies to the places above.

## `priceMin` (type: `integer`):

Lowest cold rent per month (rent; warm rent with Rent prices set to warm) or purchase price (buy) in euros. Empty or 0 means no minimum.

## `priceMax` (type: `integer`):

Highest cold rent per month (rent; warm rent with Rent prices set to warm) or purchase price (buy) in euros. Empty or 0 means no maximum.

## `priceType` (type: `string`):

Whether the price range above means cold rent (Kaltmiete, the ImmoScout24 default) or warm rent (Gesamtmiete: cold rent plus service and heating costs). Warm rent works for apartments for rent only. Purchase prices are not affected.

## `roomsMin` (type: `number`):

Fewest rooms (German count: living rooms and bedrooms, half rooms allowed, e.g. 2.5).

## `roomsMax` (type: `number`):

Most rooms.

## `areaMin` (type: `integer`):

Smallest living area, or plot area for plots, in square metres.

## `areaMax` (type: `integer`):

Largest living area, or plot area for plots, in square metres.

## `sortBy` (type: `string`):

Newest first suits scheduled monitoring: each run starts with the latest listings.

## `includeNewHomeBuilderOffers` (type: `boolean`):

House searches on ImmoScout24 also show catalogue houses from builders (Hausbauangebote, "Bauen mit ..."), which are not existing properties. They are left out unless you turn this on.

## `includeDetails` (type: `boolean`):

Add warm rent, service charges, heating costs and deposit from each delivered listing's own page, plus its full description, every labelled attribute (floor, year built, heating, energy certificate), the advertiser's name and company, and the whole photo gallery. Off by default. Each listing whose page was read adds a small extra charge (see Pricing); a listing whose page could not be opened is still delivered with its search-result fields. Runs about one second slower per listing.

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

Up to 10 search result links copied from immobilienscout24.de (https://www.immobilienscout24.de/Suche/de/...), with all their filters. When links are given, the place, rent/buy, type and filter fields above are not used. Links for investment property, garages, shared rooms, short stays or drawn map areas are skipped and listed in the run summary.

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

Upper limit of listings saved across all searches (up to 10,000). Listings are saved as they are found; about 30 seconds per 1,000 listings. Raise the run timeout for very large runs.

## `maxPages` (type: `integer`):

Safety cap on result pages per search (up to 100 listings per page).

## Actor input object example

```json
{
  "locations": [
    "Berlin"
  ],
  "operation": "rent",
  "propertyType": "apartment",
  "priceType": "cold",
  "sortBy": "newest",
  "includeNewHomeBuilderOffers": false,
  "includeDetails": false,
  "maxResults": 50,
  "maxPages": 120
}
```

# Actor output Schema

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

No description

## `summary` (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 = {
    "locations": [
        "Berlin"
    ],
    "includeDetails": false,
    "maxResults": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("automatic/immoscout24-de-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 = {
    "locations": ["Berlin"],
    "includeDetails": False,
    "maxResults": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("automatic/immoscout24-de-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 '{
  "locations": [
    "Berlin"
  ],
  "includeDetails": false,
  "maxResults": 50
}' |
apify call automatic/immoscout24-de-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,automatic/immoscout24-de-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/bGxNi34gBfF4FBblx/builds/LJyuNhxpaf1k62CP2/openapi.json
