Immowelt Germany Rent & Buy Listings Scraper: MCP config, n8n workflow and API

{
  "mode": "search",
  "city": "Berlin",
  "distributionType": "mieten",
  "estateType": "wohnung",
  "sellerType": "any",
  "wbsRequired": false,
  "excludeGroundFloor": false,
  "maxItems": 5,
  "includeDetails": false,
  "maxDetails": 0
}

---
name: immowelt-germany-rent-and-buy-listings-scraper
description: "German real-estate listings from Immowelt.de with price, rooms, living space, address, images, provider, energy and optional expose detail fields such as coordinates, amenities, documents and the full description. Runs the Apify Actor vexaloom-labs/immowelt-germany-rent-and-buy-listings-scraper. Use when the user needs Immowelt data with fields such as title, city, district, distributionType, estateType, priceCold and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "vexaloom-labs/immowelt-germany-rent-and-buy-listings-scraper"
  store-url: "https://apify.com/vexaloom-labs/immowelt-germany-rent-and-buy-listings-scraper"
---

# Immowelt Germany Rent & Buy Listings Scraper

Use this skill to fetch Immowelt data with the Apify Actor `vexaloom-labs/immowelt-germany-rent-and-buy-listings-scraper` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `mode` | one of `search`, `byUrl`, `byIds`, required | How to find listings: by German city and filters, by a pasted Immowelt search URL, or by listing IDs / expose URLs. |
| `city` | string | German city or town, for example Berlin, Muenchen, Hamburg, Koeln or Frankfurt am Main. Any place Immowelt indexes can be used. |
| `distributionType` | one of `mieten`, `kaufen`, `zwangsversteigerung` | Choose rentals, for-sale listings, or compulsory auctions. |
| `estateType` | string | Broad property category. Temporary living is rent-only and is automatically switched to rentals. All 14 Immowelt categories are supported. |
| `estateSubType` | string | Optional narrower sub-type. Use a value that belongs to the chosen property type; leave empty for any sub-type. |
| `features` | array | Only include listings that have all selected features. Leave empty for no feature filter. |
| `energyClass` | array | Only include listings with one of the selected German energy certificate classes (A+ is the most efficient). |
| `buildState` | array | Only include listings in one of the selected building conditions. |
| `projectTypes` | array | Only include listings with one of the selected project or tenure types, such as new build, resale, investment or apartment swap. |
| `sellerType` | one of `any`, `private`, `professional` | Filter by private owners, professional agents, or any seller. |
| `wbsRequired` | boolean | Only include listings that require a certificate of eligibility (Wohnberechtigungsschein). |
| `floorLocation` | array | Only include listings on one of the selected floor locations. |
| `excludeGroundFloor` | boolean | Skip ground-floor listings. |
| `includeKeywords` | array | Keep only listings whose title or description contains every listed keyword (case-insensitive). |

Example `input.json` (the Actor's published prefill):

```json
{
  "mode": "search",
  "city": "Berlin",
  "distributionType": "mieten",
  "estateType": "wohnung",
  "sellerType": "any",
  "wbsRequired": false,
  "excludeGroundFloor": false,
  "maxItems": 5,
  "includeDetails": false,
  "maxDetails": 0
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/vexaloom-labs~immowelt-germany-rent-and-buy-listings-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/vexaloom-labs~immowelt-germany-rent-and-buy-listings-scraper/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. Published fields include: `title`, `city`, `district`, `distributionType`, `estateType`, `priceCold`, `priceWarm`, `purchasePrice`, `rooms`, `livingSpaceSqm`, `yearBuilt`, `energyClass`, `providerName`, `sourceUrl`.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.