DEV Community

Cover image for How to Scrape German Real Estate Listings with ImmoScout24 Scraper
ReventaData
ReventaData

Posted on Edited on Originally published at apify.com

How to Scrape German Real Estate Listings with ImmoScout24 Scraper

By the end of this tutorial you will have a Python script that turns an ImmoScout24 search, for example Berlin apartments to rent under 1,500 EUR, into structured rows: price, living space, rooms, address, coordinates, the agent behind the listing and the phone number they published.

ImmoScout24 (immobilienscout24.de) is a German real-estate portal. Copying listings by hand does not scale: a capture of the Berlin rent search dated 2026-11-07 reports 13,833 hits spread over 662 result pages. The Apify Actor ImmoScout24 Scraper (reventadata/immobilienscout24-scraper) does the page reading for you, and you call it from Python.

Unofficial. This Actor is not affiliated with, endorsed by or connected to ImmoScout24 or Scout24.


Prerequisites

You need Python 3.11 or newer (apify-client 3.x requires it), an Apify account and an API token from API & Integrations in Apify Console. Install the client:

pip install -U "apify-client~=3.0"
Enter fullscreen mode Exit fullscreen mode

Put the token in an environment variable so it never lands in your code:

export APIFY_API_TOKEN="your_apify_token_here"
Enter fullscreen mode Exit fullscreen mode

What you'll achieve

You will run one search, rent or buy, apartment or house, for one German city, and get one dataset row per listing. Each row carries the price, living space, rooms, postal address, coordinates when the seller shows the exact address, energy class, feature tags, photo links and the agent's company, contact name and phone.

The result is a dataset you can export or read through the API, one row per listing, with the same field names every time.

Example use case: you are looking at Berlin apartments to rent with at most 1,500 EUR base rent and at least 50 m², and you want them ranked by rent per square metre. The last step does exactly that.


Step 1: Open the Actor

Open the ImmoScout24 Scraper page on Apify Store. It lists the input fields and the output. This tutorial drives the Actor from Python, so you only need its name: reventadata/immobilienscout24-scraper.


Step 2: Configure the search

There are two ways to describe a search.

  • A place. Fill state and city with the slugs from an ImmoScout24 address (berlin and berlin, bayern and muenchen, hessen and frankfurt-am-main), then pick listingType (rent or buy) and propertyType (apartment or house). A value outside those lists is refused before the run starts.
  • A pasted URL. Put an ImmoScout24 search address in startUrls. Supported are /Suche/de/<state>/<city>/ followed by wohnung-mieten, wohnung-kaufen or haus-kaufen, with the price, livingspace, numberofrooms and sorting filters the site writes into the address.

Here is the first way, with numeric limits:

import os
from apify_client import ApifyClient

client = ApifyClient(os.environ["APIFY_API_TOKEN"])

run_input = {
    "state": "berlin",
    "city": "berlin",
    "listingType": "rent",
    "propertyType": "apartment",
    "maxPrice": 1500,
    "minLivingSpaceM2": 50,
    "includeGroupedListings": False,
    "maxItems": 50,
    "maxPages": 3,
}
Enter fullscreen mode Exit fullscreen mode

maxPrice and minLivingSpaceM2 are applied by the Actor after a page is fetched, and a listing that lacks the value is dropped. maxItems caps the rows saved, and maxPages caps the result pages walked per search.


Step 3: Optional settings

The second way hands the filtering to the site itself, which is the better choice when you have already built the search in your browser:

run_input = {
    "startUrls": [
        {"url": "https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten?price=1000.0-1500.0&livingspace=50.0-80.0"}
    ],
    "includeGroupedListings": False,
    "maxPages": 2,
}
Enter fullscreen mode Exit fullscreen mode

includeGroupedListings is on by default. The site folds the other units of a new-build project under one card; the Actor saves them as separate rows with groupedUnderId set. Setting it to False, as in both snippets, keeps only the cards.


Step 4: Run it and read the rows

Call the Actor and read the dataset. call() waits until the run ends.

run = client.actor("reventadata/immobilienscout24-scraper").call(run_input=run_input)
if run is None or run.status != "SUCCEEDED":
    status = run.status if run else "unknown"
    raise SystemExit(f"Run did not succeed (status: {status}).")

items = client.dataset(run.default_dataset_id).list_items().items
print(f"Retrieved {len(items)} listings.\n")
Enter fullscreen mode Exit fullscreen mode

Then print what you got:

for item in items:
    size = f'{item.get("livingSpaceM2")} m²' if item.get("livingSpaceM2") else "size not stated"
    print(f'{item.get("price")} {item.get("currency")} | {size} | {item.get("rooms")} rooms | {item.get("postcode")} {item.get("quarter")}')
    print(f'  {item.get("title")}')
    print(f'  {item.get("url")}')
    phone = item.get("contactPhone") or item.get("contactMobile") or "no phone published"
    print(f'  {item.get("realtorCompanyName") or "no company shown"} | {phone}')
Enter fullscreen mode Exit fullscreen mode

Here is one row from the sample rows from a run on 2026-11-10 (Hamburg apartments to rent, minRooms: 2, maxPrice: 1500), with the photos list shortened to two entries:

{
    "id": "171310471",
    "url": "https://www.immobilienscout24.de/expose/171310471",
    "listingType": "rent",
    "propertyType": "apartment",
    "realEstateType": "ApartmentRent",
    "title": "Erstbezug nach DG-Neuaufbau – Wunderbare - 2 -Zimmer-Wohnung zu vermieten",
    "street": "Kurvenstr.",
    "houseNumber": "10d",
    "postcode": "22043",
    "city": "Hamburg",
    "quarter": "Marienthal",
    "locationText": "Kurvenstr. 10d, Marienthal, Hamburg",
    "latitude": 53.56681,
    "longitude": 10.07373,
    "hasPreciseAddress": true,
    "price": 1015,
    "currency": "EUR",
    "priceInterval": "MONTH",
    "totalRent": 1135,
    "livingSpaceM2": 45.26,
    "plotAreaM2": null,
    "rooms": 2,
    "constructionYear": 1948,
    "hasBalcony": false,
    "hasBuiltInKitchen": true,
    "hasGarden": false,
    "hasLift": null,
    "hasCellar": null,
    "hasGuestToilet": null,
    "isBarrierFree": null,
    "hasBuyerCommission": null,
    "energyEfficiencyClass": "A+",
    "hasEnergyCertificate": true,
    "fairPriceRating": null,
    "isPrivateOffer": false,
    "hasFloorplan": true,
    "hasVideo": false,
    "hasVirtualTour": null,
    "features": [
        "Einbauküche",
        "Keller"
    ],
    "realtorCompanyName": "Voigt und König Immobilienverwaltungs GmbH",
    "realtorId": "136907945",
    "contactSalutation": "MALE",
    "contactFirstName": "F. König - ",
    "contactLastName": "Voigt und König Immobilienverwaltungs GmbH ",
    "contactCompany": "Voigt und König Immobilienverwaltungs GmbH",
    "contactPhone": "040 89979767",
    "contactMobile": null,
    "photos": [
        "https://pictures.immobilienscout24.de/listings/ae6fc300-863f-40cf-a61c-9960081c2359-2126632276.png/ORIG/legacy_thumbnail/800x600/format/webp/quality/50",
        "https://pictures.immobilienscout24.de/listings/36cc0971-ab59-4aa9-952f-f4f38ee45a9f-2126632282.png/ORIG/legacy_thumbnail/800x600/format/webp/quality/50"
    ],
    "floorplans": [],
    "projectId": null,
    "projectName": null,
    "projectUrl": null,
    "groupedUnderId": null,
    "publishedAt": "2026-11-08T17:47:08.000+01:00",
    "createdAt": "2026-11-08T17:47:08.000+01:00",
    "modifiedAt": "2026-11-08T17:48:02.559+01:00",
    "searchUrl": "https://www.immobilienscout24.de/Suche/de/hamburg/hamburg/wohnung-mieten",
    "scrapedAt": "2026-11-10T19:52:32+00:00"
}
Enter fullscreen mode Exit fullscreen mode

Understanding your results

  • price is the base rent per month on rent searches (priceInterval is MONTH) and the purchase price on buy searches. totalRent is the calculated total rent when the site shows one; the sample row has both.
  • livingSpaceM2, rooms and, for houses, plotAreaM2 are numbers.
  • Yes/no fields such as hasBalcony, hasLift or hasCellar are null when the listing does not say, not false.
  • latitude and longitude come with the exact address. In the capture, 19 of the 20 cards carry coordinates.
  • contactPhone and contactMobile are the numbers the seller published in the results list. In the capture, 8 of the 20 cards carry one. The Actor does not open listing pages.
  • groupedUnderId is null for a card and holds the card's id for a unit folded under it.
  • photos are links filled in at 800x600.
  • realtorCompanyName, contactFirstName and contactLastName name the agent and the contact the listing shows.
  • url opens the listing on the site.

Pro tips

  1. Mind the grouped units. Page 1 of that capture holds 20 cards and 205 grouped units, so 225 rows for one page if you leave includeGroupedListings on.
  2. Filter on the site when you can. A URL filter shrinks what is fetched; minPrice, maxPrice, minLivingSpaceM2, maxLivingSpaceM2, minRooms and maxRooms only drop rows afterwards.
  3. Start small. maxItems defaults to 100 and maxPages to 50. The input description warns that a page can take 15 to 45 seconds, so try maxPages: 1 first.
  4. Rank your own way. This reads the rows from the run above and sorts by rent per square metre:
priced = [i for i in items if i.get("price") and i.get("livingSpaceM2")]
priced.sort(key=lambda i: i["price"] / i["livingSpaceM2"])
for i in priced[:5]:
    print(f'{i["price"] / i["livingSpaceM2"]:.1f} EUR/m² | {i["url"]}')
Enter fullscreen mode Exit fullscreen mode
  1. Ids are unique. A listing that moves between pages while the run walks is saved once.
  2. Mind the caps. Both maxItems and maxPages stop the run, whichever limit is reached first.

Troubleshooting

  • Zero rows. If the site answers but nothing matches (or your limits drop everything), the run ends SUCCEEDED with a status message and an empty dataset. If pages could not be read and no row was saved, the run is marked FAILED with the reason.
  • Unknown city slug. With no rows saved, the run ends FAILED with a slug message (after earlier rows, it logs a warning). Copy both slugs from a search address.
  • Houses for rent. The input allows rent with house, but the Actor stops with a message: only apartments for rent, apartments for sale and houses for sale are offered.
  • A price of 0. In the capture, 2 of the 29 rows on the Berlin houses-for-sale page 2 carry a price of 0 in the site's data and the Actor passes it on. Set minPrice to 1 to drop such rows.

Pricing and Next Steps

For current pricing and details, see the Store page.

To repeat a search automatically, save it as a task and attach an Apify schedule, which starts an Actor on a cron expression. The Apify Python client docs cover the rest of the API.

What would you track on ImmoScout24: rents in one city, houses for sale, or an agent's listings? Drop a comment below.

Top comments (0)