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"
Put the token in an environment variable so it never lands in your code:
export APIFY_API_TOKEN="your_apify_token_here"
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
stateandcitywith the slugs from an ImmoScout24 address (berlinandberlin,bayernandmuenchen,hessenandfrankfurt-am-main), then picklistingType(rentorbuy) andpropertyType(apartmentorhouse). 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 bywohnung-mieten,wohnung-kaufenorhaus-kaufen, with theprice,livingspace,numberofroomsandsortingfilters 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,
}
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,
}
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")
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}')
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"
}
Understanding your results
-
priceis the base rent per month on rent searches (priceIntervalisMONTH) and the purchase price on buy searches.totalRentis the calculated total rent when the site shows one; the sample row has both. -
livingSpaceM2,roomsand, for houses,plotAreaM2are numbers. - Yes/no fields such as
hasBalcony,hasLiftorhasCellararenullwhen the listing does not say, notfalse. -
latitudeandlongitudecome with the exact address. In the capture, 19 of the 20 cards carry coordinates. -
contactPhoneandcontactMobileare 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. -
groupedUnderIdisnullfor a card and holds the card's id for a unit folded under it. -
photosare links filled in at 800x600. -
realtorCompanyName,contactFirstNameandcontactLastNamename the agent and the contact the listing shows. -
urlopens the listing on the site.
Pro tips
-
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
includeGroupedListingson. -
Filter on the site when you can. A URL filter shrinks what is fetched;
minPrice,maxPrice,minLivingSpaceM2,maxLivingSpaceM2,minRoomsandmaxRoomsonly drop rows afterwards. -
Start small.
maxItemsdefaults to 100 andmaxPagesto 50. The input description warns that a page can take 15 to 45 seconds, so trymaxPages: 1first. - 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"]}')
- Ids are unique. A listing that moves between pages while the run walks is saved once.
-
Mind the caps. Both
maxItemsandmaxPagesstop 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
rentwithhouse, 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
minPriceto 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)