Immowelt is a German real-estate portal with listings for sale and for rent. Immowelt Scraper (reventadata/immowelt-scraper) is the Apify Actor that reads its public search pages and returns one row per listing: price, size, rooms, district, energy class where published, agency and the phone numbers the agency published.

This tutorial runs the Actor from Python. The sample rows come from one example run of the Actor on 18 November 2026: ten apartments for sale in Berlin, from the first page of the search. Nothing in them is invented.

By the end you will have a short script that starts the Actor, waits for it, reads the rows and prints a summary line for each listing.

Prerequisites

You need three things:

  1. Python 3, with pip.
  2. A free Apify account, which you can create with an email address or a GitHub login.
  3. Your Apify API token, which the script reads from an environment variable.

Install the client and export the token:

pip install -U "apify-client~=3.0" export APIFY_API_TOKEN="your_apify_token_here" 

No scraping code is needed on your side. The Actor reads the public pages, and the proxy is handled for you.

What you'll achieve

You will search Immowelt for apartments to buy in Berlin, take the first page of results capped at ten listings, read the rows in Python and print a summary for each one.

The same input works for other places. Set transaction to rent for rental listings, and give location a city name, Deutschland for the whole country, or an immowelt place id such as AD08DE8634.

Each row also carries the agency name, the phone numbers the agency published and the listing link, so you can follow up on a listing straight from the output.

You will also see which fields came back empty in this run, so you know what to expect from the rows.

Step 1: Open Immowelt Scraper

The Immowelt Scraper page on the Apify Store describes the Actor's inputs and output. This tutorial calls the Actor from the API, so the only name you need is reventadata/immowelt-scraper.

Step 2: Choose the search

The search is described by a few input fields:

  • transaction: buy or rent. Any other value is refused before the run starts.
  • propertyType: apartment or house. Any other value is refused before the run starts.
  • location: a city name as immowelt.de writes it, such as Berlin, München or Frankfurt am Main, Deutschland for the whole country, or a place id such as AD08DE8634. A name the site does not know stops the run with an error.
  • maxPrice: optional, in EUR. On a rent search it limits the monthly rent. Left out when empty.
  • sortBy: relevance (the site's own order) or priceAsc (cheapest first). Any other value is refused before the run starts.
  • includeAuctions: buy searches only. Off by default. When on, auction and compulsory-auction listings are included.
  • maxItems: the cap on rows, 1000 by default.
  • maxPages: the cap on result pages. A page holds 30 listings for apartments and 40 for houses.

This tutorial's run uses transaction buy, propertyType apartment, location berlin, maxItems 10 and maxPages 1: one page of results, cut to ten rows.

{ "transaction": "buy", "propertyType": "apartment", "location": "berlin", "maxItems": 10, "maxPages": 1 } 

Step 3: Run it from Python

This script starts the Actor, waits for it, reads the dataset and prints two lines per listing:

import os from apify_client import ApifyClient # 1. Initialise the client with your token from the environment client = ApifyClient(os.environ["APIFY_API_TOKEN"]) # 2. Describe the search: apartments to buy in Berlin, one page, 10 rows run_input = { "transaction": "buy", "propertyType": "apartment", "location": "berlin", "maxItems": 10, "maxPages": 1, } # 3. Start the Actor and wait for it to finish run = client.actor("reventadata/immowelt-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}).") # 4. Read the rows from the run's default dataset items = client.dataset(run.default_dataset_id).list_items().items print(f"Retrieved {len(items)} listings.\n") # 5. Print two lines per listing for item in items: print(f"{item['price']} EUR, {item['areaM2']} m2, {item['rooms']} rooms, {item['district']}") print(f" {item['agencyName']} | {item['url']}") 

Run with the input above, it prints two lines per listing.

Here is one complete row from the run, the first listing, with imageUrls cut to its first entry and the searchUrl field left out:

{ "id": "256Q14GY2JL7", "legacyId": "1215b46c-9e03-4081-bc72-67209544ff9f", "url": "https://www.immowelt.de/expose/1215b46c-9e03-4081-bc72-67209544ff9f", "title": "Wohnung zum Kauf", "headline": "Sehr gepflegte 2-Zimmer-Wohnung mit ansprechenden Wohnraum und nützlichem Kellerraum", "descriptionSnippet": "Diese charmante und gepflegte Etagenwohnung bietet eine ideale Gelegenheit für Immobilieninvestoren oder Eigennutzer. Mit einer Wohnfläche von 45 m² präsentiert sich diese Immobilie in einem hervorra...", "transaction": "buy", "propertyType": "APARTMENT", "propertySubType": null, "price": 170000, "currency": "EUR", "priceOnRequest": false, "pricePerSquareMeter": 3778, "coldRent": null, "warmRent": null, "areaM2": 45, "plotAreaM2": null, "rooms": 2, "bedrooms": null, "floor": "3 Geschosse", "availableFrom": "frei ab 01.02.2027", "energyClass": "D", "street": "Wendenschloßstraße", "zipCode": "12557", "city": "Berlin", "district": "Köpenick", "addressPublished": true, "listedAt": "2025-12-01T09:01:14.95Z", "updatedAt": "2026-11-17T12:27:32.784Z", "hasBrokerageFee": false, "isNew": true, "hasFloorPlan": false, "hasVirtualTour": false, "hasVideo": false, "imageUrl": "https://mms.immowelt.de/3/2/9/9/329954f0-f004-47bc-ba98-2b821cb41256.jpg", "imageUrls": [ "https://mms.immowelt.de/3/2/9/9/329954f0-f004-47bc-ba98-2b821cb41256.jpg" ], "sellerType": "PROFESSIONAL", "publisherType": "AGENCY", "agencyName": "Immobilien Konzept", "agencyProfileUrl": "https://www.immowelt.de/profil/02d166243f7d43cc95210d5429f9cadd", "agencyWebsite": "http://www.immobilienkonzept-amberg.de/", "agencyAddress": "Schrannenplatz 6, 92224 Amberg", "contactName": "Herr Andreas Kiener", "phoneNumbers": [ "09621 1770799", "0173 3976 814" ] } 

Understanding your results

Each row carries 45 fields. The ones you will use most:

  • price: the asking price in EUR. On a rental row it is the cold rent (Kaltmiete). When a listing has no price, priceOnRequest is true and price is null, not 0.
  • coldRent and warmRent: the rent figures on a rental listing, when the listing shows them.
  • areaM2, rooms, bedrooms, floor, energyClass: size, room count, bedrooms, floor and energy class as the listing publishes them.
  • street, zipCode, city, district: the address. street is filled only when addressPublished is true.
  • pricePerSquareMeter: the price per square metre, as the listing states it.
  • agencyName, agencyProfileUrl, agencyWebsite, phoneNumbers: the agency and the phone numbers it published.
  • imageUrls: the photo links of the listing.

In this run, propertySubType, coldRent, warmRent and plotAreaM2 are empty on all 10 rows. street is empty on 2 rows, and both have addressPublished set to false. bedrooms is empty on 2 rows, availableFrom on 5 and energyClass on 1.

Pro tips

  1. Put maxPrice in the search. It is sent to immowelt.de with the search, so listings above it are not returned.
  2. Use sortBy priceAsc for cheapest first. The default relevance is the site's own order.
  3. Read pricePerSquareMeter instead of computing it. The value comes from the listing's own text. In this run all 10 rows carry one.
  4. Keep test runs small. maxItems and maxPages cap the rows and the pages fetched. Start with the input above and raise them once the script works.
  5. Mind the ceiling. A search returns at most 9,990 results. The run logs a warning when a search is bigger; split it by city, by district or by maxPrice bands.
  6. Check addressPublished before you use street. The street is filled only when the listing publishes its address. In this run two of the ten rows had no street, and both had addressPublished set to false.

Troubleshooting

  • Zero rows, status SUCCEEDED. The search matched nothing. The run's status message says so.
  • Zero rows, status FAILED. A location the site does not know, or pages that could not be read, end the run with the reason. Fix the input and run again.
  • Fewer rows than expected. The run log ends with Skipped N: reason lines and Pushed N row(s).. A listed entry without data is counted as skipped.
  • Empty fields. A field the listing does not carry is null or an empty list, not a missing key. In this run every row had at least one photo and one phone number.

Next steps

Change the input and run the script again, for another city, for rentals, or with a higher maxItems.

Immowelt Scraper is not affiliated with immowelt. Check that your use of the data complies with the site's terms and with data-protection law.

For current pricing and details, see the Store page.

What are you planning to search for on Immowelt? Drop a comment!

About the author: reventadata builds and publishes data extraction Actors on the Apify Store.