immobilienscout24.de APIimmobilienscout24.de ↗
Access ImmobilienScout24.de geo suggestions, listing details, property images, and realtor profiles via 5 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/c161b4d9-ffca-40ff-b4e9-3bb0e8bdc884/get_geocode_suggestions?QUERY=M%C3%BCnchen' \ -H 'X-API-Key: $PARSE_API_KEY'
Get geocode ID and path suggestions for a location name (city, postcode, street, train station, POI, address). Returns an array of location suggestions with entity details and match offsets. Useful for resolving location names to structured geo identifiers.
| Param | Type | Description |
|---|---|---|
| QUERYrequired | string | Location search query (city name, postcode, street, district, train station, POI, or address) |
{
"type": "object",
"fields": {
"data": "array of suggestion objects, each with 'entity' (type, id, label, geopath) and 'matches' (array of offset/length)",
"status": "string, always 'success'"
},
"sample": {
"data": [
{
"entity": {
"id": "1276003001",
"type": "city",
"label": "Berlin",
"geopath": {
"uri": "/de/berlin/berlin"
}
},
"matches": [
{
"length": 6,
"offset": 0
}
]
},
{
"entity": {
"id": "1100000006",
"type": "quarterOrTown",
"label": "Berlin - Steglitz-Zehlendorf",
"geopath": {
"uri": "/de/berlin/berlin/steglitz-zehlendorf"
}
},
"matches": [
{
"length": 6,
"offset": 0
}
]
}
],
"status": "success"
}
}About the immobilienscout24.de API
The ImmobilienScout24 API provides access to Germany's largest real estate portal across 5 endpoints, covering location geocoding, property listings, listing images, and realtor profiles. The get_geocode_suggestions endpoint resolves city names, postcodes, train stations, and addresses into structured geo identifiers with type, label, and geopath fields — a prerequisite for location-based listing searches.
Location Resolution
The get_geocode_suggestions endpoint accepts a QUERY string — city name, postcode, street, district, POI, or full address — and returns an array of suggestion objects. Each object includes an entity with type, id, label, and geopath, plus a matches array of offset/length pairs for highlighting query matches. This makes it straightforward to convert free-text location input into the structured geo identifiers used elsewhere on the platform.
Listing Search and Detail
The search_listings endpoint accepts filters including TYPE (apartmentRent, apartmentBuy, houseRent, houseBuy, and others), LOCATION, MIN_AREA, MAX_AREA, MAX_PRICE, MAX_ROOMS, and SORTING (0 = default, 3 = price descending, 4 = price ascending), returning paginated results via searchResponseModel. The get_listing_details endpoint takes a specific LISTING_ID and returns fields including id, exposeId, totalRent, propertyPrice, realEstateType, and a frontendModel object with the full listing payload. The get_listing_images endpoint returns an images array, imageCount, and totalCount for the same listing ID.
Realtor Profiles
The get_realtor_details endpoint looks up a company-wide realtor by their REALTOR_ID in <prefix>.<uuid> format, as found in listing detail pages. The response data object contains a statusCode (REALTOR_FOUND or REALTOR_NOT_FOUND) and a payload with basicInfo, branchenbuchContactDetails, evaluations, products, and badges. This is useful for building agent directories or cross-referencing listing agents.
Current Limitations
Three endpoints — search_listings, get_listing_details, and get_listing_images — are currently blocked by AWS WAF on the ImmobilienScout24 side. The fully operational endpoints at this time are get_geocode_suggestions and get_realtor_details.
- Resolve German city names and postcodes to structured geo IDs for location-aware real estate tools
- Build an agent or realtor directory using company basicInfo, evaluations, and contact details from get_realtor_details
- Cross-reference realtor badges and products to assess listing agency credibility
- Autocomplete location input in property search UIs using get_geocode_suggestions match offsets
- Aggregate property metadata (type, price, area) from listing detail responses for market analysis
- Compile image galleries for listings using get_listing_images imageCount and images array
- Filter apartment or house listings by price, area, and room count via search_listings parameters
| 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.