# ImmoScout24 API (Germany + Austria) — immobilienscout24.de and immobilienscout24.at property listings for rent and sale: place lookup, search with every site filter (price, rooms, area, plot, year built, floor, balcony / garden / lift / kitchen / cellar / parking, energy class, apartment and house kinds, new-build, commission-free, keyword…) and sort, real paging with totals, search around a coordinate, result counts, the full listing (rent, running costs, deposit, purchase costs, energy certificate, description, all photos, address and coordinates, the advertiser with phone numbers and imprint, local price comparison), new-build projects and advertiser profiles with all their listings — no API key, no account

> Look up places by name or postcode and get the location ids the search actions accept: cities, districts, quarters, postcodes and streets in Germany; states, cities, districts, quarters and postcodes in Austria.
> ReefAPI engine `immoscout24` · 8 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/immoscout24/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/immoscout24/v1/locations — 1 credit
Look up places by name or postcode and get the location ids the search actions accept: cities, districts, quarters, postcodes and streets in Germany; states, cities, districts, quarters and postcodes in Austria.

**Parameters:**
- `query` (string, required) — Place name or postcode.
- `country` (enum, optional, default "de") — Which ImmoScout24 market. A pasted immobilienscout24.de / .at link, or a listing / location id whose shape names the market, overrides it. [one of: de, at]

**Returns:** results[]{id, name, type, parent, latitude, longitude, search_mode} (Germany) | results[]{id, name, type, matched_by} + parsed_filters + unmatched (Austria) + count

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

### POST https://api.reefapi.com/immoscout24/v1/search — 2 credits
Search ImmoScout24 listings (Germany or Austria) in a place, with every filter and sort the site itself offers, paged with the source's own total. Germany pages up to 100 rows; Austria 25 rows per page and 100 pages at most (the site's own ceiling).

**Parameters:**
- `location` (string, required) — Where: a place name or postcode ('Berlin', 'München Schwabing', '10115', 'Wien', 'Graz', '1010'), a location id from the `locations` action (Germany '1276003001', Austria '009001'), or a pasted search link of either site (its place, type and filters are used; your own params win).
- `country` (enum, optional, default "de") — Which ImmoScout24 market. A pasted immobilienscout24.de / .at link, or a listing / location id whose shape names the market, overrides it. [one of: de, at]
- `property_type` (enum, optional, default "apartment_rent") — What to search. Both markets: apartment_rent, apartment_buy, house_rent, house_buy, plot_rent, plot_buy, garage_rent, garage_buy, room_rent, short_term_rent, office_*, retail_*, industry_*, gastronomy_*, investment_buy. Germany only: special_purpose_*, commercial_plot_*, compulsory_auction, senior_care, assisted_living, prefab_house. Austria only: hotel_*, agriculture_*, leisure_*. [one of: apartment_rent, apartment_buy, house_rent, house_buy, plot_rent, plot_buy, garage_rent, garage_buy, room_rent, short_term_rent, office_rent, office_buy, retail_rent, retail_buy, industry_rent, industry_buy, gastronomy_rent, gastronomy_buy, special_purpose_rent, special_purpose_buy, commercial_plot_rent, commercial_plot_buy, investment_buy, compulsory_auction, senior_care, assisted_living, prefab_house, hotel_rent, hotel_buy, agriculture_rent, agriculture_buy, leisure_rent, leisure_buy]
- `sort` (enum, optional, default "default") — Ordering. Germany: default, price_asc, price_desc, area_asc, area_desc, rooms_asc, rooms_desc, newest, oldest. Austria: default, price_asc, price_desc, area_asc, area_desc, newest, price_per_sqm_asc, price_per_sqm_desc. [one of: default, price_asc, price_desc, area_desc, area_asc, rooms_desc, rooms_asc, newest, oldest, price_per_sqm_asc, price_per_sqm_desc]
- `page` (integer, optional, default 1) — Result page (1-based).
- `page_size` (integer, optional, default 20) — Germany: rows per page, 1-100 (default 20). Austria: fixed at 25.
- `price_min` (number, optional) — Minimum price in EUR — monthly rent for rent types (cold rent / Kaltmiete unless price_basis=total), asking price for buy types.
- `price_max` (number, optional) — Maximum price in EUR.
- `price_basis` (enum, optional) — Germany, apartment_rent / house_rent only: which rent price_min/price_max filter on. [one of: cold, total]
- `rooms_min` (number, optional) — Minimum number of rooms.
- `rooms_max` (number, optional) — Maximum number of rooms.
- `area_min` (number, optional) — Minimum area in m² — living space for homes, net floor space for commercial, plot area for plot types.
- `area_max` (number, optional) — Maximum area in m².
- `plot_min` (number, optional) — Minimum plot size in m² (Austria: any type; Germany: plot types).
- `plot_max` (number, optional) — Maximum plot size in m².
- `year_built_min` (integer, optional) — Germany: built in or after this year.
- `year_built_max` (integer, optional) — Germany: built in or before this year.
- `floor_min` (integer, optional) — Germany: on this floor or higher.
- `floor_max` (integer, optional) — Germany: on this floor or lower.
- `price_per_sqm_min` (number, optional) — Austria: minimum price per m² in EUR.
- `price_per_sqm_max` (number, optional) — Austria: maximum price per m² in EUR.
- `features` (array, optional) — Must-have features, comma-separated. Germany: balcony, garden, kitchen, lift, cellar, parking, guest_toilet, barrier_free (on house searches balcony / lift / garden — and kitchen on house_buy — are refused because the source ignores them). Austria: balcony, garden, terrace, loggia, lift, cellar, pool, air_conditioning, parking, barrier_free, wheelchair_accessible, senior_friendly, bathtub, furnished, partly_furnished. [one of: balcony, garden, kitchen, lift, cellar, parking, guest_toilet, barrier_free, terrace, loggia, pool, air_conditioning, wheelchair_accessible, senior_friendly, bathtub, furnished, partly_furnished]
- `pets_allowed` (boolean, optional) — Germany: pets allowed.
- `energy_classes` (array, optional) — Germany: energy efficiency classes, comma-separated (a_plus, a … h). [one of: a_plus, a, b, c, d, e, f, g, h]
- `apartment_types` (array, optional) — Apartment kinds (apartment types only). Germany: floor_apartment, roof_storey, loft, maisonette, penthouse, terraced_flat, ground_floor, raised_ground_floor, half_basement, other. Austria: floor_apartment, ground_floor, loft, maisonette, roof_storey, penthouse. [one of: floor_apartment, roof_storey, loft, maisonette, penthouse, terraced_flat, ground_floor, raised_ground_floor, half_basement, other]
- `house_types` (array, optional) — House kinds (house types only). Germany: single_family, mid_terrace, end_terrace, semi_detached, multi_family, bungalow, farmhouse, villa, castle, special. Austria: single_family, terraced, semi_detached, multi_family, bungalow, farmhouse, villa, town_house. [one of: single_family, mid_terrace, end_terrace, semi_detached, multi_family, bungalow, farmhouse, villa, castle, special, terraced, town_house]
- `new_build` (boolean, optional) — New-build only (Neubau).
- `old_build` (boolean, optional) — Austria: old building only (Altbau).
- `condition` (array, optional) — Austria: condition, comma-separated. [one of: first_time_use, mint_condition, refurbished, modernized, fully_renovated, well_kept, need_of_renovation, demolition]
- `construction_method` (array, optional) — Austria: construction method (wood, massive, prefabricated). [one of: wood, massive, prefabricated]
- `exclude_projects` (boolean, optional) — Germany: leave out new-build project listings.
- `developer_project_only` (boolean, optional) — Austria: new-build developer projects only.
- `keyword` (string, optional) — Free-text keyword the listing must mention (e.g. 'Altbau', 'Pool').
- `commission_free` (boolean, optional) — Commission-free listings only (provisionsfrei).
- `private_only` (boolean, optional) — Austria: private advertisers only.
- `wbs_required` (boolean, optional) — Germany: only listings that require a housing entitlement certificate (WBS).
- `social_housing` (boolean, optional) — Austria: social / council housing only (Gemeindewohnungen).
- `financial_contribution_required` (boolean, optional) — Austria, rent: only listings that require a financial contribution (Finanzierungsbeitrag).
- `flat_share_suitable` (boolean, optional) — Germany: suitable for a flat share.
- `min_internet_mbps` (number, optional) — Germany: minimum available internet speed in Mbit/s.
- `investment_only` (boolean, optional) — Austria: investment properties only.
- `short_term_rentable` (boolean, optional) — Austria, rent: short-term rentable only.
- `holiday_home` (boolean, optional) — Austria: suitable as a holiday home.
- `forced_sale` (boolean, optional) — Austria, buy: forced sales (Zwangsversteigerung) only.
- `transit_types` (array, optional) — Austria: public transport nearby, comma-separated (bus, tram, subway, urban_train, regional_train, ferry, cable_car). [one of: bus, tram, subway, urban_train, regional_train, ferry, cable_car]
- `subway_lines` (array, optional) — Austria (Vienna): near these U-Bahn lines, comma-separated (u1, u2, u3, u4, u6). [one of: u1, u2, u3, u4, u6]
- `picture_tags` (string, optional) — Austria: listings whose photos carry this tag — the site's own lowercase English photo tags, comma-separated (e.g. 'balcony'); a tag the site does not use matches nothing.

**Returns:** results[]{id, url, country, title, property_type|estate_type+deal, price_eur, price_text, price_per_sqm_eur, area_m2, rooms, plot_m2, key_facts[], address{text, street, postcode, city, district, latitude, longitude}, energy_class, published / published_at, is_private, is_project, photo, photos[], agent{id, company, name} (Austria) | agency_logo + group (Germany)} + total + page + page_size + total_pages + has_next + location + filters_applied

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

### POST https://api.reefapi.com/immoscout24/v1/search_by_coordinates — 2 credits
Germany: search listings within a radius (km) of a latitude / longitude, with the same filters, sorting and paging as `search`.

**Parameters:**
- `latitude` (number, required) — Latitude (Germany).
- `longitude` (number, required) — Longitude (Germany).
- `radius_km` (number, optional, default 2) — Radius in km.
- `property_type` (enum, optional, default "apartment_rent") — What to search. Both markets: apartment_rent, apartment_buy, house_rent, house_buy, plot_rent, plot_buy, garage_rent, garage_buy, room_rent, short_term_rent, office_*, retail_*, industry_*, gastronomy_*, investment_buy. Germany only: special_purpose_*, commercial_plot_*, compulsory_auction, senior_care, assisted_living, prefab_house. Austria only: hotel_*, agriculture_*, leisure_*. [one of: apartment_rent, apartment_buy, house_rent, house_buy, plot_rent, plot_buy, garage_rent, garage_buy, room_rent, short_term_rent, office_rent, office_buy, retail_rent, retail_buy, industry_rent, industry_buy, gastronomy_rent, gastronomy_buy, special_purpose_rent, special_purpose_buy, commercial_plot_rent, commercial_plot_buy, investment_buy, compulsory_auction, senior_care, assisted_living, prefab_house, hotel_rent, hotel_buy, agriculture_rent, agriculture_buy, leisure_rent, leisure_buy]
- `sort` (enum, optional, default "default") — Ordering. Germany: default, price_asc, price_desc, area_asc, area_desc, rooms_asc, rooms_desc, newest, oldest. Austria: default, price_asc, price_desc, area_asc, area_desc, newest, price_per_sqm_asc, price_per_sqm_desc. [one of: default, price_asc, price_desc, area_desc, area_asc, rooms_desc, rooms_asc, newest, oldest, price_per_sqm_asc, price_per_sqm_desc]
- `page` (integer, optional, default 1) — Result page.
- `page_size` (integer, optional, default 20) — Rows per page, 1-100.
- `price_min` (number, optional) — Minimum price in EUR — monthly rent for rent types (cold rent / Kaltmiete unless price_basis=total), asking price for buy types.
- `price_max` (number, optional) — Maximum price in EUR.
- `price_basis` (enum, optional) — Germany, apartment_rent / house_rent only: which rent price_min/price_max filter on. [one of: cold, total]
- `rooms_min` (number, optional) — Minimum number of rooms.
- `rooms_max` (number, optional) — Maximum number of rooms.
- `area_min` (number, optional) — Minimum area in m² — living space for homes, net floor space for commercial, plot area for plot types.
- `area_max` (number, optional) — Maximum area in m².
- `plot_min` (number, optional) — Minimum plot size in m² (Austria: any type; Germany: plot types).
- `plot_max` (number, optional) — Maximum plot size in m².
- `year_built_min` (integer, optional) — Germany: built in or after this year.
- `year_built_max` (integer, optional) — Germany: built in or before this year.
- `floor_min` (integer, optional) — Germany: on this floor or higher.
- `floor_max` (integer, optional) — Germany: on this floor or lower.
- `price_per_sqm_min` (number, optional) — Austria: minimum price per m² in EUR.
- `price_per_sqm_max` (number, optional) — Austria: maximum price per m² in EUR.
- `features` (array, optional) — Must-have features, comma-separated. Germany: balcony, garden, kitchen, lift, cellar, parking, guest_toilet, barrier_free (on house searches balcony / lift / garden — and kitchen on house_buy — are refused because the source ignores them). Austria: balcony, garden, terrace, loggia, lift, cellar, pool, air_conditioning, parking, barrier_free, wheelchair_accessible, senior_friendly, bathtub, furnished, partly_furnished. [one of: balcony, garden, kitchen, lift, cellar, parking, guest_toilet, barrier_free, terrace, loggia, pool, air_conditioning, wheelchair_accessible, senior_friendly, bathtub, furnished, partly_furnished]
- `pets_allowed` (boolean, optional) — Germany: pets allowed.
- `energy_classes` (array, optional) — Germany: energy efficiency classes, comma-separated (a_plus, a … h). [one of: a_plus, a, b, c, d, e, f, g, h]
- `apartment_types` (array, optional) — Apartment kinds (apartment types only). Germany: floor_apartment, roof_storey, loft, maisonette, penthouse, terraced_flat, ground_floor, raised_ground_floor, half_basement, other. Austria: floor_apartment, ground_floor, loft, maisonette, roof_storey, penthouse. [one of: floor_apartment, roof_storey, loft, maisonette, penthouse, terraced_flat, ground_floor, raised_ground_floor, half_basement, other]
- `house_types` (array, optional) — House kinds (house types only). Germany: single_family, mid_terrace, end_terrace, semi_detached, multi_family, bungalow, farmhouse, villa, castle, special. Austria: single_family, terraced, semi_detached, multi_family, bungalow, farmhouse, villa, town_house. [one of: single_family, mid_terrace, end_terrace, semi_detached, multi_family, bungalow, farmhouse, villa, castle, special, terraced, town_house]
- `new_build` (boolean, optional) — New-build only (Neubau).
- `old_build` (boolean, optional) — Austria: old building only (Altbau).
- `condition` (array, optional) — Austria: condition, comma-separated. [one of: first_time_use, mint_condition, refurbished, modernized, fully_renovated, well_kept, need_of_renovation, demolition]
- `construction_method` (array, optional) — Austria: construction method (wood, massive, prefabricated). [one of: wood, massive, prefabricated]
- `exclude_projects` (boolean, optional) — Germany: leave out new-build project listings.
- `developer_project_only` (boolean, optional) — Austria: new-build developer projects only.
- `keyword` (string, optional) — Free-text keyword the listing must mention (e.g. 'Altbau', 'Pool').
- `commission_free` (boolean, optional) — Commission-free listings only (provisionsfrei).
- `private_only` (boolean, optional) — Austria: private advertisers only.
- `wbs_required` (boolean, optional) — Germany: only listings that require a housing entitlement certificate (WBS).
- `social_housing` (boolean, optional) — Austria: social / council housing only (Gemeindewohnungen).
- `financial_contribution_required` (boolean, optional) — Austria, rent: only listings that require a financial contribution (Finanzierungsbeitrag).
- `flat_share_suitable` (boolean, optional) — Germany: suitable for a flat share.
- `min_internet_mbps` (number, optional) — Germany: minimum available internet speed in Mbit/s.
- `investment_only` (boolean, optional) — Austria: investment properties only.
- `short_term_rentable` (boolean, optional) — Austria, rent: short-term rentable only.
- `holiday_home` (boolean, optional) — Austria: suitable as a holiday home.
- `forced_sale` (boolean, optional) — Austria, buy: forced sales (Zwangsversteigerung) only.
- `transit_types` (array, optional) — Austria: public transport nearby, comma-separated (bus, tram, subway, urban_train, regional_train, ferry, cable_car). [one of: bus, tram, subway, urban_train, regional_train, ferry, cable_car]
- `subway_lines` (array, optional) — Austria (Vienna): near these U-Bahn lines, comma-separated (u1, u2, u3, u4, u6). [one of: u1, u2, u3, u4, u6]
- `picture_tags` (string, optional) — Austria: listings whose photos carry this tag — the site's own lowercase English photo tags, comma-separated (e.g. 'balcony'); a tag the site does not use matches nothing.

**Returns:** results[] (same row as search) + total + page + total_pages + has_next + centre

**Example request body:**
```json
{
  "latitude": 52.52,
  "longitude": 13.405
}
```

### POST https://api.reefapi.com/immoscout24/v1/count — 1 credit
Count the listings that match a place and filters without paging through them.

**Parameters:**
- `location` (string, required) — Where: a place name or postcode ('Berlin', 'München Schwabing', '10115', 'Wien', 'Graz', '1010'), a location id from the `locations` action (Germany '1276003001', Austria '009001'), or a pasted search link of either site (its place, type and filters are used; your own params win).
- `country` (enum, optional, default "de") — Which ImmoScout24 market. A pasted immobilienscout24.de / .at link, or a listing / location id whose shape names the market, overrides it. [one of: de, at]
- `property_type` (enum, optional, default "apartment_rent") — What to search. Both markets: apartment_rent, apartment_buy, house_rent, house_buy, plot_rent, plot_buy, garage_rent, garage_buy, room_rent, short_term_rent, office_*, retail_*, industry_*, gastronomy_*, investment_buy. Germany only: special_purpose_*, commercial_plot_*, compulsory_auction, senior_care, assisted_living, prefab_house. Austria only: hotel_*, agriculture_*, leisure_*. [one of: apartment_rent, apartment_buy, house_rent, house_buy, plot_rent, plot_buy, garage_rent, garage_buy, room_rent, short_term_rent, office_rent, office_buy, retail_rent, retail_buy, industry_rent, industry_buy, gastronomy_rent, gastronomy_buy, special_purpose_rent, special_purpose_buy, commercial_plot_rent, commercial_plot_buy, investment_buy, compulsory_auction, senior_care, assisted_living, prefab_house, hotel_rent, hotel_buy, agriculture_rent, agriculture_buy, leisure_rent, leisure_buy]
- `price_min` (number, optional) — Minimum price in EUR — monthly rent for rent types (cold rent / Kaltmiete unless price_basis=total), asking price for buy types.
- `price_max` (number, optional) — Maximum price in EUR.
- `price_basis` (enum, optional) — Germany, apartment_rent / house_rent only: which rent price_min/price_max filter on. [one of: cold, total]
- `rooms_min` (number, optional) — Minimum number of rooms.
- `rooms_max` (number, optional) — Maximum number of rooms.
- `area_min` (number, optional) — Minimum area in m² — living space for homes, net floor space for commercial, plot area for plot types.
- `area_max` (number, optional) — Maximum area in m².
- `plot_min` (number, optional) — Minimum plot size in m² (Austria: any type; Germany: plot types).
- `plot_max` (number, optional) — Maximum plot size in m².
- `year_built_min` (integer, optional) — Germany: built in or after this year.
- `year_built_max` (integer, optional) — Germany: built in or before this year.
- `floor_min` (integer, optional) — Germany: on this floor or higher.
- `floor_max` (integer, optional) — Germany: on this floor or lower.
- `price_per_sqm_min` (number, optional) — Austria: minimum price per m² in EUR.
- `price_per_sqm_max` (number, optional) — Austria: maximum price per m² in EUR.
- `features` (array, optional) — Must-have features, comma-separated. Germany: balcony, garden, kitchen, lift, cellar, parking, guest_toilet, barrier_free (on house searches balcony / lift / garden — and kitchen on house_buy — are refused because the source ignores them). Austria: balcony, garden, terrace, loggia, lift, cellar, pool, air_conditioning, parking, barrier_free, wheelchair_accessible, senior_friendly, bathtub, furnished, partly_furnished. [one of: balcony, garden, kitchen, lift, cellar, parking, guest_toilet, barrier_free, terrace, loggia, pool, air_conditioning, wheelchair_accessible, senior_friendly, bathtub, furnished, partly_furnished]
- `pets_allowed` (boolean, optional) — Germany: pets allowed.
- `energy_classes` (array, optional) — Germany: energy efficiency classes, comma-separated (a_plus, a … h). [one of: a_plus, a, b, c, d, e, f, g, h]
- `apartment_types` (array, optional) — Apartment kinds (apartment types only). Germany: floor_apartment, roof_storey, loft, maisonette, penthouse, terraced_flat, ground_floor, raised_ground_floor, half_basement, other. Austria: floor_apartment, ground_floor, loft, maisonette, roof_storey, penthouse. [one of: floor_apartment, roof_storey, loft, maisonette, penthouse, terraced_flat, ground_floor, raised_ground_floor, half_basement, other]
- `house_types` (array, optional) — House kinds (house types only). Germany: single_family, mid_terrace, end_terrace, semi_detached, multi_family, bungalow, farmhouse, villa, castle, special. Austria: single_family, terraced, semi_detached, multi_family, bungalow, farmhouse, villa, town_house. [one of: single_family, mid_terrace, end_terrace, semi_detached, multi_family, bungalow, farmhouse, villa, castle, special, terraced, town_house]
- `new_build` (boolean, optional) — New-build only (Neubau).
- `old_build` (boolean, optional) — Austria: old building only (Altbau).
- `condition` (array, optional) — Austria: condition, comma-separated. [one of: first_time_use, mint_condition, refurbished, modernized, fully_renovated, well_kept, need_of_renovation, demolition]
- `construction_method` (array, optional) — Austria: construction method (wood, massive, prefabricated). [one of: wood, massive, prefabricated]
- `exclude_projects` (boolean, optional) — Germany: leave out new-build project listings.
- `developer_project_only` (boolean, optional) — Austria: new-build developer projects only.
- `keyword` (string, optional) — Free-text keyword the listing must mention (e.g. 'Altbau', 'Pool').
- `commission_free` (boolean, optional) — Commission-free listings only (provisionsfrei).
- `private_only` (boolean, optional) — Austria: private advertisers only.
- `wbs_required` (boolean, optional) — Germany: only listings that require a housing entitlement certificate (WBS).
- `social_housing` (boolean, optional) — Austria: social / council housing only (Gemeindewohnungen).
- `financial_contribution_required` (boolean, optional) — Austria, rent: only listings that require a financial contribution (Finanzierungsbeitrag).
- `flat_share_suitable` (boolean, optional) — Germany: suitable for a flat share.
- `min_internet_mbps` (number, optional) — Germany: minimum available internet speed in Mbit/s.
- `investment_only` (boolean, optional) — Austria: investment properties only.
- `short_term_rentable` (boolean, optional) — Austria, rent: short-term rentable only.
- `holiday_home` (boolean, optional) — Austria: suitable as a holiday home.
- `forced_sale` (boolean, optional) — Austria, buy: forced sales (Zwangsversteigerung) only.
- `transit_types` (array, optional) — Austria: public transport nearby, comma-separated (bus, tram, subway, urban_train, regional_train, ferry, cable_car). [one of: bus, tram, subway, urban_train, regional_train, ferry, cable_car]
- `subway_lines` (array, optional) — Austria (Vienna): near these U-Bahn lines, comma-separated (u1, u2, u3, u4, u6). [one of: u1, u2, u3, u4, u6]
- `picture_tags` (string, optional) — Austria: listings whose photos carry this tag — the site's own lowercase English photo tags, comma-separated (e.g. 'balcony'); a tag the site does not use matches nothing.

**Returns:** total (the site's own count of live listings for the place and filters) + location + filters_applied

**Example request body:**
```json
{
  "location": "München",
  "property_type": "apartment_buy"
}
```

### POST https://api.reefapi.com/immoscout24/v1/listing — 2 credits
Everything the site shows on one listing (expose): price, rent with running and heating costs, deposit, commission, purchase costs, area, rooms, floor, year built, condition, energy certificate, the full description texts, every photo, the address and coordinates as published, the advertiser (name, company, phone numbers, imprint, rating, profile link), the local price comparison and the sibling units of a new-build project. Takes a German or Austrian listing id or link.

**Parameters:**
- `listing` (string, required) — Listing id (Germany digits, e.g. 172626075; Austria 24 characters, e.g. 68ef90538c4b5843c5d4b14c) or an expose link of either site.

**Returns:** listing{id, url, country, title, price{…}, living_space_m2, rooms, floor, year_built, energy{…}, description, photos[], address{…}, agent{id, name, company, phones/phone, imprint…}, project_units[], price_comparison, attribute_groups[] / features[], facts{…}}. Price fields, Germany: base_rent_eur = cold rent (Kaltmiete); total_rent_eur = total rent incl. service charge and heating (Warmmiete / Gesamtmiete); service_charge_eur = Nebenkosten; heating_costs_eur = Heizkosten; deposit_eur = Kaution; purchase_price_eur = Kaufpreis. Price fields, Austria — each is one named line of the listing's cost table, null when the listing has no such line: main_rent_eur = 'Miete' (usually net of VAT, main_rent_vat_eur beside it); total_rent_eur = 'Gesamtmiete' (gross rent incl. operating and other costs and VAT, without heating) with total_rent_net_eur / total_rent_vat_eur; monthly_costs_eur = 'Monatliche Kosten' / 'Gesamtbelastung' (everything payable per month incl. heating and VAT) with monthly_costs_net_eur / monthly_costs_vat_eur; operating_costs_eur = 'Betriebskosten'; heating_costs_eur / heating_costs_net_eur = 'Heizkosten' / 'Heizkosten Netto'; other_costs_eur / other_costs_net_eur = 'Sonstige Kosten' / 'Sonstige Kosten Netto'; *_vat_eur = the matching 'USt.' line; deposit_eur = 'Kaution' when stated as an amount (deposit_text always). running_costs[] / one_time_costs[] keep the whole table as printed.

**Example request body:**
```json
{
  "listing": "172626075"
}
```

### POST https://api.reefapi.com/immoscout24/v1/project — 1 credit
Germany: a new-build project — name, developer, price range, description, address with coordinates, photos, documents, contact with phone and imprint, and every unit it lists.

**Parameters:**
- `project` (string, required) — Project id (a German listing's `project.id`, e.g. 153524) or a link carrying it.

**Returns:** project{id, name, developer, price_range, key_facts[], description, address{…}, photos[], units[]{id, title, price_eur, area_m2, rooms}, contact{…}, homepage, documents[]}

**Example request body:**
```json
{
  "project": "153524"
}
```

### POST https://api.reefapi.com/immoscout24/v1/agent — 3 credits
The advertiser (agency / agent / developer / private) behind listings: Austria — the full public profile (name, address, phone numbers, website, about text, logo, badges) by advertiser id or profile link; both markets — from a listing id, the advertiser block of that listing. Always with how many listings the advertiser has live (Germany: per property type).

**Parameters:**
- `agent` (string, optional) — Advertiser id from a listing's `agent.id` (Austria '012.…', Germany '001.…') or an immobilienscout24.at /anbieter/ link. Germany needs `listing` for the name/phone block (its profile page is not public to automated clients); with only an id it returns the listing counts.
- `listing` (string, optional) — Any listing id/link of the advertiser.

**Returns:** agent{id, country, name, company, phones[], address, website, about, logo, rating, imprint, profile_url, listing_counts{…}, listing_total}

**Example request body:**
```json
{
  "agent": "012.0012000001QAU61"
}
```

### POST https://api.reefapi.com/immoscout24/v1/agent_listings — 3 credits
Every live listing of one advertiser, paged. Germany: one property type per call (default: the advertiser's largest type, with the per-type counts in the answer); Austria: residential or commercial segment.

**Parameters:**
- `agent` (string, required) — Advertiser id from a listing's `agent.id` (Germany '001.559854', Austria '012.0012000001QAU61') or an immobilienscout24.at /anbieter/ link.
- `property_type` (enum, optional) — Germany: which property type (default: the advertiser's largest). [one of: apartment_rent, apartment_buy, house_rent, house_buy, plot_rent, plot_buy, garage_rent, garage_buy, room_rent, short_term_rent, office_rent, office_buy, retail_rent, retail_buy, industry_rent, industry_buy, gastronomy_rent, gastronomy_buy, special_purpose_rent, special_purpose_buy, commercial_plot_rent, commercial_plot_buy, investment_buy, compulsory_auction, senior_care, assisted_living, prefab_house]
- `segment` (enum, optional, default "residential") — Austria: residential or commercial listings. [one of: residential, commercial]
- `sort` (enum, optional, default "default") — Ordering. Germany: default, price_asc, price_desc, area_asc, area_desc, rooms_asc, rooms_desc, newest, oldest. Austria: default, price_asc, price_desc, area_asc, area_desc, newest, price_per_sqm_asc, price_per_sqm_desc. [one of: default, price_asc, price_desc, area_desc, area_asc, rooms_desc, rooms_asc, newest, oldest, price_per_sqm_asc, price_per_sqm_desc]
- `page` (integer, optional, default 1) — Result page.
- `page_size` (integer, optional, default 20) — Germany: rows per page, 1-100. Austria: fixed at 25.

**Returns:** results[] (same row as search) + total + page + total_pages + has_next + listing_counts

**Example request body:**
```json
{
  "agent": "001.559854"
}
```

## 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=immoscout24
- Human docs page: https://reefapi.com/docs/immoscout24
- Overview page: https://reefapi.com/immoscout24-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
