# ImmobilienScout24 Scraper (`anyxsolutions/immobilienscout24-scraper`) Actor Scrapes rental and sale listings from ImmobilienScout24, Germany's largest property portal. Give it a search URL to collect every listing on the result pages, or a listing URL to get the full expose with prices, specs, energy data, photos, and the agency. - **URL**: https://apify.com/anyxsolutions/immobilienscout24-scraper.md - **Developed by:** [Anyx Solutions](https://apify.com/anyxsolutions) (community) - **Categories:** - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.99 / 1,000 results 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? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. - **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use). - **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`. - **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`. - **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`. - **Any other language** — the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![banner](generated) ## ImmobilienScout24 Scraper **Rental and sale listings from Germany's largest property portal — search results and full exposes as clean JSON.** Scrapes rental and sale listings from ImmobilienScout24, Germany's largest property portal. Give it a search URL to collect every listing on the result pages, or a listing URL to get the full expose with prices, specs, energy data, photos, and the agency. Built for rent-index research, portfolio monitoring, lead generation for relocation and property services, and market analysts who need structured German real-estate data without an API key. ### ⚡ Quick start ```json { "startUrls": [ { "url": "https://www.immobilienscout24.de/Suche/de/bayern/muenchen/wohnung-mieten" } ], "maxItems": 5 } ``` ### 🧩 Input | Field | Type | Required | Default | Description | | -------------------- | ------- | -------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `startUrls` | array | yes | — | immobilienscout24.de URLs to scrape. Search pages (`/Suche/de/bayern/muenchen/wohnung-mieten`) return every listing card; listing pages (`/expose/170265164`) return the full expose. | | `maxItems` | integer | no | `5` | Maximum number of listings to return per start URL. Search pages hold 20 listings each; the Actor stops paging once the limit is reached. | | `proxyConfiguration` | object | no | `{ "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "DE" }` | Apify proxy settings used for the run. The site runs a browser challenge on every page, so German residential proxies are the default. | ### 📤 Output Every result is one dataset row. The `itemType` field tells the two shapes apart: `search` for a listing card taken from a search result page (the complete listing record the site itself renders, with address, price, rooms, living space, photos, and realtor), and `property` for a full expose scraped from a listing page. #### Fields | Field | Type | Description | | ----------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------- | | `itemType` | string | `search` or `property`. | | `url` | string | Public listing URL. | | `@id` | string | Listing ID (search items). | | `@modification` | string | Last modification timestamp (search items). | | `@creation` | string | Creation timestamp (search items). | | `@publishDate` | string | Publication timestamp (search items). | | `realEstateId` | number | Numeric listing ID (search items). | | `disabledGrouping` | string | Whether grouped listings are disabled (search items). | | `resultlist.realEstate` | object | Full listing record: title, address with coordinates, price, living space, rooms, features, pictures, and realtor (search items). | | `id` | number | Listing ID (property items). | | `title` | string | Listing headline (property items). | | `description` | string | Short summary: type, rooms, size, and district (property items). | | `address` | string | Street and district, or the site's notice when the address is hidden (property items). | | `propertyLlink` | string | Canonical listing URL (property items). | | `propertySepcs` | object | Floor, living space, availability, rooms, parking, feature tags, and internet availability (property items). | | `price` | object | Base rent, price per m², utilities, heating, total rent, deposit, parking rent, and currency (property items). | | `building` | object | Construction year, energy sources, energy certificate, and final energy demand (property items). | | `attachments` | object | Photo URLs and whether a video is available (property items). | | `agencyName` | string | Realtor or landlord name (property items). | | `agencyAddress` | string | Realtor address, when published (property items). |
Example output ```json { "itemType": "property", "url": "https://www.immobilienscout24.de/expose/170265164", "id": 170265164, "title": "Erstbezug: Stilvolle 4-Zimmer-Wohnung", "description": "Mietwohnung (Wohnung/Miete): 4 Zimmer - 99,7 qm - Marie-Jucharcz-Straße 4, 80995 München, Feldmoching bei ImmobilienScout24 (Scout-ID: 170265164)", "address": "Marie-Jucharcz-Straße 4, Feldmoching, 80995 München", "propertyLlink": "https://www.immobilienscout24.de/expose/170265164", "propertySepcs": { "floorsNumber": "2 von 2", "livingSpace": "99,68 m²", "livingSpaceUnit": "Square Meter", "vacantFrom": "01.06.2026", "numberOfRooms": 4, "Garage/parking space": "1 Garage", "additionalSpecs": [ "Balkon/ Terrasse", "Keller", "Personenaufzug", "Stufenloser Zugang" ], "internetAvailable": true }, "price": { "priceWithoutHeadting": "1.993,60 €", "priceperMeter": "20 €/m²", "additionalCosts": "249,20 €", "heatingCosts": "119,62 €", "totalRent": "2.362,42 €", "basisRent": "1.993,60 €", "deposit": "4928", "garage/parkingRent": "90 €", "priceCurrency": "€" }, "building": { "constructionYear": 2026, "energySources": "Fernwärme", "energyCertificate": "liegt vor", "energyCertificateType": "Bedarfsausweis", "energyCertificateDate": 2026, "finalEnergyRrequirement": "59,4 kWh/(m²*a)" }, "attachments": { "propertyImages": [ "https://pictures.immobilienscout24.de/listings/d378b9c1-df2f-4476-b017-56953a6d0b4e-2080247411.png" ], "videoAvailable": false }, "agencyName": "BayernHeim GmbH", "agencyAddress": "" } ```
### 💡 Use cases - **Rent-index research** — track asking rents and price per m² across cities, districts, and property types over time. - **Portfolio and competitor monitoring** — watch specific listings or a realtor's inventory for price changes and availability. - **Lead generation** — collect realtor and landlord names from listings in a target area for relocation, mortgage, and moving services. - **Market analysis** — combine energy certificates, construction years, and features to segment the German housing stock. ### ❓ FAQ - **Do I need a proxy?** Yes. The site shows a bot challenge on every page, and German residential proxies clear it reliably, so they are the default. - **Which URLs are supported?** Any search result page under `/Suche/` (with filters, sorting, and paging) and any listing page under `/expose/`. - **How many results can I get?** `maxItems` caps listings per start URL. Add more start URLs, or split a search by district, to widen coverage. - **Why is the address sometimes a notice instead of a street?** Many advertisers hide the exact address; the site then shows a note that the full address is available from the provider. - **Why did a run return fewer items than expected?** The site may have changed its layout. Open an issue and we will update the Actor. ### 🔗 More scrapers by Anyx - [Kleinanzeigen Scraper](https://apify.com/anyxsolutions/kleinanzeigen-scraper) - [Homegate Scraper](https://apify.com/anyxsolutions/homegate-scraper) - [ImmoScout24 Scraper](https://apify.com/anyxsolutions/immoscout24-scraper) - [AutoScout24 Scraper](https://apify.com/anyxsolutions/autoscout24-scraper) - [Indeed Scraper](https://apify.com/anyxsolutions/indeed-scraper) ### 🤝 Anyx Solutions We build custom scrapers and data-extraction pipelines. - Email: tantosthor@gmail.com ### 🖼 Image credit Image credit: [immobilienscout24.de](https://www.immobilienscout24.de/) # Actor input Schema ## `startUrls` (type: `array`): immobilienscout24.de URLs to scrape. Search pages (https://www.immobilienscout24.de/Suche/de/bayern/muenchen/wohnung-mieten) return every listing card; listing pages (https://www.immobilienscout24.de/expose/170265164) return the full expose. ## `maxItems` (type: `integer`): Maximum number of listings to return per start URL. Search pages hold 20 listings each; the Actor stops paging once the limit is reached. ## `proxyConfiguration` (type: `object`): Apify proxy settings used for the run. The site runs a browser challenge on every page, so German residential proxies are the default. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.immobilienscout24.de/Suche/de/bayern/muenchen/wohnung-mieten" } ], "maxItems": 5, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "DE" } } ``` # Actor output Schema ## `overview` (type: `string`): No description # 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 = { "startUrls": [ { "url": "https://www.immobilienscout24.de/Suche/de/bayern/muenchen/wohnung-mieten" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("anyxsolutions/immobilienscout24-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.immobilienscout24.de/Suche/de/bayern/muenchen/wohnung-mieten" }] } # Run the Actor and wait for it to finish run = client.actor("anyxsolutions/immobilienscout24-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 '{ "startUrls": [ { "url": "https://www.immobilienscout24.de/Suche/de/bayern/muenchen/wohnung-mieten" } ] }' | apify call anyxsolutions/immobilienscout24-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,anyxsolutions/immobilienscout24-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 ` 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/BdE0OqJkRI3ObVtw9/builds/028GWP68sQYh6eWjk/openapi.json