# Germany Real Estate Scraper ($0.80/1K) (`carabain-digital/germany-real-estate`) Actor Search ImmoScout24 and Immowelt at once for Wohnungen and HΓ€user in Germany. One search, one dataset: merged, deduplicated on postcode and house number, newest first. Optional full details and price history. Residential proxy included. Export to JSON, CSV or Excel. - **URL**: https://apify.com/carabain-digital/germany-real-estate.md - **Developed by:** [Carabain Digital](https://apify.com/carabain-digital) (community) - **Categories:** Real estate, Lead generation - **Security:** Limited permissions - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.48 / 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 ### What is Germany Real Estate Scraper? **Germany Real Estate Scraper** searches **two property portals in Germany with one query** (ImmoScout24 and Immowelt) and returns one clean dataset of Immobilien (Wohnungen and HΓ€user): **merged, deduplicated across sites and sorted newest first**. Export as JSON, CSV or Excel. Costs **$0.80 per 1,000 listings**; full details are an add-on at $2 per 1,000 and price history at $1 per 1,000. A residential proxy is built in. - 🌍 **2 sites, one run**: ImmoScout24 and Immowelt are searched in parallel, usually in seconds for 100 listings - 🧹 **Cross-site dedup**: the same home on several portals (same postcode, house number and listing type) appears once, with an `also_on` list of the other sites - πŸ“… **Newest first** across all sites, with a total **Max listings** cap and an optional cap per site - 🎯 **Pick the sites** you want under **Sites** - πŸ›‘οΈ **A blocked or failing site never fails the run**: it is retried on a fresh proxy session, then skipped and logged; the others still deliver - πŸ“ˆ **Optional price history**: the same shared store as our single-site Actors - πŸ€– **Agent friendly**: one flat schema for all sites, works through the Apify MCP server #### Which sites are included? | Site | Country | Single-site Actor | Default | Notes | |---|---|---|---|---| | [ImmoScout24](https://www.immobilienscout24.de) | Germany | [immoscout24-listings](https://apify.com/carabain-digital/immoscout24-listings) | yes | Largest German portal; German residential proxy; filters use ImmoScout24's own location box (districts, no postcodes) | | [Immowelt](https://www.immowelt.de) | Germany | [immowelt-listings](https://apify.com/carabain-digital/immowelt-listings) | yes | At most 10,000 results per search; DataDome protected, so a few proxy exits are refused and retried on a fresh one | **Results per site are capped by each site, not by this Actor** (ImmoScout24 and Immowelt (10,000 per search)). Asking for more returns what the site offers. #### What data can I extract?
πŸ†” Stable listing ID, source site and URLπŸ’Ά Asking price or monthly rent
πŸ“ Address, postcode, city, region, country🏠 Property type, listing type and status
πŸ“ Living area and plot areaπŸ› Rooms and bedrooms
⚑ Energy labelπŸ“… Date listed
πŸ§‘β€πŸ’Ό Agent name, phone and link (where the site shows them)πŸ–Ό Photos
πŸ” also_on: other sites with the same homeπŸ“– Description, coordinates, build year (add-on)
Every site fills what it has; the rest is `null`. Site-specific extras are kept as extra fields. #### How do I scrape German real estate? 1. [Create a free Apify account](https://console.apify.com/sign-up) and open this Actor. 2. Enter a **Location** (for example `Berlin`) and choose **For sale** or **For rent**. 3. Optionally set price, property type, rooms, living area and **Max listings**. 4. Optionally change **Sites**, and switch on **Full details** and/or **Price history**. 5. Click **Start** and download the listings from the **Output** tab as JSON, CSV, Excel, XML or HTML. ### How much does it cost to scrape German property sites? You **pay per home** that ends up in your dataset: **$0.80 per 1,000 unique listings**, after duplicates are removed. No subscription, the proxy is included. - **Add-on: Full details, $2.00 per 1,000** listings, **off by default**. Charged only for listings that were actually enriched. One price for both sites, while the single-site Actors charge $1 each. - **Add-on: Price history, $1.00 per 1,000** listings, **off by default**. Charged only for listings that already had history (the first run is free). - The monthly credit of Apify's free plan covers thousands of listings. - You are charged for the listings in the dataset, not for the (more numerous) listings fetched before deduplication and the **Max listings** cut. Set a maximum cost per run in the run options. ### Input See the **Input** tab for all options. The shared fields are the same as in our single-site real-estate Actors, except Start URLs (they are site-specific: for those use the single-site Actors). | Field | Description | |---|---| | **Location** (`location`) | City or postcode, sent to every selected site. Commas run separate searches | | **Listing type** (`listing_type`) | `sale` (default) or `rent` | | **Min / Max price** (`min_price`, `max_price`) | Asking price, or rent per month, in euro | | **Property type** (`property_type`) | `any`, `house`, `apartment`, `land`, `commercial`, `parking`, `room` | | **Min rooms** (`min_rooms`) | At least this many rooms | | **Min living area** (`min_living_area_m2`) | At least this many m2 | | **Sites** (`sites`) | `immoscout24`, `immowelt` (default: `immoscout24`, `immowelt`) | | **Max listings** (`limit`) | Cap on the merged dataset; every site gets a fair share | | **Max listings per site** (`limit_per_site`) | Optional cap per site (default: Max listings) | | **Full details** (`includeDetails`) | Paid add-on: detail page data | | **Price history** (`trackHistory`, `historyStoreName`) | Paid add-on: history in your own named store | | **Proxy** (`proxyConfiguration`) | Apify RESIDENTIAL, country DE by default; the Actor applies it only to the sites that need it | Example input: ```json { "location": "Berlin", "listing_type": "rent", "max_price": 1500, "limit": 100 } ``` #### Location All sites are in Germany, so one location works everywhere. The Actor sends it to **every selected site as is**: - **Several places**: a comma list runs one search per place on every site (the per-site limit is divided over the places). A place that a site rejects is skipped for that site. - **No location** means everything on the selected sites. Country names are not accepted as location. - If **every** selected site rejects the input, the run fails with an input error so you notice. - Some filters differ per site: ImmoScout24 has no `commercial`, Immowelt no `room`, ImmoScout24 does not take postcodes; a site that does not know the filter is skipped. ### Output Listings are stored in the default dataset, one item per unique home. Export them as JSON, CSV, Excel, XML or HTML. Every site uses the same field names (`id` is `:`). Example (shortened): ```json { "id": "immoscout24:123456789", "source": "immoscout24", "url": "https://www.immobilienscout24.de/expose/123456789", "title": "Helle 2-Zimmer-Wohnung in Prenzlauer Berg", "listing_type": "rent", "property_type": "apartment", "status": "available", "price": 1350, "price_currency": "EUR", "price_period": "month", "postcode": "10405", "city": "Berlin", "country": "DE", "living_area_m2": 58, "rooms": 2, "listed_at": "2026-10-31T08:12:00Z", "scraped_at": "2026-10-31T09:00:01Z", "also_on": [ "immowelt" ] } ``` (shortened; all real-estate fields are present, `null` when the site has none. Values above are illustrative.) `status` is `available`, `under_offer`, `sold` or `rented`. #### How duplicates are removed Two listings are the same home when they have the same **postcode**, **house number (with addition)** and **listing type** (sale or rent), on different sites. The first one is kept (order: ImmoScout24, Immowelt) and the other sites go in `also_on`. Listings without postcode or house number are never merged, and two listings of the same site are never merged (flats in one building). #### Sorting With **Max listings**, every site gets a fair share: listings are taken in turns from each site (each in its own newest-first order), so sites without exact dates are not pushed out. The result is then sorted newest first by `listed_at`; items without a date keep their site order. #### Price history: track price and status changes Switch on **Price history** (`trackHistory`) to follow listings over time. The Actor keeps a small history record per listing in a **named key-value store in your own Apify account** (default name `realestate-history`; change it with `historyStoreName`). We run no database and hold none of your data. - **Shared with the single-site Actors.** Our single-site real-estate Actors use the same default store name and listing IDs, so a listing tracked there continues its series here, and the other way round. - **The first run starts the series.** Listings seen for the first time are not charged for the add-on. - **Every later run** adds `first_seen_at`, `previous_price`, `price_change`, `price_change_pct`, `status_changed` and `price_history` (the last 20 points) to each listing you saw before. - **History runs once over the merged list**, after deduplication, so a home on two sites is tracked under the site it was kept from. - **Do not run two runs on the same store at the same time**: the last writer wins per record. If you delete the store, history silently starts empty. ### What can I do with German real estate data? - πŸ“ˆ **Market research**: compare asking prices and rents per city and portal - πŸ”” **Alerts and feeds**: new listings and price drops to Slack, e-mail or your own site - 🏒 **Investors and agents**: find new listings, compare price per m2, benchmark competitors - 🧠 **AI and analytics**: feed listing data into valuation models ### Tips for best results - Both sites are fast; 100 listings usually take a few seconds. Immowelt may need a retry on a fresh proxy exit, which the Actor does for you. - Use a district name for ImmoScout24 (it does not take postcodes); with a postcode, only Immowelt answers. - For a daily feed, schedule a run with a high **Max listings** and **Price history** on. - Need a search URL you built on one site? Use that site's own Actor ([immoscout24-listings](https://apify.com/carabain-digital/immoscout24-listings), [immowelt-listings](https://apify.com/carabain-digital/immowelt-listings)); this Actor takes filters, not URLs. ### Frequently asked questions #### Can I use Germany Real Estate Scraper with the Apify API? Yes. Use the [Apify API](https://docs.apify.com/api/v2) or the Apify clients. Python: ```python from apify_client import ApifyClient client = ApifyClient("") run = client.actor("carabain-digital/germany-real-estate").call(run_input={"location": "Berlin", "listing_type": "rent", "max_price": 1500, "limit": 100}) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item["source"], item["title"]) ``` #### Can I use Germany Real Estate Scraper through an MCP server or with AI agents? Yes. Add the [Apify MCP server](https://mcp.apify.com) to your AI agent (Claude, ChatGPT, Cursor and others) and let it call `carabain-digital/germany-real-estate` with `call-actor`. The input is small and every field has a description, so an agent can fill it from a request such as "find the 20 newest apartments for rent in Berlin" (`location`, `listing_type`, `property_type`, `limit`). A small run finishes in seconds; the agent then reads the dataset with `get-dataset-items`. Add-ons are off by default, so an agent pays only the base price unless it asks for more. #### Can I integrate the data with other apps? Yes: Make, Zapier, Google Sheets, Slack, Airbyte and webhooks, via Apify's [integrations](https://apify.com/integrations). #### Why are there fewer listings than Max listings? Each site returns what matches your search, duplicates across sites are removed, and sites that do not know a filter are skipped. A narrow search or a site's own ceiling can leave you with fewer. #### Why does one site return nothing? Either it has no match for your search, or it was blocked and skipped after retries. The run log lists skipped sites. If **all** selected sites fail, the run fails so you notice. Try again later or open an issue. #### Is it legal to scrape property portals? The Actor only collects publicly visible listing data. Listings can contain personal data (for example an agent's name or phone number), and rules such as GDPR may apply to how you store and use it. Check your use case with a lawyer. See also [Is web scraping legal?](https://blog.apify.com/is-web-scraping-legal/) #### Germany Real Estate Scraper not working? / Feedback Open an issue in the **Issues** tab of this Actor with the run link and the input you used; I usually answer within a few days. ### Other scrapers by us The two single-site Actors behind this one are linked in the table above: [immoscout24-listings](https://apify.com/carabain-digital/immoscout24-listings), [immowelt-listings](https://apify.com/carabain-digital/immowelt-listings). They are cheaper per home when you need one site only, and take search URLs. ⭐ **Does it work well for you?** A review on the Store page helps others find this Actor and helps us keep it maintained. # Actor input Schema ## `location` (type: `string`): German city, district, state or postcode, sent to both sites. Several places separated by commas run as separate searches. Example: `Berlin`, `Hamburg, Potsdam` or `Bayern`. ImmoScout24 does not take postcodes (it skips them), Immowelt does. Leave empty for all of Germany. ## `listing_type` (type: `string`): Search homes `rent` or `sale`. Example: `rent`. ## `min_price` (type: `integer`): Lowest asking price in euro (rent per month for rentals). Example: `1000` (rent) or `250000` (sale). ## `max_price` (type: `integer`): Highest asking price in euro (rent per month for rentals). Example: `2000` (rent) or `500000` (sale). ## `property_type` (type: `string`): Only this type of property. Example: `apartment`. `any` returns every type. A site that does not know the type (ImmoScout24 has no `commercial`, Immowelt no `room`) is skipped. ## `min_rooms` (type: `integer`): Only homes with at least this many rooms (German count: ImmoScout24 excludes kitchen and bathroom; Immowelt counts half rooms). Example: `2`. ## `min_living_area_m2` (type: `integer`): Only homes with at least this living area in square metres. Example: `60`. ## `sites` (type: `array`): Which sites to search. Default: all of them. Example: `["immoscout24", "immowelt"]`. ## `limit` (type: `integer`): Cap on the merged dataset, newest first. Example: `100`. ## `limit_per_site` (type: `integer`): Optional cap per site, to keep the mix balanced and browser sites short. Default: Max listings. Example: `25`. ## `includeDetails` (type: `boolean`): Also open each listing's detail page on ImmoScout24 and Immowelt: description, features, coordinates (when the exact address is public), construction year, energy certificate data, agent and all photos. Adds $2.00 per 1,000 listings that were actually enriched. Runs take a little longer. ## `trackHistory` (type: `boolean`): Keep a price and status history per listing in a named storage in your own account and add `first_seen_at`, `previous_price`, `price_change`, `price_change_pct`, `status_changed` and `price_history` to every listing you have scraped before. The history store is shared with our single-site real-estate Actors. Adds $1.00 per 1,000 listings that already had history (the first run only starts the series). Do not run two runs on the same store at once. ## `historyStoreName` (type: `string`): Name of the key-value store that holds the history (a-z, 0-9 and dashes). Use the same name in all our real-estate Actors to share one history. Example: `realestate-history`. ## `proxyConfiguration` (type: `object`): Keep Apify RESIDENTIAL (the default). Both ImmoScout24 and Immowelt block datacenter IPs; the Actor sets the exit country to Germany. ## Actor input object example ```json { "location": "Berlin", "listing_type": "rent", "property_type": "any", "sites": [ "immoscout24", "immowelt" ], "limit": 20, "includeDetails": false, "trackHistory": false, "historyStoreName": "realestate-history", "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } } ``` # Actor output Schema ## `listings` (type: `string`): All listings from the selected sites, merged and deduplicated, newest first. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "location": "Berlin", "listing_type": "rent", "sites": [ "immoscout24", "immowelt" ], "limit": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } }; // Run the Actor and wait for it to finish const run = await client.actor("carabain-digital/germany-real-estate").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "location": "Berlin", "listing_type": "rent", "sites": [ "immoscout24", "immowelt", ], "limit": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "DE", }, } # Run the Actor and wait for it to finish run = client.actor("carabain-digital/germany-real-estate").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 '{ "location": "Berlin", "listing_type": "rent", "sites": [ "immoscout24", "immowelt" ], "limit": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } }' | apify call carabain-digital/germany-real-estate --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,carabain-digital/germany-real-estate" } } } ``` 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 ` 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/xrLx5hIMGB006W2Vr/builds/rmqk8wdVfGn7nL5TO/openapi.json