# Wiener Wohnen Direktvergabe Scraper (`rainminer/wienerwohnen-at-scraper`) Actor

Scrape public Wiener Wohnen Direktvergabe apartment listings in Vienna. Export rent, rooms, size, address, district, and listing/apply URLs to JSON or CSV for Austrian social-housing research, monitoring, and lead generation — public inventory only, no login.

- **URL**: https://apify.com/rainminer/wienerwohnen-at-scraper.md
- **Developed by:** [rainminer](https://apify.com/rainminer) (community)
- **Categories:** Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.49 / 1,000 direktvergabe listings

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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Wiener Wohnen Direktvergabe Scraper

![Wiener Wohnen website](https://www.wienerwohnen.at/.resources/wrwks-dxp-foundation/assets/meta/og-image.png)

Extract **public Direktvergabe apartment listings** from [wienerwohnen.at](https://www.wienerwohnen.at) — Vienna's municipal social housing authority — without writing a single line of code. Export results to JSON, CSV, Excel, or any dataset format supported by Apify.

### What is Direktvergabe?

Direktvergabe (direct allocation) is a programme run by **Wiener Wohnen**, the City of Vienna's public housing management company. Under Direktvergabe, existing tenants who wish to leave their Gemeindebau (social housing) flat can offer it directly to the public. Listings include the apartment's address, district, size, monthly rent, and any transfer fee (Privatablöse) agreed between the outgoing and incoming tenant.

Because these flats carry subsidised rents well below the private market, the listings are in high demand. This scraper lets researchers, housing advocates, journalists, and tenants track the full list of currently available Direktvergabe flats in real time.

### Features

- Scrapes all **Direktvergabe listings** from the public search page at wienerwohnen.at
- Follows **pagination automatically** (up to ~9 pages, ~97 total listings)
- Extracts all key fields: address, Vienna district, number of rooms, apartment size, monthly rent, and Privatablöse (transfer fee)
- Supports **direct listing URLs** — if you already have the URL of a specific flat, the Actor handles it
- Configurable **maxItems** limit to control how many results you need per run
- Works reliably **without a proxy** — no bot protection on public listings
- Returns clean, structured JSON ready for import into spreadsheets, databases, or downstream automation

### Output fields

Each item in the dataset contains the following fields:

| Field              | Description                                   | Example                           |
| ------------------ | --------------------------------------------- | --------------------------------- |
| `listingId`        | Unique identifier derived from the URL slug   | `GRASBERGERGASSE-4-1-Zimmer-25m2` |
| `address`          | Street address of the apartment               | `GRASBERGERGASSE 4`               |
| `district`         | Vienna postal district code                   | `1030`                            |
| `districtCode`     | District code as integer                      | `1030`                            |
| `rooms`            | Number of rooms                               | `1`                               |
| `roomsText`        | Rooms as displayed on the listing             | `1 Zimmer`                        |
| `areaSqm`          | Apartment area in square metres               | `25.05`                           |
| `areaText`         | Area as displayed on the listing              | `25,05 m2`                        |
| `rentEur`          | Monthly rent in euros                         | `227.60`                          |
| `rentText`         | Rent as displayed on the listing              | `227,60 €`                        |
| `transferFeeEur`   | Privatablöse (transfer fee) in euros          | `1`                               |
| `transferFeeText`  | Transfer fee as displayed                     | `1 €`                             |
| `heatingEnergy`    | Heating energy demand (from detail page)      | `102 kWh/m2a`                     |
| `transferredItems` | Description of items included in transfer fee | `Einbaumöbel ...`                 |
| `url`              | Full URL to the listing detail page           | `https://www.wienerwohnen.at/...` |
| `searchUrl`        | The start URL this listing was found from     | `https://www.wienerwohnen.at/...` |

### How to use

#### 1. Provide start URLs

The default start URL covers the entire Direktvergabe search:

```
https://www.wienerwohnen.at/ich-moechte/wohnung-tauschen-oder-weitergeben/wohnung-weitergeben/direktvergabe/direktvergabe-wohnung-suchen.html
```

You can also paste a direct listing URL (a URL containing `/direktvergabe-wohnung/` in its path) to scrape just one flat.

#### 2. Set maxItems

Use the **Maximum items** field to limit how many listings are returned per start URL. The default is `5` for testing. Set it to `100` or higher to collect all available listings.

#### 3. Proxy settings

No proxy is required. The site does not block crawlers on its public listing pages. Leave the proxy setting at the default (`useApifyProxy: false`) to keep costs low.

#### 4. Run and export

Click **Start** and wait for the run to finish. Results appear in the **Dataset** tab. Use the **Export** button to download as JSON, CSV, or Excel.

### Example output

```json
{
  "listingId": "GRASBERGERGASSE-4-1-Zimmer-25m2",
  "address": "GRASBERGERGASSE 4",
  "district": "1030",
  "districtCode": 1030,
  "rooms": 1,
  "roomsText": "1 Zimmer",
  "areaSqm": 25.05,
  "areaText": "25,05 m2",
  "rentEur": 227.6,
  "rentText": "227,60 €",
  "transferFeeEur": 1,
  "transferFeeText": "1 €",
  "heatingEnergy": null,
  "transferredItems": null,
  "url": "https://www.wienerwohnen.at/ich-moechte/wohnung-tauschen-oder-weitergeben/wohnung-weitergeben/direktvergabe/direktvergabe-wohnung-suchen/direktvergabe-wohnung/GRASBERGERGASSE-4-1-Zimmer-25m2.html",
  "searchUrl": "https://www.wienerwohnen.at/ich-moechte/wohnung-tauschen-oder-weitergeben/wohnung-weitergeben/direktvergabe/direktvergabe-wohnung-suchen.html"
}
```

### Use cases

- **Housing research**: track which Vienna districts have the most Direktvergabe flats available, and how rents compare to the private market
- **Journalism & advocacy**: monitor the supply of affordable social housing in Vienna over time
- **Personal search**: get notified when new flats in your preferred district appear by scheduling daily Actor runs and comparing datasets
- **Data science**: build historical datasets of Gemeindebau flat pricing and availability for academic research

### Legal & ethical use

This Actor scrapes **publicly accessible** information from wienerwohnen.at. No login, registration, or personal data is required. Only data visible to any anonymous visitor is collected. Always use scraped data in compliance with applicable laws and the website's terms of service.

### Image Credit

Image credit: [wienerwohnen.at](https://www.wienerwohnen.at/)

# Actor input Schema

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

One or more wienerwohnen.at Direktvergabe search pages or individual listing URLs.

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

Maximum number of listings to return per start URL.

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

Proxy settings. The scraper works without a proxy in most regions.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.wienerwohnen.at/ich-moechte/wohnung-tauschen-oder-weitergeben/wohnung-weitergeben/direktvergabe/direktvergabe-wohnung-suchen.html"
    }
  ],
  "maxItems": 5,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# 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 = {
    "startUrls": [
        {
            "url": "https://www.wienerwohnen.at/ich-moechte/wohnung-tauschen-oder-weitergeben/wohnung-weitergeben/direktvergabe/direktvergabe-wohnung-suchen.html"
        }
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("rainminer/wienerwohnen-at-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 = {
    "startUrls": [{ "url": "https://www.wienerwohnen.at/ich-moechte/wohnung-tauschen-oder-weitergeben/wohnung-weitergeben/direktvergabe/direktvergabe-wohnung-suchen.html" }],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("rainminer/wienerwohnen-at-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 '{
  "startUrls": [
    {
      "url": "https://www.wienerwohnen.at/ich-moechte/wohnung-tauschen-oder-weitergeben/wohnung-weitergeben/direktvergabe/direktvergabe-wohnung-suchen.html"
    }
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call rainminer/wienerwohnen-at-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,rainminer/wienerwohnen-at-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/W3aN7lx3FiSvd1eP9/builds/7AkgBfbZTte0qeRGG/openapi.json