# Immowelt.de API scraper - German real estate data: apartments and houses for sale (kaufen) and to rent (mieten) plus foreclosure auctions, across every German city, district and federal state, with structured filters (price EUR, rooms, living space m2, plot m2, property type and subtype, new-build, garden/cellar/lift, sort) and 30-row pagination; each listing with price, rooms, living space, address, energy class, photos and the listing agency; a full per-listing detail record (description, all photos, complete feature and energy table, year built, running costs, price-per-m2 market comparison); and a free-text location resolver that maps a German place name to Immowelt's geo-id - no API key required

> Search Immowelt.de property listings in any German city, district, postcode area or federal state - for sale, to rent or foreclosure auction - with structured filters: price (EUR), number of rooms, living space (m2), plot size (m2), property type and subtype (penthouse, loft, detached house, villa...), new-build only, and features such as garden, cellar or lift. Results are 30 per page and can be sorted by price, date or size. Each row carries the numeric price, rooms, living space, plot, address (city/district/postcode), energy class, publication date, photos and the listing agency. `location` takes plain German free text ('Berlin', 'Muenchen', 'Koeln') and is resolved to Immowelt's own geo-id, or you can pass a geo-id ('AD08DE8634') straight through.
> ReefAPI engine `immowelt` · 3 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/immowelt/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/immowelt/v1/search — 1 credit
Search Immowelt.de property listings in any German city, district, postcode area or federal state - for sale, to rent or foreclosure auction - with structured filters: price (EUR), number of rooms, living space (m2), plot size (m2), property type and subtype (penthouse, loft, detached house, villa...), new-build only, and features such as garden, cellar or lift. Results are 30 per page and can be sorted by price, date or size. Each row carries the numeric price, rooms, living space, plot, address (city/district/postcode), energy class, publication date, photos and the listing agency. `location` takes plain German free text ('Berlin', 'Muenchen', 'Koeln') and is resolved to Immowelt's own geo-id, or you can pass a geo-id ('AD08DE8634') straight through.

**Parameters:**
- `location` (string, required) — Where to search - a German city, town, district or federal state as plain text ('Berlin', 'Muenchen', 'Koeln', 'Frankfurt am Main', 'Hamburg'), or an Immowelt geo-id ('AD08DE8634') taken from a previous response's location.geo_id / results[].geo_ids. Free text is slugified and resolved against Immowelt's own place index; umlauts may be written either way (Muenchen or München).
- `contract` (enum, optional, default "sale") — Which market to search. Rent prices are monthly cold rent in EUR; sale prices are the asking price. [one of: sale, rent, auction, buy_auction]
- `property_type` (enum, optional, default "apartment") — Kind of property. [one of: apartment, house, land, any]
- `property_subtype` (string, optional) — Narrow to one or several comma-separated subtypes: penthouse, loft, maisonette, terrace_flat, ground_floor, attic, souterrain (flats); detached, semi_detached, terraced, villa, bungalow, farmhouse (houses). e.g. 'penthouse,loft'.
- `page` (integer, optional, default 1) — Result page. 30 listings per page; paginate with page += 1 until page > max_pages.
- `sort` (enum, optional, default "relevance") — Result ordering. [one of: relevance, newest, price_low, price_high, largest]
- `price_min` (integer, optional) — Minimum price in EUR - asking price when contract=sale, monthly cold rent when contract=rent.
- `price_max` (integer, optional) — Maximum price in EUR.
- `rooms_min` (integer, optional) — Minimum number of rooms (Zimmer).
- `rooms_max` (integer, optional) — Maximum number of rooms.
- `living_space_min` (integer, optional) — Minimum living space in square metres (Wohnflaeche).
- `living_space_max` (integer, optional) — Maximum living space in square metres.
- `plot_min` (integer, optional) — Minimum plot size in square metres (Grundstuecksflaeche) - relevant for houses and land.
- `plot_max` (integer, optional) — Maximum plot size in square metres.
- `features` (string, optional) — Only return listings that have these features. One or several comma-separated: garden, cellar, lift. e.g. 'garden,lift'. [one of: garden, cellar, lift]
- `new_build` (boolean, optional, default false) — true = only new-build properties (Neubau).

**Returns:** results[]{id, legacy_id, url, title, contract, property_type, price{amount_eur, kind, label, formatted, per_sqm, total_eur}, rooms, living_space_m2, plot_area_m2, energy_class, address{city, district, zip_code, country, is_address_published}, geo_ids[], key_facts[], description_preview, published_at, updated_at, status, reference, tags{is_new, has_floor_plan, has_virtual_tour, has_video, has_brokerage_fee}, primary_photo_url, photo_count, agent{agency_name, publisher_type, is_private_owner, profile_url, imprint_url, website, business_address, badge, logo_url, contact_person, phone_numbers}, facts[]{type, label, value}} + total + count + page + page_size + max_pages + location{query, geo_id, city, region, url} + filters_applied. For a rental, `price.amount_eur` is the headline cold rent (Kaltmiete, the number Immowelt shows) and `price.total_eur` is the total monthly figure including running costs when the source publishes a different one; for a sale the two are the same and total_eur is null. `contact_person` and `phone_numbers` are null unless the request opts into personal data (include_pii); the agency itself is always returned. A field Immowelt does not publish for a listing comes back null.

**Example request body:**
```json
{
  "location": "Berlin"
}
```

### POST https://api.reefapi.com/immowelt/v1/detail — 1 credit
Full record for one Immowelt listing, by its expose URL or its listing id. Returns the asking price or monthly rent with running costs and commission, rooms, living space, plot, year built, condition, heating and energy source, the complete feature and energy-certificate table, the full German description and neighbourhood text, every photo at full resolution, the market price-per-m2 comparison Immowelt itself publishes for the area, and the listing agency. Both Immowelt id spaces are accepted - the short online id from a search row ('256Q14GY2JL7') and the legacy UUID in an older expose link - and both are returned so a row can be joined either way.

**Parameters:**
- `listing` (string, required) — An Immowelt expose URL (https://www.immowelt.de/expose/<id>) or just the id. Both the short online id ('256Q14GY2JL7', what a search row's `id` gives you) and the legacy UUID ('1215b46c-9e03-4081-bc72-67209544ff9f') work.

**Returns:** listing{id, legacy_id, url, online_id, reference, title, contract, property_type, property_subtype, price{amount_eur, kind, label, formatted, per_sqm, commission, additional_costs[]{group,label,value}}, rooms, living_space_m2, plot_area_m2, year_built, condition, heating, energy_source, address{city, district, zip_code, region, country, is_address_published}, geo_ids[], description, area_description, extra_information, features[]{group,label,value}, photos[], photo_count, price_comparison{market_price_per_sqm_eur, listing_price_per_sqm}, published_at, updated_at, tags{...}, agent{agency_name, agency_id, is_private_owner, logo_url, contact_person, phone_numbers}}. The broker's personal name and phone numbers are null unless the request opts into personal data (include_pii).

**Example request body:**
```json
{
  "listing": "https://www.immowelt.de/expose/256Q14GY2JL7"
}
```

### POST https://api.reefapi.com/immowelt/v1/location — 1 credit
Resolve a free-text German place - city, town, district or federal state - to Immowelt's own geo-id and canonical search URL, and report how many listings are live there right now. Use it to power a search box, to confirm which area a search will actually cover, or to obtain a geo-id you can then reuse in `search` without paying for resolution again.

**Parameters:**
- `query` (string, required) — Free-text German place to resolve: 'Berlin', 'Muenchen', 'Koeln', 'Frankfurt am Main', 'Nuernberg'. Umlauts may be written either way.
- `contract` (enum, optional, default "sale") — Which market the reported total counts. [one of: sale, rent]
- `property_type` (enum, optional, default "apartment") — Which property kind the reported total counts. [one of: apartment, house, land, any]

**Returns:** resolved{query, geo_id, city, region, city_slug, url, contract, property_type, total} + matched (bool)

**Example request body:**
```json
{
  "query": "München"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=immowelt
- Human docs page: https://reefapi.com/docs/immowelt
- Overview page: https://reefapi.com/immowelt-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
