# Private Häuser in Nordrhein-Westfalen finden

**Use case:** 

Exportiere private Häuser zum Kauf in Nordrhein-Westfalen mit Kaufpreis, Fläche, Grundstück, Zimmern, Adresse, Kontakt und Bildern.

## Input

```json
{
  "startUrls": [
    "https://www.kleinanzeigen.de/s-haus-kaufen/berlin/anbieter:privat/c208l3331r50"
  ],
  "maxResults": 200,
  "sorting": "newest",
  "categories": [
    "haeuser_kauf"
  ],
  "location": "Nordrhein-Westfalen",
  "posterType": "PRIVATE",
  "monitorMode": false,
  "telegramNotificationLimit": 10
}
```

## Output

```json
{
  "expose_id": {
    "label": "ID",
    "format": "text"
  },
  "listing_url": {
    "label": "URL",
    "format": "link"
  },
  "title": {
    "label": "Titel",
    "format": "text"
  },
  "description": {
    "label": "Beschreibung",
    "format": "text"
  },
  "category_localized": {
    "label": "Kategorie",
    "format": "text"
  },
  "property_type": {
    "label": "Immobilienart",
    "format": "text"
  },
  "purchase_price": {
    "label": "Kaufpreis",
    "format": "number"
  },
  "rent_cold": {
    "label": "Kaltmiete",
    "format": "number"
  },
  "rent_total": {
    "label": "Gesamtmiete",
    "format": "number"
  },
  "warm_rent": {
    "label": "Warmmiete",
    "format": "number"
  },
  "ancillary_costs": {
    "label": "Nebenkosten",
    "format": "number"
  },
  "heating_costs": {
    "label": "Heizkosten",
    "format": "number"
  },
  "deposit": {
    "label": "Kaution",
    "format": "number"
  },
  "maintenance_fees": {
    "label": "Hausgeld",
    "format": "number"
  },
  "price_currency": {
    "label": "Währung",
    "format": "text"
  },
  "price_type": {
    "label": "Preistyp",
    "format": "text"
  },
  "original_price": {
    "label": "Originalpreis",
    "format": "number"
  },
  "provision": {
    "label": "Provision",
    "format": "text"
  },
  "deposit_costs": {
    "label": "Kautionskosten",
    "format": "text"
  },
  "size": {
    "label": "Wohnfläche",
    "format": "number"
  },
  "rooms": {
    "label": "Zimmer",
    "format": "number"
  },
  "sleeping_rooms": {
    "label": "Schlafzimmer",
    "format": "number"
  },
  "bathrooms": {
    "label": "Badezimmer",
    "format": "number"
  },
  "floor": {
    "label": "Etage",
    "format": "text"
  },
  "number_of_floors": {
    "label": "Stockwerke",
    "format": "text"
  },
  "lot_area": {
    "label": "Grundstücksfläche",
    "format": "number"
  },
  "year_constructed": {
    "label": "Baujahr",
    "format": "number"
  },
  "flat_type": {
    "label": "Wohnungstyp",
    "format": "text"
  },
  "house_type": {
    "label": "Haustyp",
    "format": "text"
  },
  "balcony": {
    "label": "Balkon",
    "format": "boolean"
  },
  "terrace": {
    "label": "Terrasse",
    "format": "boolean"
  },
  "fitted_kitchen": {
    "label": "Einbauküche",
    "format": "boolean"
  },
  "garden": {
    "label": "Garten",
    "format": "boolean"
  },
  "cellar": {
    "label": "Keller",
    "format": "boolean"
  },
  "loft": {
    "label": "Dachboden",
    "format": "boolean"
  },
  "garage": {
    "label": "Garage",
    "format": "boolean"
  },
  "guest_wc": {
    "label": "Gäste-WC",
    "format": "boolean"
  },
  "is_furnished": {
    "label": "Möbliert",
    "format": "boolean"
  },
  "bathtub": {
    "label": "Badewanne",
    "format": "boolean"
  },
  "elevator": {
    "label": "Aufzug",
    "format": "boolean"
  },
  "wg_possible": {
    "label": "WG-geeignet",
    "format": "boolean"
  },
  "swap_offer": {
    "label": "Tauschangebot",
    "format": "text"
  },
  "zip_code": {
    "label": "PLZ",
    "format": "number"
  },
  "city": {
    "label": "Stadt",
    "format": "text"
  },
  "state": {
    "label": "Bundesland",
    "format": "text"
  },
  "street": {
    "label": "Straße",
    "format": "text"
  },
  "address_line_1": {
    "label": "Adresse 1",
    "format": "text"
  },
  "address_line_2": {
    "label": "Adresse 2",
    "format": "text"
  },
  "location_lat": {
    "label": "Breitengrad",
    "format": "number"
  },
  "location_lng": {
    "label": "Längengrad",
    "format": "number"
  },
  "location_localized": {
    "label": "Standort",
    "format": "text"
  },
  "location_id": {
    "label": "Standort-ID",
    "format": "text"
  },
  "location_radius": {
    "label": "Standort-Radius",
    "format": "number"
  },
  "location_parent_id": {
    "label": "Standort-Parent-ID",
    "format": "text"
  },
  "online_since": {
    "label": "Online seit",
    "format": "date"
  },
  "last_edit_date": {
    "label": "Zuletzt bearbeitet",
    "format": "date"
  },
  "vacant_at_from": {
    "label": "Verfügbar ab",
    "format": "text"
  },
  "scraped_timestamp": {
    "label": "Scraping-Zeitpunkt",
    "format": "date"
  },
  "status": {
    "label": "Status",
    "format": "text"
  },
  "ad_status": {
    "label": "Anzeigenstatus",
    "format": "text"
  },
  "listing_type": {
    "label": "Angebotstyp",
    "format": "text"
  },
  "ad_type": {
    "label": "Anzeigentyp",
    "format": "text"
  },
  "contact": {
    "label": "Kontakt",
    "format": "object"
  },
  "company": {
    "label": "Firma",
    "format": "text"
  },
  "imprint": {
    "label": "Impressum",
    "format": "text"
  },
  "user_id": {
    "label": "User-ID",
    "format": "text"
  },
  "seller_type": {
    "label": "Verkäufertyp",
    "format": "text"
  },
  "user_rating": {
    "label": "Bewertung",
    "format": "number"
  },
  "user_since": {
    "label": "User seit",
    "format": "date"
  },
  "user_badges": {
    "label": "User-Badges",
    "format": "text"
  },
  "pictures": {
    "label": "Bilder",
    "format": "array"
  },
  "documents": {
    "label": "Dokumente",
    "format": "array"
  },
  "medias": {
    "label": "Medien",
    "format": "array"
  },
  "virtual_tour": {
    "label": "Virtueller Rundgang",
    "format": "boolean"
  },
  "online_tour": {
    "label": "Online-Besichtigung",
    "format": "text"
  },
  "features_active": {
    "label": "Aktive Features",
    "format": "array"
  },
  "is_new_construction": {
    "label": "Neubau",
    "format": "boolean"
  },
  "offer_allowed": {
    "label": "Angebot möglich",
    "format": "boolean"
  },
  "secure_payment_possible": {
    "label": "Sichere Zahlung",
    "format": "boolean"
  },
  "buy_now": {
    "label": "Sofortkauf",
    "format": "boolean"
  },
  "financing_eligible": {
    "label": "Finanzierung möglich",
    "format": "boolean"
  },
  "re_financing_eligible": {
    "label": "Refinanzierung möglich",
    "format": "boolean"
  },
  "is_buy": {
    "label": "Kaufangebot",
    "format": "boolean"
  },
  "platform": {
    "label": "Plattform",
    "format": "text"
  },
  "description_content_type": {
    "label": "Beschreibungsformat",
    "format": "text"
  },
  "category_name": {
    "label": "Kategorie (intern)",
    "format": "text"
  },
  "category_id": {
    "label": "Kategorie-ID",
    "format": "text"
  },
  "category_parent_id": {
    "label": "Kategorie-Parent-ID",
    "format": "text"
  },
  "ad_source_id": {
    "label": "Quell-ID",
    "format": "text"
  },
  "ad_external_reference_id": {
    "label": "Externe Referenz-ID",
    "format": "text"
  },
  "posted_from": {
    "label": "Gepostet von",
    "format": "text"
  },
  "labels": {
    "label": "Labels",
    "format": "text"
  },
  "tracking_account_type": {
    "label": "Account-Typ",
    "format": "text"
  },
  "placeholder_image": {
    "label": "Platzhalterbild",
    "format": "boolean"
  }
}
```

## About this Actor

This example demonstrates how to use [Kleinanzeigen Immobilien Scraper Pro - 1000/Min](https://apify.com/clearpath/kleinanzeigen-immobilien-api-pro) with a specific input configuration. Visit the [Actor detail page](https://apify.com/clearpath/kleinanzeigen-immobilien-api-pro) to learn more, explore other use cases, and run it yourself.


## 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.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **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 full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/clearpath/kleinanzeigen-immobilien-api-pro.md

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).