Willhaben Real Estate Search

Search willhaben.at real estate listings (apartments, houses) via their public webapi. No browser needed. Search any Austrian state and district with price/r...

Security Scan

The skill is internally consistent: it bundles a small Python CLI that queries willhaben.at public web API, requires only python3/requests, and does not ask for unrelated credentials or system access.

Purpose & Capability

Name/description match the bundled assets: SKILL.md documents calling willhaben webapi endpoints and the included Python script implements those calls. Required binaries (python3) and the stated dependency (requests) are appropriate and proportional to the stated purpose.

Instruction Scope

Runtime instructions and code are limited to contacting willhaben.at webapi endpoints, parsing returned JSON, and printing or emitting JSON/text; they do not read local secrets, other files, or send data to unexpected third-party endpoints. The script only references willhaben endpoints and prints results locally.

Install Mechanism

No install specification—this is instruction-only with an included script. Nothing is downloaded from third-party URLs or written to disk beyond the provided script, so install risk is minimal.

Credentials

The skill requests no environment variables, credentials, or config paths. The script does not attempt to access tokens or other secrets. Network access to willhaben.at is required and appropriate for the declared function.

Persistence & Privilege

always is false and the skill does not attempt to modify agent/system configuration or other skills. It runs as a normal user-invocable CLI utility and does not request elevated persistence.

Assessment

This skill appears to do what it says: a small Python CLI that queries willhaben.at's public web API and prints parsed listing details. Before installing or running: (1) confirm you have python3 and the requests library available; (2) be aware the script issues outbound HTTP requests to willhaben.at (it includes a custom 'x-wh-client' header — harmless but you can remove or change it if you prefer); (3) respect willhaben's terms of service and rate limits (the script sleeps 0.3s between detail requests); (4) review the included script yourself (it's small and readable) and run it in a non-sensitive environment if you have concerns about network calls. If you plan to let an autonomous agent use this skill, remember it can make outbound web requests — ensure that is acceptable for your security posture.

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