# Property Search

Search for real estate listings on Immobilienscout24 with filters for location, property type, price range, rooms, and size. Apartment rentals include tenant-network listings (Nachvermietung). Numeric prices use the upper bound of rental estimates; price_formatted preserves the advertised range. is_tenant_network identifies these listings.

- **Documentation:** [https://scrappa.co/docs/immobilienscout24-api/immobilienscout24_search](https://scrappa.co/docs/immobilienscout24-api/immobilienscout24_search)
- **API group:** Immobilienscout24 API
- **Endpoint:** `GET https://scrappa.co/api/immobilienscout24/search`

## 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 |
| --- | --- | --- | --- |
| `location` | string | Yes | City name, postal code, or geocode (e.g., "Berlin", "10115", "1276003001") |
| `type` | string | No | Property type: apartment-rent, apartment-buy, house-rent, house-buy (default: apartment-rent) |
| `price_min` | integer | No | Minimum price in EUR |
| `price_max` | integer | No | Maximum price in EUR |
| `rooms_min` | number | No | Minimum number of rooms |
| `rooms_max` | number | No | Maximum number of rooms |
| `size_min` | integer | No | Minimum size in m² |
| `size_max` | integer | No | Maximum size in m² |
| `page` | integer | No | Page number for pagination |
| `per_page` | integer | No | Number of results per page (max: 50, default: 20) |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/immobilienscout24/search?location=Berlin&type=apartment-rent"
```

## Example response

```json
{
    "success": true,
    "total_results": 1234,
    "page": 1,
    "total_pages": 62,
    "results": [
        {
            "id": "165221493",
            "title": "Sample listing in Berlin",
            "price": 2440,
            "is_tenant_network": false,
            "price_formatted": "2440 EUR",
            "rooms": 4,
            "size_m2": 137,
            "address": "Berlin, Germany",
            "lat": 52.52,
            "lon": 13.405,
            "image_url": "https://pictures.immobilienscout24.de/listings/sample.jpg",
            "url": "https://www.immobilienscout24.de/expose/165221493",
            "is_private": false,
            "published": "10 days ago"
        }
    ]
}
```

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