# ImmoScout24 Scraper: Germany Property Listings (`reventadata/immobilienscout24-scraper`) Actor

Scrape ImmoScout24.de property listings: apartments to rent, apartments and houses to buy, by city or pasted search URL. Price, living space, rooms, address, coordinates, agent and contact details, energy class, features and photos. Filter by price, size and rooms. Unofficial.

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

## Pricing

from $1.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.

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

> **Unofficial.** This Actor is not affiliated with, authorised by, endorsed by, or in any
> way officially connected to ImmoScout24 or Scout24. "ImmoScout24" is a trademark of its
> respective owner and is used here only to describe what this tool reads. It reads the same
> public pages a browser does.

ImmoScout24 Scraper reads property listings from [ImmobilienScout24.de](https://www.immobilienscout24.de),
the German real-estate portal: apartments to rent, apartments and houses to buy, with price,
living space, rooms, address and coordinates, the agent or seller and their published contact details, energy class,
features, photos and publication dates.

### What data can you extract from ImmoScout24?

Every listing ImmoScout24 returns for your search, with the fields the site publishes in its
search results. The Actor reads public search pages directly, so it needs no browser
and does not open listing pages.

### Why scrape ImmoScout24?

- **Rent and buy.** Apartments for rent, apartments for sale, houses for sale, for any city slug the site serves (tested: Berlin, Frankfurt, München, Hamburg).
- **Paste a search URL or pick a city.** Filters you set on the site (price, living space, rooms, sorting) travel in the URL and are applied by the site.
- **Numeric limits** on price, living space and rooms are also available as inputs; they are applied to the rows after they are fetched.
- **Seller data.** Agent or company name, contact name, phone and mobile number as the seller published them on the listing.
- **New-build projects.** Units that the site folds under one project card are returned as their own rows, with `groupedUnderId` and the project name and link (switch off with `includeGroupedListings`).
- **No duplicates.** A listing that moves between pages while the run walks is returned once.

### How to scrape ImmoScout24

1. Either paste one or more search URLs (`https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten`), or fill state, city, rent or buy, and apartment or house.
2. Optionally set limits, `maxItems` and `maxPages`.
3. Run it. Results land in the dataset.

#### Input

| Field | Type | Meaning |
|---|---|---|
| `startUrls` | array | Search result pages. Supported: `/Suche/de/<state>/<city>/` + `wohnung-mieten`, `wohnung-kaufen` or `haus-kaufen`, with the `price`, `livingspace`, `numberofrooms` and `sorting` parameters. Anything else stops the run with a message. |
| `state`, `city` | string | Slugs from a search URL (`berlin`/`berlin`, `bayern`/`muenchen`, `hessen`/`frankfurt-am-main`). Used when `startUrls` is empty. An unknown slug stops the run with an error. |
| `listingType` | string | `rent` | `buy`. |
| `propertyType` | string | `apartment` | `house`. Houses for rent are not offered. |
| `minPrice`, `maxPrice` | integer | Optional, EUR (base rent per month on rent searches). Rows outside, or without a price, are dropped. |
| `minLivingSpaceM2`, `maxLivingSpaceM2`, `minRooms`, `maxRooms` | integer | Optional. Rows outside, or without the value, are dropped. |
| `includeGroupedListings` | boolean | Default on. |
| `maxItems` | integer | Cap on rows across all searches. Default 100. |
| `maxPages` | integer | Cap on pages per search, 20 listings each (plus grouped ones). Default 50. |

```json
{
    "state": "bayern",
    "city": "muenchen",
    "listingType": "buy",
    "propertyType": "house",
    "maxItems": 100
}
```

#### Output

One row, from a real local run on 2026-11-07 (photo list shortened):

```json
{
    "id": "171987619",
    "url": "https://www.immobilienscout24.de/expose/171987619",
    "listingType": "buy",
    "propertyType": "house",
    "realEstateType": "HouseBuy",
    "title": "Wohnen im Grünen, stadtnah leben – Traumhäuser in ruhiger Premiumlage von München-Trudering",
    "street": "Helenenstraße",
    "houseNumber": "20A",
    "postcode": "81825",
    "city": "München",
    "quarter": "Trudering",
    "locationText": "Helenenstraße 20A, Waldtrudering, München",
    "latitude": 48.11747,
    "longitude": 11.67938,
    "hasPreciseAddress": true,
    "price": 869900,
    "currency": "EUR",
    "priceInterval": "ONE_TIME_CHARGE",
    "totalRent": null,
    "livingSpaceM2": 116.4,
    "plotAreaM2": 143.03,
    "rooms": 4,
    "constructionYear": null,
    "hasBalcony": null,
    "hasBuiltInKitchen": null,
    "hasGarden": null,
    "hasLift": null,
    "hasCellar": true,
    "hasGuestToilet": true,
    "isBarrierFree": false,
    "hasBuyerCommission": false,
    "energyEfficiencyClass": "A+",
    "hasEnergyCertificate": true,
    "fairPriceRating": null,
    "isPrivateOffer": false,
    "hasFloorplan": true,
    "hasVideo": false,
    "hasVirtualTour": null,
    "features": ["Provisionsfrei für Kaufende", "Keller", "Gäste-WC"],
    "realtorCompanyName": "Avenida Wohnbau GmbH",
    "realtorId": "60805254",
    "contactSalutation": "MALE",
    "contactFirstName": "Maher",
    "contactLastName": "Osman",
    "contactCompany": "Avenida Wohnbau GmbH",
    "contactPhone": null,
    "contactMobile": "0176 23201992",
    "photos": [
        "https://pictures.immobilienscout24.de/listings/70b25df4-4cf0-41ce-98b1-eee82caa8090-2116727587.jpg/ORIG/legacy_thumbnail/800x600/format/webp/quality/50",
        "https://pictures.immobilienscout24.de/listings/533372c2-844e-4aa4-96d3-6501d1947292-2116727583.jpg/ORIG/legacy_thumbnail/800x600/format/webp/quality/50"
    ],
    "floorplans": [],
    "projectId": 153735,
    "projectName": "Partio Helenenstraße 20a",
    "projectUrl": "https://www.immobilienscout24.de/neubau/avenida-wohnbau-gmbh/partio-helenenstrasse-20a/153735.html",
    "groupedUnderId": null,
    "publishedAt": "2026-10-23T16:28:29.000+02:00",
    "createdAt": "2026-10-23T16:28:29.000+02:00",
    "modifiedAt": "2026-10-22T18:22:52.795+02:00",
    "searchUrl": "https://www.immobilienscout24.de/Suche/de/bayern/muenchen/haus-kaufen",
    "scrapedAt": "2026-11-07T19:37:01+00:00"
}
```

### Notes and limits

- **On rent searches `price` is the base rent per month;** `totalRent` is the calculated total rent when the site shows one. On buy searches `price` is the purchase price.
- **Yes/no fields are `null` when the listing does not say.** Coordinates, street and house number are present only when the seller shows the exact address.
- **Phone numbers are returned only where the seller published them in the results list.** The Actor does not open listing pages.
- **The count the site shows can be higher than the pages hold:** it counts grouped units, and it drifts by a few while a run walks.
- **A search that matches nothing ends with a status message and no rows.** A wrong state or city slug, an unsupported URL, or a run where the pages could not be read ends as failed with the reason.
- Only the three search types above were tested; districts inside a city, other regions and houses for rent are not offered.
- Reads the same public pages a browser does. See the disclaimer at the top.

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

Pay-per-event: you pay per result written to the dataset, with no subscription. The current
price is on the Actor's Pricing tab.

### FAQ

**How do I find a city slug?** Search on immobilienscout24.de and copy the two parts after `/Suche/de/`, for example
`hessen` and `frankfurt-am-main` from `/Suche/de/hessen/frankfurt-am-main/wohnung-mieten`.

**Why do I get fewer rows than the site's result count?** The site's count includes grouped units and drifts while
a run walks; ids that repeat across pages are returned once, and your limits drop rows.

# Actor input Schema

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

Optional. ImmoScout24 search result pages copied from the browser, for example https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten. Supported: /Suche/de/<state>/<city>/ followed by wohnung-mieten, wohnung-kaufen or haus-kaufen, with the price, livingspace, numberofrooms and sorting filters the site puts in the address. Other paths, districts and parameters stop the run with an error that says which. When empty, the state, city and type fields below are used.

## `state` (type: `string`):

State slug as it appears in an ImmoScout24 search URL, for example berlin, bayern, hessen or nordrhein-westfalen. Used only when Search URLs is empty.

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

City slug as it appears in an ImmoScout24 search URL, for example berlin, muenchen, koeln or frankfurt-am-main (no umlauts). An unknown slug stops the run with an error. Used only when Search URLs is empty.

## `listingType` (type: `string`):

Rent or buy. Houses for rent were not tested and are refused. Used only when Search URLs is empty.

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

Apartments or houses. Used only when Search URLs is empty.

## `minPrice` (type: `integer`):

Optional. Rows below this price, or with no price, are dropped after fetching. On a rent search this is the base rent per month. To filter on the site itself, paste a filtered search URL above.

## `maxPrice` (type: `integer`):

Optional. Rows above this price, or with no price, are dropped after fetching.

## `minLivingSpaceM2` (type: `integer`):

Optional. Rows smaller than this, or with no living space, are dropped after fetching.

## `maxLivingSpaceM2` (type: `integer`):

Optional. Rows larger than this, or with no living space, are dropped after fetching.

## `minRooms` (type: `integer`):

Optional. Rows with fewer rooms, or no room count, are dropped after fetching.

## `maxRooms` (type: `integer`):

Optional. Rows with more rooms, or no room count, are dropped after fetching.

## `includeGroupedListings` (type: `boolean`):

The site folds the other units of a new-build project under one card. They are separate listings and are saved with groupedUnderId set. Turn off to save only the listings that have their own card.

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

Hard cap on rows saved across all searches. A result page holds 20 listings, plus any grouped ones.

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

Cap on result pages fetched per search (20 listings each). Each page takes 15 to 45 seconds, so the default stops at 50 pages. The run also stops at the last page the site reports.

## Actor input object example

```json
{
  "state": "berlin",
  "city": "berlin",
  "listingType": "rent",
  "propertyType": "apartment",
  "includeGroupedListings": true,
  "maxItems": 20,
  "maxPages": 1
}
```

# Actor output Schema

## `dataset` (type: `string`):

Items scraped from the target website.

# 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 = {
    "state": "berlin",
    "city": "berlin",
    "maxItems": 20,
    "maxPages": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("reventadata/immobilienscout24-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 = {
    "state": "berlin",
    "city": "berlin",
    "maxItems": 20,
    "maxPages": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("reventadata/immobilienscout24-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 '{
  "state": "berlin",
  "city": "berlin",
  "maxItems": 20,
  "maxPages": 1
}' |
apify call reventadata/immobilienscout24-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,reventadata/immobilienscout24-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/S5dQEGB3Ih3aJLWU8/builds/Tt5HAVQZre99r18W7/openapi.json
