Willhaben.at Scraper

Willhaben.at is Austria's largest online marketplace, covering general goods, property, used cars, and jobs. This actor pulls structured listing data straight from willhaben's own data source, so you get clean JSON with roughly 40 fields per ad (often many more), including full geo coordinates, every photo, dates, seller type, and per-category attributes. Build a search from filters, or paste any willhaben search-page URL.

Why This Scraper?

• Roughly 40 base fields per listing, plus every category-specific attribute flattened into the record (cars get make, model, mileage, year, fuel, transmission, equipment; property gets rooms, living area, floor, price per square meter).
• Two ways to start: a search builder (category, keyword, price range, location, sort) and a paste-URLs mode that accepts any willhaben search page.
• GPS latitude and longitude, full address hierarchy (state, district, postcode, municipality), and all photo URLs on every record.
• Optional detail enrichment adds contact name, dealer or organisation info, address detail, and the complete attribute set.
• Fast: reads willhaben's structured data directly instead of rendering pages, with concurrent detail fetching.
• Automatic forward pagination with de-duplication across pages.

Data You Get

Sample shape: values are illustrative placeholders, not from a live listing.

Field	Example
id	000000001
url	https://www.willhaben.at/iad/gebrauchtwagen/d/auto/sample-000000001/
title	Sample Listing Title
description	Full listing description text appears here.
price	7800
priceDisplay	€ 7.800
category	gebrauchtwagen/auto/gebrauchtwagenboerse
make	SampleMake
model	SampleModel
mileage	120000
year	2019
fuel	Benzin
transmission	Automatik
condition	Gebrauchtwagen
state	Wien
district	Wien
postcode	1010
locationName	Sample Location
latitude	48.2000
longitude	16.3700
publishedDate	2026-01-01T00:00:00.000Z
advertiserLabel	Privat
isPrivate	true
imageCount	12
mainImage	https://cache.willhaben.at/mmo/0/000/000/000_0.jpg
images	["https://cache.willhaben.at/mmo/0/000/000/000_0.jpg", ...]
contactName	A. B.
organisationName	Sample Dealer

Plus an attr_* key for every raw attribute the category exposes, and a rawAttributes array preserving the original structure.

How to Use

Search a category (used cars), list-only:

{
  "mode": "search",
  "category": "gebrauchtwagen/auto/gebrauchtwagenboerse",
  "maxListings": 20,
  "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AT" }
}

Search the marketplace by keyword with a price range:

{
  "mode": "search",
  "category": "kaufen-und-verkaufen/marktplatz",
  "keyword": "iphone",
  "minPrice": 100,
  "maxPrice": 500,
  "sort": "price-asc",
  "maxListings": 200,
  "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AT" }
}

Rentals in Vienna with detail enrichment:

{
  "mode": "search",
  "category": "immobilien/mietwohnungen",
  "areaId": 900,
  "fetchDetails": true,
  "maxListings": 50,
  "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AT" }
}

Search jobs by keyword:

{
  "mode": "search",
  "category": "jobs",
  "keyword": "python",
  "sort": "newest",
  "maxListings": 100,
  "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AT" }
}

Paste any willhaben search URLs (multi-URL, forward pagination):

{
  "mode": "url",
  "urls": [
    "https://www.willhaben.at/iad/immobilien/eigentumswohnung/wien",
    "https://www.willhaben.at/iad/gebrauchtwagen/auto/gebrauchtwagenboerse?YEAR_MODEL_FROM=2018"
  ],
  "maxPages": 5,
  "proxy": { "useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "AT" }
}

Input Parameters

Parameter	Type	Default	Description
mode	string	search	"search" builds a query from filters; "url" scrapes pasted search pages.
category	string	kaufen-und-verkaufen/marktplatz	Section to scrape (Search mode). Includes Jobs, which returns job-specific fields (company, salary, employment type) and ignores the price and area filters.
categoryPath	string	(empty)	Advanced: override category with any willhaben SEO path.
keyword	string	(empty)	Free-text keyword within the category.
areaId	integer	(empty)	willhaben location ID, for example 900 for Vienna.
minPrice	integer	(empty)	Minimum price in euros.
maxPrice	integer	(empty)	Maximum price in euros.
sort	string	default	One of default, newest, price-asc, price-desc.
customParameters	array	[]	Extra raw willhaben filters as KEY=VALUE strings.
urls	array	(example)	Search-page URLs (URL mode).
fetchDetails	boolean	false	Open each detail page for contact and dealer info.
maxListings	integer	20	Maximum listings across all searches (0 for unlimited).
maxPages	integer	500	Maximum pages per search (about 25 listings per page). Defaults high so maxListings is the effective hard cap.
proxy	object	Residential AT	Proxy settings. Residential Austria is required.

Output Example

Sample shape: values are illustrative placeholders, not from a live listing.

{
  "id": "000000001",
  "uuid": "00000000-0000-0000-0000-000000000000",
  "url": "https://www.willhaben.at/iad/gebrauchtwagen/d/auto/sample-000000001/",
  "title": "Sample Listing Title",
  "description": "Full listing description text appears here.",
  "price": 7800,
  "priceDisplay": "€ 7.800",
  "category": "gebrauchtwagen/auto/gebrauchtwagenboerse",
  "make": "SampleMake",
  "model": "SampleModel",
  "mileage": 120000,
  "year": 2019,
  "fuel": "Benzin",
  "transmission": "Automatik",
  "condition": "Gebrauchtwagen",
  "country": "Österreich",
  "state": "Wien",
  "district": "Wien",
  "postcode": "1010",
  "locationName": "Sample Location",
  "latitude": 48.2000,
  "longitude": 16.3700,
  "publishedDate": "2026-01-01T00:00:00.000Z",
  "changedDate": "2026-01-01T00:00:00.000Z",
  "isPrivate": true,
  "advertiserLabel": "Privat",
  "imageCount": 2,
  "mainImage": "https://cache.willhaben.at/mmo/0/000/000/000_0.jpg",
  "images": [
    "https://cache.willhaben.at/mmo/0/000/000/000_0.jpg",
    "https://cache.willhaben.at/mmo/0/000/000/000_1.jpg"
  ]
}

Plan Requirement

willhaben.at accepts traffic only from Austrian (or nearby EU) residential connections; datacenter proxies are rejected. Use an Apify plan that includes Residential proxy (Starter or higher) and set the proxy country to AT. The actor automatically rotates AT and DE residential exits and falls back to a backup route if needed. On the free plan, residential proxy is not available, so runs may return no results; the actor logs guidance when that happens.