immoscout24.de APIimmoscout24.de ↗
Search and retrieve German real estate listings from Immobilienscout24.de. Filter by location, property type, rent or purchase. Get size, rooms, rent, and address data.
curl -X GET 'https://api.parse.bot/scraper/643cd5c4-de62-4953-9dd5-f0cf43c84927/search_listings' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for real estate listings in Germany by region and type.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| location | string | Location path, e.g., 'berlin/berlin' or 'bayern/muenchen' |
| real_estate_type | string | Type of real estate (e.g., 'wohnung-mieten', 'haus-kauf', 'wohnung-kauf') |
{
"type": "object",
"fields": {
"page": "integer",
"type": "string",
"count": "integer",
"listings": "array",
"location": "string"
},
"sample": {
"page": 1,
"type": "wohnung-mieten",
"count": 20,
"listings": [
{
"price": "1.853,83 €",
"title": "Modern Apartment",
"address": {
"city": "Berlin",
"street": "Wendenstrasse",
"postcode": "12557"
},
"expose_id": "162905573"
}
],
"location": "berlin/berlin"
}
}About the immoscout24.de API
The Immobilienscout24 API gives access to Germany's largest property portal through 2 endpoints covering search and listing detail retrieval. Use search_listings to query rentals and purchases by region and property type, and get_listing_details to pull full listing data including obj_baseRent, obj_livingSpace, obj_noRooms, and address fields for any specific Scout ID.
Search Listings
The search_listings endpoint accepts a location path (e.g. berlin/berlin or bayern/muenchen), a real_estate_type such as wohnung-mieten (apartment rental), haus-kauf (house purchase), or wohnung-kauf (apartment purchase), and an integer page parameter for pagination. The response returns the matched listings array alongside count (total result count), type, page, and location — enough to build paginated search flows or monitor listing volume in a given area.
Listing Details
The get_listing_details endpoint takes a single required id (the Scout ID, e.g. 162905573) and returns the full record for that listing. Key fields include obj_scoutId, obj_street, obj_zipCode, obj_baseRent (float, monthly base rent in EUR), obj_livingSpace (square meters), and obj_noRooms (float, room count). These fields cover the core attributes needed for rental market analysis, lead generation, or property tracking.
Coverage and Scope
Listings are scoped to Germany. The real_estate_type parameter controls whether you are searching the rental or purchase market; each type maps to a distinct segment of the portal. Pagination is handled via the page parameter in search_listings — there is no cursor-based pagination. Freshness depends on active listings on the portal at query time; delisted properties will not appear in search results.
- Track average
obj_baseRentacross Berlin neighborhoods by paginatingsearch_listingswith differentlocationvalues. - Build a rental price comparison tool for
wohnung-mietenlistings across Munich, Hamburg, and Frankfurt. - Monitor new listings in a target zip code by polling
search_listingsand checkingcountchanges over time. - Enrich a CRM with full listing details by feeding Scout IDs into
get_listing_detailsto retrieveobj_street,obj_zipCode, andobj_livingSpace. - Generate leads for relocation services by searching
haus-kauflistings in specific German regions. - Analyze room-to-rent ratios in German cities using
obj_noRoomsandobj_baseRentfrom bulk listing detail calls.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Immobilienscout24 have an official developer API?+
What does `search_listings` return beyond a list of properties?+
listings array along with the total count of matched results, the current page number, the type of real estate queried, and the location string used in the request. This lets you determine how many pages exist and confirm the query parameters were interpreted as expected.Does `get_listing_details` return agent contact information or photos?+
obj_street, obj_zipCode, obj_noRooms, obj_baseRent, obj_livingSpace, and obj_scoutId. Agent contact details and listing photos are not currently exposed by this endpoint. You can fork the API on Parse and revise it to add those fields if they are available on the listing page.Can I filter `search_listings` by price range or living space?+
search_listings inputs are location, real_estate_type, and page. Price or size filters are not currently available as parameters. You can fork the API on Parse and revise the endpoint to add those filter parameters.Does the API cover listings outside Germany, such as Austria or Switzerland?+
location parameter maps to German regions (e.g. berlin/berlin, bayern/muenchen). Immobilienscout24.de is a German portal; Austrian or Swiss listings are not in scope. You can fork the API on Parse and revise it to target equivalent portals for those markets.