# Willhaben Scraper (Austria) (`reventadata/willhaben-scraper`) Actor

Extract adverts from willhaben.at: general Marktplatz, Immobilien (real estate) and Gebrauchtwagen (used cars). Each row has price, previous price, location, seller, photos and link, plus rooms and area for property or year, mileage, fuel and transmission for cars.

- **URL**: https://apify.com/reventadata/willhaben-scraper.md
- **Developed by:** [reventadata](https://apify.com/reventadata) (community)
- **Categories:** E-commerce, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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 Scraper (willhaben.at, Austria)

> **Unofficial.** This Actor is not affiliated with, authorised by, endorsed by, or in any
> way officially connected to willhaben.at. "willhaben" is a trademark of its
> respective owner and is used here only to describe what this tool reads. It reads the same
> public pages a browser does.

Willhaben Scraper turns willhaben.at search pages into a clean dataset: one row per advert with price, location, seller, photos and a link, from the general Marktplatz, Immobilien (real estate) or Gebrauchtwagen (used cars).

### What does it do?

- Reads the public search result pages of willhaben.at, 100 adverts per page, page by page.
- Three sections, chosen with **Section of willhaben.at**: Marktplatz (keyword search or the whole section), Immobilien and Gebrauchtwagen (any category or region page you copy from the site's address bar).
- Every row has the same columns. Fields that belong to another section are empty (`null`).
- An advert that two keywords both find is pushed once.

### Why use it?

- **Typed columns, not raw attribute lists:** price as a number, mileage in kilometres, rooms, living area, publication time in ISO 8601.
- **Seller fields:** business seller name and seller id, and whether the seller is private. Only what the advert list publishes.
- **Price drops:** the previous price and the date of the reduction when the seller lowered the price.
- **Light and fast:** reads public pages directly, no browser needed.

### How to use it

1. Pick the section.
2. Marktplatz: enter keywords (one per line), or leave them empty to read the whole section. Immobilien and Gebrauchtwagen: leave **Search path** empty for the default page, or paste a category page path such as `immobilien/mietwohnungen/wien`.
3. Set **Maximum rows**, run, and download JSON, CSV, Excel or NDJSON.

#### Input

| Field | Type | Description |
|---|---|---|
| `vertical` | string | `marketplace`, `realEstate` or `cars`. |
| `searchQueries` | array | Marktplatz only: keywords, searched one after the other. |
| `searchPath` | string | Optional path after `willhaben.at/iad/`, for example `gebrauchtwagen/auto/gebrauchtwagenboerse`. No `?...` filters. |
| `maxItems` | integer | Hard cap on rows saved. Default 100. |
| `maxPagesPerSearch` | integer | Optional cap on result pages (100 adverts each). |
| `proxyConfiguration` | object | Optional; off by default. |

Example:

```json
{"vertical": "marketplace", "searchQueries": ["iphone"], "maxItems": 10, "maxPagesPerSearch": 1}
```

#### Output (one real row, Marktplatz, shortened)

```json
{
  "id": "1228654215",
  "url": "https://www.willhaben.at/iad/kaufen-und-verkaufen/d/apple-iphone-18-pro-max-silver-265-gb-neu-1228654215/",
  "title": "Apple IPhone 18 Pro Max, Silver 265 GB NEU",
  "price": 1599.99,
  "currency": "EUR",
  "location": "Innsbruck",
  "postcode": "6020",
  "state": "Tirol",
  "isPrivateSeller": false,
  "sellerName": "Antonios Handyshop",
  "sellerId": "28352020",
  "vertical": "marketplace",
  "searchQuery": "iphone"
}
```

A real-estate row adds `rooms`, `livingAreaM2`, `monthlyRent`, `pricePerM2`, `floor`, `propertyType`; a car row adds `year`, `mileageKm`, `fuel`, `transmission`, `powerKw`, `carMakeId`, `carModelId` and more. The full list is in the dataset schema.

### Limits you should know

- The search result list carries a shortened description (the site cuts it off with "..."). Full text, phone numbers and e-mail addresses are on the advert pages, which this Actor does not open.
- Cars: the make and model are the site's numeric codes (`carMakeId`, `carModelId`); the title usually names them.
- New-build project adverts are one row; their units are not listed as separate rows (`childListingCount` says how many there are).
- willhaben.at lists at most 999 pages per search; the adverts move while a run walks the list, so counts can drift by a few.
- Not offered: price, size or other filters. Use a category or region path, or filter the dataset afterwards.

### Data and legal

The rows hold what willhaben.at shows publicly in its search results, including business seller names. Nothing from behind a login. You are responsible for using the data in line with willhaben.at's terms and the GDPR.

### How much does it cost?

Pay-per-event: **$0.001 per advert** saved to the dataset (**$1.00 per 1,000 adverts**), plus **$0.00005** charged once when the run starts. No subscription. An advert that two keywords both find is saved once, so it is charged once.

# Actor input Schema

## `vertical` (type: `string`):

Which part of willhaben.at to read: the general Marktplatz (everything for sale), Immobilien (real estate) or Gebrauchtwagen (used cars). Each section has its own extra fields in the rows.

## `searchQueries` (type: `array`):

Marktplatz only: one or more keywords, one per line (for example "iphone"). Each keyword is searched separately; an advert found by two keywords is pushed once. Leave empty to read the whole section or the Search path below. Not available for Immobilien and Gebrauchtwagen: pick the category with Search path instead.

## `searchPath` (type: `string`):

Optional. A category or region page of the chosen section, copied from the address bar of willhaben.at: either the part after "willhaben.at/iad/" (for example "immobilien/mietwohnungen/wien" or "gebrauchtwagen/auto/gebrauchtwagenboerse") or the whole URL without "?..." filters. It must start with the section's own path. Empty means the section's main page: Marktplatz "kaufen-und-verkaufen/marktplatz", Immobilien "immobilien/mietwohnungen/wien" (rentals in Vienna), Gebrauchtwagen "gebrauchtwagen/auto/gebrauchtwagenboerse".

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

Hard cap on rows pushed across all keywords. The site lists at most 99,900 adverts per search.

## `maxPagesPerSearch` (type: `integer`):

Optional cap on result pages for each keyword (100 adverts per page; the site stops at 999 pages). Without it the run walks every page, or stops at Maximum rows.

## `proxyConfiguration` (type: `object`):

Optional proxy settings. Turn on only if you see request failures.

## Actor input object example

```json
{
  "vertical": "marketplace",
  "searchQueries": [
    "iphone"
  ],
  "maxItems": 10,
  "maxPagesPerSearch": 1,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

Adverts from willhaben.at: title, price, location, seller, photos and a link to the advert, plus real-estate or car fields.

# 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 = {
    "searchQueries": [
        "iphone"
    ],
    "maxItems": 10,
    "maxPagesPerSearch": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("reventadata/willhaben-scraper").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 = {
    "searchQueries": ["iphone"],
    "maxItems": 10,
    "maxPagesPerSearch": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("reventadata/willhaben-scraper").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 '{
  "searchQueries": [
    "iphone"
  ],
  "maxItems": 10,
  "maxPagesPerSearch": 1
}' |
apify call reventadata/willhaben-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,reventadata/willhaben-scraper"
        }
    }
}
```

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/C8HPRcm4YAKnazLbd/builds/SvsICgjxqp5XL4cYb/openapi.json
