# ImmobilienScout24 Austria Facets API Documentation

<p>Scrappa's `GET /api/immoscout24-at/facets` endpoint returns the total number of listings for a filter set and the count per facet value, without returning the listings themselves.

    ## Facet blocks

    The response has 22 blocks, for example property type and subtype, condition, building age, outdoor space, facilities, lift, furnishing, parking, private and developer listings, and the place hierarchy. Use it to build filter menus with live counts or to track market size cheaply.</p>

- **Documentation:** [https://scrappa.co/docs/immoscout24-at-api/immoscout24_at_facets](https://scrappa.co/docs/immoscout24-at-api/immoscout24_at_facets)
- **API group:** ImmobilienScout24 Austria API
- **Endpoint:** `GET https://scrappa.co/api/immoscout24-at/facets`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `transfer_type` | string | No | Deal type. One of: `BUY`, `RENT`, `LEASE`, `LEASEHOLD`, `TEMPORARY_RENT`. Defaults to `RENT`. Several values are comma separated. |
| `estate_type` | string | No | Property type. One of: `APARTMENT`, `HOUSE`, `OFFICE`, `PROPERTY`, `INDUSTRIAL`, `RETAIL`, `PARKING_PLACE`, `INVESTMENTPROPERTY`, `MISCELLANEOUS`, `GASTRONOMY`, `AGRICULTURE_AND_TIMBER`, `HOTEL`, `ROOM`, `LEISUREFACILITY`. Defaults to `APARTMENT`. Several values are comma separated. |
| `estate_detail_type` | string | No | Property subtype such as `PENTHOUSE`, `LOFT`, `MAISONETTE` or `VILLA`. One of: `AGRICULTURE_HOLDING`, `APARTMENT`, `APARTMENTHOUSE`, `BAR`, `BARN`, `BED_AND_BREAKFAST`, `BOOTBERTH`, `BUNGALOW`, `CAFE`, `CARPORT`, `DOCTORS_OFFICE`, `DUPLEX`, `END_TERRACE_HOUSE`, `EXHIBITION_SPACE`, `FARM`, `FARMHOUSE`, `FIELD`, `FLOOR_APARTMENT`, `FUNFAIR`, `GARAGE`, `GASSTATION`, `GASTRONOMY`, `GROUND_FLOOR`, `HALF_BASEMENT`, `HEALTHCARE`, `HORSE_STABLE`, `HOTEL`, `HUNTING_GROUND`, `INDUSTRIAL`, `LAND`, `LOFT`, `MAISONETTE`, `MID_TERRACE_HOUSE`, `MISCELLANEOUS`, `MISCELLANEOUS_AGRICULTURE_AND_TIMBER`, `MISCELLANEOUS_GASTRONOMY`, `MISCELLANEOUS_HOTEL`, `MISCELLANEOUS_HOUSE`, `MISCELLANEOUS_INDUSTRIAL`, `MISCELLANEOUS_INVESTEMENTPROPERTY`, `MISCELLANEOUS_RETAIL`, `MULTI_FAMILY_HOUSE`, `OFFICE`, `OFFICE_BUILDING`, `OPEN_AREA`, `PARKING_SPACE`, `PARKINGHOUSE`, `PENTHOUSE`, `PRODUCTION`, `RESTAURANT`, `RETAIL_SHOP`, `RETAIL_STORE`, `ROOF_STOREY`, `ROUGH_ATTIC`, `SEMIDETACHED_HOUSE`, `SHARED_OFFICE_SPACE`, `SHOP`, `SHOPPING_CENTER`, `SINGLE_FAMILY_HOUSE`, `SINGLE_GARAGE`, `SPECIAL_OFFICE`, `SPORTSAREA`, `SUPERMARKET`, `TERRACE_HOUSE`, `TERRACED_FLAT`, `TOWN_HOUSE`, `UNDERGROUND_PARKING_PLACE`, `VILLA`, `VINEYARD`, `WAREHOUSE`, `WORKSHOP`. Several values are comma separated. |
| `use_type` | string | No | One of: `RESIDENTIAL`, `COMMERCIAL`. Defaults to `RESIDENTIAL`. |
| `region` | string | No | Region id from the locations or autocomplete endpoint, for example `009001` (Vienna) or `009001022` (Vienna, 22nd district). An id the portal does not know is rejected without charge. |
| `zip_code` | string | No | Four digit Austrian postcode. |
| `keywords` | string | No | Free-text keywords. |
| `price_from` | number | No | Minimum price in euro (monthly for rent). |
| `price_to` | number | No | Maximum price in euro (monthly for rent). |
| `rooms_from` | number | No | Minimum number of rooms. |
| `rooms_to` | number | No | Maximum number of rooms. |
| `area_from` | number | No | Minimum living area in square meters. |
| `area_to` | number | No | Maximum living area in square meters. |
| `plot_area_from` | number | No | Minimum plot area in square meters. |
| `plot_area_to` | number | No | Maximum plot area in square meters. |
| `price_per_sqm_from` | number | No | Minimum price per square meter. |
| `price_per_sqm_to` | number | No | Maximum price per square meter. |
| `condition_type` | string | No | Condition. One of: `DEMOLITION`, `FIRST_TIME_USE`, `FIRST_TIME_USE_AFTER_REFURBISHMENT`, `FRAMING`, `FULLY_REFURBISHED`, `FULLY_RENOVATED`, `GUTTED`, `MINT_CONDITION`, `MODERNIZED`, `NEED_OF_RENOVATION`, `NEED_TO_DISCUSS`, `PARTLY_REFURBISHED`, `PROJECTPHASE`, `REFURBISHED`, `WELL_KEPT`. Several values are comma separated. |
| `condition_age` | string | No | One of: `NEWBUILDING`, `OLDBUILDING`. |
| `outdoor_spaces` | string | No | Outdoor space. One of: `BALCONY`, `GARDEN`, `LOGGIA`, `TERRACE`. Several values are comma separated. |
| `facilities` | string | No | Facilities. One of: `AIR_CONDITIONING`, `ATTIC`, `BIKE_ROOM`, `CABLE_DUCTS`, `CELLAR`, `CELLAR_PARTIAL`, `CRANE`, `EV_CHARGING_STATION`, `FIREPLACE`, `GARDEN`, `GUEST_TERRACE`, `GUEST_TOILET`, `HOLIDAY_PROPERTY_PHONE`, `LIBRARY`, `LIFTING_PLATTFORM`, `PARCEL_DELIVERY_BOX`, `PHOTOVOLTAIC_SYSTEM`, `RAMP`, `SAUNA`, `SHUTTER`, `SMART_HOME_SYSTEM`, `SPORTS_FACILITIES`, `STOREROOM`, `SWIMMING_POOL`, `WASHING_DRYING_ROOM`, `WELLNESS_AREA`, `WINTER_GARDEN`. Several values are comma separated. |
| `furnishing` | string | No | One of: `FULL`, `PART`. |
| `lift` | string | No | One of: `LIFT`, `FREIGHT_LIFT`. |
| `accessibility` | string | No | One of: `HANDICAPPED_ACCESSIBLE`, `SENIOR_CARE`, `SUITABLE_FOR_WHEELCHAIRS`. Several values are comma separated. |
| `bathroom` | string | No | One of: `BATHTUBE`, `BIDET`, `SHOWER`, `URINAL`, `WINDOW`. Several values are comma separated. |
| `construction_method` | string | No | One of: `MASSIVE`, `PREFABRICATED`, `WOOD`. Several values are comma separated. |
| `parking_spaces` | number | No | Minimum number of parking spaces. |
| `transit_line_types` | string | No | Public transport nearby. One of: `BUS`, `CABLE_CAR`, `FERRY`, `REGIONAL_TRAIN`, `SUBWAY`, `TRAM`, `URBAN_TRAIN`. Several values are comma separated. |
| `has_commission` | boolean | No | Set `false` for listings without agent commission. |
| `is_private_insertion` | boolean | No | Set `true` for private listings only. |
| `is_developer_project` | boolean | No | Set `true` for new-build projects only. |
| `is_investment_property` | boolean | No | Set `true` for investment properties only. |
| `is_forced_sale` | boolean | No | Set `true` for forced sales only. |
| `is_social_housing` | boolean | No | Set `true` for social housing only. |
| `is_shortterm_rentable` | boolean | No | Set `true` for short-term rentals only. |
| `is_suitable_as_holiday_home` | boolean | No | Set `true` for holiday homes only. |
| `requires_financial_contribution` | boolean | No | Set `true` for listings that need a financial contribution. |

## Example response

```json
{
    "data": {
        "totalHits": 3881,
        "aggregations": {
            "conditionAge": {
                "NEWBUILDING": 2715,
                "OLDBUILDING": 607
            },
            "areaOutdoorSpaces": {
                "BALCONY": 1622,
                "TERRACE": 1007
            }
        }
    },
    "meta": {
        "attempts": 1,
        "billable": true,
        "duration_ms": 640
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested listing, agency or place does not exist. Non-billable and not retryable. |
| 422 | Validation Error | A query parameter failed validation: a missing required value, an unsupported filter value or a number outside the documented range. Every filter value is checked before a request is made, so a typo is never answered with a plausible but unfiltered result. Non-billable. |
| 503 | Request Rejected | ImmobilienScout24 Austria answered with an application error, for example a region it does not know. Non-billable and not retryable: the same request fails the same way. Published as 503; branch on `meta.retryable` rather than on the status code. |
| 503 | Temporarily Unavailable | ImmobilienScout24 Austria could not be reached. Every attempt is made again on a fresh route before this is returned, so it is always retryable. The `failure_type` is one of `upstream_unreachable`, `transport_error`, `edge_blocked`, `rate_limited` or `attempts_exhausted`. Non-billable; a later request is worth making. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)