# ImmoScout24 Scraper ($0.59/1K): Rent, Buy & Price Alerts (`tsutseisoftware/immoscout24-scraper`) Actor

Scrape ImmoScout24 (immobilienscout24.de) apartments and houses for rent and sale in any German city, district or postcode: price, cold and warm rent, m², rooms, address, agency, energy class; details, deal score, rental yield, alerts.

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

## Pricing

from $0.35 / 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 & Price Alert

Get listings from **ImmoScout24** (immobilienscout24.de), Germany's biggest real estate portal, in any city, district, quarter, state or postcode as clean, ready-to-use data: **price as a number**, **price per m²**, living area, rooms, address and **map point** (when the seller shows them), private or agency seller, energy class, promotion level, how long the listing is online and the title photo. **Apartments and houses for rent and for sale**, plots, flat share rooms (WG), furnished temporary living, garages, investment properties, **foreclosure auctions** (market value and minimum bid) and **commercial property**: offices, shops, gastronomy and hotels, halls and warehouses, special-purpose property and commercial plots. Search a place, a postcode, or a **radius around any address or map point**.

Optionally the actor reads each listing page: **cold rent, warm rent, service charges, heating costs, deposit, Hausgeld, buyer's commission and the total purchase costs**, floor, bedrooms, bathrooms, year built, condition, heating, energy certificate and consumption, features (balcony, garden, elevator, cellar, fitted kitchen…), available from, pets, the description texts, all photos, the agency with its rating, ImmoScout24's **price range of similar listings** and, on request, the **agency's phone number**.

Every listing is compared with the listings of the run: **price per m² against its postcode** and a **deal score**. For apartments for sale the actor can add the **estimated rent and gross rental yield** from comparable rentals of the same postcode. On request: a **price history** of every listing across your runs (price drops with dates), a **market report** by postcode with a **rent index** (like a Mietspiegel, from current asking rents), an **agency directory** with business contacts and the **contact person** of each listing. Built for **watching ImmoScout24**: schedule it in monitoring mode and you get, and pay for, only **new listings and price changes**, plus listings that **were taken off ImmoScout24**, with an alert to Telegram, Slack, Discord, WhatsApp or your webhook.

**Price:** $0.59 per 1 000 listings (down to $0.35 on higher plans), listing details $0.19 per 1 000 more (agency phone numbers included). 100 listings ≈ $0.06. No account and no extra platform costs.

> **Deutsch:** Scraper für **ImmoScout24 (immobilienscout24.de)**: Wohnungen und Häuser zur Miete und zum Kauf, Grundstücke, WG-Zimmer, Wohnen auf Zeit, Garagen, Anlageobjekte, Zwangsversteigerungen und **Gewerbeimmobilien** (Büro, Einzelhandel, Gastronomie, Hallen) in jeder Stadt, jedem Stadtteil oder jeder PLZ, im **Umkreis einer Adresse** oder jede Such-URL mit Filtern, Umkreis oder gezeichneter Karte. Filter **provisionsfrei**, Haustiere, Heizungsart, Haustyp. Preis als Zahl, **Kaltmiete und Warmmiete**, Nebenkosten, Kaution, Hausgeld, Provision, Wohnfläche, Zimmer, Adresse, Energieklasse, Anbieter; **Preis pro m² gegenüber der PLZ**, Deal-Score und **Mietrendite**. **Suchagent für neue Angebote und Preissenkungen** mit Benachrichtigung per Telegram, Slack, Discord oder WhatsApp, **Preisverlauf** über alle Läufe, **Marktbericht mit Mietspiegel** nach PLZ und Zimmern, **Maklerverzeichnis**. Export nach Excel, CSV oder JSON.

### Why use this ImmoScout24 scraper?

- **Less than the most used ImmoScout24 scrapers:** $0.59 per 1 000 listings, $0.78 with listing details and agency phone numbers, with no extra platform costs.
- **Searches as you know them:** "Berlin", "München-Schwabing", "Landkreis Ebersberg", "Bayern", a postcode like "10115", a **radius around an address or map point** ("Alexanderplatz 1, Berlin" + 3 km, with each listing's distance), or any ImmoScout24 search URL with its filters, radius or drawn map area, plus listing URLs and IDs, all in one run.
- **Every kind of listing:** apartments and houses for rent and for sale, plots, WG rooms, temporary living, garages, investment properties, foreclosure auctions and **commercial property** (offices, shops, gastronomy, halls, special-purpose property, commercial plots).
- **The filters of the website:** price, area, rooms, plot, year built, features, energy class, apartment and house type, floor, **commission-free (provisionsfrei)**, **pets allowed**, **heating type**, new buildings; plus the actor's own filters (seller type, days online, deal score, price per m², title words, early access listings).
- **Investor fields on every listing, free:** price per m² against the postcode median and a deal score; for apartments for sale an estimated cold rent and gross rental yield on request.
- **The real costs of a flat:** cold and warm rent, service charges, heating, deposit, Hausgeld, buyer's commission and total purchase costs as numbers.
- **A monitor that pays only for news:** new listings, price changes with the previous price, and listings taken off the website, with alerts; with **Price history** every listing carries all prices your runs saw.
- **Reports for analysts and agents:** a market report with price quartiles and a rent index by postcode and rooms, and an agency directory (listings per agency, address, phone, e-mail, website) from the listings of your search.
- **Privacy by default:** contact persons are returned only when you turn on **Contact person (personal data)**; otherwise a private seller has no name and no phone. A private seller never gets a street, and its map point is rounded to about 1 km; phone numbers and e-mails are removed from texts.

| | This actor | Typical ImmoScout24 scraper |
|---|---|---|
| Price per 1 000 listings | **$0.59** (with details $0.78) | $0.80–1.75, with details $1.19–2.30 for the most used ones |
| Locations, postcodes, search URLs, listing IDs in one run | **yes** | some |
| Rent, sale, plots, WG, temporary living, garages, auctions | **yes** | often apartments and houses only |
| Cold and warm rent, costs, Hausgeld, commission as numbers | **yes** (listing details) | some |
| New listings, price changes, removed listings, alerts | **yes** (Telegram, Slack, Discord, WhatsApp, webhook) | some |
| Radius around an address or map point, with distance | **yes** | some (map point only) |
| Commercial property (offices, shops, gastronomy, halls) | **yes** | some |
| Commission-free, pets, heating, house type filters | **yes** | some |
| English titles, skip first results, early access only | **yes** | some |
| Price history of each listing across runs | **yes** (price drops, lowest and highest of 90 days) | few |
| Deal score, rental yield, market summary by postcode | **yes** | no |
| Market report with rent index (Mietspiegel-like) | **yes** | one, at a higher price |
| Agency directory from your results, contact person | **yes** (opt-in) | some |

### What data can you get?

| Field | Example |
|---|---|
| ID, URL, title | 172626075, https://www.immobilienscout24.de/expose/172626075, "Ihr neues Zuhause zu zweit" |
| Type | realEstateType apartmentrent; transactionType rent, sale or auction; propertyType flat, house, land, room, garage |
| Price | 2166 EUR (cold rent per month or purchase price), priceText "2.166 €", pricePerSqm 18.2 |
| Costs (details) | coldRent, warmRent, serviceCharge, heatingCosts, deposit, hausgeld, buyerCommission, purchaseAdditionalCosts, purchaseTotalCosts |
| Size | usableArea 118.99 m², rooms 1, plotArea, bedrooms, bathrooms, floor, floors |
| Address | Johann-Georg-Straße 9 A, 10709 Berlin, Wilmersdorf; zipCode, city, cityPart, district, state, latitude, longitude |
| Seller | isPrivateSeller, agencyName, agencyRating, agencyRatingCount, agencyProfileUrl, agencyPhone (on request) |
| Contact person (opt-in) | contactPersonName "Dominik Meier", contactPersonSalutation "Herr", contactPersonPhone |
| Commercial | realEstateType officerent, storebuy…; priceUnit sqmMonth / month / total, usableArea (floor area), totalArea, minDivisibleArea, seats, isCommissionFree |
| Building (details) | yearBuilt, lastRefurbished, condition, interiorQuality, heatingType, energySource, energyClass, energyConsumption |
| Features (details) | balcony, garden, elevator, cellar, builtInKitchen, guestToilet, barrierFree, furnished, petsAllowed, parkingSpaces |
| Texts and photos | description, equipmentDescription, locationDescription, otherDescription, imageUrl, imageUrls |
| Timing | listedAt 2026-11-13, listedAgoText "vor 4 Tagen", availableFrom 2027-01-01 |
| Market | marketAreaMedianPricePerSqm, pricePerSqmVsMarketAreaPercent, dealScore, similarPriceMin / Max |
| Yield (on request) | rentEstimateMonthly, rentPerSqmMedian, rentSampleSize, grossRentalYieldPercent |
| Monitoring | changeType new / updated / removed / reappeared, previousPrice, priceChangePercent, removedReason |
| Price history (on request) | priceHistory \[{date, price}], priceHistorySince, priceHistoryChanges, priceDropCount, lowestPrice30d, lowestPrice90d, highestPrice90d, averagePrice90d |
| Radius and language | distanceKm (from the radius centre), originalTitle (with English titles) |

Fill rates measured on real runs: price, living area, rooms, postcode and city 100 %; street and map point only when the seller shows the address (about a third to two thirds of listings); with listing details the description ~100 %, year built ~85 %, energy class ~45 % (many listings give none), agency phone ~80–90 % of agency listings.

Extra export formats: a printable HTML report or a Markdown table, besides Excel, CSV and JSON.

### How to scrape ImmoScout24

1. Enter one or more **Locations** (Berlin, München, 10115) or a **Radius centre** with **Radius (km)**, choose the **Property type**, or paste **ImmoScout24 URLs** of searches or listings.
2. Optionally set the website's filters (price, living area, rooms, plot, year built, features, energy class, apartment and house type, floor, commission-free, pets, heating) and the actor's filters (seller type, days online, deal score, price per m², title keywords, early access only).
3. Turn on **Add listing details** for costs, facts and texts, **Add rental yield** for investors, and the reports you need (price history, market report, agency directory).
4. Run it, or schedule it with **Monitoring** on to get only new listings and price changes.

### Use cases

#### New rentals in Berlin, every hour, with an alert

```json
{
  "searchLocations": ["Berlin"],
  "realEstateType": "apartmentrent",
  "maxPrice": 1500,
  "minRooms": 2,
  "onlyNewOrChanged": true,
  "monitoringKey": "berlin-2-rooms",
  "telegramBotToken": "123456:ABC...",
  "telegramChatId": "123456789"
}
```

Each run returns only apartments listed since the previous run (and price changes); the first run remembers what is there.

#### Investors: apartments for sale in Leipzig with a good rental yield

```json
{
  "searchLocations": ["Leipzig"],
  "realEstateType": "apartmentbuy",
  "includeRentalYield": true,
  "minGrossYieldPercent": 5,
  "maxItems": 200
}
```

#### Apartments within 3 km of an address, in English

```json
{
  "radiusCenter": "Alexanderplatz 1, Berlin",
  "radiusKm": 3,
  "realEstateType": "apartmentrent",
  "petsAllowed": ["yes"],
  "language": "en",
  "maxItems": 200
}
```

Every listing that shows its map point gets `distanceKm`; `title` is ImmoScout24's English translation and `originalTitle` the German one. A map point works too: `"radiusCenter": "52.52, 13.405"`.

#### Offices for rent in Munich, commission-free

```json
{
  "searchLocations": ["München"],
  "realEstateType": "officerent",
  "minLivingSpace": 200,
  "commissionFree": true,
  "includeDetails": true,
  "maxItems": 300
}
```

Commercial rows give the price as shown (`priceUnit` `month`, `sqmMonth` for rents per m² or `total`), the floor area, `totalArea` and `minDivisibleArea`.

#### Market report and rent index of a city

```json
{
  "searchLocations": ["Leipzig"],
  "realEstateType": "apartmentrent",
  "includeMarketReport": true,
  "maxItems": 2000
}
```

`MARKET_REPORT` in the key-value store has, per postcode and per town, the quartiles of the rent and the rent per m², the median area and days online, new listings of the last 7 days and the share of private landlords, all also by room count, plus `rentIndex`: the rent per m² by postcode and rooms.

#### Agency leads: listings of agencies with their phone number

```json
{
  "searchLocations": ["Hamburg"],
  "realEstateType": "housebuy",
  "sellerType": "agency",
  "includeDetails": true,
  "includeAgencyPhone": true,
  "includeAgencyDirectory": true,
  "includeContactPerson": true,
  "maxItems": 100
}
```

`AGENCY_DIRECTORY` (JSON and CSV) lists every agency of the saved listings with its listing count, kinds of listing, cities and postcodes, median price, address, phone, fax, e-mail and website (from its imprint), rating and profile. **Contact person** adds the name, salutation and phone of each listing's contact; this is personal data, and you are responsible for processing it lawfully (GDPR).

#### Price history across runs

```json
{
  "searchLocations": ["Hamburg"],
  "realEstateType": "apartmentbuy",
  "includePriceHistory": true,
  "monitoringKey": "hamburg-flats",
  "maxItems": 1000
}
```

Schedule it daily: each run adds the prices it sees, and every listing gets `priceHistory` (every price with its date), `priceDropCount`, `priceHistoryChanges` and the lowest and highest price of 30 and 90 days. Use the same **Monitoring key** in every run.

#### Paste any ImmoScout24 search URL

```json
{
  "startUrls": [
    { "url": "https://www.immobilienscout24.de/Suche/de/bayern/muenchen/wohnung-mieten?price=-2000.0&numberofrooms=3.0-" },
    { "url": "https://www.immobilienscout24.de/Suche/radius/haus-kaufen?centerofsearchaddress=M%C3%BCnchen;;;;;;&geocoordinates=48.13912;11.58022;20.0" }
  ],
  "maxItems": 500
}
```

A search URL keeps its own filters and sort order. Listing URLs (`https://www.immobilienscout24.de/expose/172626075`) and **Listing IDs** are read with their listing details.

#### Monitoring mode explained

With **Monitoring: only new or changed listings** the actor remembers the listings of each run (per **Monitoring key**) and returns only new ones and price changes (`changeType`, `previousPrice`, `priceChangePercent`). With newest first, a search stops as soon as it reaches known listings, so a check without news reads one page. **Monitoring: report listings that left the search** returns listings of the previous run that are gone, with `removedReason` `removed` (taken off ImmoScout24, e.g. rented or sold) or `noLongerMatches` (still online, no longer in your search).

#### Notifications

One message per run to Telegram, Slack, Discord, WhatsApp or any webhook (Zapier, Make, n8n), with the listings it saved: title, price and its change, rooms, m², postcode and deal score.

#### Market summary (SUMMARY)

Every run writes a free summary to the key-value store: listings ImmoScout24 reports, read and saved per search, and per postcode the number of listings, median price, median price per m² and the share of private sellers. The paid **Market report** (`MARKET_REPORT`) goes further: quartiles, room counts, days online and the rent index.

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

Pay per event, no subscription and no extra platform costs:

| Event | Free plan | Bronze | Silver | Gold+ |
|---|---|---|---|---|
| Listing saved (per 1 000) | $0.59 | $0.55 | $0.45 | $0.35 |
| Listing details (per 1 000 listings, agency phone included) | $0.19 | $0.19 | $0.19 | $0.19 |
| Rental yield (per 1 000 apartments that get one) | $0.30 | $0.30 | $0.30 | $0.30 |
| Run start | $0.003 | $0.003 | $0.003 | $0.003 |
| Monitoring page (per 1 000 pages or checks) | $0.20 | $0.20 | $0.20 | $0.20 |
| Extra page (per 1 000 pages) | $0.20 | $0.20 | $0.20 | $0.20 |
| Notification (per run that sent one) | $0.001 | $0.001 | $0.001 | $0.001 |
| Contact person (per 1 000 listings that have one) | $0.10 | $0.10 | $0.10 | $0.10 |
| Price history (per 1 000 listings with history from earlier runs) | $0.30 | $0.30 | $0.30 | $0.30 |
| Market report (per run) | $0.015 | $0.015 | $0.015 | $0.015 |
| Agency directory (per 1 000 agencies) | $1.00 | $1.00 | $1.00 | $1.00 |

| Typical run | Price (Free plan) | Typical time |
|---|---|---|
| 100 listings | ≈ $0.06 | seconds |
| 100 listings with listing details | ≈ $0.08 | under a minute |
| 5,000 listings of a big city | ≈ $2.95 | a few minutes |
| Hourly monitor without news | ≈ $0.003 a run | seconds |

A page that saves nothing (a narrow filter of the actor over a big search) is charged as an extra page. If the saved listings don't cover a run's cost, the difference is charged as extra pages; the log says how many. A normal run pays nothing more.

### Input example

```json
{
  "searchLocations": ["Berlin"],
  "realEstateType": "apartmentrent",
  "maxPrice": 1500,
  "minLivingSpace": 50,
  "minRooms": 2,
  "equipment": ["balcony"],
  "maxItems": 100
}
```

### Output example

```json
{
  "id": "172626075",
  "source": "immoscout24",
  "url": "https://www.immobilienscout24.de/expose/172626075",
  "title": "Ihr neues Zuhause zu zweit",
  "realEstateType": "apartmentrent",
  "transactionType": "rent",
  "propertyType": "flat",
  "subtype": "Loft",
  "price": 2166,
  "priceCurrency": "EUR",
  "priceText": "2.166 €",
  "priceUnit": "month",
  "pricePerSqm": 18.2,
  "coldRent": 2165.55,
  "warmRent": 2642.05,
  "serviceCharge": 303.41,
  "heatingCosts": 173.09,
  "deposit": 6496.65,
  "usableArea": 118.99,
  "rooms": 1,
  "bathrooms": 1,
  "floor": 4,
  "floors": 5,
  "address": "Johann-Georg-Straße 9 A, 10709 Berlin, Wilmersdorf",
  "zipCode": "10709",
  "city": "Berlin",
  "cityPart": "Wilmersdorf",
  "district": "Charlottenburg-Wilmersdorf",
  "region": "Berlin",
  "latitude": 52.497,
  "longitude": 13.29797,
  "isPrivateSeller": false,
  "agencyName": "GESOBAU AG",
  "agencyRating": 4.3,
  "promotionLevel": "XL",
  "availableFrom": "2027-01-01",
  "yearBuilt": 2027,
  "condition": "first_time_use",
  "heatingType": "district_heating",
  "energyClass": "B",
  "energyConsumption": 63,
  "balcony": true,
  "elevator": true,
  "imageCount": 12,
  "listedAt": "2026-11-13",
  "marketAreaMedianPricePerSqm": 19.5,
  "pricePerSqmVsMarketAreaPercent": -6.7,
  "dealScore": 53,
  "detailsIncluded": true,
  "searchQuery": "Berlin",
  "scrapedAt": "2026-11-17T21:00:00Z"
}
```

### Good to know

- **Price** is the purchase price, or for rentals the monthly cold rent (Kaltmiete), as the search results show it (whole euros, so that monitoring compares like with like); the cold rent to the cent, the warm rent and the costs come with **Add listing details**. Auctions give the market value as the price and the minimum bid apart.
- **Address and map point** are shown by the seller or not; many listings show only the postcode and quarter. Private sellers never get a street, and their map point is rounded to about 1 km.
- **Deal score** compares a listing's price per m² with listings of the run of the same kind in the same postcode (else the same city). It is null when the run saw too few comparable listings, so it is most useful on bigger runs.
- **Rental yield** is 12 × the estimated cold rent / price, from asking rents of comparable apartments for rent of the same postcode and room count; before costs, taxes and vacancy.
- **Online since** (`listedAt`) comes from what ImmoScout24 shows ("vor 4 Tagen"); for months and years it is approximate.
- **Early access listings** (`isPlusExclusive`): ImmoScout24 shows some new listings to its paying members first; they are in the results with the date the early access ends. **Only early access (Plus) listings** keeps just those.
- **Radius centre:** an address or place is located on the map with OpenStreetMap (data © OpenStreetMap contributors); a map point ("52.52, 13.405") needs no lookup. `distanceKm` is empty for listings that do not show their map point (private sellers' points are rounded, so their distance is approximate).
- **Commercial property:** rent or sale is part of the property type (`officerent`, `officebuy`…). ImmoScout24 lists gastronomy and commercial plots for rent together with those for sale; the actor keeps the rentals (listings without a price are left out, and the status says how many). The market report's price figures use monthly rents and sale prices; a rent given per m² counts for the price per m². The area filter works on the floor area; for gastronomy, special-purpose property and commercial plots the actor applies it itself. Rooms, year built, floor and features do not apply. `searchUrl` is empty for commercial searches.
- **English titles:** ImmoScout24 translates the titles of search results; descriptions stay as written.
- **Skip first results** continues a big search where an earlier run stopped; skipped results are not charged.
- **Contact person** is personal data: it is off by default, and you are responsible for processing it lawfully (GDPR).
- A page the website rejects is retried once a little later; if rejections continue, the run stops with what it has saved and says so.

### For AI agents and API users

Run it from the Apify API, the Apify MCP server, Make, Zapier or n8n. **Compact output** keeps the core fields (title, type, price, price per m², living area, rooms, postcode, city, quarter, seller type, deal score, yield, photo, link, monitoring fields). Every field is described in the dataset schema (Output tab).

### Troubleshooting

- **"does not know the place"**: use a city (Berlin), a district or quarter (München-Schwabing), a county (Landkreis Ebersberg), a state (Bayern) or a postcode (10115), or paste an ImmoScout24 search URL.
- **"rejected the search URLs"**: open the search on immobilienscout24.de, copy the URL from the address bar and try again.
- **"does not take these filters of the URL"**: the run went on without that filter; check the results or set the filter in the actor's input.
- **"No supported URL"**: paste a search page (`https://www.immobilienscout24.de/Suche/…`) or a listing page (`…/expose/…`).
- **"could not be found on the map"**: write the radius centre with the town ("Hauptstraße 5, Potsdam") or as "latitude, longitude".
- **"refused the requests"**: try again later; if it repeats, set **Proxy configuration** to Apify Proxy with the RESIDENTIAL group and country Germany.
- **Monitoring returned nothing**: nothing new since the last run with the same Monitoring key.

### Integrations

Connect the results to the tools you already use with the built-in integrations of Apify (the **Integrations** tab of the actor or of a saved task), with no code:

- **Google Sheets or Google Drive:** the results of every run in a spreadsheet or a file.
- **Zapier, Make and n8n:** start a workflow when a run finishes, or start the actor from one.
- **Slack or e-mail:** a message from Apify when a run finishes or fails.
- **Webhooks:** your own address gets the details of each run.
- **API and MCP:** run the actor from your code, or let an AI assistant run it through the Apify MCP server.

The results also download as Excel, CSV, JSON or XML from the **Output** tab.

### Privacy and error reports

When a run fails, the actor sends its developer a short error report: the error, the run ID and your input with secrets left out (tokens, webhooks, e-mails and similar values are hidden). Your results are never sent. Reports are deleted after at most 120 hours (5 days). To send nothing, turn off **Send error reports** (`sendErrorReports: false`). Questions about your data: open an issue in the **Issues** tab of this actor.

### WhatsApp notifications: setup

The actor sends the message from your own WhatsApp business number through the WhatsApp Cloud API of your Meta business account. You need a Meta business account; the actor uses only the values you enter in the **Notifications** section (the token and the numbers are stored encrypted and never written to the log).

1. **Create an app.** In Meta for Developers open **My Apps → Create app** and choose the use case **Connect with customers through WhatsApp**.
2. **Get a sending number.** In the app open **WhatsApp → API Setup**. You can start with the test number Meta gives you and add your own business number there later. Copy the **Phone number ID** (not the number itself) into **WhatsApp phone number ID**.
3. **Confirm the recipients (test number only).** A test number sends only to numbers on its list: in **API Setup**, under **To**, add each recipient's number and confirm it with the code WhatsApp sends to it.
4. **Create a permanent access token.** The token shown in API Setup expires within hours. In **Business settings → System users** add a system user, use **Assign assets** to give it your app (and your WhatsApp account), then **Generate token** for the app with the permissions `whatsapp_business_messaging` and `whatsapp_business_management` and the expiry you want. Paste it into **WhatsApp access token**.
5. **Create a message template (recommended).** In **WhatsApp Manager → Message templates → Create template** choose the category **Utility**, a name (e.g. `apify_results`) and a language, and write a body with two variables, for example: `New results of your Apify task: {{1}} Open the dataset: {{2}} (sent automatically after each run).` Meta does not accept a body that starts or ends with a variable and asks for sample values (e.g. `3 new jobs` and a dataset link); keep the text factual, a promotional text is moved to the Marketing category. Approval can take up to 24 hours. Enter the name in **WhatsApp template name** and its language code (e.g. `en_US`, `cs`, `pl`, `de`, as WhatsApp Manager shows it) in **WhatsApp template language**.
6. **Enter the recipients.** **WhatsApp recipient number** takes up to 5 numbers with the country code (e.g. `+420601234567`), separated by commas or new lines. Each number gets its own message.

**What the message contains.** With a template: `{{1}}` is the run summary with the first results on one line (title, company or price, place; never descriptions or contacts) and `{{2}}` the link to the dataset. A template with only `{{1}}` works too, it then gets the link at the end. Without a template the actor sends a text message with one link per result, like in Slack or Telegram.

**Without a template** WhatsApp delivers the message only when the recipient wrote to your business number in the last 24 hours (the customer service window), so a daily or hourly schedule needs a template. The run log says so once per run.

**What it costs.** Meta bills your business account, not this actor: per delivered message, by the message category (a template of the Utility category, or a service message for text in the 24-hour window, with a monthly free allowance per business number) and by the recipient's country. The current rates are in Meta's pricing of the WhatsApp Business Platform. The actor's own notification charge (see the **Pricing** tab) is once per run that delivered its notification, whatever the number of channels and recipients.

**Checked at the start.** When the run starts, the actor checks the token, the phone number ID and, when the token shows its WhatsApp account, the template (name, language, approval), without sending anything. Settings that can't work stop the run with a message that says what to fix, before anything is read from the website.

**When nothing arrives**, the run log names the WhatsApp error and what to do: a template that does not exist in that language or is not approved yet, a template with another number of variables, a recipient missing from the test number's list, an expired token, or the 24-hour window. A failed notification never fails the run and is not charged. Meta can accept a message and still not deliver it later (for example when the recipient's phone is not on WhatsApp); such a run counts as notified.

### FAQ

#### Is it legal to scrape ImmoScout24?

It reads only publicly available data, without logging in, at a polite pace, slows down when the website asks and never solves captchas or other challenges. Contact persons (names and phone numbers of agents and private sellers) are returned only with **Contact person (personal data)**, which is off by default; private sellers never get a street, and phone numbers and e-mails are removed from texts, though free text can still contain a name someone wrote there. Agency phone numbers and the agency directory are business contacts returned only on request. You are responsible for how you use the data, in particular for processing personal data lawfully under the GDPR, and for the website's terms. This is an unofficial tool, not connected with Scout24 SE or ImmoScout24.

#### How is it different from other ImmoScout24 scrapers?

It costs less than the most used ImmoScout24 scrapers, takes locations, postcodes, a radius around any address, search URLs and listing IDs in one run, covers every kind of residential and commercial listing including auctions, gives the real costs of a flat as numbers, adds a deal score and the rental yield, and its monitor returns only new listings and price changes, plus listings that left the search. On request it keeps a price history across runs and writes a market report with a rent index and an agency directory.

#### Do I need a proxy?

No.

#### Can I get the phone number and name of the agent?

Yes: turn on **Add listing details** and **Add agency phone numbers** for the agency's number, and **Contact person (personal data)** for the name, salutation and phone number of the contact person the listing shows (also of private sellers who show them). The contact person is personal data; you are responsible for processing it lawfully (GDPR).

#### Can I search around an address?

Yes: **Radius centre** takes an address, a place or "latitude, longitude", **Radius (km)** the size of the circle. Each listing gets its distance from the centre.

#### Does it work for ImmoScout24 Austria or Switzerland?

No, it reads immobilienscout24.de (Germany).

#### How often should I run the monitor?

Hourly for a hot city, daily for a region. A check without news costs about $0.003.

This actor is also known as an ImmoScout24 API, ImmobilienScout24 scraper, ImmoScout24 crawler or ImmoScout24 price tracker (German: "Wohnungssuche Berlin", "Immobilien Scraper", "Mietpreise Deutschland").

# Changelog

This Actor's version history is a separate document: https://apify.com/tsutseisoftware/immoscout24-scraper/changelog.md

# Actor input Schema

## `searchLocations` (type: `array`):

Places to search, as you would type them on ImmoScout24: a city (Berlin, München), a district or quarter (Berlin-Prenzlauer Berg, München-Schwabing), a county (Landkreis Ebersberg), a state (Bayern) or a postcode (10115). A listing found in several searches is saved once.

## `realEstateType` (type: `string`):

What to search in the locations and the radius. Commercial types (offices, shops, gastronomy, halls, special-purpose property, commercial plots) take the price, area and commission filters. ImmoScout24 search URLs keep their own type.

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

Maximum number of listings saved. You pay per saved listing. 0 = no limit.

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

Search pages copied from the browser with any filters, radius or drawn map area (e.g. https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten?price=-1500.0\&numberofrooms=2.0-) and listing URLs (https://www.immobilienscout24.de/expose/172626075), read with their listing details. A search URL keeps its own filters and sort order.

## `listingIds` (type: `array`):

ImmoScout24 listing IDs (the number in a listing URL, e.g. 172626075): each listing is read with its listing details.

## `radiusCenter` (type: `string`):

Search a circle around an address, a place or a map point instead of (or besides) the locations: e.g. "Alexanderplatz 1, Berlin", "Marienplatz, München" or "52.52, 13.405". An address is located with OpenStreetMap. Every listing gets its distance from the centre (distanceKm) when it shows its map point.

## `radiusKm` (type: `number`):

Radius around the centre in km (default 5).

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

Order of the results. Newest first is best for monitoring new listings.

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

Purchase price, or for rentals the monthly cold rent (Kaltmiete).

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

Purchase price, or for rentals the monthly cold rent (Kaltmiete).

## `priceIsWarmRent` (type: `boolean`):

Rentals: apply the min and max price to the warm rent (Warmmiete) instead of the cold rent.

## `minLivingSpace` (type: `integer`):

Smallest living area (Wohnfläche) in square metres.

## `maxLivingSpace` (type: `integer`):

Largest living area (Wohnfläche) in square metres.

## `minRooms` (type: `number`):

German room count (living rooms and bedrooms, without kitchen and bath); e.g. 2 or 2.5.

## `maxRooms` (type: `number`):

Most rooms (German room count, e.g. 3 or 3.5).

## `minPlotArea` (type: `integer`):

Houses and plots: Grundstücksfläche.

## `maxPlotArea` (type: `integer`):

Houses and plots: Grundstücksfläche.

## `minYearBuilt` (type: `integer`):

Oldest year of construction (Baujahr).

## `maxYearBuilt` (type: `integer`):

Newest year of construction (Baujahr).

## `equipment` (type: `array`):

Only listings with all of these features (empty = any).

## `energyClasses` (type: `array`):

Only listings with one of these energy efficiency classes (empty = any; listings without a class are left out when set).

## `apartmentTypes` (type: `array`):

Apartments: only these types (empty = any).

## `minFloor` (type: `integer`):

Apartments: lowest floor (0 = ground floor).

## `maxFloor` (type: `integer`):

Apartments: highest floor (0 = ground floor).

## `excludeNewBuildProjects` (type: `boolean`):

Leave out listings of developers' new-build projects (Neubauprojekte).

## `onlyNewBuildings` (type: `boolean`):

Only new buildings (Neubau).

## `excludeSwapFlats` (type: `boolean`):

Apartments: leave out flat swap offers (Wohnungstausch).

## `commissionFree` (type: `boolean`):

Only listings without a commission for the buyer or tenant.

## `petsAllowed` (type: `array`):

Rentals (apartments, houses, flat shares, temporary living): only listings that allow pets, or allow them by arrangement (empty = any).

## `heatingTypes` (type: `array`):

Apartments and houses: only these heating types (empty = any).

## `buildingTypes` (type: `array`):

Houses: only these house types (empty = any).

## `sellerType` (type: `string`):

Keep only listings of agencies (brokers, housing companies, developers) or only private listings.

## `titleKeywords` (type: `array`):

Keep only listings whose title contains at least one of these words (e.g. Altbau, Dachgeschoss, provisionsfrei).

## `excludeTitleKeywords` (type: `array`):

Leave out listings whose title contains any of these words (e.g. WBS, Tausch, Senioren).

## `maxDaysOnline` (type: `integer`):

Keep only listings online at most this many days (from what ImmoScout24 shows, e.g. "vor 4 Tagen"; approximate for months). With newest first the search stops at older listings.

## `onlyPlusListings` (type: `boolean`):

Keep only the newest listings ImmoScout24 shows to its paying members (Suchen+) first.

## `maxPricePerSqm` (type: `number`):

Keep only listings at most this expensive per m² of living area (plots: plot area); rentals: cold rent per m². Listings without an area are left out.

## `minDealScore` (type: `integer`):

Keep only listings with at least this deal score (50 = the usual price per m² of comparable listings in the same postcode, higher = cheaper).

## `minGrossYieldPercent` (type: `number`):

Apartments for sale, with "Add rental yield": keep only those with at least this gross yield.

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

Read every listing page: cold and warm rent, service charges, heating costs, deposit, Hausgeld, buyer's commission and total purchase costs, floor, bedrooms, bathrooms, year built, condition, heating, energy certificate and consumption, features (balcony, garden, elevator, cellar, fitted kitchen...), available from, pets, the description texts, all photos, the agency with its rating, and ImmoScout24's price range of similar listings. Charged as "Listing details" ($0.19 per 1,000 listings).

## `includeAgencyPhone` (type: `boolean`):

With "Add listing details": the phone number an agency or company shows on its listing. Never for private sellers. No extra charge (part of the listing details). These are business contacts; use them according to the GDPR.

## `includeContactPerson` (type: `boolean`):

With "Add listing details": the name, salutation and phone number of the contact person the listing shows (an agent, a team or a private seller who shows them). This is personal data: you are responsible for processing it lawfully (GDPR), e.g. only with a legitimate interest and never for unsolicited advertising. Charged as "Contact person" per listing that has one (see the Pricing tab).

## `includeRentalYield` (type: `boolean`):

Apartments for sale: the run also reads apartments for rent of the same place and adds an estimated monthly cold rent and the gross rental yield (12 × rent / price) from comparable rentals of the same postcode and room count. Charged as "Rental yield" ($0.30 per 1,000 apartments) only for apartments that get a yield.

## `includePriceHistory` (type: `boolean`):

Remember the price of every listing your runs see (per Monitoring key) and add its history: since when your runs see it, every price with its date, the number of changes and price drops, the lowest and highest price of 30 and 90 days. Charged as "Price history" per listing whose history goes back before this run (the first run only starts it).

## `includeMarketReport` (type: `boolean`):

MARKET_REPORT in the key-value store: per postcode and per town the quartiles of the price and the price per m², the median area and days online, new listings of 7 days, the share of private sellers and the same by room count; for apartments for rent a rent index by postcode and rooms (asking rents, like a Mietspiegel). Charged once per run as "Market report".

## `includeAgencyDirectory` (type: `boolean`):

With "Add listing details": AGENCY_DIRECTORY (JSON and CSV) in the key-value store, one entry per agency of the saved listings: listings in your results, kinds of listing, cities and postcodes, median price, address, phone, fax, e-mail and website from its imprint, rating and ImmoScout24 profile. Business contacts; use them according to the GDPR. Charged as "Agency directory" per agency.

## `language` (type: `string`):

English: the titles of the search results in ImmoScout24's English translation (originalTitle keeps the German one). Descriptions stay as the seller wrote them.

## `compact` (type: `boolean`):

Only the main fields: title, type, price, price per m², living area, rooms, postcode, city, quarter, seller type, deal score, yield, photo, URL and the monitoring fields.

## `maxItemsPerSearch` (type: `integer`):

Maximum per location or search URL. Empty = no limit.

## `skipItems` (type: `integer`):

Skip this many results at the top of every search (e.g. 500 to go on where an earlier run with "Max listings" 500 stopped). Skipped results are not read further and not charged.

## `onlyNewOrChanged` (type: `boolean`):

Return new listings, and listings whose price changed, with the previous price.

## `monitoringKey` (type: `string`):

Name of the remembered state; use a different key for every saved search. Empty = "default".

## `monitoringEarlyStop` (type: `boolean`):

With newest first: stop a search as soon as it reaches listings already known (fast, cheap checks). Turn it off to see price changes of older listings and to report listings that left the search.

## `onlyNew` (type: `boolean`):

Return new listings only, not changed ones.

## `onlyPriceDrops` (type: `boolean`):

Of the changed listings, return only those whose price went down.

## `minPriceDropPercent` (type: `integer`):

Of the changed listings, return only those whose price went down by at least this many %.

## `includeRemovedListings` (type: `boolean`):

Listings of the previous run that are no longer in the search: the actor checks each one and returns it with removedReason removed (taken off ImmoScout24, e.g. rented or sold) or noLongerMatches (still online, no longer in your search). Works for searches read in full with "Monitoring: stop at known listings" off. Each check is charged as a monitoring page.

## `skipFirstRun` (type: `boolean`):

The first run only remembers the listings and returns nothing; later runs return what is new.

## `resetMonitoring` (type: `boolean`):

Forget the remembered listings of this Monitoring key.

## `telegramBotToken` (type: `string`):

Token of your bot from @BotFather.

## `telegramChatId` (type: `string`):

Chat, group or channel to send to (e.g. 123456789 or -1001234567890).

## `slackWebhookUrl` (type: `string`):

Incoming webhook (https://hooks.slack.com/...).

## `discordWebhookUrl` (type: `string`):

Webhook of your Discord channel (https://discord.com/api/webhooks/...). In Discord: channel settings → Integrations → Webhooks → Copy Webhook URL. Stored encrypted.

## `webhookUrl` (type: `string`):

Any HTTPS URL (Zapier, Make, n8n, your server): receives the listings as JSON.

## `whatsappAccessToken` (type: `string`):

Access token of the WhatsApp Cloud API of your Meta business account, used with "WhatsApp phone number ID" and "WhatsApp recipient number" (step by step in the README, section "WhatsApp notifications: setup"). For scheduled runs use a permanent token of a system user: Business settings → System users → Generate token, with the permissions whatsapp_business_messaging and whatsapp_business_management; the token of WhatsApp → API Setup expires within hours. Stored encrypted.

## `whatsappPhoneNumberId` (type: `string`):

ID of your WhatsApp business number that sends the message (not the number itself), e.g. 106540352242922. In your Meta app: WhatsApp → API Setup → Phone number ID.

## `whatsappTo` (type: `string`):

Phone number that gets the message, in international format with the country code (e.g. +420601234567); up to 5 numbers separated by commas or new lines, each gets its own message and the notification is charged once per run. A test number of Meta sends only to numbers you added and confirmed under API Setup → To. Stored encrypted.

## `whatsappTemplateName` (type: `string`):

Name of your approved message template (WhatsApp Manager → Message templates, e.g. apify_results), recommended: WhatsApp delivers a template message at any time. Its body gets the run summary with the first results in {{1}} and the dataset link in {{2}} (a template with only {{1}} gets both in {{1}}). Empty: a plain text message, which WhatsApp delivers only when the recipient wrote to your business number in the last 24 hours, so a scheduled run usually needs a template. Meta charges your business account for template messages (step by step in the README, section "WhatsApp notifications: setup").

## `whatsappTemplateLanguage` (type: `string`):

Language code of the template exactly as WhatsApp Manager → Message templates shows it next to the template, e.g. en_US, en_GB, cs, sk, pl or de. Used only with "WhatsApp template name".

## `notificationLimit` (type: `integer`):

How many listings the message lists.

## `notifyOnlyChanges` (type: `boolean`):

No message after a run that saved nothing.

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

No proxy needed. If ImmoScout24 keeps refusing your runs, switch to Apify Proxy with the RESIDENTIAL group and country Germany; a run through a residential proxy may be charged a little more to cover its traffic.

## `exportFormats` (type: `array`):

Off by default. Printable HTML report: the results as a clean, branded table with the main columns, made for printing, saving as PDF or sending to someone; for working with the data use Excel or CSV, which have every field. Markdown table: the same columns as text for AI tools, docs or GitHub. The Output tab links the files. Each file has the overview columns of every saved row and nothing is left out, so a run with tens of thousands of rows makes a file of tens of MB that can be slow to open; for big runs use the dataset or its Excel export. Excel (XLSX), CSV and JSON are always in the Output tab and under Export, at no extra cost.

## `sendErrorReports` (type: `boolean`):

When a run fails, send the developer a short error report: the error and your input with secrets left out (tokens, webhooks and e-mails are hidden). Your results are never sent. Reports are deleted after at most 120 hours. Turn off to send nothing.

## Actor input object example

```json
{
  "searchLocations": [
    "Berlin"
  ],
  "realEstateType": "apartmentrent",
  "maxItems": 20,
  "sortBy": "newest",
  "priceIsWarmRent": false,
  "excludeNewBuildProjects": false,
  "onlyNewBuildings": false,
  "excludeSwapFlats": false,
  "commissionFree": false,
  "sellerType": "all",
  "onlyPlusListings": false,
  "includeDetails": false,
  "includeAgencyPhone": false,
  "includeContactPerson": false,
  "includeRentalYield": false,
  "includePriceHistory": false,
  "includeMarketReport": false,
  "includeAgencyDirectory": false,
  "language": "de",
  "compact": false,
  "onlyNewOrChanged": false,
  "monitoringEarlyStop": true,
  "onlyNew": false,
  "onlyPriceDrops": false,
  "includeRemovedListings": false,
  "skipFirstRun": false,
  "resetMonitoring": false,
  "whatsappTemplateLanguage": "en_US",
  "notificationLimit": 10,
  "notifyOnlyChanges": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "exportFormats": [],
  "sendErrorReports": true
}
```

# Actor output Schema

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

No description

## `summary` (type: `string`):

No description

## `marketReport` (type: `string`):

MARKET_REPORT: prices, prices per m² and a rent index by postcode, town and rooms.

## `agencyDirectory` (type: `string`):

AGENCY_DIRECTORY: the agencies of the saved listings with their business contacts.

## `agencyDirectoryCsv` (type: `string`):

The agency directory as a CSV file.

## `excel` (type: `string`):

All saved rows as an Excel file, with every field.

## `htmlReport` (type: `string`):

The saved rows with the main columns as a clean table to print, save as PDF or send; only when "Extra export formats" includes it. Excel has every field.

## `markdown` (type: `string`):

The saved rows as a Markdown table, handy for AI tools, docs and GitHub; only when "Extra export formats" includes Markdown.

# 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 = {
    "searchLocations": [
        "Berlin"
    ],
    "maxItems": 20,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("tsutseisoftware/immoscout24-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 = {
    "searchLocations": ["Berlin"],
    "maxItems": 20,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("tsutseisoftware/immoscout24-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 '{
  "searchLocations": [
    "Berlin"
  ],
  "maxItems": 20,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call tsutseisoftware/immoscout24-scraper --silent --output-dataset

```

## MCP server setup

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