# ImmoScout24 Search

## Overview

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

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

Search ImmoScout24 listings in real time and retrieve price, rooms, area, and contact data for any German property query.

## 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/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search apartments for rent in Berlin Mitte

```json
{
  "meta": {
    "page": 1,
    "query": "Berlin Mitte",
    "total_pages": 63,
    "has_next_page": true,
    "total_results": 1247,
    "real_estate_type": "apartmentrent"
  },
  "result": [
    {
      "zip": "10119",
      "city": "Berlin",
      "price": 1050,
      "rooms": 2,
      "title": "Geräumige 2-Zimmer-Wohnung in Berlin-Mitte mit Einbauküche",
      "address": "Torstraße 45",
      "currency": "EUR",
      "latitude": 52.5268,
      "expose_id": "154389201",
      "longitude": 13.4106,
      "warm_rent": 1280,
      "listing_url": "https://www.immobilienscout24.de/expose/154389201",
      "living_area": 68,
      "seller_type": "agency",
      "published_at": "2026-04-21T09:00:00Z",
      "thumbnail_url": "https://pictures.immobilienscout24.de/listings/a1b2c3d4-e5f6-7890-abcd-ef1234567890/image-0/300x200.jpg",
      "real_estate_type": "apartmentrent"
    },
    {
      "zip": "10249",
      "city": "Berlin",
      "price": 1320,
      "rooms": 3,
      "title": "Ruhige 3-Zimmer-Wohnung mit Balkon nahe Volkspark Friedrichshain",
      "address": "Petersburger Str. 12",
      "currency": "EUR",
      "latitude": 52.5161,
      "expose_id": "154521837",
      "longitude": 13.4554,
      "warm_rent": 1580,
      "listing_url": "https://www.immobilienscout24.de/expose/154521837",
      "living_area": 84,
      "seller_type": "private",
      "published_at": "2026-04-22T14:30:00Z",
      "thumbnail_url": "https://pictures.immobilienscout24.de/listings/b2c3d4e5-f6a7-8901-bcde-f23456789012/image-0/300x200.jpg",
      "real_estate_type": "apartmentrent"
    }
  ]
}
```

### Search houses for sale in Munich with price filter

```json
{
  "meta": {
    "page": 1,
    "query": "München",
    "total_pages": 20,
    "has_next_page": true,
    "total_results": 387,
    "real_estate_type": "housebuy"
  },
  "result": [
    {
      "zip": "81241",
      "city": "München",
      "price": 1280000,
      "rooms": 5,
      "title": "Freistehendes Einfamilienhaus in München-Pasing, 5 Zimmer, Garten",
      "address": "Gleichmannstraße 12",
      "currency": "EUR",
      "latitude": 48.1397,
      "expose_id": "155102847",
      "longitude": 11.4573,
      "warm_rent": null,
      "listing_url": "https://www.immobilienscout24.de/expose/155102847",
      "living_area": 168,
      "seller_type": "agency",
      "published_at": "2026-04-20T08:00:00Z",
      "thumbnail_url": "https://pictures.immobilienscout24.de/listings/d4e5f6a7-b8c9-0123-def0-456789012345/image-0/300x200.jpg",
      "real_estate_type": "housebuy"
    }
  ]
}
```

## Documentation

## Overview
ImmoScout24 is Germany's largest property marketplace. Cloudflare protects the site from automated access. Piloterr handles the bypass and returns structured JSON listing data in real time, no proxies to manage, no HTML to parse.

## Quickstart
```
GET https://api.piloterr.com/v2/immoscout24/search?query=Berlin%20Mitte&real_estate_type=apartmentrent
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | City, district, or postal code |
| `real_estate_type` | string | no | `apartmentrent` (default), `apartmentbuy`, `houserent`, `housebuy` |
| `price_from` / `price_to` | number | no | Price range in EUR |
| `rooms_from` / `rooms_to` | number | no | Room count range |
| `area_from` / `area_to` | number | no | Living area range in m² |
| `page` | number | no | Page number (default: 1) |

## Main use cases
- Build German real estate price trackers that monitor rental and purchase trends by district in real time
- Aggregate ImmoScout24 listings into a property intelligence dashboard with price per m² breakdowns
- Power tenant-side tools that alert users when new listings matching their criteria appear in a target city
- Collect location-level data for urban analytics and neighbourhood pricing models
- Feed property comparison platforms with live German market data across cities and property types