Willhaben Real Estate Search
Search and retrieve property listings from willhaben.at using their public webapi. No browser automation needed.
Prerequisites
Requires python3 with the requests library (pre-installed in most environments).
Quick Start
Search listings
# Apartments for sale in Schärding, max €300k
python3 scripts/willhaben-search.py --district schaerding --type apartment --max-price 300000
# Houses in Wels, max €350k
python3 scripts/willhaben-search.py --district wels --type house --max-price 350000
# With room filter and JSON output
python3 scripts/willhaben-search.py --district linz --type apartment --max-price 300000 --min-rooms 2 --format json
# With full details (heating, energy, condition) for each listing
python3 scripts/willhaben-search.py --district schaerding --type apartment --max-price 300000 --with-details
Get detail for a specific listing
python3 scripts/willhaben-search.py --detail 1148259428
python3 scripts/willhaben-search.py --detail 1148259428 --format json
Detail fields include:
- HEATING (heating type): Fernwärme, Fußbodenheizung, Zentralheizung, Gasheizung, etc.
- BUILDING_CONDITION: Erstbezug, Sehr gut/gut, Renoviert, Renovierungsbedürftig
- YEAR_OF_BUILDING: Construction year
- ENERGY_HWB + ENERGY_HWB_CLASS: Energy rating (kWh/m²a) + class (A-G)
- ENERGY_FGEE + ENERGY_FGEE_CLASS: Overall energy efficiency factor
- Parking: Extracted from listing body text (garage, stellplatz, carport, tiefgarage)
Property Types
| CLI Type | Willhaben Category |
|---|---|
apartment |
Eigentumswohnung (buy) |
house |
Haus kaufen |
District Slugs
Districts use willhaben's URL slug format — the slug is taken directly from the willhaben URL path. Browse willhaben.at/iad/immobilien/ to discover slugs for any district.
Examples:
| District | Slug |
|---|---|
| Schärding | schaerding |
| Ried im Innkreis | ried-im-innkreis |
| Wels (Stadt) | wels |
| Linz (Stadt) | linz |
| Linz-Land | linz-land |
| Braunau am Inn | braunau-am-inn |
| Wien | wien |
| Graz | graz |
| Salzburg | salzburg-stadt |
| Innsbruck | innsbruck |
| Klagenfurt | klagenfurt |
Any valid willhaben district slug works — these are just examples.
States
Default state is oberoesterreich. Override with --state:
python3 scripts/willhaben-search.py --state salzburg --district salzburg-stadt --type apartment
Available: oberoesterreich, niederoesterreich, wien, salzburg, steiermark, kaernten, tirol, vorarlberg, burgenland
Parameters
| Parameter | Description |
|---|---|
--district |
District URL slug (required for search) |
--state |
Austrian state (default: oberoesterreich) |
--type |
Property type: apartment or house |
--max-price |
Maximum price in EUR |
--min-rooms |
Minimum number of rooms |
--max-pages |
Max result pages (default: 5) |
--with-details |
Fetch heating/energy/condition for each listing |
--detail |
Get full details for a specific listing ID |
--format |
text or json |
API Details
Uses willhaben's public webapi:
- Search:
GET https://www.willhaben.at/webapi/iad/search/atz/seo/immobilien/{type}/{state}/{district} - Detail:
GET https://www.willhaben.at/webapi/iad/atverz/{ad_id}
No authentication needed. Be respectful with request rates — add delays between detail requests (~200-300ms).
Notes
- Listing URLs follow pattern:
https://www.willhaben.at/iad/{SEO_URL} - Search returns: id, title, price, rooms, area, location, district, postcode, published date
- Detail adds: heating, building condition, year built, HWB/fGEE energy ratings, parking
- Parking is extracted from the listing body text when not in structured fields