# ImmoScout24 Ad

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/immoscout24/ad` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/immoscout24-ad |

## Access

This endpoint is **private**. Requests return HTTP 403 until access is granted. There is no self-serve request-access button. Open a support ticket from the dashboard Help desk (https://app.piloterr.com/app?returnTo=help-desk/tickets/new) and include the endpoint path, your use case, target fields, and expected volume.

## Description

Retrieve the full expose details of any ImmoScout24 property listing by its unique expose ID.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/immoscout24/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup Berlin-Mitte apartment rental (ID 154389201)

```json
{
  "zip": "10119",
  "city": "Berlin",
  "floor": 3,
  "price": 1050,
  "rooms": 2,
  "title": "Geräumige 2-Zimmer-Wohnung in Berlin-Mitte mit Einbauküche",
  "cellar": true,
  "garden": false,
  "images": [
    "https://pictures.immobilienscout24.de/listings/a1b2c3d4-e5f6-7890-abcd-ef1234567890/image-0/800x600.jpg",
    "https://pictures.immobilienscout24.de/listings/a1b2c3d4-e5f6-7890-abcd-ef1234567890/image-1/800x600.jpg",
    "https://pictures.immobilienscout24.de/listings/a1b2c3d4-e5f6-7890-abcd-ef1234567890/image-2/800x600.jpg",
    "https://pictures.immobilienscout24.de/listings/a1b2c3d4-e5f6-7890-abcd-ef1234567890/image-3/800x600.jpg",
    "https://pictures.immobilienscout24.de/listings/a1b2c3d4-e5f6-7890-abcd-ef1234567890/image-4/800x600.jpg"
  ],
  "address": "Torstraße 45",
  "balcony": false,
  "deposit": 3150,
  "parking": "none",
  "currency": "EUR",
  "district": "Mitte",
  "elevator": false,
  "latitude": 52.5268,
  "condition": "modernized",
  "expose_id": "154389201",
  "longitude": 13.4106,
  "warm_rent": 1280,
  "year_built": 1910,
  "description": "Wir vermieten eine gepflegte, helle 2-Zimmer-Wohnung in zentraler Lage in Berlin-Mitte. Die Wohnung befindet sich im 3. Obergeschoss eines Altbaus (Baujahr 1910, vollständig saniert 2018). Ausstattung: Einbauküche, Parkettboden, Fußbodenheizung im Bad, modernes Bad mit Dusche und Badewanne. Die Wohnung liegt in der Torstraße, fußläufig zu U-Bahn-Station Rosenthaler Platz (U8). Besichtigungen nach Vereinbarung.",
  "firing_type": "gas",
  "listing_url": "https://www.immobilienscout24.de/expose/154389201",
  "living_area": 68,
  "seller_type": "agency",
  "contact_name": "Julia Herrmann",
  "heating_type": "central_heating",
  "pets_allowed": null,
  "published_at": "2026-04-21T09:00:00Z",
  "total_floors": 5,
  "contact_email": "berlin@buwog.com",
  "contact_phone": "+49 30 88009800",
  "energy_rating": "D",
  "federal_state": "Berlin",
  "heating_costs": 50,
  "apartment_type": "flat",
  "floor_plan_url": "https://pictures.immobilienscout24.de/listings/a1b2c3d4-e5f6-7890-abcd-ef1234567890/floorplan/800x600.jpg",
  "contact_company": "BUWOG Immobilien GmbH",
  "additional_costs": 180,
  "real_estate_type": "apartmentrent",
  "energy_consumption_kwh": 112.4,
  "energy_certificate_type": "demand"
}
```

### Lookup Munich house for sale (ID 155102847)

```json
{
  "zip": "81241",
  "city": "München",
  "floor": null,
  "price": 1280000,
  "rooms": 5,
  "title": "Freistehendes Einfamilienhaus in München-Pasing, 5 Zimmer, Garten",
  "cellar": true,
  "garden": true,
  "images": [
    "https://pictures.immobilienscout24.de/listings/d4e5f6a7-b8c9-0123-def0-456789012345/image-0/800x600.jpg",
    "https://pictures.immobilienscout24.de/listings/d4e5f6a7-b8c9-0123-def0-456789012345/image-1/800x600.jpg",
    "https://pictures.immobilienscout24.de/listings/d4e5f6a7-b8c9-0123-def0-456789012345/image-2/800x600.jpg",
    "https://pictures.immobilienscout24.de/listings/d4e5f6a7-b8c9-0123-def0-456789012345/image-3/800x600.jpg"
  ],
  "address": "Gleichmannstraße 12",
  "balcony": true,
  "deposit": null,
  "parking": "garage",
  "currency": "EUR",
  "district": "Pasing",
  "elevator": false,
  "latitude": 48.1397,
  "condition": "refurbished",
  "expose_id": "155102847",
  "longitude": 11.4573,
  "warm_rent": null,
  "year_built": 1975,
  "description": "Gepflegtes, freistehendes Einfamilienhaus in ruhiger Wohnlage in München-Pasing. Das Haus wurde 1975 erbaut und 2019 umfassend renoviert (neue Heizung, neues Dach, neue Fenster). Fußbodenheizung im Erdgeschoss, Kamin im Wohnzimmer, großer Garten ca. 400 m², Doppelgarage. Sehr gute U-Bahn-Anbindung (U5 Westendstraße, 8 Minuten zu Fuß). Energieausweis vorhanden.",
  "firing_type": "gas",
  "listing_url": "https://www.immobilienscout24.de/expose/155102847",
  "living_area": 168,
  "seller_type": "agency",
  "contact_name": "Stefan Berger",
  "heating_type": "floor_heating",
  "pets_allowed": true,
  "published_at": "2026-04-20T08:00:00Z",
  "total_floors": 2,
  "contact_email": "muenchen-west@engelvoelkers.com",
  "contact_phone": "+49 89 20180900",
  "energy_rating": "C",
  "federal_state": "Bayern",
  "heating_costs": null,
  "apartment_type": null,
  "floor_plan_url": "https://pictures.immobilienscout24.de/listings/d4e5f6a7-b8c9-0123-def0-456789012345/floorplan/800x600.jpg",
  "contact_company": "Engel & Völkers München West",
  "additional_costs": null,
  "real_estate_type": "housebuy",
  "energy_consumption_kwh": 74.2,
  "energy_certificate_type": "demand"
}
```

## Documentation

## Overview
ImmoScout24 is Germany's largest property marketplace. Cloudflare protects the site against automated access. Piloterr handles the bypass and returns the full expose as structured JSON: price breakdown, property specs, energy rating, seller contact, and images.

## Quickstart
```
GET https://api.piloterr.com/v2/immoscout24/ad?id=154389201
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `id` | string | yes | Unique expose ID (from the listing URL or from `/v2/immoscout24/search`) |

## Main use cases
- Enrich property databases with complete ImmoScout24 expose data including energy rating, deposit, and floor plan
- Build real-time price monitors for individual German property listings
- Extract seller and agency contact details for real estate lead generation at scale
- Power property due-diligence workflows with energy, floor, and condition data
- Feed investment analysis tools with live German property data: price per m², year built, heating costs