# Willhaben Marketplace, Cars & Real Estate Listings Scraper (`dataspryva/willhaben-marketplace-cars-and-real-estate`) Actor

Search Willhaben.at classifieds, used cars, and real estate (rent or buy apartments, houses, land) by keyword, price range, and sort order. Get listing prices, locations, images, and category-specific details such as car mileage or living area.

- **URL**: https://apify.com/dataspryva/willhaben-marketplace-cars-and-real-estate.md
- **Developed by:** [Dataspryva](https://apify.com/dataspryva) (community)
- **Categories:** Real estate, E-commerce, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Willhaben Marketplace, Cars, Real Estate & Jobs Scraper

Willhaben.at is Austria's largest classifieds site — marketplace goods, used cars, apartments, houses, land and jobs all live in one place. This actor turns those listings into structured records: prices, locations, seller details, car specifications, property areas and energy data, job salaries, images and direct links. Search by keyword and filters, or paste any Willhaben search or listing URL. No login, cookies, API key or proxy setup is needed.

### What this actor does

- **Marketplace, cars, real estate and jobs in one actor** — choose a section or paste URLs from any of them.
- **Location-aware search** — filter by federal state, city, district or Austrian postcode.
- **Real filters, not post-filtering** — price, car make/model/year/mileage/fuel/transmission/body/drive/colour/power, property type/rooms/area/outdoor space/equipment, and job region/field/employment type/employer type.
- **Optional detail enrichment** — add full descriptions, seller contact details, equipment lists, energy certificates and rent breakdowns from each listing page.
- **Incremental monitoring** — on recurring runs return only new, changed, expired or reappeared listings/jobs.
- **Omit-empty output** — a field the source does not carry is left out, never sent as `null` or blank.

### Output per listing

Every record has `recordType: "listing"` and the `mode` that produced it.

**Identity and pricing**

- `adId`, `uuid`, `heading`, `description`, `descriptionSnippet`
- `price`, `currency`, `priceDisplay`, `oldPrice`, `priceReductionDate`, `pricePerSquareMeter`
- `adUrl`, `categoryId`, `locationId`

**Location**

- `location`, `district`, `state`, `postcode`, `address`, `street`, `municipality`, `postalName`, `country`
- `latitude`, `longitude`

**Dates, status and seller**

- `publishedDate`, `changedDate`, `endDate`, `firstPublishedDate`
- `status`, `isPrivate`, `sellerType`
- `seller`, `sellerId`, `sellerContactName`, `sellerPhone`, `sellerWebsite`, `sellerLogoUrl`

**Media and extras**

- `imageUrl`, `imageUrls`, `imageCount`, `floorPlanUrls`
- `rawAttributes` (when "Include raw attributes" is on)
- `scrapedAt`

#### Cars & vehicles

- `carMake`, `carModel`, `carMakeId`, `carModelId`, `carModelDetail`, `vehicleCategory`
- `year`, `registrationMonth`, `mileageKm`, `fuelType`, `transmission`
- `engineDisplacementCc`, `powerKw`, `consumptionLper100km`, `co2EmissionsGperKm`, `batteryCapacityKwh`
- `bodyType`, `condition`, `driveType`, `color`, `doors`, `seats`, `owners`
- `warranty`, `inspection`, `inspectionValidUntil`, `equipment[]`

#### Real estate

- `propertyType`, `propertyTypeId`, `rooms`, `roomsCount`, `livingAreaSqm`, `usableAreaSqm`, `plotAreaSqm`
- `floor`, `floorSurface`, `freeAreaType`, `freeAreaSqm`, `heating`, `buildingCondition`, `constructionYear`
- `energyClassHwb`, `energyDemandHwb`, `energyClassFgee`, `energyDemandFgee`
- `availableDate`, `availableNow`, `ownershipType`, `rentalTerm`
- `rentPerMonth`, `rentNet`, `rentVat`, `totalEncumbrance`, `deposit`, `additionalCosts`, `monthlyCosts`
- `equipment[]`

### Output per job

Job records have `recordType: "job"`.

- `jobId`, `jobTitle`, `description`, `jobUrl`
- `companyName`, `companyId`, `companySlug`, `companyUid`, `companyAddress`, `companyLogoUrl`
- `position`, `salary`, `salaryTimeFrame`, `employmentTime`, `employmentModes[]`
- `locations[]` — objects with `name`, `federalState`, `country`
- `publishedDate`, `modifiedDate`, `expiryDate`
- `isExpired`, `isTopJob`, `overpay`, `brandNew`, `internalApplication`
- `contactName`, `contactEmail`, `languageSkills[]`, `professionalExperience`
- `mode`, `scrapedAt`

Add `includeDetails` to fill full descriptions, expiry dates, company addresses, contact details and language skills where the source publishes them. Contact email is only present on some job ads.

### Incremental output

When `incrementalMode` is on, each record also has:

- `changeType` — `NEW`, `UPDATED`, `UNCHANGED`, `REAPPEARED` or `EXPIRED`
- `changedFields[]` — tracked fields that changed on an `UPDATED` record
- `firstSeenAt`, `lastSeenAt`, `previousPrice`
- `emitUnchanged` / `emitExpired` control whether unchanged or missing records are included

The first run returns everything as `NEW`. Later runs compare against the saved state for the same `stateKey` (or the same filters when `stateKey` is empty).

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `mode` | string | `searchItems` | `searchItems`, `searchCars`, `searchRealEstate`, `searchJobs` or `byUrls` |
| `query` | string | – | Keyword to search for |
| `startUrls` | array | – | Willhaben search, category, listing, job search or job URLs (mode `byUrls`) |
| `state` | string | – | Austrian federal state or other countries |
| `location` | string | – | City, district or postcode; for jobs it is the job location |
| `radiusKm` | integer | – | Job search radius, 1–100 km |
| `sortBy` | string | `relevance` | `relevance`, `newest`, `priceAsc`, `priceDesc`, `distance` |
| `priceMin`, `priceMax` | integer | – | Price range in EUR (ignored for jobs) |
| `maxItems` | integer | `20` | Maximum listings or jobs (1–50,000) |
| `includeDetails` | boolean | `false` | Fetch full descriptions, contact/seller and extra detail fields |
| `includeRawAttributes` | boolean | `false` | Add every source attribute as `rawAttributes` |
| `sellerType` | string | – | `private` or `dealer` (marketplace items and cars; ignored for real estate and jobs) |
| `vehicleCategory` | string | `cars` | `cars`, `motorcycles`, `caravans` or `commercial` |
| `carMake` | string | – | Car manufacturer |
| `carModel` | string | – | Model name; requires `carMake` |
| `yearFrom`, `yearTo` | integer | – | First-registration year range |
| `mileageFrom`, `mileageTo` | integer | – | Mileage range in km |
| `fuelType` | string | – | Petrol, diesel, electric, gas, hybrid or hydrogen |
| `transmission` | string | – | Automatic or manual |
| `bodyType` | string | – | Convertible, compact, estate, saloon, SUV, etc. |
| `carCondition` | string | – | Used, new, classic, demonstration car, etc. |
| `driveType` | string | – | All-wheel, rear-wheel or front-wheel drive |
| `color` | string | – | Exterior colour |
| `powerFrom`, `powerTo` | integer | – | Engine power range in kW |
| `realEstateCategory` | string | `rentApartment` | Rent/buy apartment or house, land, new-build, commercial, holiday or other |
| `propertySubtype` | string | – | Penthouse, detached house, building plot, etc. |
| `rooms` | string | – | Room-count bucket (`1`, `2`, … `10+`, not specified) |
| `livingAreaFrom`, `livingAreaTo` | integer | – | Living area range in m² |
| `plotAreaFrom`, `plotAreaTo` | integer | – | Plot area range in m² |
| `freeAreaType` | string | – | Balcony, terrace, garden, loggia, winter garden or roof terrace |
| `equipment` | string | – | Lift, cellar, parking, built-in kitchen, etc. |
| `availableNow` | boolean | `false` | Only properties available immediately |
| `jobRegion` | string | – | Austrian state, Austria, Germany or Switzerland |
| `employmentMode` | string | – | Full-time, part-time, freelance or marginal |
| `jobPosition` | string | – | Management, team lead, employee, apprenticeship, internship, etc. |
| `jobOperationArea` | string | – | Job field such as IT, care, finance, sales or trades |
| `jobCompanyType` | string | – | Staffing agency or direct employer |
| `jobTimeLimit` | string | – | Any time, last 24 hours, last 72 hours or last week |
| `incrementalMode` | boolean | `false` | Return only new/changed records on recurring runs |
| `stateKey` | string | – | Stable name for the monitoring campaign |
| `emitUnchanged` | boolean | `false` | Include unchanged records |
| `emitExpired` | boolean | `false` | Include records that disappeared after a complete scan |

#### Example: marketplace furniture

```json
{
  "mode": "searchItems",
  "query": "sofa",
  "state": "Wien",
  "priceMax": 800,
  "sortBy": "priceAsc",
  "maxItems": 100
}
```

#### Example: used BMW with detail enrichment

```json
{
  "mode": "searchCars",
  "carMake": "1005",
  "carModel": "3er-Reihe",
  "yearFrom": 2018,
  "mileageTo": 120000,
  "fuelType": "100003",
  "priceMax": 30000,
  "includeDetails": true,
  "maxItems": 50
}
```

#### Example: Vienna rental apartments

```json
{
  "mode": "searchRealEstate",
  "realEstateCategory": "rentApartment",
  "state": "Wien",
  "rooms": "2X2",
  "livingAreaFrom": 55,
  "priceMax": 1400,
  "maxItems": 100
}
```

#### Example: chef jobs in Vienna

```json
{
  "mode": "searchJobs",
  "query": "Koch",
  "jobRegion": "14486",
  "employmentMode": "110",
  "jobTimeLimit": "last_week",
  "includeDetails": true,
  "maxItems": 50
}
```

#### Example: paste search and listing URLs

```json
{
  "mode": "byUrls",
  "startUrls": [
    { "url": "https://www.willhaben.at/iad/immobilien/mietwohnungen/wien?PRICE_TO=1200" },
    { "url": "https://www.willhaben.at/iad/gebrauchtwagen/d/auto/bmw-3er-reihe-320d-1234567890/" },
    { "url": "https://www.willhaben.at/jobs/suche?keyword=koch&region=14486" }
  ],
  "maxItems": 30
}
```

### Use cases

- **Car dealers and buyers** — track make/model/year/mileage/price across Austria and compare private vs dealer offers.
- **Real-estate analysts** — build €/m², rent, energy-class and availability datasets by district.
- **Property hunters** — monitor Vienna or Graz rentals and new-build projects with incremental runs.
- **Recruiters and job analysts** — export job ads with salary, company, employment type and location.
- **Resellers** — watch marketplace categories for new listings and price reductions.
- **Market researchers** — collect cross-section supply data for Austrian goods and property.

### FAQ

**Is this affiliated with Willhaben?**
No. This actor reads publicly visible listings and has no relationship with Willhaben.at.

**Do I need an account, cookies or an API key?**
No. Listings, search pages and job ads are read without logging in.

**Do I need to configure a proxy?**
No. The actor chooses a working connection automatically. Just fill in the input and run it.

**Why are some fields missing on some records?**
Sellers do not always publish every attribute. A field the source does not carry is omitted, never sent as `null` or a blank value.

**Why is car mileage or first registration missing on some cars?**
Some sellers leave those fields empty. The actor returns the data the listing actually contains.

**What does "Fetch detail pages" add?**
Full descriptions, seller/contact details, equipment lists, energy certificates, rent breakdowns, floor plans and extra car specification fields. It is optional because it makes the run slower.

**How many records can one run return?**
Up to `maxItems`, which can be set to 50,000. Willhaben serves at most 199,800 records per search query; for larger jobs, split by state or price range and combine the results.

**Can I run this on a schedule and only get new listings?**
Yes. Turn on `incrementalMode`; the first run establishes the baseline and later runs return new, changed, expired or reappeared records according to `emitUnchanged` and `emitExpired`.

**Do price and seller-type filters work for jobs and real estate?**
Job ads have no listing price, so price filters are ignored for jobs. Willhaben does not apply seller-type filtering to real estate or jobs; those filters are ignored and the run reports it in its status message.

**Are image and listing links usable outside Apify?**
Yes. Image URLs and listing/job links are public absolute URLs.

# Actor input Schema

## `mode` (type: `string`):

Choose a marketplace section, cars, real estate, jobs, or paste Willhaben URLs.

## `query` (type: `string`):

Free-text keyword, e.g. 'sofa', 'iPhone', 'BMW', 'Wohnung'. Leave empty to browse the category.

## `startUrls` (type: `array`):

(mode=byUrls) Paste search, category, single listing, job search or single job URLs. Filters already in the URL are preserved.

## `state` (type: `string`):

Restrict listings to one Austrian federal state (or other countries). Location overrides this when both are set.

## `location` (type: `string`):

e.g. 'Wien', 'Graz', '1050'. Resolved through Willhaben's location search. For jobs it is sent as the job location.

## `radiusKm` (type: `integer`):

(mode=searchJobs) Radius around the location, 1-100 km.

## `sortBy` (type: `string`):

Result ordering. Jobs support relevance and newest; other orders are mapped to newest for jobs.

## `priceMin` (type: `integer`):

Minimum listing price in euros. Ignored for jobs.

## `priceMax` (type: `integer`):

Maximum listing price in euros. Ignored for jobs.

## `maxItems` (type: `integer`):

Maximum listings or jobs to return.

## `includeDetails` (type: `boolean`):

Add the full description, seller/contact data and extra car or real-estate details from each listing/job page. Slower and more expensive.

## `includeRawAttributes` (type: `boolean`):

Add every source attribute as a rawAttributes list. Useful for category-specific analysis; increases output size.

## `sellerType` (type: `string`):

Filter by private seller or commercial dealer. Applies to marketplace items and cars; ignored for real estate and jobs.

## `vehicleCategory` (type: `string`):

(mode=searchCars) Which vehicle section to search.

## `carMake` (type: `string`):

(mode=searchCars) Vehicle manufacturer.

## `carModel` (type: `string`):

(mode=searchCars) Model name, e.g. '3er-Reihe' or 'Golf'. Requires Car make.

## `yearFrom` (type: `integer`):

(mode=searchCars) Earliest registration year.

## `yearTo` (type: `integer`):

(mode=searchCars) Latest registration year.

## `mileageFrom` (type: `integer`):

(mode=searchCars) Minimum mileage.

## `mileageTo` (type: `integer`):

(mode=searchCars) Maximum mileage.

## `fuelType` (type: `string`):

(mode=searchCars)

## `transmission` (type: `string`):

(mode=searchCars)

## `bodyType` (type: `string`):

(mode=searchCars)

## `carCondition` (type: `string`):

(mode=searchCars)

## `driveType` (type: `string`):

(mode=searchCars)

## `color` (type: `string`):

(mode=searchCars)

## `powerFrom` (type: `integer`):

(mode=searchCars) Minimum engine power.

## `powerTo` (type: `integer`):

(mode=searchCars) Maximum engine power.

## `realEstateCategory` (type: `string`):

(mode=searchRealEstate) Which property market to search.

## `propertySubtype` (type: `string`):

(mode=searchRealEstate) Optional subtype such as penthouse, detached house or building plot.

## `rooms` (type: `string`):

(mode=searchRealEstate) Room-count bucket.

## `livingAreaFrom` (type: `integer`):

(mode=searchRealEstate)

## `livingAreaTo` (type: `integer`):

(mode=searchRealEstate)

## `plotAreaFrom` (type: `integer`):

(mode=searchRealEstate)

## `plotAreaTo` (type: `integer`):

(mode=searchRealEstate)

## `freeAreaType` (type: `string`):

(mode=searchRealEstate) Balcony, terrace, garden, etc.

## `equipment` (type: `string`):

(mode=searchRealEstate) e.g. lift, cellar, parking, built-in kitchen.

## `availableNow` (type: `boolean`):

(mode=searchRealEstate) Only listings available now.

## `jobRegion` (type: `string`):

(mode=searchJobs)

## `employmentMode` (type: `string`):

(mode=searchJobs)

## `jobPosition` (type: `string`):

(mode=searchJobs)

## `jobOperationArea` (type: `string`):

(mode=searchJobs)

## `jobCompanyType` (type: `string`):

(mode=searchJobs)

## `jobTimeLimit` (type: `string`):

(mode=searchJobs)

## `incrementalMode` (type: `boolean`):

Return only new/changed listings or jobs on recurring runs. The first run returns everything as NEW.

## `stateKey` (type: `string`):

(incrementalMode) Stable name for this search so later runs compare against the right state. Leave empty to derive it from the filters.

## `emitUnchanged` (type: `boolean`):

(incrementalMode) Also return records whose tracked fields did not change.

## `emitExpired` (type: `boolean`):

(incrementalMode) After a complete scan, also emit listings/jobs that disappeared since the last run.

## Actor input object example

```json
{
  "mode": "searchItems",
  "query": "sofa",
  "sortBy": "relevance",
  "maxItems": 3,
  "includeDetails": false,
  "includeRawAttributes": false,
  "vehicleCategory": "cars",
  "realEstateCategory": "rentApartment",
  "availableNow": false,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false
}
```

# Actor output Schema

## `listings` (type: `string`):

Dataset containing all scraped Willhaben listings and job ads.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "searchItems",
    "query": "sofa",
    "sortBy": "relevance",
    "maxItems": 3,
    "includeDetails": false,
    "includeRawAttributes": false
};

// Run the Actor and wait for it to finish
const run = await client.actor("dataspryva/willhaben-marketplace-cars-and-real-estate").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "searchItems",
    "query": "sofa",
    "sortBy": "relevance",
    "maxItems": 3,
    "includeDetails": False,
    "includeRawAttributes": False,
}

# Run the Actor and wait for it to finish
run = client.actor("dataspryva/willhaben-marketplace-cars-and-real-estate").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "searchItems",
  "query": "sofa",
  "sortBy": "relevance",
  "maxItems": 3,
  "includeDetails": false,
  "includeRawAttributes": false
}' |
apify call dataspryva/willhaben-marketplace-cars-and-real-estate --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,dataspryva/willhaben-marketplace-cars-and-real-estate"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/sSrZYqOzOQO2bTYr4/builds/10AHfQXOlb4fyOst2/openapi.json