ImmoScout24 (Germany + Austria) API & Scraper
The ImmoScout24 API returns rental and sale listings from immobilienscout24.de (Germany) and immobilienscout24.at (Austria) as JSON, in euros: search with each site's own filters, full listings with rent and running costs, energy data and photos, and the advertiser's phone numbers.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
It reads both sites logged out. `locations` turns a place name or postcode into the place id each site uses. `search` takes a place, a property type (apartments, houses, plots, garages, rooms, short-term rentals and commercial types, to rent or to buy) and the same filters the site offers, and returns the site's own total with real paging. In Germany a search for apartments to rent in Berlin found 5,225 listings on 2026-11-15 and pages up to 100 rows at a time; in Austria Vienna had 4,096 rental apartments, 25 per page. `listing` returns one listing in full: in Germany cold rent, total rent, service charge, heating costs, deposit, price per m², floor, year built, energy certificate, the full description texts, every photo, the address and coordinates where the advertiser publishes them, and the advertiser's name, company, phone numbers and legal imprint; in Austria every line of the listing's own cost table as its own field (rent, total rent, monthly costs, operating, heating and other costs, each with its VAT line, and the deposit), commission, energy data, features, nearby public transport, photos and the contact person with phone number. `agent` and `agent_listings` return an agency's profile and every listing it has live.
What an ImmoScout24 field actually contains
Fields that read differently from how they look. Every row was measured against live immobilienscout24.de and immobilienscout24.at data on 2026-11-15.
| Field | What it holds |
|---|---|
| price_eur (Germany search row) | The price the German result list prints, rounded to whole euros: 2,166 in the list, 2,165.55 in the listing. Areas are rounded the same way (119 vs 118.99 m²). 16 of 16 German listings checked matched their listing within that rounding. |
| price.total_rent_eur vs monthly_costs_eur (Austria) | total_rent_eur is the listing's 'Gesamtmiete' line: gross rent including operating and other costs and VAT, without heating. monthly_costs_eur is 'Monatliche Kosten' (or 'Gesamtbelastung'): everything payable per month including heating. A Graz flat on 2026-11-15: total rent 793.48, monthly costs 878.14 (= 793.48 + heating 70.55 + VAT 14.11). Each line has its _net_eur and _vat_eur partner where the listing prints one; a line the listing does not print is null, never filled from another line. On 17 Austrian rentals, 96 of 96 returned values matched the listing page's printed cost table. |
| price.base_rent_eur, total_rent_eur (Germany) | Cold rent (Kaltmiete) and total rent including running costs (Warmmiete) as the listing states them, with service_charge_eur and heating_costs_eur beside them. price_basis=total filters on the total rent instead: Berlin apartments up to 1,000 EUR were 2,030 by cold rent and 1,264 by total rent. |
| price.headline_eur, headline_exact_eur (Austria) | headline_eur is the number the Austrian listing prints at the top, which can be rounded (129) or a project's lowest unit ("ab 110 €"); headline_exact_eur is the matching line of the listing's own cost table (129.36). 8 of 8 single listings matched their search row exactly. |
| matches_requested_deal (Austria) | The Austrian rent list also shows new-build projects for sale: on Vienna's first rental page 2 of 25 rows were for sale. They are kept, because the site shows them, and marked false. |
| total vs result_entries_total (Germany) | Commercial and new-build results group several listings of one advertiser into one entry. total counts listings (Berlin offices: 12,221), result_entries_total counts entries (9,382); a page can return more rows than page_size. |
| agent.phones, agent.imprint (Germany) | The phone numbers the advertiser publishes on the listing and the advertiser's legal imprint with its own phone numbers and e-mail. 12 of 16 German listings published a phone number directly; 15 of 16 carried an imprint. |
| agent.id | The advertiser's id on ImmoScout24 (Germany 001.559854, Austria 012.0012000001QAU61). agent_listings takes it and returns every live listing of that advertiser: GESOBAU had 88 apartments to rent. |
| address.latitude, longitude | Coordinates as the site publishes them. Germany: 225 of 434 search rows (listings with a hidden street address carry none). Austria: 250 of 320 search rows; the Austrian listing page itself publishes no coordinates. |
Prices are in euros as each site prints them. Every listing id taken from a search (32 of 32, both countries) came back as the same listing.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/immoscout24/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"location": "Berlin",
"property_type": "apartment_rent"
}
}{
"ok": true,
"meta": {
"api": "immoscout24",
"endpoint": "search",
"mode": "live",
"latency_ms": 437.6,
"record_count": 20,
"bytes": 27824,
"cache_hit": false,
"stop_reason": "limit_reached",
"upstream_requests": 1,
"country": "de",
"total": 5223,
"page": 1,
"charged_credits": 2,
"version": "1.0.0",
"request_id": "2924a26cd1dc4880",
"queue_ms": 4.3,
"fetched_at": "2026-11-15T18:52:17.554Z"
},
"data": {
"results": [
{
"id": "172626075",
"url": "https://www.immobilienscout24.de/expose/172626075",
"country": "de",
"title": "Ihr neues Zuhause zu zweit",
"property_type": "apartment_rent",
"price_eur": 2166,
"price_text": "2.166 €",
"price_per_sqm_eur": null,
"area_m2": 119,
"rooms": 1,
"plot_m2": null,
"net_floor_m2": null,
"total_floor_m2": null,
"divisible_from_m2": null,
"key_facts": [
"2.166 €",
"119 m²",
"1 Zi."
],
"address": {
"text": "Johann-Georg-Straße 9 A, 10709 Berlin, Wilmersdorf",
"street": "Johann-Georg-Straße 9 A",
"postcode": "10709",
"city": "Berlin",
"district": "Wilmersdorf",
"latitude": 52.497,
"longitude": 13.29797
},
"energy_class": "B",
"published": "vor 2 Tagen",
"is_private": false,
"is_project": false,
"is_new": false,
"has_live_video_tour": false,
"only_on_immoscout24": false,
"listing_size": "XL",
"tags": [],
"photo": "https://pictures.immobilienscout24.de/listings/9b41c22e-473d-4e8e-b50f-af38bfea8835-2129708367.jpg/ORIG/resize/800x600>/format/webp/quality/80",
"photos": [
"https://pictures.immobilienscout24.de/listings/9b41c22e-473d-4e8e-b50f-af38bfea8835-2129708367.jpg/ORIG/legacy_thumbnail/1500x1000/format/webp/quality/80"
],
"agency_logo": "https://pictures.immobilienscout24.de/usercontent/9e2ab332-4e91-4991-ac70-0dc4ce04280c.PNG/ORIG/resize/300x300/format/webp/quality/80",
"group": null
},
{
"id": "172626069",
"url": "https://www.immobilienscout24.de/expose/172626069",
"country": "de",
"title": "Für die schönen Seiten des Lebens",
"property_type": "apartment_rent",
"price_eur": 1097,
"price_text": "1.097 €",
"price_per_sqm_eur": null,
"area_m2": 60,
"rooms": 1,
"plot_m2": null,
"net_floor_m2": null,
"total_floor_m2": null,
"divisible_from_m2": null,
"key_facts": [
"1.097 €",
"60 m²",
"1 Zi."
],
"address": {
"text": "Johann-Georg-Straße 9 A, 10709 Berlin, Wilmersdorf",
"street": "Johann-Georg-Straße 9 A",
"postcode": "10709",
"city": "Berlin",
"district": "Wilmersdorf",
"latitude": 52.497,
"longitude": 13.29797
},
"energy_class": "B",
"published": "vor 2 Tagen",
"is_private": false,
"is_project": false,
"is_new": false,
"has_live_video_tour": false,
"only_on_immoscout24": false,
"listing_size": "XL",
"tags": [],
"photo": "https://pictures.immobilienscout24.de/listings/c4b1ea14-1cbc-436e-831c-5ed38c444108-2129708229.jpg/ORIG/resize/800x600>/format/webp/quality/80",
"photos": [
"https://pictures.immobilienscout24.de/listings/c4b1ea14-1cbc-436e-831c-5ed38c444108-2129708229.jpg/ORIG/legacy_thumbnail/1500x1000/format/webp/quality/80"
],
"agency_logo": "https://pictures.immobilienscout24.de/usercontent/9e2ab332-4e91-4991-ac70-0dc4ce04280c.PNG/ORIG/resize/300x300/format/webp/quality/80",
"group": null
},
{
"id": "172626061",
"url": "https://www.immobilienscout24.de/expose/172626061",
"country": "de",
"title": "Für die schönen Seiten des Lebens",
"property_type": "apartment_rent",
"price_eur": 2287,
"price_text": "2.287 €",
"price_per_sqm_eur": null,
"area_m2": 126,
"rooms": 1,
"plot_m2": null,
"net_floor_m2": null,
"total_floor_m2": null,
"divisible_from_m2": null,
"key_facts": [
"2.287 €",
"126 m²",
"1 Zi."
],
"address": {
"text": "Johann-Georg-Straße 9 A, 10709 Berlin, Wilmersdorf",
"street": "Johann-Georg-Straße 9 A",
"postcode": "10709",
"city": "Berlin",
"district": "Wilmersdorf",
"latitude": 52.497,
"longitude": 13.29797
},
"energy_class": "B",
"published": "vor 2 Tagen",
"is_private": false,
"is_project": false,
"is_new": false,
"has_live_video_tour": false,
"only_on_immoscout24": false,
"listing_size": "XL",
"tags": [],
"photo": "https://pictures.immobilienscout24.de/listings/0447d233-d752-4453-a62b-0e522935c324-2129708086.jpg/ORIG/resize/800x600>/format/webp/quality/80",
"photos": [
"https://pictures.immobilienscout24.de/listings/0447d233-d752-4453-a62b-0e522935c324-2129708086.jpg/ORIG/legacy_thumbnail/1500x1000/format/webp/quality/80"
],
"agency_logo": "https://pictures.immobilienscout24.de/usercontent/9e2ab332-4e91-4991-ac70-0dc4ce04280c.PNG/ORIG/resize/300x300/format/webp/quality/80",
"group": null
}
],
"count": 20,
"total": 5223,
"result_entries_total": 5223,
"page": 1,
"page_size": 20,
"total_pages": 262,
"has_next": true,
"country": "de",
"property_type": "apartment_rent",
"sort": "default",
"location": {
"query": "Berlin",
"id": "1276003001",
"name": "Berlin",
"type": "city",
"parent": "Berlin",
"latitude": 52.51051,
"longitude": 13.43068,
"search_mode": "region"
},
"filters_applied": {}
}
}What the ImmoScout24 (Germany + Austria) API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| locations | Look up places by name or postcode and get the location ids the search actions accept: cities, districts, quarters, postcodes and streets in Germany; states, cities, districts, quarters and postcodes in Austria. | Real-estate investors call locations to look up places by name or postcode and get the location ids the search actions accept. | query, country |
| search | Search ImmoScout24 listings (Germany or Austria) in a place, with every filter and sort the site itself offers, paged with the source's own total. Germany pages up to 100 rows; Austria 25 rows per page and 100 pages at most (the site's own ceiling). | Brokerage tools call search to search ImmoScout24 listings (Germany or Austria) in a place, with every filter and sort the s…. | location, country, property_type, sort, page, ... |
| search_by_coordinates | Germany: search listings within a radius (km) of a latitude / longitude, with the same filters, sorting and paging as `search`. | Property dashboards call search_by_coordinates to get germany. | latitude, longitude, radius_km, property_type, sort, ... |
| count | Count the listings that match a place and filters without paging through them. | Lead-generation teams call count to get count the listings that match a place and filters without paging through them.. | location, country, property_type, apartment_types, area_max, ... |
| listing | Everything the site shows on one listing (expose): price, rent with running and heating costs, deposit, commission, purchase costs, area, rooms, floor, year built, condition, energy certificate, the full description texts, every photo, the address and coordinates as published, the advertiser (name, company, phone numbers, imprint, rating, profile link), the local price comparison and the sibling units of a new-build project. Takes a German or Austrian listing id or link. | Real-estate investors call listing to get everything the site shows on one listing (expose). | listing |
| project | Germany: a new-build project — name, developer, price range, description, address with coordinates, photos, documents, contact with phone and imprint, and every unit it lists. | Brokerage tools call project to get germany. | project |
| agent | The advertiser (agency / agent / developer / private) behind listings: Austria — the full public profile (name, address, phone numbers, website, about text, logo, badges) by advertiser id or profile link; both markets — from a listing id, the advertiser block of that listing. Always with how many listings the advertiser has live (Germany: per property type). | Property dashboards call agent to get the advertiser (agency / agent / developer / private) behind listings. | agent, listing |
| agent_listings | Every live listing of one advertiser, paged. Germany: one property type per call (default: the advertiser's largest type, with the per-type counts in the answer); Austria: or commercial segment. | Lead-generation teams call agent_listings to get every live listing of one advertiser, paged. | agent, property_type, segment, page, page_size, ... |
Call search from your stack
curl -X POST https://api.reefapi.com/immoscout24/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"location":"Berlin","property_type":"apartment_rent"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/immoscout24/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"location": "Berlin",
"property_type": "apartment_rent"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/immoscout24/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"location": "Berlin",
"property_type": "apartment_rent"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.immoscout24.search with {"location":"Berlin","property_type":"apartment_rent"}.Who uses this API and why
- Track asking rents and prices per city, district or postcode in Germany and Austria.
- Build a lead list of agencies and developers with their phone numbers, imprint and live listing counts.
- Monitor new listings in a search with sort=newest and alert on matches.
- Compare cold rent, total rent, service charges and deposits across neighbourhoods.
- Collect new-build projects with every unit, price and developer contact.
Questions developers ask before integrating
Is there an ImmoScout24 API for Germany and Austria?
Yes. The immoscout24 API on ReefAPI searches immobilienscout24.de (Germany) and immobilienscout24.at (Austria) with each site's own filters and returns full listings with rent, running costs, deposit, energy data, photos and the advertiser's phone numbers as JSON, without an ImmoScout24 account.
Do I need an ImmoScout24 account?
No. Everything is read logged out, for Germany and for Austria.
Which filters can I use for Germany?
Price (cold or total rent), rooms, living or floor area, plot size for plots, year built, floor, balcony, garden, fitted kitchen, lift, cellar, parking, guest toilet, step-free access, pets allowed, energy class, apartment and house kinds, new-build only, without project listings, keyword, commission-free, WBS required, suitable for a flat share and minimum internet speed. Each was checked against the unfiltered total on 2026-11-15: Berlin rental apartments 5,225, with a balcony 3,625, with a lift 3,071, pets allowed 512, WBS required 238.
Which filters can I use for Austria?
Price, price per m², rooms, area, plot size, balcony, garden, terrace, loggia, lift, cellar, pool, air conditioning, parking, barrier-free, wheelchair-accessible, senior-friendly, bathtub, furnished or partly furnished, apartment and house kinds, new or old building, condition, construction method, keyword, commission-free, private advertisers only, developer projects, investment properties, short-term rentable, holiday home, forced sale, social housing, financial contribution required, public transport type, Vienna U-Bahn line and photo tag. Vienna rental apartments 4,096 on 2026-11-15: furnished 697, near the U1 359, social housing 20.
What is the difference between total rent and monthly costs in Austria?
total_rent_eur is the listing's Gesamtmiete line (rent with operating and other costs and VAT, without heating); monthly_costs_eur is Monatliche Kosten, everything payable per month including heating. A Graz flat on 2026-11-15: total rent 793.48, monthly costs 878.14. A line the listing does not print stays null.
How deep can I page?
Germany: up to 100 rows per page, and page 500 of all 91,801 German rental apartments still returned 100 rows. Austria: 25 rows per page and 100 pages, which is the Austrian site's own limit (2,500 rows per search); asking for page 101 returns an empty page, not page 1 again.
Do I get the agent's phone number?
Yes, when the advertiser publishes it. Germany returns the listing's phone numbers and the advertiser's legal imprint (address, phone, e-mail). Austria returns the contact person's name and phone number on the listing, and agent returns the agency's address, phone numbers, website and description.
Can I get all listings of one agency?
Yes: agent_listings with the agent.id from any listing. In Germany it pages per property type and agent reports how many listings the advertiser has in each type; in Austria it pages the residential and the commercial listings separately.
Can I search around a point?
In Germany, yes: search_by_coordinates with a radius in km (Berlin centre: 448 listings within 2 km, 1,758 within 5 km). The Austrian site has no radius search; search Austria by place, district or postcode.
Does it cover new-build projects?
Yes. A German listing that belongs to a new-build project carries project.id; project returns the project with its developer, price range, description, photos, documents, contact phone and every unit it lists (8 of 8 projects checked on 2026-11-15). Austrian project listings return their units inside listing.
What is the ImmoScout24 (Germany + Austria) API?
ImmoScout24 (Germany + Austria) API is a ReefAPI endpoint group for rentals and sales on immobilienscout24.de and immobilienscout24.at: every site filter, full listings with costs, photos and the advertiser's phone numbers. It returns live JSON through POST requests under /immoscout24/v1.
Is the ImmoScout24 (Germany + Austria) API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. ImmoScout24 (Germany + Austria) calls use the same shared credit balance as every other ReefAPI engine.
Do I need an ImmoScout24 (Germany + Austria) login or account?
No login to ImmoScout24 (Germany + Austria) is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the ImmoScout24 (Germany + Austria) data?
The page example is captured from a live locations call, and production requests fetch live data through ReefAPI rather than a static sample.