Piloterr

ImmobilienScout24 Search

GET
/v2/immobilienscout24/search

Search ImmobilienScout24 by region and property type. real_estate_type covers rent, buy, house, and land. Page with pagenumber.

Credit cost: 2 credits per call

Authorization

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Query Parameters

query*string

Where to search.

Berlin rent:

berlin/berlin

Berlin buy: the same region, with real_estate_type set to buy.

Another city:

bayern/muenchen

Full search URL:

https://www.immobilienscout24.de/Suche/de/berlin/berlin/wohnung-mieten

berlin alone is the same as berlin/berlin. An expose URL is rejected.

Default"berlin/berlin"
real_estate_type?string

Rent or buy.

Berlin rent:

rent

Berlin buy:

buy

Also accepted: wohnung-mieten, wohnung-kaufen, haus-mieten, haus-kaufen, grundstueck-kaufen, wg-zimmer, wohnen-auf-zeit.

On a full URL this replaces the kind already in the path.

page?number

Page number, starting at 1.

Next page of a Berlin rent search:

2

Page 2 returns different listing ids from page 1.

return_page_source?boolean

When true, return the raw HTML in result instead of the parsed JSON.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/immobilienscout24/search?query=berlin%2Fberlin"

{  "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  }}

{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}