# ImmobilienScout24 Search ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/immobilienscout24/search` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 2 credits per call | | **Documentation** | https://www.piloterr.com/library/immobilienscout24-search | ## Description Search ImmobilienScout24 by region and property type. real_estate_type covers rent, buy, house, and land. Page with pagenumber. ## 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/immobilienscout24/search' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Berlin apartment for rent ```json { "results": [ { "id": "168052908", "url": "https://www.immobilienscout24.de/expose/168052908", "city": "Berlin", "tags": [], "price": 362, "rooms": 2, "title": "Naturverbunden wohnen in kompakter 2-Zimmer-Gartenwohnung mit WBS-140-Förderung", "garden": false, "images": [ "https://pictures.immobilienscout24.de/listings/7059e813-0eb0-4e71-82d6-e98b247a3755-2033933665.jpg/ORIG/legacy_thumbnail/800x600/format/webp/quality/50" ], "is_new": false, "street": "Hellersdorfer Straße", "address": "Hellersdorfer Straße 91, Hellersdorf, Berlin", "balcony": false, "project": { "id": "147913", "url": "https://www.immobilienscout24.de/neubau/gesobau-ag/cecilien-carr/147913.html", "name": "Cecilien-Carré", "title": "Moderne Neubauwohnungen im grünen Berlin-Hellersdorf – WBS 220 erforderlich", "address": "Hellersdorfer Straße 91, 12619 Berlin", "price_display": "362 - 1.271 €", "available_from": "16.10.2026", "living_space_display": "52 - 87 m²", "grouped_listing_count": 10 }, "quarter": "Kaulsdorf (Hellersdorf)", "realtor": "GESOBAU AG", "currency": "EUR", "latitude": 52.52485, "postcode": "12619", "floorplan": false, "longitude": 13.58695, "offer_type": "rent", "total_rent": 569, "house_number": "91", "listing_type": "XXL", "living_space": 51.7, "published_at": "2026-10-07T12:56:54.000+02:00", "price_display": "362 €", "private_offer": false, "price_interval": "month", "built_in_kitchen": false, "floorplan_images": [], "real_estate_type": "apartment_rent", "construction_year": 2025, "total_rent_display": "569 €", "living_space_display": "51,7 m²", "energy_efficiency_class": "B" } ], "pagination": { "next": "https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten?pagenumber=2", "page": 1, "per_page": 20, "total_pages": 632, "total_results": 13214 } } ``` ### Berlin apartment for sale ```json { "results": [ { "id": "166798088", "url": "https://www.immobilienscout24.de/expose/166798088", "city": "Berlin", "tags": [ "Balkon/Terrasse" ], "price": 519464, "rooms": 3, "title": "Altbau-Charme in Treptow-Köpenick – Gemütliche 3-Zimmer-Wohnung mit zwei Balkonen", "garden": false, "images": [ "https://pictures.immobilienscout24.de/listings/74f381ed-e8e8-45c7-9cfa-b98bcc835c72-2011215447.jpg/ORIG/legacy_thumbnail/800x600/format/webp/quality/50" ], "is_new": false, "street": "Baumschulenstraße", "address": "Baumschulenstraße 27/29, Baumschulenweg, Berlin", "balcony": true, "project": { "id": "127686", "url": "https://www.immobilienscout24.de/neubau/escon-gmbh/baumschulenstrasse-27-29/127686.html", "name": "Baumschulenstraße 27/29", "title": "Sanierter Altbau in zentraler Lage mit klimatisierten Dachgeschosswohnungen", "address": "Baumschulenstraße 27/29, 12437 Berlin", "price_display": "222.500 - 741.000 €", "available_from": "07/2026", "living_space_display": "33 - 101 m²", "grouped_listing_count": null }, "quarter": "Baumschulenweg (Treptow)", "realtor": "ESCON GmbH", "currency": "EUR", "latitude": 52.46454, "postcode": "12437", "floorplan": true, "longitude": 13.48634, "offer_type": "buy", "total_rent": null, "house_number": "27/29", "listing_type": "XXL", "living_space": 84.65, "published_at": "2026-04-08T15:40:53.000+02:00", "price_display": "519.464 €", "private_offer": false, "price_interval": "one_time_charge", "built_in_kitchen": false, "floorplan_images": [ "https://pictures.immobilienscout24.de/listings/f46e6ba8-dbc2-4714-b4aa-d4bb72d88010-2011215445.jpg/ORIG/legacy_thumbnail/800x600/format/webp/quality/50" ], "real_estate_type": "apartment_buy", "construction_year": null, "total_rent_display": null, "living_space_display": "84,65 m²", "energy_efficiency_class": null } ], "pagination": { "next": "https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-kaufen?pagenumber=2", "page": 1, "per_page": 20, "total_pages": 642, "total_results": 13741 } } ``` ## Documentation ## Overview Search immobilienscout24.de. ## Quickstart Berlin rent: ``` GET https://api.piloterr.com/v2/immobilienscout24/search?query=berlin/berlin&real_estate_type=rent ``` Berlin buy, page 2: ``` GET https://api.piloterr.com/v2/immobilienscout24/search?query=berlin/berlin&real_estate_type=buy&page=2 ``` Then open expose `168052908` on `/v2/immobilienscout24/property`. ## Parameters | Parameter | Required | Example | |---|---|---| | `query` | yes | `berlin/berlin` or `bayern/muenchen`. `berlin` alone is `berlin/berlin`. An expose URL is rejected. | | `real_estate_type` | no | `rent` or `buy`. Also `wohnung-mieten`, `wohnung-kaufen`, `haus-mieten`, `haus-kaufen`, `grundstueck-kaufen`, `wg-zimmer`, `wohnen-auf-zeit`. | | `page` | no | `1`, or `2` for the next page. Page 2 of a Berlin rent search returns different listing ids. | | `return_page_source` | no | When true, the raw HTML is returned. | ## Response fields `price` is that listing's cold rent or purchase price. `price_display` is the card label, such as `362 €` or `519.464 €`. `total_rent` is the warm rent. On expose `168052908` the cold rent is 362 and the warm rent is 569. A sale has no warm rent, so `total_rent` is null. A project span stays on `project.price_display`, for example `362 - 1.271 €` or `222.500 - 741.000 €`. ## Main use cases - Monitor Berlin apartment rents - Collect Munich homes for sale - Split a project price range from a single cold rent ## Error codes | Code | When | |---|---| | 400 | Missing query, a region that is not a place name, an unknown type, or a domain that is not ImmobilienScout24 | | 401 | Missing API key | | 403 | The site showed a bot check | | 404 | The page had no listings | ## Related endpoints [ImmobilienScout24 Property](https://www.piloterr.com/library/immobilienscout24-property)