# 🏡 ImmoScout24 Detail Scraper 300ms/req | ImmobilienScout24 (`clearpath/immoscout24-detail-listing-scraper`) Actor

Vollständige Immobiliendetails aus ImmoScout24-URLs: Preise, Zimmer, Fläche, Adresse, Ausstattung, Energiedaten und Maklerkontakt mit Telefonnummer. Bis zu 10.000 Inserate pro Lauf. Export als CSV, JSON oder Excel.

- **URL**: https://apify.com/clearpath/immoscout24-detail-listing-scraper.md
- **Developed by:** [ClearPath](https://apify.com/clearpath) (community)
- **Categories:** Real estate, Automation, Lead generation
- **Stats:** 196 total users, 17 monthly users, 100.0% runs succeeded, 4 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.19 / 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?

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

## 🏡 ImmoScout24.de Detail-Listing Scraper

[![50+ Datenfelder. Telefonnummern. Exposé-Texte. Dokumente. ImmoScout24 Detail.](https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/immoscout24-detail-listing-scraper-readme-hero-b2e6cb90aed4.png)](https://console.apify.com/actors/wdaV0qFwqQJ2H7ywd/input)

Von **Clearpath**, den Entwicklern von [ImmoScout24 Pro und Lite](https://apify.com/clearpath/immoscout24-api-pro), den [Kleinanzeigen-Immobilien-Scrapern](https://apify.com/clearpath/kleinanzeigen-immobilien-api-pro) und [Immobilien Export Pro](https://apify.com/clearpath/immobilien-export-pro). Eine spezialisierte Suite für Immobiliendaten, Kontaktdaten und automatisierte Wohnungssuche.

### Warum diesen Actor wählen?

**50+ Datenfelder für deine Auswertung.** Ergänze bekannte Inserate um vollständige Beschreibungen, Ausstattungs- und Lageangaben, Mietnebenkosten, Kaution und Verfügbarkeit. So vergleichst du Angebote anhand der Details, die in einer Ergebnisliste fehlen.

**Telefonnummern und Ansprechpartner.** Erhalte veröffentlichte Telefonnummern, Kontaktnamen und bei Maklern die Firma sowie verfügbare Profil-Links. Die Kennzeichnung als Privat- oder Maklerangebot hilft dir, die passenden Kontakte auszuwählen.

**Exposé-Texte, Bilder und Dokumente zusammen.** Lade Bild-URLs in Original- und Vorschaugröße sowie Links zu bereitgestellten PDFs. Verarbeite bis zu 10.000 Inserat-URLs oder IDs pro Lauf und exportiere die Ergebnisse als JSON, CSV oder Excel.

<a href="https://console.apify.com/actors/wdaV0qFwqQJ2H7ywd/input"><img src="https://api.apify.com/v2/key-value-stores/pJ7iaZsTFhR3k9tjV/records/immoscout24-detail-listing-scraper-readme-cta-b89cb317c78b.svg" width="260" height="48" alt="Eigenes ImmoScout24-Inserat testen"/></a>

### Mit einem Inserat starten

Ersetze die Beispiel-URL durch ein aktuell erreichbares ImmoScout24-Inserat. Du kannst mehrere URLs oder Exposé-IDs als Zeichenketten eintragen.

```json
{
  "urls": [
    "https://www.immobilienscout24.de/expose/83860520"
  ]
}
```

[Actor-Eingabe öffnen](https://console.apify.com/actors/wdaV0qFwqQJ2H7ywd/input) und dein Inserat einfügen. Telefonnummern, Texte und Dokumente werden übernommen, soweit sie veröffentlicht sind; nicht jedes Inserat enthält jedes Feld. JSON erhält die verschachtelten Kontakt-, Bild- und Dokumentdaten.

Abgerechnet wird pro Ergebnis gemäß [Preisliste](https://apify.com/clearpath/immoscout24-detail-listing-scraper/pricing). Für die Suche nach passenden Inseraten nutze [ImmoScout24 Pro](https://apify.com/clearpath/immoscout24-api-pro) oder [Lite](https://apify.com/clearpath/immoscout24-api-lite).

<table><tr><td colspan="5" style="background:#3DF5DD;color:#333333;padding:10px 14px;font-size:13px;font-weight:700">Clearpath · Immobilien-Suite</td></tr><tr><td style="background:#CAFFF4;padding:10px 10px;border:1px solid #B9E6DD;vertical-align:top;width:20%"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-wdaV0qFwqQJ2H7ywd-TAEi6GeGks-ImmoScout24-canva2.png" width="20" height="20" alt="" style="vertical-align:middle"/>&nbsp;&nbsp;<a href="https://apify.com/clearpath/immoscout24-detail-listing-scraper" style="color:#333333;text-decoration:none;font-weight:700;font-size:13px">Exposé-Details</a></span><br><span style="color:#39564F;font-size:12px;white-space:nowrap">Du bist hier</span></td><td style="background:#E7FFF8;padding:10px 10px;border:1px solid #B9E6DD;vertical-align:top;width:20%"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-s609dyAJSrju54QSh-zj5NeZTykb-ImmoScout24-canva2.png" width="20" height="20" alt="" style="vertical-align:middle"/>&nbsp;&nbsp;<a href="https://apify.com/clearpath/immoscout24-api-pro" style="color:#333333;text-decoration:none;font-weight:700;font-size:13px">ImmoScout Pro</a></span><br><span style="color:#39564F;font-size:12px;white-space:nowrap">Suche & Details</span></td><td style="background:#E7FFF8;padding:10px 10px;border:1px solid #B9E6DD;vertical-align:top;width:20%"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-mwBC2oe2vWbDfbeVb-GOkoVZbFaU-ImmoScout24-canva2.png" width="20" height="20" alt="" style="vertical-align:middle"/>&nbsp;&nbsp;<a href="https://apify.com/clearpath/immoscout24-api-lite" style="color:#333333;text-decoration:none;font-weight:700;font-size:13px">ImmoScout Lite</a></span><br><span style="color:#39564F;font-size:12px;white-space:nowrap">Suchen überwachen</span></td><td style="background:#E7FFF8;padding:10px 10px;border:1px solid #B9E6DD;vertical-align:top;width:20%"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-Yu9fmARTOt79Ungbn-PTLhKqKWa5-kleinanzeigen-immobilien-api-pro-logo.png" width="20" height="20" alt="" style="vertical-align:middle"/>&nbsp;&nbsp;<a href="https://apify.com/clearpath/kleinanzeigen-immobilien-api-pro" style="color:#333333;text-decoration:none;font-weight:700;font-size:13px">Kleinanzeigen</a></span><br><span style="color:#39564F;font-size:12px;white-space:nowrap">Immobiliendaten</span></td><td style="background:#E7FFF8;padding:10px 10px;border:1px solid #B9E6DD;vertical-align:top;width:20%"><span style="white-space:nowrap"><img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/DSvMCAwsufMyZeLyt-actor-rfUFdb0huw88MIU1k-h35QRTa0k4-immobilien-export-pro-logo2.png" width="20" height="20" alt="" style="vertical-align:middle"/>&nbsp;&nbsp;<a href="https://apify.com/clearpath/immobilien-export-pro" style="color:#333333;text-decoration:none;font-weight:700;font-size:13px">Immo-Export</a></span><br><span style="color:#39564F;font-size:12px;white-space:nowrap">Mehrere Portale</span></td></tr></table>

#### Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

```
clearpath/immoscout24-detail-listing-scraper on Apify. Call: ApifyClient("TOKEN").actor("clearpath/immoscout24-detail-listing-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs: urls (array of strings, required, max 10000 ImmoScout24 expose URLs or IDs). Full actor spec (input schema with all params/enums/defaults, output dataset fields, README): GET https://api.apify.com/v2/acts/clearpath~immoscout24-detail-listing-scraper/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Pricing: pay per result, $1.49 per 1,000 results. Get token: https://console.apify.com/account/integrations To reach the maintainers, add feedback="<what you needed and did not get>" to any run, including one that worked: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. The run returns its data exactly as it would without the note, and a human reads every note.
```

### 💰 Kosten

ImmoScout24 Detail Scraper verwendet ein effizientes Ressourcenmodell für kostengünstige Datenextraktion:

#### Kostenübersicht

- **Speichernutzung:** 256MB-512MB für optimale Leistung
- **Ausführungszeit:** Typischerweise 2-60 Sekunden pro Durchlauf
- **Pay per Result:** $1,49 pro 1.000 Inserate

#### Speicherempfehlungen

| Anwendungsfall | Speicher | Laufzeit | Listings | Kosteneffizienz |
|----------------|----------|----------|----------|-----------------|
| Kleine Batches (1-100) | 128MB | 2-10 Sekunden | Bis zu 100 | ⭐⭐⭐⭐⭐ |
| Große Batches (100-10000) | 256MB | 5-15 Sekunden | Bis zu 10000 | ⭐⭐⭐⭐⭐ |

### Schnellstart

#### Schritt-für-Schritt-Anleitung

1. **Erstelle ein Apify-Konto** [hier](https://console.apify.com/sign-up)
   - Registriere Dich für ein kostenloses Apify-Konto
   - Keine Kreditkarte für kostenlose Konten erforderlich

2. **Führe den Actor aus**
   - Navigiere zum ImmoScout24 Detail-Listing Scraper
   - Gib Deine Liste von ImmoScout24 URLs ein
   - Klicke "Run"

3. **Greife auf Deine Daten zu**
   - Sieh Dir die Ergebnisse direkt in der Apify-Konsole an
   - Lade sie als JSON, CSV oder Excel herunter
   - Nutze die Apify API zur Integration in Deine Anwendungen

### ⬇️ Input

Der Actor akzeptiert eine Liste von URLs zur Verarbeitung:

- `urls` (erforderlich): Ein Array von ImmoScout24 Detail-Listing URLs zur Verarbeitung. Stelle sicher, dass Du die .de Domains verwendest, da .at oder .ch Domains derzeit nicht unterstützt werden.

**Beispiel-Input:**

```json
{
  "urls": [
    "https://www.immobilienscout24.de/expose/123456789",
    "https://www.immobilienscout24.de/expose/987654321"
  ]
}
```

Das Array darf maximal 10000 Einträge pro Durchlauf enthalten, aber Du kannst den Actor mehrfach ausführen für unbegrenzte Datensammlung.

### ⬆️ Output

Der Actor gibt einen Datensatz mit detaillierten Informationen für jede URL aus. **Beispiel-Ausgabe:**

```json
{
  "expose_id": 159114845,
  "listing_url": "https://www.immobilienscout24.de/expose/159114845",
  "description": "Modern ausgestattete 3-Zimmerwohnung mit ca. 96m² Wohnfläche mit Aufzug. Die vorhandene Einbauküche ...",
  "furnishing_description": null,
  "location_description": "Das Objekt befindet sich in belebter Wohnlage in Frankfurt am Main Nordend-West. Anbindung ...",
  "further_notes": null,
  "address_line_1": "60318 Nordend-West, Frankfurt am Main",
  "address_line_2": null,
  "location_lat": null,
  "location_lng": null,
  "online_since": null,
  "title": "Frankfurt-Nordend: moderne 3-Zimmer Wohnung mit Balkon, Parkett, EBK, ruhig und freundlich!",
  "heating_included_in_ancillary_costs": true,
  "deposit_costs": "5.250,00",
  "parking_info": "Garage",
  "vacant_at_from": "2025-08-01",
  "publication_state": "active",
  "real_estate_type": "APARTMENT_RENT",
  "property_type": "wohnung_miete",
  "rent_cold": 1750.0,
  "rent_total": 2050.0,
  "purchase_price": 0,
  "private_offer": true,
  "ancillary_costs": 300.0,
  "year_constructed": 1966,
  "condition": "well_kept",
  "size": "96",
  "fitted_kitchen": true,
  "garden": false,
  "number_of_floors": "4",
  "cellar": true,
  "house_number": "no_information",
  "rooms": "3",
  "elevator": true,
  "city_district": "Nordend_West",
  "firing_types": "oil",
  "street": "no_information",
  "zip_code": 60318,
  "heating_costs": 0.0,
  "city": "Frankfurt_am_Main",
  "state": "Hessen",
  "pets_allowed": false,
  "balcony_terrace": true,
  "floor": "1",
  "picture_count": 14,
  "is_expose_buy": false,
  "visits": null,
  "contact_requests": null,
  "pictures": [
    {
      "type": "full",
      "full_url": "<url of the image>",
      "web_url": "<url of the image>",
      "preview_url": "<url of the image>",
      "caption": "1_Wohnzimmer"
    }
  ],
  "documents": [
    {
      "type": "document",
      "name": "Grundriss",
      "url": "<url of the document>"
    },
    {
      "type": "document",
      "name": "Energieausweis",
      "url": "<url of the document>"
    }
  ],
  "no_of_parking_spaces": null,
  "heating_type": "oil_heating",
  "type_of_flat": "apartment",
  "is_rented": false,
  "is_barrier_free": true,
  "contact": {
    "premium_profile_required_for_contacting": true,
    "type": "private",
    "name": "Mr. Name",
    "address": "",
    "phone_number": "+49 ..."
  },
  "attributes": {
    "obj_regio1": "Hessen",
    "obj_serviceCharge": "300",
    "obj_heatingType": "oil_heating",
    "obj_cId": "18660995",
    "obj_newlyConst": "n",
    "obj_balcony": "y",
    "obj_picturecount": "14",
    "obj_totalRent": "2050",
    "obj_yearConstructed": "1966",
    "geo_ot": "nordend_west",
    "obj_privateOffer": "true",
    "obj_scoutId": "159114845",
    "obj_firingTypes": "oil",
    "obj_hasKitchen": "y",
    "obj_ExclusiveExpose": "false",
    "geo_bln": "hessen",
    "obj_cellar": "y",
    "obj_yearConstructedRange": "2",
    "obj_baseRent": "1750",
    "obj_houseNumber": "no_information",
    "obj_livingSpace": "96",
    "geo_krs": "frankfurt_am_main",
    "obj_zipCode": "60318",
    "obj_condition": "well_kept",
    "obj_interiorQual": "sophisticated",
    "obj_highDemand": "false",
    "obj_petsAllowed": "negotiable",
    "obj_street": "no_information",
    "obj_lift": "y",
    "obj_depositLink": "y",
    "obj_baseRentRange": "8",
    "obj_streetPlain": "no_information",
    "obj_typeOfFlat": "apartment",
    "obj_noRooms": "3",
    "obj_assistedLiving": "n",
    "obj_ityp": "0,active",
    "geo_land": "deutschland",
    "obj_immotype": "wohnung_miete",
    "obj_privateOfferInvestmentCheck": "false",
    "obj_contactFormInputFieldCount": "10",
    "obj_floor": "1",
    "obj_cwId": "009.c750431e-0b31-4a5b-9742-a00d52586610",
    "obj_numberOfFloors": "4",
    "geo_bg": "innenstadt_iii",
    "obj_noRoomsRange": "3",
    "obj_garden": "n",
    "obj_regio4": "Nordend_West",
    "obj_barrierFree": "y",
    "obj_international": "n",
    "obj_regio3": "Innenstadt_III",
    "obj_objectnumber": "159114845",
    "obj_livingSpaceRange": "4",
    "obj_regio2": "Frankfurt_am_Main"
  }
}
```

#### Immobilientypen

Die Eigenschaft `real_estate_type` kann einen der folgenden Werte haben:

- APARTMENT_BUY / APARTMENT_RENT
- HOUSE_BUY / HOUSE_RENT
- INDUSTRY / OFFICE / STORE
- ASSISTED_LIVING / GASTRONOMY
- SHORT_TERM_ACCOMMODATION / INVESTMENT
- LIVING_RENT_SITE / LIVING_BUY_SITE
- GARAGE_RENT / GARAGE_BUY
- TRADE_SITE / SPECIAL_PURPOSE
- FLAT_SHARE_ROOM / HOUSE_TYPE
- COMPULSORY_AUCTION / SENIOR_CARE

### Nutzung

- **Pay per Result:** $1,49 pro 1.000 Inserate
- **Unbegrenzte Durchläufe:** Du zahlst nur für gelieferte Ergebnisse

### 🙋‍♀️ Individuelle Lösungen

Falls Du Hilfe oder eine individuelle Lösung benötigst (z.B. Enterprise-Preise), kontaktiere mich unter: max@mapa.slmail.me

***

### English Version

🎯 **Try it FREE for 2 hours!**

Get started in under 1 minute - just paste your ImmoScout24 search URL, click "Start", and watch new listings appear instantly. No credit card required for your free trial. [Start your free trial now →](https://console.apify.com/actors/wdaV0qFwqQJ2H7ywd)

### 🤩 Why Use This Scraper?

Collecting ImmoScout24 data reliably yourself is hard. Our specialized scraper:

- ✅ Provides reliable data extraction where DIY solutions typically fail
- ✅ Saves you weeks of development time and ongoing maintenance
- ✅ **Scrape unlimited listings** - Process thousands of properties in a single run
- ✅ Super fast (seconds, not minutes even for processing 1000 listings in one run)

[![Fastest ImmoScout24 API scraper on the market](https://i.postimg.cc/mDRrW3rJ/immoscout24-detail-api-fast.png)](https://i.postimg.cc/mDRrW3rJ/immoscout24-detail-api-fast.png)

Whether you need property data for market analysis, research, price tracking or integration with your systems, this tool delivers consistent results without the headaches of building and maintaining your own scraper.

### 🌟 Features

- 🔍 **Comprehensive Data Extraction** - Extracts detailed property information including descriptions, pricing, features, contact details, and images
- ✉️ **Contact Information** - Includes contact name, address and phone number when available in the listing
- 🚀 **High Performance** - Process up to 10000 URLs per run within seconds
- ♾️ **Unlimited Usage** - No restrictions on the number of listings you can scrape
- 💰 **Cost-Effective** - Only $1.49 per 1,000 results (pay per result)
- 🛡️ **IP Protection** - Fully automatic and preconfigured, no setup required
- 📊 **Rich Data Output** - JSON, CSV, or Excel formats for easy integration

### 💰 How Much Does It Cost?

ImmoScout24 Detail Scraper uses an efficient resource model for cost-effective data extraction:

#### Cost Breakdown

- **Memory usage:** 256MB-512MB for optimal performance
- **Execution time:** Typically 2-60 seconds per run
- **Pay per result:** $1.49 per 1,000 results

#### Memory Recommendations

| Use Case | Memory | Runtime | Listings | Cost Efficiency |
|----------|--------|---------|----------|-----------------|
| Small batches (1-100) | 128MB | 2-10 seconds | Up to 100 | ⭐⭐⭐⭐⭐ |
| Large batches (100-10000) | 256MB | 5-15 seconds | Up to 10000 | ⭐⭐⭐⭐⭐ |

### Quick Start

#### Step-by-Step Instructions

1. **Create an Apify account** [here](https://console.apify.com/sign-up)
   - Register for a free Apify account
   - No credit card required for free accounts

2. **Run the actor**
   - Navigate to the ImmoScout24 Detail-Listing Scraper
   - Enter your list of ImmoScout24 URLs
   - Click "Run"

3. **Access your data**
   - View results directly in the Apify console
   - Download as JSON, CSV, or Excel
   - Use the Apify API to integrate with your applications

### ⬇️ Input

The actor accepts a list of urls to process:

- `urls` (required): An array of ImmoScout24 Detail-Listing URLs to process. Make sure to use the .de domains as currently .at or .ch domains are not supported.

**Example Input:**

```json
{
  "urls": [
    "https://www.immobilienscout24.de/expose/123456789",
    "https://www.immobilienscout24.de/expose/987654321"
  ]
}
```

The array must not exceed 10000 entries per run, but you can run the actor multiple times for unlimited data collection.

### ⬆️ Output

The actor outputs a dataset with detailed information for each URL. **Sample output:**

```json
{
  "expose_id": 159114845,
  "listing_url": "https://www.immobilienscout24.de/expose/159114845",
  "description": "Modern ausgestattete 3-Zimmerwohnung mit ca. 96m² Wohnfläche mit Aufzug. Die vorhandene Einbauküche ...",
  "furnishing_description": null,
  "location_description": "Das Objekt befindet sich in belebter Wohnlage in Frankfurt am Main Nordend-West. Anbindung ...",
  "further_notes": null,
  "address_line_1": "60318 Nordend-West, Frankfurt am Main",
  "address_line_2": null,
  "location_lat": null,
  "location_lng": null,
  "online_since": null,
  "title": "Frankfurt-Nordend: moderne 3-Zimmer Wohnung mit Balkon, Parkett, EBK, ruhig und freundlich!",
  "heating_included_in_ancillary_costs": true,
  "deposit_costs": "5.250,00",
  "parking_info": "Garage",
  "vacant_at_from": "2025-08-01",
  "publication_state": "active",
  "real_estate_type": "APARTMENT_RENT",
  "property_type": "wohnung_miete",
  "rent_cold": 1750.0,
  "rent_total": 2050.0,
  "purchase_price": 0,
  "private_offer": true,
  "ancillary_costs": 300.0,
  "year_constructed": 1966,
  "condition": "well_kept",
  "size": "96",
  "fitted_kitchen": true,
  "garden": false,
  "number_of_floors": "4",
  "cellar": true,
  "house_number": "no_information",
  "rooms": "3",
  "elevator": true,
  "city_district": "Nordend_West",
  "firing_types": "oil",
  "street": "no_information",
  "zip_code": 60318,
  "heating_costs": 0.0,
  "city": "Frankfurt_am_Main",
  "state": "Hessen",
  "pets_allowed": false,
  "balcony_terrace": true,
  "floor": "1",
  "picture_count": 14,
  "is_expose_buy": false,
  "visits": null,
  "contact_requests": null,
  "pictures": [
    {
      "type": "full",
      "full_url": "<url of the image>",
      "web_url": "<url of the image>",
      "preview_url": "<url of the image>",
      "caption": "1_Wohnzimmer"
    }
  ],
  "documents": [
    {
      "type": "document",
      "name": "Grundriss",
      "url": "<url of the document>"
    },
    {
      "type": "document",
      "name": "Energieausweis",
      "url": "<url of the document>"
    }
  ],
  "no_of_parking_spaces": null,
  "heating_type": "oil_heating",
  "type_of_flat": "apartment",
  "is_rented": false,
  "is_barrier_free": true,
  "contact": {
    "premium_profile_required_for_contacting": true,
    "type": "private",
    "name": "Mr. Name",
    "address": "",
    "phone_number": "+49 ..."
  },
  "attributes": {
    "obj_regio1": "Hessen",
    "obj_serviceCharge": "300",
    "obj_heatingType": "oil_heating",
    "obj_cId": "18660995",
    "obj_newlyConst": "n",
    "obj_balcony": "y",
    "obj_picturecount": "14",
    "obj_totalRent": "2050",
    "obj_yearConstructed": "1966",
    "geo_ot": "nordend_west",
    "obj_privateOffer": "true",
    "obj_scoutId": "159114845",
    "obj_firingTypes": "oil",
    "obj_hasKitchen": "y",
    "obj_ExclusiveExpose": "false",
    "geo_bln": "hessen",
    "obj_cellar": "y",
    "obj_yearConstructedRange": "2",
    "obj_baseRent": "1750",
    "obj_houseNumber": "no_information",
    "obj_livingSpace": "96",
    "geo_krs": "frankfurt_am_main",
    "obj_zipCode": "60318",
    "obj_condition": "well_kept",
    "obj_interiorQual": "sophisticated",
    "obj_highDemand": "false",
    "obj_petsAllowed": "negotiable",
    "obj_street": "no_information",
    "obj_lift": "y",
    "obj_depositLink": "y",
    "obj_baseRentRange": "8",
    "obj_streetPlain": "no_information",
    "obj_typeOfFlat": "apartment",
    "obj_noRooms": "3",
    "obj_assistedLiving": "n",
    "obj_ityp": "0,active",
    "geo_land": "deutschland",
    "obj_immotype": "wohnung_miete",
    "obj_privateOfferInvestmentCheck": "false",
    "obj_contactFormInputFieldCount": "10",
    "obj_floor": "1",
    "obj_cwId": "009.c750431e-0b31-4a5b-9742-a00d52586610",
    "obj_numberOfFloors": "4",
    "geo_bg": "innenstadt_iii",
    "obj_noRoomsRange": "3",
    "obj_garden": "n",
    "obj_regio4": "Nordend_West",
    "obj_barrierFree": "y",
    "obj_international": "n",
    "obj_regio3": "Innenstadt_III",
    "obj_objectnumber": "159114845",
    "obj_livingSpaceRange": "4",
    "obj_regio2": "Frankfurt_am_Main"
  }
}
```

#### Property Types

The property `real_estate_type` can be one of:

- APARTMENT_BUY / APARTMENT_RENT
- HOUSE_BUY / HOUSE_RENT
- INDUSTRY / OFFICE / STORE
- ASSISTED_LIVING / GASTRONOMY
- SHORT_TERM_ACCOMMODATION / INVESTMENT
- LIVING_RENT_SITE / LIVING_BUY_SITE
- GARAGE_RENT / GARAGE_BUY
- TRADE_SITE / SPECIAL_PURPOSE
- FLAT_SHARE_ROOM / HOUSE_TYPE
- COMPULSORY_AUCTION / SENIOR_CARE

### 🚀 Integration with ImmoScout24 API Lite

Combine the Detail Scraper with our **ImmoScout24 API Lite** for a complete monitoring and data extraction solution:

#### Perfect Workflow

1. **🔍 Monitor** - API Lite detects new listings instantly in monitor mode
2. **📋 Extract Details** - Detail Scraper gets comprehensive data from detected URLs
3. **📊 Analyze** - Process complete datasets for research or applications
4. **📱 Get Notified** - Receive alerts for each step

#### Integration Benefits

- **⚡ Speed Advantage** - Monitor + detailed extraction in automated pipeline
- **🎯 Precision Targeting** - Only get detailed data for new/relevant listings
- **💰 Cost Efficiency** - API Lite for monitoring ($0.000 per run), Detail Scraper for comprehensive data
- **🔄 Full Automation** - Complete hands-free property data collection

### ❓ Frequently Asked Questions

#### How reliable is the scraper?

The scraper is continuously updated to adapt to site changes, with a success rate above 99% for valid URLs.

#### What happens if a listing is no longer available?

The scraper will return an error message for that specific URL while continuing to process other URLs in your list.

#### Can I use this data commercially?

Yes, the data extracted can be used for commercial purposes. However, we recommend reviewing ImmoScout24's terms of service regarding data usage.

#### Can I scrape more than 1000 listings at once?

Yes! Currently limited to 10000 URLs per run, but you can run the actor multiple times for unlimited data collection. For larger batches, contact us for custom solutions.

#### What's the difference between this and ImmoScout24 API Lite?

- **API Lite**: Fast monitoring, basic data, real-time alerts, monitor mode, best for regio, radius and shape (Zeichnen) searches
- **Detail Scraper**: Comprehensive property data, contact information (email and phone number if present), full descriptions, etc.

#### Do I need proxies?

The actor automatically uses Apify's residential proxy configuration when available. For optimal performance with large batches, residential proxies are recommended.

### Usage

- **Pay per result:** $1.49 per 1,000 results
- **Unlimited runs:** you only pay for delivered results

### 🔧 Advanced Usage Examples

#### JavaScript Integration

```javascript
import { ApifyApi } from 'apify-client';

const client = new ApifyApi({ token: 'your_apify_token' });

const run = await client.actor('immoscout24-detail-scraper').call({
    urls: [
        "https://www.immobilienscout24.de/expose/123456789",
        "https://www.immobilienscout24.de/expose/987654321"
    ]
}, {
    memory: 1024 // Use 1024MB for large batches
});

const dataset = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Extracted data from ${dataset.items.length} properties`);
```

#### Python Integration

```python
from apify_client import ApifyClient

client = ApifyClient("your_apify_token")

run = client.actor('immoscout24-detail-scraper').call(
    run_input={
        "urls": [
            "https://www.immobilienscout24.de/expose/123456789",
            "https://www.immobilienscout24.de/expose/987654321"
        ]
    },
    memory_mbytes=1024
)

dataset_items = client.dataset(run['defaultDatasetId']).list_items().items
print(f"Extracted data from {len(dataset_items)} properties")
```

### 📊 Popular Use Cases

#### Real Estate Investment Analysis

- Extract comprehensive property data for investment decisions
- Track pricing trends across different markets
- Analyze property features and neighborhood characteristics
- Build automated valuation models

#### Market Research & Analytics

- Collect large datasets for academic or commercial research
- Monitor competitive pricing and availability
- Generate market reports and insights
- Track property market trends over time

#### Property Management

- Extract detailed information for portfolio analysis
- Monitor competitor properties and pricing
- Automate property data collection for CRM systems
- Generate comprehensive property reports

#### Integration with Other Tools

- **Zapier/Make**: Automate workflows with 3000+ apps
- **Google Sheets**: Automatically populate spreadsheets
- **CRM Systems**: Import property data directly
- **Business Intelligence**: Feed data into analytics platforms

### 🙋‍♀️ Custom Solutions

Need help or a custom solution? We offer:

- **Custom data fields** - Extract additional information specific to your needs
- **Bulk processing** - Handle larger datasets with custom configurations
- **API integrations** - Direct integration with your existing systems
- **White-label solutions** - Branded scraping solutions for your business

Contact me at: max@mapa.slmail.me

# Actor input Schema

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

An array of ImmoScout24 Detail-Listing URLs to process. Make sure to use the .de domains as currently .at or .ch domains are not supported. Must not exceed 10000 entries. May also use ID's instead of URL's.

## `feedback` (type: `string`):

For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns.

## Actor input object example

```json
{
  "urls": [
    "https://www.immobilienscout24.de/expose/83860520"
  ]
}
```

# Actor output Schema

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

// Prepare Actor input
const input = {
    "urls": [
        "https://www.immobilienscout24.de/expose/83860520"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("clearpath/immoscout24-detail-listing-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/expose/83860520"] }

# Run the Actor and wait for it to finish
run = client.actor("clearpath/immoscout24-detail-listing-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/expose/83860520"
  ]
}' |
apify call clearpath/immoscout24-detail-listing-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,clearpath/immoscout24-detail-listing-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/wdaV0qFwqQJ2H7ywd/builds/cxFu5eImiiaEmp4c3/openapi.json
