# Immobilienscout24 Property Search Scraper (`ecomscrape/immobilienscout24-property-search-scraper`) Actor

Immobilienscout24 Property Search Scraper - Extract German real estate data automatically. Get property listings with prices, square meters, room count, addresses, contact info & energy ratings in JSON format. Perfect for real estate analysis, market research & property investment tools.

- **URL**: https://apify.com/ecomscrape/immobilienscout24-property-search-scraper.md
- **Developed by:** [ecomscrape](https://apify.com/ecomscrape) (community)
- **Categories:** Real estate, Developer tools, Automation
- **Stats:** 45 total users, 1 monthly users, 100.0% runs succeeded, 3 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-usage

## 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

## Contact

If you encounter any issues or need to exchange information, please feel free to contact us through the following link:
[My profile](https://apify.com/ecomscrape)

## Guide (English version)

### immobilienscout24 Property Search Scraper: Extract German Real Estate Data Efficiently

### Introduction

immobilienscout24 stands as Germany's number #1 real estate platform, serving as the leading online marketplace for residential and commercial properties. With around 13 million users visiting the portal monthly, it represents the most comprehensive source of German property data available online. For real estate professionals, investors, researchers, and market analysts, accessing this vast database manually is time-consuming and inefficient. The immobilienscout24 Property Search Scraper addresses this challenge by automating the extraction of detailed property information, enabling users to gather market intelligence, conduct competitive analysis, and make data-driven decisions in the German real estate market.

### Overview of the Scraper

The immobilienscout24 Property Search Scraper is a powerful automation tool designed to extract comprehensive property listings from Germany's premier real estate platform. This scraper efficiently navigates search result pages and collects detailed property information including pricing, specifications, location data, and contact details. The tool supports both residential and commercial property extraction, making it invaluable for market research, competitive analysis, and lead generation.

**Key Advantages:**

- **Comprehensive Data Extraction**: Captures over 20 detailed property attributes per listing
- **Scalable Processing**: Handles multiple URLs and large-scale data collection
- **Proxy Integration**: Built-in residential proxy support to avoid detection
- **Structured Output**: Delivers clean, organized data ready for analysis
- **Flexible Configuration**: Customizable retry limits and item counts per URL

**Target Users:**

- Real estate agencies and brokers seeking market intelligence
- Property investors analyzing market trends and opportunities
- Researchers studying German housing market dynamics
- PropTech companies requiring property data feeds
- Market analysts tracking pricing and availability trends

### Input and Output Details

Example url 1: https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten?enteredFrom=one_step_search

Example url 2: https://www.immobilienscout24.de/Suche/de/schleswig-holstein/wohnung-mieten?enteredFrom=one_step_search

Example url 3: https://www.immobilienscout24.de/Suche/de/bremen/wohnung-mieten?enteredFrom=one_step_search

Example Screenshot of property list by query page:

![](https://i.ibb.co/zVsGjR5n/Screenshot-from-2025-06-14-23-45-54.png)

#### Input Format

The scraper accepts a JSON configuration that defines scraping parameters and target URLs:

```json
{
  "max_retries_per_url": 2, // Maximum waiting time when accessing the links you provided.
  "proxy": { // Add a proxy to ensure that during the data collection process, you are not detected as a bot.
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL" 
    ],
    "apifyProxyCountry": "SG" // You should choose an Country that coincides with the Country you want to collect data from
  },
  "max_items_per_url": 20,
  "urls": [ // Links to property list by query pages.
    "https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten?enteredFrom=one_step_search",
    "https://www.immobilienscout24.de/Suche/de/bremen/wohnung-mieten?enteredFrom=one_step_search",
    "https://www.immobilienscout24.de/Suche/de/schleswig-holstein/wohnung-mieten?enteredFrom=one_step_search"
  ]
}
```

**Input Parameters Explained:**

- **max_retries_per_url**: Controls persistence when accessing target pages (recommended: 2-3)
- **proxy configuration**: Essential for avoiding bot detection during large-scale scraping
- **max_items_per_url**: Limits properties extracted per search page to manage resource usage
- **urls array**: Contains immobilienscout24 search result URLs targeting specific locations, property types, or criteria

#### Output Format

You get the output from the Immobilienscout24 Property Search Scraper stored in a tab. The following is an example of the Information Fields collected after running the Actor.

```json
[ // List of property information
  {
    "id": "158484560",
    "url": "https://www.immobilienscout24.de/expose/158484560",
    "created_at": "2025-04-10T14:03:06.000+02:00",
    "modified_at": "2025-05-13T12:51:14.436+02:00",
    "published_at": "2025-04-10T14:03:06.000+02:00",
    "project": {
      "project_id": 138772,
      "premium": "false",
      "published": "true",
      "virtual_tour_available": "false",
      "title": "Pufendorfstraße 3 d u. 3 e, 10249 Berlin",
      "name": "Midtown Berlin",
      "link": "https://www.immobilienscout24.de/neubau/pandion-servicegesellschaft-mbh/midtown-berlin/138772.html",
      "attributes": [
        {
          "label": "Preis",
          "text": "1.342 - 3.625 €"
        },
        {
          "label": "Wohnfläche",
          "text": "46,00 - 120,00 m²"
        },
        {
          "label": "Bezugsfrei ab",
          "text": "01.07.2025"
        },
        {
          "label": "Wohneinheiten",
          "text": "65"
        },
        {
          "label": "Ausstattung",
          "text": "Gehoben"
        },
        {
          "label": "Zimmer",
          "text": "2 - 4"
        }
      ],
      "picture": {
        "uri": "https://pictures.immobilienscout24.de/dims3/S3/http://s3-eu-west-1.amazonaws.com/pda-pro-pictures-projectpictures-8hecgpgpb9fo/94921427/2f40884d-9992-497a-a8ed-db360ccedade.jpg",
        "scales": {
          "scale_and_crop": "https://pictures.immobilienscout24.de/dims3/S3/legacy_thumbnail/{width}x{height}/format/jpg/http://s3-eu-west-1.amazonaws.com/pda-pro-pictures-projectpictures-8hecgpgpb9fo/94921427/2f40884d-9992-497a-a8ed-db360ccedade.jpg",
          "scale": "https://pictures.immobilienscout24.de/dims3/S3/resize/{width}x{height}%3E/http://s3-eu-west-1.amazonaws.com/pda-pro-pictures-projectpictures-8hecgpgpb9fo/94921427/2f40884d-9992-497a-a8ed-db360ccedade.jpg",
          "white_filling": "https://pictures.immobilienscout24.de/dims3/S3/resize/{width}x{height}%3E/extent/{width}x{height}/format/jpg/http://s3-eu-west-1.amazonaws.com/pda-pro-pictures-projectpictures-8hecgpgpb9fo/94921427/2f40884d-9992-497a-a8ed-db360ccedade.jpg"
        }
      },
      "gallery_attachments": {
        "attachment": {
          "@xsi.type": "common:Picture",
          "@xlink.href": "https://pictures.immobilienscout24.de/dims3/S3/http://s3-eu-west-1.amazonaws.com/pda-pro-pictures-projectpictures-8hecgpgpb9fo/94921427/2f40884d-9992-497a-a8ed-db360ccedade.jpg",
          "floorplan": "false",
          "title_picture": "false",
          "urls": [
            {
              "url": [
                {
                  "@scale": "SCALE",
                  "@href": "https://pictures.immobilienscout24.de/dims3/S3/resize/%WIDTH%x%HEIGHT%%3E/quality/50/http://s3-eu-west-1.amazonaws.com/pda-pro-pictures-projectpictures-8hecgpgpb9fo/94921427/2f40884d-9992-497a-a8ed-db360ccedade.jpg"
                },
                {
                  "@scale": "SCALE_AND_CROP",
                  "@href": "https://pictures.immobilienscout24.de/dims3/S3/legacy_thumbnail/%WIDTH%x%HEIGHT%/format/webp/quality/50/http://s3-eu-west-1.amazonaws.com/pda-pro-pictures-projectpictures-8hecgpgpb9fo/94921427/2f40884d-9992-497a-a8ed-db360ccedade.jpg"
                },
                {
                  "@scale": "WHITE_FILLING",
                  "@href": "https://pictures.immobilienscout24.de/dims3/S3/resize/%WIDTH%x%HEIGHT%%3E/extent/%WIDTH%x%HEIGHT%/format/webp/quality/50/http://s3-eu-west-1.amazonaws.com/pda-pro-pictures-projectpictures-8hecgpgpb9fo/94921427/2f40884d-9992-497a-a8ed-db360ccedade.jpg"
                }
              ]
            }
          ]
        }
      },
      "address": "Pufendorfstraße 3d, 10249 Berlin",
      "is_presale": "false"
    },
    "title": "Neubau Erstbezug * 3 Zi. Wohnung im 5.OG * Gäste-WC * Balkon * TG Stellplatz",
    "address": {
      "street": "Pufendorfstraße",
      "house_number": "3A-3E",
      "postcode": "10249",
      "city": "Berlin",
      "quarter": "Friedrichshain (Friedrichshain)",
      "wgs84_coordinate": {
        "latitude": 52.52193,
        "longitude": 13.43821
      },
      "precise_house_number": "true",
      "description": {
        "text": "Pufendorfstraße 3A-3E, Friedrichshain, Berlin"
      }
    },
    "attributes": [
      {
        "attribute": [
          {
            "label": "Kaltmiete",
            "value": "2.410,42 €"
          },
          {
            "label": "Wohnfläche",
            "value": "79,51 m²"
          },
          {
            "label": "Zimmer",
            "value": 3
          }
        ]
      }
    ],
    "floorplan": "true",
    "private_offer": "false",
    "contact_details": {
      "salutation": "MALE",
      "firstname": "Thomas",
      "lastname": "Bernhard",
      "phone_number": "030 200074935",
      "cell_phone_number": "0162 1774183",
      "company": "PANDION Servicegesellschaft mbH"
    },
    "realtor_company_name": "PANDION Servicegesellschaft mbH",
    "spotlight_listing": "true",
    "price": {
      "value": 2410.42,
      "currency": "EUR",
      "marketing_type": "RENT",
      "price_interval_type": "MONTH"
    },
    "living_space": 79.51,
    "number_of_rooms": 3,
    "energy_performance_certificate": "true",
    "energy_efficiency_class": "B",
    "built_in_kitchen": "true",
    "balcony": "true",
    "garden": "false",
    "calculated_total_rent": {
      "total_rent": {
        "value": 2874.42,
        "currency": "EUR",
        "marketing_type": "RENT",
        "price_interval_type": "MONTH"
      },
      "calculation_mode": "SUMMARIZED"
    },
    "construction_year": 2025,
    "tags": [
      "Balkon/Terrasse",
      "Einbauküche",
      "Keller",
      "Gäste-WC",
      "Aufzug"
    ],
    "from_url": "https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten?enteredFrom=one_step_search"
  }, // ... Many other property details
] 
```

The scraper delivers structured property data with comprehensive details:

**Core Identification Fields:**

- **ID**: Unique immobilienscout24 property identifier for tracking and reference
- **URL**: Direct link to the individual property listing page
- **Created At/Modified At/Published At**: Temporal data for tracking listing lifecycle

**Property Details:**

- **Title**: Property headline as displayed on immobilienscout24
- **Address**: Complete location information including street, district, and postal code
- **Attributes**: Comprehensive property characteristics and features
- **Project**: Development or building complex name (for new constructions)

**Financial Information:**

- **Price**: Base rental or purchase price in EUR
- **Calculated Total Rent**: Includes additional costs like utilities and maintenance (for rentals)
- **Living Space**: Property size in square meters
- **Number of Rooms**: Total room count including bedrooms and living areas

**Property Features:**

- **Built-in Kitchen**: Boolean indicating if kitchen is included/equipped
- **Balcony/Garden**: Outdoor space availability indicators
- **Construction Year**: Building age for assessing property condition and value
- **Energy Performance Certificate**: Energy efficiency rating (mandatory in Germany)
- **Energy Efficiency Class**: Classification from A+ (most efficient) to H (least efficient)

**Marketing and Contact Data:**

- **Contact Details**: Property manager, landlord, or agent information
- **Realtor Company Name**: Real estate agency handling the listing
- **Private Offer**: Indicates if listed by individual owner vs. professional agent
- **Spotlight Listing**: Premium placement status affecting visibility
- **Floorplan**: Availability of property layout diagrams
- **Tags**: Categorization labels and special features

This comprehensive output structure enables users to perform detailed market analysis, compare properties across multiple criteria, and identify trends in pricing, features, and availability within the German real estate market.

### Usage Instructions

**Step-by-Step Implementation:**

1. **Configure Input Parameters**: Set appropriate retry limits (2-3 recommended) and item counts based on your data volume needs
2. **Setup Proxy Settings**: Enable residential proxies with Germany-appropriate countries (DE, AT, CH recommended for best results)
3. **Prepare Target URLs**: Collect immobilienscout24 search URLs with your desired filters (location, price range, property type)
4. **Execute Scraping**: Run the tool during off-peak hours to minimize detection risk
5. **Process Output**: Import the structured data into your analysis platform or database

**Best Practices:**

- **Respect Rate Limits**: Space requests appropriately to avoid overwhelming the platform
- **Use Specific Search Queries**: Target precise locations and criteria to maximize data relevance
- **Monitor Success Rates**: Track failed requests and adjust retry settings accordingly
- **Validate Data Quality**: Implement checks for missing or inconsistent information

**Common Error Handling:**

- **CAPTCHA Challenges**: Residential proxies significantly reduce occurrence
- **Rate Limiting**: Implement delays between requests and rotate proxy IPs
- **Data Inconsistencies**: Cross-reference extracted data with multiple sources when possible

### Benefits and Applications

**Time Efficiency**: Automates hours of manual browsing and data collection into minutes of automated processing, enabling real-time market monitoring and rapid competitive analysis.

**Real-World Applications:**

- **Market Research**: Track pricing trends, availability patterns, and feature preferences across German cities
- **Investment Analysis**: Identify undervalued properties and emerging neighborhoods through comprehensive data comparison
- **Lead Generation**: Discover new property opportunities and contact information for direct outreach
- **Competitive Intelligence**: Monitor competitor listings, pricing strategies, and market positioning

**Business Value**: Provides data-driven insights that inform strategic decisions, reduce research costs, and accelerate deal identification in Germany's competitive real estate market.

### Conclusion

The immobilienscout24 Property Search Scraper transforms manual property research into an automated, scalable process that delivers comprehensive market intelligence. By extracting detailed property data from Germany's leading real estate platform, users gain competitive advantages through faster market analysis, broader property coverage, and deeper insights into pricing and availability trends.

Ready to streamline your German real estate research? Start extracting valuable property data today and gain the competitive edge your business needs.

## Einführung (deutsche Version)

### immobilienscout24 Property Search Scraper: Extrahieren Sie deutsche Immobiliendaten effizient

### Einführung

immobilienscout24 ist Deutschlands Immobilienplattform Nummer 1 und dient als führender Online-Marktplatz für Wohn- und Gewerbeimmobilien. Mit rund 13 Millionen Nutzern, die das Portal monatlich besuchen, stellt es die umfassendste Quelle für Immobiliendaten aus Deutschland dar, die online verfügbar ist. Für Immobilienfachleute, Investoren, Forscher und Marktanalysten ist der manuelle Zugriff auf diese riesige Datenbank zeitaufwendig und ineffizient. Der immobilienscout24 Property Search Scraper löst dieses Problem, indem er die Extraktion detaillierter Immobilieninformationen automatisiert. Damit können Nutzer Marktdaten gewinnen, Konkurrenzanalysen durchführen und datenbasierte Entscheidungen auf dem deutschen Immobilienmarkt treffen.

### Überblick über den Scraper

Der immobilienscout24 Property Search Scraper ist ein leistungsstarkes Automatisierungstool zur Extraktion umfassender Immobilienanzeigen von Deutschlands führender Immobilienplattform. Dieser Scraper navigiert effizient durch die Suchergebnisseiten und sammelt detaillierte Immobiliendaten wie Preise, Spezifikationen, Standortdaten und Kontaktdetails. Das Tool unterstützt sowohl Wohn- als auch Gewerbeimmobilien und ist somit unverzichtbar für Marktforschung, Konkurrenzanalyse und Lead-Generierung.

**Wesentliche Vorteile:**

- **Umfassende Datenerfassung:** Erfasst mehr als 20 detaillierte Eigenschaften pro Anzeige
- **Skalierbare Verarbeitung:** Unterstützt mehrere URLs und groß angelegte Datensammlungen
- **Proxyeinbindung:** Integrierte Unterstützung für Residential Proxies zur Umgehung von Erkennung
- **Strukturierte Ausgabe:** Liefert saubere, organisierte Daten, die sofort analysiert werden können
- **Flexible Konfiguration:** Anpassbare Retry-Limits und Item-Anzahl pro URL

**Zielgruppen:**

- Immobilienagenturen und Makler, die Markteinsichten suchen
- Immobilieninvestoren, die Markttrends und -chancen analysieren
- Forscher, die die Dynamik des deutschen Wohnungsmarkts untersuchen
- PropTech-Unternehmen, die Immobilien-Datenfeeds benötigen
- Marktanalysten, die Preis- und Verfügbarkeitsentwicklungen verfolgen

### Details zu Eingabe und Ausgabe

Beispiel-URL 1: https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten?enteredFrom=one_step_search

Beispiel-URL 2: https://www.immobilienscout24.de/Suche/de/schleswig-holstein/wohnung-mieten?enteredFrom=one_step_search

Beispiel-URL 3: https://www.immobilienscout24.de/Suche/de/bremen/wohnung-mieten?enteredFrom=one_step_search

Beispiel-Screenshot der Immobilienliste nach Suchabfrage:

![](https://i.ibb.co/zVsGjR5n/Screenshot-from-2025-06-14-23-45-54.png)

#### Eingabeformat

Der Scraper akzeptiert eine JSON-Konfiguration, die die Scraping-Parameter und Ziel-URLs definiert:

```json
{
  "max_retries_per_url": 2, // Maximum waiting time when accessing the links you provided.
  "proxy": { // Add a proxy to ensure that during the data collection process, you are not detected as a bot.
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL" 
    ],
    "apifyProxyCountry": "SG" // You should choose an Country that coincides with the Country you want to collect data from
  },
  "max_items_per_url": 20,
  "urls": [ // Links to property list by query pages.
    "https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten?enteredFrom=one_step_search",
    "https://www.immobilienscout24.de/Suche/de/bremen/wohnung-mieten?enteredFrom=one_step_search",
    "https://www.immobilienscout24.de/Suche/de/schleswig-holstein/wohnung-mieten?enteredFrom=one_step_search"
  ]
}
```

**Erläuterung der Eingabeparameter:**

- **max_retries_per_url**: Steuert die Anzahl der Zugriffsversuche auf Zielseiten (empfohlen: 2-3)
- **Proxy-Konfiguration**: Wichtig, um bei groß angelegtem Scraping eine Bot-Erkennung zu vermeiden
- **max_items_per_url**: Begrenzt die Anzahl der pro Suchseite extrahierten Immobilien zur Ressourcensteuerung
- **URLs-Array**: Enthält immobilienscout24-Suchergebnis-URLs für bestimmte Standorte, Immobilientypen oder Suchkriterien

#### Ausgabeformat

Sie erhalten die Ausgabe des Immobilienscout24 Property Search Scrapers in einem Tabellendokument. Untenstehend sehen Sie ein Beispiel für die Informationsfelder, die nach Ausführung des Actors gesammelt werden.

```json
[ // List of property information
  {
    "id": "158484560",
    "url": "https://www.immobilienscout24.de/expose/158484560",
    "created_at": "2025-04-10T14:03:06.000+02:00",
    "modified_at": "2025-05-13T12:51:14.436+02:00",
    "published_at": "2025-04-10T14:03:06.000+02:00",
    "project": {
      "project_id": 138772,
      "premium": "false",
      "published": "true",
      "virtual_tour_available": "false",
      "title": "Pufendorfstraße 3 d u. 3 e, 10249 Berlin",
      "name": "Midtown Berlin",
      "link": "https://www.immobilienscout24.de/neubau/pandion-servicegesellschaft-mbh/midtown-berlin/138772.html",
      "attributes": [
        {
          "label": "Preis",
          "text": "1.342 - 3.625 €"
        },
        {
          "label": "Wohnfläche",
          "text": "46,00 - 120,00 m²"
        },
        {
          "label": "Bezugsfrei ab",
          "text": "01.07.2025"
        },
        {
          "label": "Wohneinheiten",
          "text": "65"
        },
        {
          "label": "Ausstattung",
          "text": "Gehoben"
        },
        {
          "label": "Zimmer",
          "text": "2 - 4"
        }
      ],
      "picture": {
        "uri": "https://pictures.immobilienscout24.de/dims3/S3/http://s3-eu-west-1.amazonaws.com/pda-pro-pictures-projectpictures-8hecgpgpb9fo/94921427/2f40884d-9992-497a-a8ed-db360ccedade.jpg",
        "scales": {
          "scale_and_crop": "https://pictures.immobilienscout24.de/dims3/S3/legacy_thumbnail/{width}x{height}/format/jpg/http://s3-eu-west-1.amazonaws.com/pda-pro-pictures-projectpictures-8hecgpgpb9fo/94921427/2f40884d-9992-497a-a8ed-db360ccedade.jpg",
          "scale": "https://pictures.immobilienscout24.de/dims3/S3/resize/{width}x{height}%3E/http://s3-eu-west-1.amazonaws.com/pda-pro-pictures-projectpictures-8hecgpgpb9fo/94921427/2f40884d-9992-497a-a8ed-db360ccedade.jpg",
          "white_filling": "https://pictures.immobilienscout24.de/dims3/S3/resize/{width}x{height}%3E/extent/{width}x{height}/format/jpg/http://s3-eu-west-1.amazonaws.com/pda-pro-pictures-projectpictures-8hecgpgpb9fo/94921427/2f40884d-9992-497a-a8ed-db360ccedade.jpg"
        }
      },
      "gallery_attachments": {
        "attachment": {
          "@xsi.type": "common:Picture",
          "@xlink.href": "https://pictures.immobilienscout24.de/dims3/S3/http://s3-eu-west-1.amazonaws.com/pda-pro-pictures-projectpictures-8hecgpgpb9fo/94921427/2f40884d-9992-497a-a8ed-db360ccedade.jpg",
          "floorplan": "false",
          "title_picture": "false",
          "urls": [
            {
              "url": [
                {
                  "@scale": "SCALE",
                  "@href": "https://pictures.immobilienscout24.de/dims3/S3/resize/%WIDTH%x%HEIGHT%%3E/quality/50/http://s3-eu-west-1.amazonaws.com/pda-pro-pictures-projectpictures-8hecgpgpb9fo/94921427/2f40884d-9992-497a-a8ed-db360ccedade.jpg"
                },
                {
                  "@scale": "SCALE_AND_CROP",
                  "@href": "https://pictures.immobilienscout24.de/dims3/S3/legacy_thumbnail/%WIDTH%x%HEIGHT%/format/webp/quality/50/http://s3-eu-west-1.amazonaws.com/pda-pro-pictures-projectpictures-8hecgpgpb9fo/94921427/2f40884d-9992-497a-a8ed-db360ccedade.jpg"
                },
                {
                  "@scale": "WHITE_FILLING",
                  "@href": "https://pictures.immobilienscout24.de/dims3/S3/resize/%WIDTH%x%HEIGHT%%3E/extent/%WIDTH%x%HEIGHT%/format/webp/quality/50/http://s3-eu-west-1.amazonaws.com/pda-pro-pictures-projectpictures-8hecgpgpb9fo/94921427/2f40884d-9992-497a-a8ed-db360ccedade.jpg"
                }
              ]
            }
          ]
        }
      },
      "address": "Pufendorfstraße 3d, 10249 Berlin",
      "is_presale": "false"
    },
    "title": "Neubau Erstbezug * 3 Zi. Wohnung im 5.OG * Gäste-WC * Balkon * TG Stellplatz",
    "address": {
      "street": "Pufendorfstraße",
      "house_number": "3A-3E",
      "postcode": "10249",
      "city": "Berlin",
      "quarter": "Friedrichshain (Friedrichshain)",
      "wgs84_coordinate": {
        "latitude": 52.52193,
        "longitude": 13.43821
      },
      "precise_house_number": "true",
      "description": {
        "text": "Pufendorfstraße 3A-3E, Friedrichshain, Berlin"
      }
    },
    "attributes": [
      {
        "attribute": [
          {
            "label": "Kaltmiete",
            "value": "2.410,42 €"
          },
          {
            "label": "Wohnfläche",
            "value": "79,51 m²"
          },
          {
            "label": "Zimmer",
            "value": 3
          }
        ]
      }
    ],
    "floorplan": "true",
    "private_offer": "false",
    "contact_details": {
      "salutation": "MALE",
      "firstname": "Thomas",
      "lastname": "Bernhard",
      "phone_number": "030 200074935",
      "cell_phone_number": "0162 1774183",
      "company": "PANDION Servicegesellschaft mbH"
    },
    "realtor_company_name": "PANDION Servicegesellschaft mbH",
    "spotlight_listing": "true",
    "price": {
      "value": 2410.42,
      "currency": "EUR",
      "marketing_type": "RENT",
      "price_interval_type": "MONTH"
    },
    "living_space": 79.51,
    "number_of_rooms": 3,
    "energy_performance_certificate": "true",
    "energy_efficiency_class": "B",
    "built_in_kitchen": "true",
    "balcony": "true",
    "garden": "false",
    "calculated_total_rent": {
      "total_rent": {
        "value": 2874.42,
        "currency": "EUR",
        "marketing_type": "RENT",
        "price_interval_type": "MONTH"
      },
      "calculation_mode": "SUMMARIZED"
    },
    "construction_year": 2025,
    "tags": [
      "Balkon/Terrasse",
      "Einbauküche",
      "Keller",
      "Gäste-WC",
      "Aufzug"
    ],
    "from_url": "https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten?enteredFrom=one_step_search"
  }, // ... Many other property details
] 
```

The scraper delivers structured property data with comprehensive details:

**Core Identification Fields:**

- **ID**: Unique immobilienscout24 property identifier for tracking and reference
- **URL**: Direct link to the individual property listing page
- **Created At/Modified At/Published At**: Temporal data for tracking listing lifecycle

**Property Details:**

- **Title**: Property headline as displayed on immobilienscout24
- **Address**: Complete location information including street, district, and postal code
- **Attributes**: Comprehensive property characteristics and features
- **Project**: Development or building complex name (for new constructions)

**Financial Information:**

- **Price**: Base rental or purchase price in EUR
- **Calculated Total Rent**: Includes additional costs like utilities and maintenance (for rentals)
- **Living Space**: Property size in square meters
- **Number of Rooms**: Total room count including bedrooms and living areas

**Property Features:**

- **Built-in Kitchen**: Boolean indicating if kitchen is included/equipped
- **Balcony/Garden**: Outdoor space availability indicators
- **Construction Year**: Building age for assessing property condition and value
- **Energy Performance Certificate**: Energy efficiency rating (mandatory in Germany)
- **Energy Efficiency Class**: Classification from A+ (most efficient) to H (least efficient)

**Marketing and Contact Data:**

- **Contact Details**: Property manager, landlord, or agent information
- **Realtor Company Name**: Real estate agency handling the listing
- **Private Offer**: Indicates if listed by individual owner vs. professional agent
- **Spotlight Listing**: Premium placement status affecting visibility
- **Floorplan**: Availability of property layout diagrams
- **Tags**: Categorization labels and special features

This comprehensive output structure enables users to perform detailed market analysis, compare properties across multiple criteria, and identify trends in pricing, features, and availability within the German real estate market.

### Usage Instructions

**Step-by-Step Implementation:**

1. **Configure Input Parameters**: Set appropriate retry limits (2-3 recommended) and item counts based on your data volume needs
2. **Setup Proxy Settings**: Enable residential proxies with Germany-appropriate countries (DE, AT, CH recommended for best results)
3. **Prepare Target URLs**: Collect immobilienscout24 search URLs with your desired filters (location, price range, property type)
4. **Execute Scraping**: Run the tool during off-peak hours to minimize detection risk
5. **Process Output**: Import the structured data into your analysis platform or database

**Best Practices:**

- **Respect Rate Limits**: Space requests appropriately to avoid overwhelming the platform
- **Use Specific Search Queries**: Target precise locations and criteria to maximize data relevance
- **Monitor Success Rates**: Track failed requests and adjust retry settings accordingly
- **Validate Data Quality**: Implement checks for missing or inconsistent information

**Common Error Handling:**

- **CAPTCHA Challenges**: Residential proxies significantly reduce occurrence
- **Rate Limiting**: Implement delays between requests and rotate proxy IPs
- **Data Inconsistencies**: Cross-reference extracted data with multiple sources when possible

### Benefits and Applications

**Time Efficiency**: Automates hours of manual browsing and data collection into minutes of automated processing, enabling real-time market monitoring and rapid competitive analysis.

**Real-World Applications:**

- **Market Research**: Track pricing trends, availability patterns, and feature preferences across German cities
- **Investment Analysis**: Identify undervalued properties and emerging neighborhoods through comprehensive data comparison
- **Lead Generation**: Discover new property opportunities and contact information for direct outreach
- **Competitive Intelligence**: Monitor competitor listings, pricing strategies, and market positioning

**Business Value**: Provides data-driven insights that inform strategic decisions, reduce research costs, and accelerate deal identification in Germany's competitive real estate market.

### Conclusion

The immobilienscout24 Property Search Scraper transforms manual property research into an automated, scalable process that delivers comprehensive market intelligence. By extracting detailed property data from Germany's leading real estate platform, users gain competitive advantages through faster market analysis, broader property coverage, and deeper insights into pricing and availability trends.

Ready to streamline your German real estate research? Start extracting valuable property data today and gain the competitive edge your business needs.

## Related Actors

- [**Immobilienscout24.de Property Details Scraper**](https://apify.com/ecomscrape/immobilienscout24-property-details-scraper): Your comprehensive tool for extracting valuable property information from immobilienscout24.de extensive real estate platform.

## Your feedback

We are always working to improve Actors' performance. So, if you have any technical feedback about Immobilienscout24 Property Search Scraper or simply found a bug, please create an issue on the Actor's Issues tab in Apify Console.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the Property list page urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `max_items_per_url` (type: `integer`):

Limit the number of items per URL you want to scrape

## `max_retries_per_url` (type: `integer`):

Limit the number of retries for each URL if the scrape is detected as a bot or the page fails to load

## `proxy` (type: `object`):

Select proxies to be used by your scraper.

## Actor input object example

```json
{
  "urls": [
    "https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten?enteredFrom=one_step_search"
  ],
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": false
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": [
        "https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten?enteredFrom=one_step_search"
    ],
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
    "proxy": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("ecomscrape/immobilienscout24-property-search-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "urls": ["https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten?enteredFrom=one_step_search"],
    "max_items_per_url": 20,
    "max_retries_per_url": 2,
    "proxy": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("ecomscrape/immobilienscout24-property-search-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 '{
  "urls": [
    "https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten?enteredFrom=one_step_search"
  ],
  "max_items_per_url": 20,
  "max_retries_per_url": 2,
  "proxy": {
    "useApifyProxy": false
  }
}' |
apify call ecomscrape/immobilienscout24-property-search-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ecomscrape/immobilienscout24-property-search-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 <APIFY_API_TOKEN>` 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/V63x04whZYtczU95O/builds/aQEjt6onVSoZyFP1r/openapi.json